From 194f3d98735025fbb7471fc747bfd2e909a6ca54 Mon Sep 17 00:00:00 2001 From: Jeffrey Aven Date: Tue, 16 Sep 2025 04:57:00 +1000 Subject: [PATCH 1/2] updated datadog provider --- .../src/datadog/v00.00.00000/provider.yaml | 457 +- .../v00.00.00000/services/actions.yaml | 3805 ++++ .../datadog/v00.00.00000/services/apm.yaml | 2054 +++ .../services/apm_retention_filters.yaml | 1387 -- .../datadog/v00.00.00000/services/audit.yaml | 1237 -- .../v00.00.00000/services/authn_mappings.yaml | 1517 -- .../v00.00.00000/services/catalog.yaml | 2356 +++ .../v00.00.00000/services/ci_visibility.yaml | 2685 --- .../v00.00.00000/services/cloud_costs.yaml | 2509 +++ .../services/cloud_workload_security.yaml | 1334 -- .../services/cloudflare_integration.yaml | 1209 -- .../services/confluent_cloud.yaml | 1561 -- .../v00.00.00000/services/containers.yaml | 1581 -- .../services/dashboard_lists.yaml | 1303 -- .../v00.00.00000/services/dashboards.yaml | 1300 ++ .../services/digital_experience.yaml | 2247 +++ .../v00.00.00000/services/dora_metrics.yaml | 1214 -- .../v00.00.00000/services/downtimes.yaml | 2025 -- .../datadog/v00.00.00000/services/events.yaml | 1415 -- .../services/fastly_integration.yaml | 1455 -- .../services/gcp_integration.yaml | 1272 -- .../v00.00.00000/services/incidents.yaml | 4424 ----- .../v00.00.00000/services/infrastructure.yaml | 4124 +++++ .../v00.00.00000/services/integrations.yaml | 5112 +++++ .../v00.00.00000/services/ip_allowlist.yaml | 1067 -- .../v00.00.00000/services/key_management.yaml | 2241 --- .../v00.00.00000/services/log_archives.yaml | 1840 -- .../v00.00.00000/services/log_metrics.yaml | 1305 -- .../datadog/v00.00.00000/services/logs.yaml | 5394 ++++-- .../v00.00.00000/services/metrics.yaml | 8004 ++++---- .../v00.00.00000/services/monitoring.yaml | 2085 +++ .../v00.00.00000/services/monitors.yaml | 1299 -- .../services/okta_integration.yaml | 1222 -- .../services/opsgenie_integration.yaml | 1248 -- .../v00.00.00000/services/organization.yaml | 10531 +++++++++++ .../v00.00.00000/services/organizations.yaml | 932 - .../v00.00.00000/services/powerpack.yaml | 1642 -- .../v00.00.00000/services/processes.yaml | 1072 -- .../v00.00.00000/services/remote_config.yaml | 6784 +++++++ .../services/restriction_policies.yaml | 1098 -- .../datadog/v00.00.00000/services/roles.yaml | 2201 --- .../datadog/v00.00.00000/services/rum.yaml | 2004 -- .../v00.00.00000/services/security.yaml | 12753 +++++++++++++ .../services/security_monitoring.yaml | 3919 ---- .../services/sensitive_data_scanner.yaml | 1931 -- .../services/service_accounts.yaml | 1807 -- .../services/service_definition.yaml | 1994 -- .../services/service_management.yaml | 15378 ++++++++++++++++ .../services/service_scorecards.yaml | 1593 -- .../services/software_delivery.yaml | 4550 +++++ .../v00.00.00000/services/span_metrics.yaml | 1287 -- .../datadog/v00.00.00000/services/spans.yaml | 1736 -- .../v00.00.00000/services/synthetics.yaml | 978 - .../datadog/v00.00.00000/services/teams.yaml | 2837 --- .../v00.00.00000/services/usage_metering.yaml | 2228 --- .../datadog/v00.00.00000/services/users.yaml | 2010 -- 56 files changed, 83915 insertions(+), 72638 deletions(-) create mode 100644 providers/src/datadog/v00.00.00000/services/actions.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/apm.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/apm_retention_filters.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/audit.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/authn_mappings.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/catalog.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/ci_visibility.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/cloud_costs.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/cloud_workload_security.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/cloudflare_integration.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/confluent_cloud.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/containers.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/dashboard_lists.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/dashboards.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/digital_experience.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/dora_metrics.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/downtimes.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/events.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/fastly_integration.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/gcp_integration.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/incidents.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/infrastructure.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/integrations.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/ip_allowlist.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/key_management.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/log_archives.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/log_metrics.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/monitoring.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/monitors.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/okta_integration.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/opsgenie_integration.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/organization.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/organizations.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/powerpack.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/processes.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/remote_config.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/restriction_policies.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/roles.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/rum.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/security.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/security_monitoring.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/sensitive_data_scanner.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/service_accounts.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/service_definition.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/service_management.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/service_scorecards.yaml create mode 100644 providers/src/datadog/v00.00.00000/services/software_delivery.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/span_metrics.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/spans.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/synthetics.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/teams.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/usage_metering.yaml delete mode 100644 providers/src/datadog/v00.00.00000/services/users.yaml diff --git a/providers/src/datadog/v00.00.00000/provider.yaml b/providers/src/datadog/v00.00.00000/provider.yaml index 77917f68..c5b28cca 100644 --- a/providers/src/datadog/v00.00.00000/provider.yaml +++ b/providers/src/datadog/v00.00.00000/provider.yaml @@ -2,427 +2,150 @@ id: datadog name: datadog version: v00.00.00000 providerServices: - apm_retention_filters: - id: 'apm_retention_filters:v00.00.00000' - name: apm_retention_filters + actions: + id: actions:v00.00.00000 + name: actions preferred: true service: - $ref: datadog/v00.00.00000/services/apm_retention_filters.yaml - title: Datadog API V2 Collection - Apm Retention Filters + $ref: datadog/v00.00.00000/services/actions.yaml + title: actions API version: v00.00.00000 - description: APM Retention Filters - audit: - id: 'audit:v00.00.00000' - name: audit + description: datadog actions API + apm: + id: apm:v00.00.00000 + name: apm preferred: true service: - $ref: datadog/v00.00.00000/services/audit.yaml - title: Datadog API V2 Collection - Audit + $ref: datadog/v00.00.00000/services/apm.yaml + title: apm API version: v00.00.00000 - description: Search Your Audit Logs Events Over HTTP. - authn_mappings: - id: 'authn_mappings:v00.00.00000' - name: authn_mappings + description: datadog apm API + catalog: + id: catalog:v00.00.00000 + name: catalog preferred: true service: - $ref: datadog/v00.00.00000/services/authn_mappings.yaml - title: Datadog API V2 Collection - Authn Mappings + $ref: datadog/v00.00.00000/services/catalog.yaml + title: catalog API version: v00.00.00000 - description: AuthN Mappings - ci_visibility: - id: 'ci_visibility:v00.00.00000' - name: ci_visibility + description: datadog catalog API + cloud_costs: + id: cloud_costs:v00.00.00000 + name: cloud_costs preferred: true service: - $ref: datadog/v00.00.00000/services/ci_visibility.yaml - title: Datadog API V2 Collection - Ci Visibility + $ref: datadog/v00.00.00000/services/cloud_costs.yaml + title: cloud_costs API version: v00.00.00000 - description: CI Visibility Pipelines - cloudflare_integration: - id: 'cloudflare_integration:v00.00.00000' - name: cloudflare_integration + description: datadog cloud_costs API + dashboards: + id: dashboards:v00.00.00000 + name: dashboards preferred: true service: - $ref: datadog/v00.00.00000/services/cloudflare_integration.yaml - title: Datadog API V2 Collection - Cloudflare Integration + $ref: datadog/v00.00.00000/services/dashboards.yaml + title: dashboards API version: v00.00.00000 - description: Cloudflare Integration - cloud_workload_security: - id: 'cloud_workload_security:v00.00.00000' - name: cloud_workload_security + description: datadog dashboards API + digital_experience: + id: digital_experience:v00.00.00000 + name: digital_experience preferred: true service: - $ref: datadog/v00.00.00000/services/cloud_workload_security.yaml - title: Datadog API V2 Collection - Cloud Workload Security + $ref: datadog/v00.00.00000/services/digital_experience.yaml + title: digital_experience API version: v00.00.00000 - description: Cloud Workload Security - confluent_cloud: - id: 'confluent_cloud:v00.00.00000' - name: confluent_cloud + description: datadog digital_experience API + infrastructure: + id: infrastructure:v00.00.00000 + name: infrastructure preferred: true service: - $ref: datadog/v00.00.00000/services/confluent_cloud.yaml - title: Datadog API V2 Collection - Confluent Cloud + $ref: datadog/v00.00.00000/services/infrastructure.yaml + title: infrastructure API version: v00.00.00000 - description: Confluent Cloud - containers: - id: 'containers:v00.00.00000' - name: containers + description: datadog infrastructure API + integrations: + id: integrations:v00.00.00000 + name: integrations preferred: true service: - $ref: datadog/v00.00.00000/services/containers.yaml - title: Datadog API V2 Collection - Containers + $ref: datadog/v00.00.00000/services/integrations.yaml + title: integrations API version: v00.00.00000 - description: Container Images - dashboard_lists: - id: 'dashboard_lists:v00.00.00000' - name: dashboard_lists - preferred: true - service: - $ref: datadog/v00.00.00000/services/dashboard_lists.yaml - title: Datadog API V2 Collection - Dashboard Lists - version: v00.00.00000 - description: Dashboard Lists - dora_metrics: - id: 'dora_metrics:v00.00.00000' - name: dora_metrics - preferred: true - service: - $ref: datadog/v00.00.00000/services/dora_metrics.yaml - title: Datadog API V2 Collection - Dora Metrics - version: v00.00.00000 - description: DORA Metrics - downtimes: - id: 'downtimes:v00.00.00000' - name: downtimes - preferred: true - service: - $ref: datadog/v00.00.00000/services/downtimes.yaml - title: Datadog API V2 Collection - Downtimes - version: v00.00.00000 - description: |- - **Note**: Downtime V2 Is Currently In Private Beta. To Request Access, Contact [Datadog Support](Https://Docs.Datadoghq.Com/Help/). - - [Downtiming](Https://Docs.Datadoghq.Com/Monitors/Notify/Downtimes) Gives - You Greater Control Over Monitor Notifications By Allowing You To Globally Exclude - Scopes From Alerting. Downtime Settings, Which Can Be Scheduled With Start And - End Times, Prevent All Alerting Related To Specified Datadog Tags. - events: - id: 'events:v00.00.00000' - name: events - preferred: true - service: - $ref: datadog/v00.00.00000/services/events.yaml - title: Datadog API V2 Collection - Events - version: v00.00.00000 - description: |- - The Events Service Allows You To Programmatically Post Events To The Event Stream - And Fetch Events From The Event Stream. Events Are Limited To 4000 Characters. - If An Event Is Sent Out With A Message Containing More Than 4000 Characters, Only The - First 4000 Characters Are Displayed. - fastly_integration: - id: 'fastly_integration:v00.00.00000' - name: fastly_integration - preferred: true - service: - $ref: datadog/v00.00.00000/services/fastly_integration.yaml - title: Datadog API V2 Collection - Fastly Integration - version: v00.00.00000 - description: Fastly Integration - gcp_integration: - id: 'gcp_integration:v00.00.00000' - name: gcp_integration - preferred: true - service: - $ref: datadog/v00.00.00000/services/gcp_integration.yaml - title: Datadog API V2 Collection - Gcp Integration - version: v00.00.00000 - description: GCP Integration - incidents: - id: 'incidents:v00.00.00000' - name: incidents - preferred: true - service: - $ref: datadog/v00.00.00000/services/incidents.yaml - title: Datadog API V2 Collection - Incidents - version: v00.00.00000 - description: Manage Incident Response. - ip_allowlist: - id: 'ip_allowlist:v00.00.00000' - name: ip_allowlist - preferred: true - service: - $ref: datadog/v00.00.00000/services/ip_allowlist.yaml - title: Datadog API V2 Collection - Ip Allowlist - version: v00.00.00000 - description: IP Allowlist - key_management: - id: 'key_management:v00.00.00000' - name: key_management - preferred: true - service: - $ref: datadog/v00.00.00000/services/key_management.yaml - title: Datadog API V2 Collection - Key Management - version: v00.00.00000 - description: Key Management + description: datadog integrations API logs: - id: 'logs:v00.00.00000' + id: logs:v00.00.00000 name: logs preferred: true service: $ref: datadog/v00.00.00000/services/logs.yaml - title: Datadog API V2 Collection - Logs + title: logs API version: v00.00.00000 - description: Search Your Logs And Send Them To Your Datadog Platform Over HTTP. - log_archives: - id: 'log_archives:v00.00.00000' - name: log_archives - preferred: true - service: - $ref: datadog/v00.00.00000/services/log_archives.yaml - title: Datadog API V2 Collection - Log Archives - version: v00.00.00000 - description: Logs Archives - log_metrics: - id: 'log_metrics:v00.00.00000' - name: log_metrics - preferred: true - service: - $ref: datadog/v00.00.00000/services/log_metrics.yaml - title: Datadog API V2 Collection - Log Metrics - version: v00.00.00000 - description: Logs Metrics + description: datadog logs API metrics: - id: 'metrics:v00.00.00000' + id: metrics:v00.00.00000 name: metrics preferred: true service: $ref: datadog/v00.00.00000/services/metrics.yaml - title: Datadog API V2 Collection - Metrics - version: v00.00.00000 - description: |- - The Metrics Endpoint Allows You To: - - - Post Metrics Data So It Can Be Graphed On Datadog’S Dashboards - - Query Metrics From Any Time Period (Timeseries And Scalar) - - Modify Tag Configurations For Metrics - - View Tags And Volumes For Metrics - - **Note**: A Graph Can Only Contain A Set Number Of Points - And As The Timeframe Over Which A Metric Is Viewed Increases, - Aggregation Between Points Occurs To Stay Below That Set Number. - - The Post, Patch, And Delete `Manage Tags` API Methods Can Only Be Performed By - A User Who Has The `Manage Tags For Metrics` Permission. - monitors: - id: 'monitors:v00.00.00000' - name: monitors - preferred: true - service: - $ref: datadog/v00.00.00000/services/monitors.yaml - title: Datadog API V2 Collection - Monitors - version: v00.00.00000 - description: |- - [Monitors](Https://Docs.Datadoghq.Com/Monitors) Allow You To Watch A Metric Or Check That You Care About And - Notifies Your Team When A Defined Threshold Has Exceeded. - - For More Information, See [Creating Monitors](Https://Docs.Datadoghq.Com/Monitors/Create/Types/) And - [Tag Policies](Https://Docs.Datadoghq.Com/Monitors/Settings/). - okta_integration: - id: 'okta_integration:v00.00.00000' - name: okta_integration - preferred: true - service: - $ref: datadog/v00.00.00000/services/okta_integration.yaml - title: Datadog API V2 Collection - Okta Integration - version: v00.00.00000 - description: Okta Integration - opsgenie_integration: - id: 'opsgenie_integration:v00.00.00000' - name: opsgenie_integration - preferred: true - service: - $ref: datadog/v00.00.00000/services/opsgenie_integration.yaml - title: Datadog API V2 Collection - Opsgenie Integration - version: v00.00.00000 - description: Opsgenie Integration - organizations: - id: 'organizations:v00.00.00000' - name: organizations - preferred: true - service: - $ref: datadog/v00.00.00000/services/organizations.yaml - title: Datadog API V2 Collection - Organizations - version: v00.00.00000 - description: 'Create, Edit, And Manage Your Organizations. Read More About [Multi-Org Accounts](Https://Docs.Datadoghq.Com/Account Management/Multi Organization).' - powerpack: - id: 'powerpack:v00.00.00000' - name: powerpack - preferred: true - service: - $ref: datadog/v00.00.00000/services/powerpack.yaml - title: Datadog API V2 Collection - Powerpack - version: v00.00.00000 - description: |- - The Powerpack Endpoints Allow You To: - - - Get A Powerpack - - Create A Powerpack - - Delete A Powerpack - - Get A List Of All Powerpacks - - The Patch And Delete API Methods Can Only Be Performed On A Powerpack By - A User Who Has The Powerpack Create Permission For That Specific Powerpack. - processes: - id: 'processes:v00.00.00000' - name: processes - preferred: true - service: - $ref: datadog/v00.00.00000/services/processes.yaml - title: Datadog API V2 Collection - Processes - version: v00.00.00000 - description: The Processes API Allows You To Query Processes Data For Your Organization. - restriction_policies: - id: 'restriction_policies:v00.00.00000' - name: restriction_policies - preferred: true - service: - $ref: datadog/v00.00.00000/services/restriction_policies.yaml - title: Datadog API V2 Collection - Restriction Policies - version: v00.00.00000 - description: Restriction Policies - roles: - id: 'roles:v00.00.00000' - name: roles - preferred: true - service: - $ref: datadog/v00.00.00000/services/roles.yaml - title: Datadog API V2 Collection - Roles - version: v00.00.00000 - description: |- - The Roles API Is Used To Create And Manage Datadog Roles, What - [Global Permissions](Https://Docs.Datadoghq.Com/Account Management/Rbac/) - They Grant, And Which Users Belong To Them. - - Permissions Related To Specific Account Assets Can Be Granted To Roles - In The Datadog Application Without Using This API. For Example, Granting - Read Access On A Specific Log Index To A Role Can Be Done In Datadog From The - [Pipelines Page](Https://App.Datadoghq.Com/Logs/Pipelines). - rum: - id: 'rum:v00.00.00000' - name: rum - preferred: true - service: - $ref: datadog/v00.00.00000/services/rum.yaml - title: Datadog API V2 Collection - Rum - version: v00.00.00000 - description: Search Or Aggregate Your RUM Events Over HTTP. - security_monitoring: - id: 'security_monitoring:v00.00.00000' - name: security_monitoring - preferred: true - service: - $ref: datadog/v00.00.00000/services/security_monitoring.yaml - title: Datadog API V2 Collection - Security Monitoring - version: v00.00.00000 - description: Security Monitoring - sensitive_data_scanner: - id: 'sensitive_data_scanner:v00.00.00000' - name: sensitive_data_scanner - preferred: true - service: - $ref: datadog/v00.00.00000/services/sensitive_data_scanner.yaml - title: Datadog API V2 Collection - Sensitive Data Scanner - version: v00.00.00000 - description: Sensitive Data Scanner - service_accounts: - id: 'service_accounts:v00.00.00000' - name: service_accounts - preferred: true - service: - $ref: datadog/v00.00.00000/services/service_accounts.yaml - title: Datadog API V2 Collection - Service Accounts - version: v00.00.00000 - description: Service Accounts - service_definition: - id: 'service_definition:v00.00.00000' - name: service_definition - preferred: true - service: - $ref: datadog/v00.00.00000/services/service_definition.yaml - title: Datadog API V2 Collection - Service Definition - version: v00.00.00000 - description: Service Definition - service_scorecards: - id: 'service_scorecards:v00.00.00000' - name: service_scorecards - preferred: true - service: - $ref: datadog/v00.00.00000/services/service_scorecards.yaml - title: Datadog API V2 Collection - Service Scorecards + title: metrics API version: v00.00.00000 - description: Service Scorecards - spans: - id: 'spans:v00.00.00000' - name: spans + description: datadog metrics API + monitoring: + id: monitoring:v00.00.00000 + name: monitoring preferred: true service: - $ref: datadog/v00.00.00000/services/spans.yaml - title: Datadog API V2 Collection - Spans + $ref: datadog/v00.00.00000/services/monitoring.yaml + title: monitoring API version: v00.00.00000 - description: Search And Aggregate Your Spans From Your Datadog Platform Over HTTP. - span_metrics: - id: 'span_metrics:v00.00.00000' - name: span_metrics + description: datadog monitoring API + organization: + id: organization:v00.00.00000 + name: organization preferred: true service: - $ref: datadog/v00.00.00000/services/span_metrics.yaml - title: Datadog API V2 Collection - Span Metrics + $ref: datadog/v00.00.00000/services/organization.yaml + title: organization API version: v00.00.00000 - description: Spans Metrics - synthetics: - id: 'synthetics:v00.00.00000' - name: synthetics + description: datadog organization API + remote_config: + id: remote_config:v00.00.00000 + name: remote_config preferred: true service: - $ref: datadog/v00.00.00000/services/synthetics.yaml - title: Datadog API V2 Collection - Synthetics + $ref: datadog/v00.00.00000/services/remote_config.yaml + title: remote_config API version: v00.00.00000 - description: |- - Datadog Synthetics Uses Simulated User Requests And Browser Rendering To Help You Ensure Uptime, - Identify Regional Issues, And Track Your Application Performance. Datadog Synthetics Tests Come In - Two Different Flavors, [API Tests](Https://Docs.Datadoghq.Com/Synthetics/Api Tests/) - And [Browser Tests](Https://Docs.Datadoghq.Com/Synthetics/Browser Tests). You Can Use Datadog’S API To - Manage Both Test Types Programmatically. - - For More Information About Synthetics, See The [Synthetics Overview](Https://Docs.Datadoghq.Com/Synthetics/). - teams: - id: 'teams:v00.00.00000' - name: teams + description: datadog remote_config API + security: + id: security:v00.00.00000 + name: security preferred: true service: - $ref: datadog/v00.00.00000/services/teams.yaml - title: Datadog API V2 Collection - Teams + $ref: datadog/v00.00.00000/services/security.yaml + title: security API version: v00.00.00000 - description: View And Manage Teams Within Datadog. - usage_metering: - id: 'usage_metering:v00.00.00000' - name: usage_metering + description: datadog security API + service_management: + id: service_management:v00.00.00000 + name: service_management preferred: true service: - $ref: datadog/v00.00.00000/services/usage_metering.yaml - title: Datadog API V2 Collection - Usage Metering + $ref: datadog/v00.00.00000/services/service_management.yaml + title: service_management API version: v00.00.00000 - description: Usage Metering - users: - id: 'users:v00.00.00000' - name: users + description: datadog service_management API + software_delivery: + id: software_delivery:v00.00.00000 + name: software_delivery preferred: true service: - $ref: datadog/v00.00.00000/services/users.yaml - title: Datadog API V2 Collection - Users + $ref: datadog/v00.00.00000/services/software_delivery.yaml + title: software_delivery API version: v00.00.00000 - description: 'Create, Edit, And Disable Users.' + description: datadog software_delivery API config: auth: type: custom diff --git a/providers/src/datadog/v00.00.00000/services/actions.yaml b/providers/src/datadog/v00.00.00000/services/actions.yaml new file mode 100644 index 00000000..4bb642de --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/actions.yaml @@ -0,0 +1,3805 @@ +openapi: 3.0.0 +info: + title: actions API + description: datadog actions API + version: '1.0' +paths: + /api/v2/actions-datastores: + get: + description: Lists all datastores for the organization. + operationId: ListDatastores + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DatastoreArray' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List datastores + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_read + post: + description: Creates a new datastore. + operationId: CreateDatastore + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateAppsDatastoreRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CreateAppsDatastoreResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create datastore + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_manage + /api/v2/actions-datastores/{datastore_id}: + delete: + description: Deletes a datastore by its unique identifier. + operationId: DeleteDatastore + parameters: + - description: The unique identifier of the datastore to retrieve. + in: path + name: datastore_id + required: true + schema: + type: string + responses: + '200': + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete datastore + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_manage + get: + description: Retrieves a specific datastore by its ID. + operationId: GetDatastore + parameters: + - description: The unique identifier of the datastore to retrieve. + in: path + name: datastore_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/Datastore' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get datastore + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_read + patch: + description: Updates an existing datastore's attributes. + operationId: UpdateDatastore + parameters: + - description: The unique identifier of the datastore to retrieve. + in: path + name: datastore_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateAppsDatastoreRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/Datastore' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update datastore + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_manage + /api/v2/actions-datastores/{datastore_id}/items: + delete: + description: Deletes an item from a datastore by its key. + operationId: DeleteDatastoreItem + parameters: + - description: The unique identifier of the datastore to retrieve. + in: path + name: datastore_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteAppsDatastoreItemRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteAppsDatastoreItemResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete datastore item + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_write + get: + description: >- + Lists items from a datastore. You can filter the results by specifying + either an item key or a filter query parameter, but not both at the same + time. Supports server-side pagination for large datasets. + operationId: ListDatastoreItems + parameters: + - description: The unique identifier of the datastore to retrieve. + in: path + name: datastore_id + required: true + schema: + type: string + - description: >- + Optional query filter to search items using the [logs search + syntax](https://docs.datadoghq.com/logs/explorer/search_syntax/). + in: query + name: filter + schema: + type: string + - description: >- + Optional primary key value to retrieve a specific item. Cannot be + used together with the filter parameter. + in: query + name: item_key + schema: + maxLength: 256 + type: string + - description: >- + Optional field to limit the number of items to return per page for + pagination. Up to 100 items can be returned per page. + in: query + name: page[limit] + schema: + format: int64 + maximum: 100 + minimum: 1 + type: integer + - description: >- + Optional field to offset the number of items to skip from the + beginning of the result set for pagination. + in: query + name: page[offset] + schema: + format: int64 + type: integer + - description: >- + Optional field to sort results by. Prefix with '-' for descending + order (e.g., '-created_at'). + in: query + name: sort + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ItemApiPayloadArray' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List datastore items + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_read + patch: + description: Partially updates an item in a datastore by its key. + operationId: UpdateDatastoreItem + parameters: + - description: The unique identifier of the datastore to retrieve. + in: path + name: datastore_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateAppsDatastoreItemRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ItemApiPayload' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update datastore item + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_write + /api/v2/actions-datastores/{datastore_id}/items/bulk: + post: + description: >- + Creates or replaces multiple items in a datastore by their keys in a + single operation. + operationId: BulkWriteDatastoreItems + parameters: + - description: The unique identifier of the datastore to retrieve. + in: path + name: datastore_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/BulkPutAppsDatastoreItemsRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PutAppsDatastoreItemResponseArray' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Bulk write datastore items + tags: + - Actions Datastores + x-permission: + operator: OR + permissions: + - apps_datastore_write + /api/v2/actions/app_key_registrations: + get: + description: List App Key Registrations + operationId: ListAppKeyRegistrations + parameters: + - description: The number of App Key Registrations to return per page. + in: query + name: page[size] + required: false + schema: + format: int64 + type: integer + - description: The page number to return. + in: query + name: page[number] + required: false + schema: + format: int64 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListAppKeyRegistrationsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too many requests + summary: List App Key Registrations + tags: + - Action Connection + x-permission: + operator: OR + permissions: + - org_app_keys_read + /api/v2/actions/app_key_registrations/{app_key_id}: + delete: + description: Unregister an App Key + operationId: UnregisterAppKey + parameters: + - $ref: '#/components/parameters/ApplicationKeyId' + responses: + '204': + description: No Content + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too many requests + summary: Unregister an App Key + tags: + - Action Connection + x-permission: + operator: OR + permissions: + - user_access_manage + - user_app_keys + - service_account_write + get: + description: Get an existing App Key Registration + operationId: GetAppKeyRegistration + parameters: + - $ref: '#/components/parameters/ApplicationKeyId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetAppKeyRegistrationResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too many requests + summary: Get an existing App Key Registration + tags: + - Action Connection + x-permission: + operator: OR + permissions: + - org_app_keys_read + put: + description: Register a new App Key + operationId: RegisterAppKey + parameters: + - $ref: '#/components/parameters/ApplicationKeyId' + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/RegisterAppKeyResponse' + description: Created + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too many requests + summary: Register a new App Key + tags: + - Action Connection + x-permission: + operator: OR + permissions: + - user_access_manage + - user_app_keys + - service_account_write + /api/v2/actions/connections: + post: + description: >- + Create a new Action Connection. This API requires a [registered + application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + operationId: CreateActionConnection + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateActionConnectionRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/CreateActionConnectionResponse' + description: Successfully created Action Connection + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too Many Request + summary: Create a new Action Connection + tags: + - Action Connection + /api/v2/actions/connections/{connection_id}: + delete: + description: >- + Delete an existing Action Connection. This API requires a [registered + application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: DeleteActionConnection + parameters: + - $ref: '#/components/parameters/ConnectionId' + responses: + '204': + description: The resource was deleted successfully. + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too Many Request + summary: Delete an existing Action Connection + tags: + - Action Connection + x-permission: + operator: OR + permissions: + - connection_write + get: + description: >- + Get an existing Action Connection. This API requires a [registered + application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + operationId: GetActionConnection + parameters: + - $ref: '#/components/parameters/ConnectionId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetActionConnectionResponse' + description: Successfully get Action Connection + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too Many Request + summary: Get an existing Action Connection + tags: + - Action Connection + patch: + description: >- + Update an existing Action Connection. This API requires a [registered + application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + operationId: UpdateActionConnection + parameters: + - $ref: '#/components/parameters/ConnectionId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateActionConnectionRequest' + description: Update an existing Action Connection request body + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateActionConnectionResponse' + description: Successfully updated Action Connection + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too Many Request + summary: Update an existing Action Connection + tags: + - Action Connection +components: + schemas: + DatastoreArray: + description: A collection of datastores returned by list operations. + properties: + data: + description: >- + An array of datastore objects containing their configurations and + metadata. + items: + $ref: '#/components/schemas/DatastoreData' + type: array + required: + - data + type: object + CreateAppsDatastoreRequest: + description: >- + Request to create a new datastore with specified configuration and + metadata. + properties: + data: + $ref: '#/components/schemas/CreateAppsDatastoreRequestData' + type: object + CreateAppsDatastoreResponse: + description: >- + Response after successfully creating a new datastore, containing the + datastore's assigned ID. + properties: + data: + $ref: '#/components/schemas/CreateAppsDatastoreResponseData' + type: object + JSONAPIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + items: + $ref: '#/components/schemas/JSONAPIErrorItem' + type: array + required: + - errors + type: object + Datastore: + description: A datastore's complete configuration and metadata. + properties: + data: + $ref: '#/components/schemas/DatastoreData' + type: object + UpdateAppsDatastoreRequest: + description: >- + Request to update a datastore's configuration such as its name or + description. + properties: + data: + $ref: '#/components/schemas/UpdateAppsDatastoreRequestData' + type: object + DeleteAppsDatastoreItemRequest: + description: Request to delete a specific item from a datastore by its primary key. + properties: + data: + $ref: '#/components/schemas/DeleteAppsDatastoreItemRequestData' + type: object + DeleteAppsDatastoreItemResponse: + description: Response from successfully deleting a datastore item. + properties: + data: + $ref: '#/components/schemas/DeleteAppsDatastoreItemResponseData' + type: object + ItemApiPayloadArray: + description: A collection of datastore items with pagination and schema metadata. + properties: + data: + description: An array of datastore items with their content and metadata. + items: + $ref: '#/components/schemas/ItemApiPayloadData' + maxItems: 100 + type: array + meta: + $ref: '#/components/schemas/ItemApiPayloadMeta' + description: >- + Metadata about the included items, including pagination info and + datastore schema. + required: + - data + type: object + UpdateAppsDatastoreItemRequest: + description: Request to update specific fields on an existing datastore item. + properties: + data: + $ref: '#/components/schemas/UpdateAppsDatastoreItemRequestData' + type: object + ItemApiPayload: + description: A single datastore item with its content and metadata. + properties: + data: + $ref: '#/components/schemas/ItemApiPayloadData' + type: object + BulkPutAppsDatastoreItemsRequest: + description: Request to insert multiple items into a datastore in a single operation. + properties: + data: + $ref: '#/components/schemas/BulkPutAppsDatastoreItemsRequestData' + type: object + PutAppsDatastoreItemResponseArray: + description: >- + Response after successfully inserting multiple items into a datastore, + containing the identifiers of the created items. + properties: + data: + description: >- + An array of data objects containing the identifiers of the + successfully inserted items. + items: + $ref: '#/components/schemas/PutAppsDatastoreItemResponseData' + maxItems: 100 + type: array + required: + - data + type: object + ListAppKeyRegistrationsResponse: + description: A paginated list of app key registrations. + properties: + data: + description: An array of app key registrations. + items: + $ref: '#/components/schemas/AppKeyRegistrationData' + type: array + meta: + $ref: '#/components/schemas/ListAppKeyRegistrationsResponseMeta' + type: object + GetAppKeyRegistrationResponse: + description: The response object after getting an app key registration. + properties: + data: + $ref: '#/components/schemas/AppKeyRegistrationData' + type: object + RegisterAppKeyResponse: + description: The response object after creating an app key registration. + properties: + data: + $ref: '#/components/schemas/AppKeyRegistrationData' + type: object + CreateActionConnectionRequest: + description: Request used to create an action connection. + properties: + data: + $ref: '#/components/schemas/ActionConnectionData' + required: + - data + type: object + CreateActionConnectionResponse: + description: The response for a created connection + properties: + data: + $ref: '#/components/schemas/ActionConnectionData' + type: object + GetActionConnectionResponse: + description: The response for found connection + properties: + data: + $ref: '#/components/schemas/ActionConnectionData' + type: object + UpdateActionConnectionRequest: + description: Request used to update an action connection. + properties: + data: + $ref: '#/components/schemas/ActionConnectionDataUpdate' + required: + - data + type: object + UpdateActionConnectionResponse: + description: The response for an updated connection. + properties: + data: + $ref: '#/components/schemas/ActionConnectionData' + type: object + DatastoreData: + description: >- + Core information about a datastore, including its unique identifier and + attributes. + properties: + attributes: + $ref: '#/components/schemas/DatastoreDataAttributes' + id: + description: The unique identifier of the datastore. + type: string + type: + $ref: '#/components/schemas/DatastoreDataType' + required: + - type + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + CreateAppsDatastoreRequestData: + description: >- + Data wrapper containing the configuration needed to create a new + datastore. + properties: + attributes: + $ref: '#/components/schemas/CreateAppsDatastoreRequestDataAttributes' + id: + description: >- + Optional ID for the new datastore. If not provided, one will be + generated automatically. + type: string + type: + $ref: '#/components/schemas/DatastoreDataType' + required: + - type + type: object + CreateAppsDatastoreResponseData: + description: The newly created datastore's data. + properties: + id: + description: The unique identifier assigned to the newly created datastore. + type: string + type: + $ref: '#/components/schemas/DatastoreDataType' + required: + - type + type: object + JSONAPIErrorItem: + description: API error response body + properties: + detail: + description: >- + A human-readable explanation specific to this occurrence of the + error. + example: Missing required attribute in body + type: string + meta: + additionalProperties: {} + description: Non-standard meta-information about the error + type: object + source: + $ref: '#/components/schemas/JSONAPIErrorItemSource' + status: + description: Status code of the response. + example: '400' + type: string + title: + description: Short human-readable summary of the error. + example: Bad Request + type: string + type: object + UpdateAppsDatastoreRequestData: + description: >- + Data wrapper containing the datastore identifier and the attributes to + update. + properties: + attributes: + $ref: '#/components/schemas/UpdateAppsDatastoreRequestDataAttributes' + id: + description: The unique identifier of the datastore to update. + type: string + type: + $ref: '#/components/schemas/DatastoreDataType' + required: + - type + type: object + DeleteAppsDatastoreItemRequestData: + description: >- + Data wrapper containing the information needed to identify and delete a + specific datastore item. + properties: + attributes: + $ref: '#/components/schemas/DeleteAppsDatastoreItemRequestDataAttributes' + type: + $ref: '#/components/schemas/DatastoreItemsDataType' + required: + - type + type: object + DeleteAppsDatastoreItemResponseData: + description: >- + Data containing the identifier of the datastore item that was + successfully deleted. + properties: + id: + description: The unique identifier of the item that was deleted. + type: string + type: + $ref: '#/components/schemas/DatastoreItemsDataType' + required: + - type + type: object + ItemApiPayloadData: + description: Core data and metadata for a single datastore item. + properties: + attributes: + $ref: '#/components/schemas/ItemApiPayloadDataAttributes' + id: + description: The unique identifier of the datastore. + type: string + type: + $ref: '#/components/schemas/DatastoreItemsDataType' + required: + - type + type: object + ItemApiPayloadMeta: + description: >- + Additional metadata about a collection of datastore items, including + pagination and schema information. + properties: + page: + $ref: '#/components/schemas/ItemApiPayloadMetaPage' + schema: + $ref: '#/components/schemas/ItemApiPayloadMetaSchema' + type: object + UpdateAppsDatastoreItemRequestData: + description: >- + Data wrapper containing the item identifier and the changes to apply + during the update operation. + properties: + attributes: + $ref: '#/components/schemas/UpdateAppsDatastoreItemRequestDataAttributes' + id: + description: The unique identifier of the datastore item. + type: string + type: + $ref: '#/components/schemas/UpdateAppsDatastoreItemRequestDataType' + required: + - type + type: object + BulkPutAppsDatastoreItemsRequestData: + description: >- + Data wrapper containing the items to insert and their configuration for + the bulk insert operation. + properties: + attributes: + $ref: '#/components/schemas/BulkPutAppsDatastoreItemsRequestDataAttributes' + type: + $ref: '#/components/schemas/DatastoreItemsDataType' + required: + - type + type: object + PutAppsDatastoreItemResponseData: + description: >- + Data containing the identifier of a single item that was successfully + inserted into the datastore. + properties: + id: + description: The unique identifier assigned to the inserted item. + type: string + type: + $ref: '#/components/schemas/DatastoreItemsDataType' + required: + - type + type: object + AppKeyRegistrationData: + description: Data related to the app key registration. + properties: + id: + description: The app key registration identifier + format: uuid + readOnly: true + type: string + type: + $ref: '#/components/schemas/AppKeyRegistrationDataType' + required: + - type + type: object + ListAppKeyRegistrationsResponseMeta: + description: The definition of `ListAppKeyRegistrationsResponseMeta` object. + properties: + total: + description: The total number of app key registrations. + example: 1 + format: int64 + type: integer + total_filtered: + description: >- + The total number of app key registrations that match the specified + filters. + example: 1 + format: int64 + type: integer + type: object + ActionConnectionData: + description: Data related to the connection. + properties: + attributes: + $ref: '#/components/schemas/ActionConnectionAttributes' + id: + description: The connection identifier + readOnly: true + type: string + type: + $ref: '#/components/schemas/ActionConnectionDataType' + required: + - type + - attributes + type: object + ActionConnectionDataUpdate: + description: Data related to the connection update. + properties: + attributes: + $ref: '#/components/schemas/ActionConnectionAttributesUpdate' + type: + $ref: '#/components/schemas/ActionConnectionDataType' + required: + - type + - attributes + type: object + DatastoreDataAttributes: + description: Detailed information about a datastore. + properties: + created_at: + description: Timestamp when the datastore was created. + format: date-time + type: string + creator_user_id: + description: The numeric ID of the user who created the datastore. + format: int64 + type: integer + creator_user_uuid: + description: The UUID of the user who created the datastore. + type: string + description: + description: A human-readable description about the datastore. + type: string + modified_at: + description: Timestamp when the datastore was last modified. + format: date-time + type: string + name: + description: The display name of the datastore. + type: string + org_id: + description: The ID of the organization that owns this datastore. + format: int64 + type: integer + primary_column_name: + $ref: '#/components/schemas/DatastoreAttributesPrimaryColumnName' + primary_key_generation_strategy: + $ref: '#/components/schemas/DatastorePrimaryKeyGenerationStrategy' + type: object + DatastoreDataType: + default: datastores + description: The resource type for datastores. + enum: + - datastores + example: datastores + type: string + x-enum-varnames: + - DATASTORES + CreateAppsDatastoreRequestDataAttributes: + description: Configuration and metadata to create a new datastore. + properties: + description: + description: A human-readable description about the datastore. + type: string + name: + description: The display name for the new datastore. + example: datastore-name + type: string + org_access: + $ref: >- + #/components/schemas/CreateAppsDatastoreRequestDataAttributesOrgAccess + primary_column_name: + $ref: '#/components/schemas/DatastoreAttributesPrimaryColumnName' + primary_key_generation_strategy: + $ref: '#/components/schemas/DatastorePrimaryKeyGenerationStrategy' + required: + - name + - primary_column_name + type: object + JSONAPIErrorItemSource: + description: References to the source of the error. + properties: + header: + description: >- + A string indicating the name of a single request header which caused + the error. + example: Authorization + type: string + parameter: + description: A string indicating which URI query parameter caused the error. + example: limit + type: string + pointer: + description: >- + A JSON pointer to the value in the request document that caused the + error. + example: /data/attributes/title + type: string + type: object + UpdateAppsDatastoreRequestDataAttributes: + description: Attributes that can be updated on a datastore. + properties: + description: + description: A human-readable description about the datastore. + type: string + name: + description: The display name of the datastore. + type: string + type: object + DeleteAppsDatastoreItemRequestDataAttributes: + description: Attributes specifying which datastore item to delete by its primary key. + properties: + id: + description: Optional unique identifier of the item to delete. + example: a7656bcc-51d4-4884-adf7-4d0d9a3e0633 + type: string + item_key: + description: >- + The primary key value that identifies the item to delete. Cannot + exceed 256 characters. + example: primaryKey + maxLength: 256 + type: string + required: + - item_key + type: object + DatastoreItemsDataType: + default: items + description: The resource type for datastore items. + enum: + - items + example: items + type: string + x-enum-varnames: + - ITEMS + ItemApiPayloadDataAttributes: + description: Metadata and content of a datastore item. + properties: + created_at: + description: Timestamp when the item was first created. + format: date-time + type: string + modified_at: + description: Timestamp when the item was last modified. + format: date-time + type: string + org_id: + description: The ID of the organization that owns this item. + format: int64 + type: integer + primary_column_name: + $ref: '#/components/schemas/DatastoreAttributesPrimaryColumnName' + signature: + description: A unique signature identifying this item version. + type: string + store_id: + description: The unique identifier of the datastore containing this item. + type: string + value: + $ref: '#/components/schemas/ItemApiPayloadDataAttributesValue' + type: object + ItemApiPayloadMetaPage: + description: Pagination information for a collection of datastore items. + properties: + hasMore: + description: Whether there are additional pages of items beyond the current page. + type: boolean + totalCount: + description: The total number of items in the datastore, ignoring any filters. + format: int64 + type: integer + totalFilteredCount: + description: The total number of items that match the current filter criteria. + format: int64 + type: integer + type: object + ItemApiPayloadMetaSchema: + description: >- + Schema information about the datastore, including its primary key and + field definitions. + properties: + fields: + description: An array describing the columns available in this datastore. + items: + $ref: '#/components/schemas/ItemApiPayloadMetaSchemaField' + type: array + primary_key: + description: The name of the primary key column for this datastore. + type: string + type: object + UpdateAppsDatastoreItemRequestDataAttributes: + description: >- + Attributes for updating a datastore item, including the item key and + changes to apply. + properties: + id: + description: The unique identifier of the item being updated. + type: string + item_changes: + $ref: >- + #/components/schemas/UpdateAppsDatastoreItemRequestDataAttributesItemChanges + item_key: + description: >- + The primary key that identifies the item to update. Cannot exceed + 256 characters. + example: '' + maxLength: 256 + type: string + required: + - item_changes + - item_key + type: object + UpdateAppsDatastoreItemRequestDataType: + default: items + description: The resource type for datastore items. + enum: + - items + example: items + type: string + x-enum-varnames: + - ITEMS + BulkPutAppsDatastoreItemsRequestDataAttributes: + description: Configuration for bulk inserting multiple items into a datastore. + properties: + conflict_mode: + $ref: '#/components/schemas/DatastoreItemConflictMode' + values: + $ref: '#/components/schemas/DatastoreItemValues' + required: + - values + type: object + AppKeyRegistrationDataType: + description: The definition of `AppKeyRegistrationDataType` object. + enum: + - app_key_registration + example: app_key_registration + type: string + x-enum-varnames: + - APP_KEY_REGISTRATION + ActionConnectionAttributes: + description: The definition of `ActionConnectionAttributes` object. + properties: + integration: + $ref: '#/components/schemas/ActionConnectionIntegration' + name: + description: Name of the connection + example: My AWS Connection + type: string + required: + - name + - integration + type: object + ActionConnectionDataType: + description: The definition of `ActionConnectionDataType` object. + enum: + - action_connection + example: action_connection + type: string + x-enum-varnames: + - ACTION_CONNECTION + ActionConnectionAttributesUpdate: + description: The definition of `ActionConnectionAttributesUpdate` object. + properties: + integration: + $ref: '#/components/schemas/ActionConnectionIntegrationUpdate' + name: + description: Name of the connection + example: My AWS Connection + type: string + type: object + DatastoreAttributesPrimaryColumnName: + description: >- + The name of the primary key column for this datastore. Primary column + names: + - Must abide by both [PostgreSQL naming conventions](https://www.postgresql.org/docs/7.0/syntax525.htm) + - Cannot exceed 63 characters + example: '' + maxLength: 63 + type: string + DatastorePrimaryKeyGenerationStrategy: + description: >- + Can be set to `uuid` to automatically generate primary keys when new + items are added. Default value is `none`, which requires you to supply a + primary key for each new item. + enum: + - none + - uuid + type: string + x-enum-varnames: + - NONE + - UUID + CreateAppsDatastoreRequestDataAttributesOrgAccess: + description: >- + The organization access level for the datastore. For example, + 'contributor'. + enum: + - contributor + - viewer + - manager + type: string + x-enum-varnames: + - CONTRIBUTOR + - VIEWER + - MANAGER + ItemApiPayloadDataAttributesValue: + additionalProperties: {} + description: The data content (as key-value pairs) of a datastore item. + type: object + ItemApiPayloadMetaSchemaField: + description: Information about a specific column in the datastore schema. + properties: + name: + description: The name of this column in the datastore. + example: '' + type: string + type: + description: >- + The data type of this column. For example, 'string', 'number', or + 'boolean'. + example: '' + type: string + required: + - name + - type + type: object + UpdateAppsDatastoreItemRequestDataAttributesItemChanges: + description: Changes to apply to a datastore item using set operations. + properties: + ops_set: + additionalProperties: {} + description: >- + Set operation that contains key-value pairs to set on the datastore + item. + type: object + type: object + DatastoreItemConflictMode: + description: >- + How to handle conflicts when inserting items that already exist in the + datastore. + enum: + - fail_on_conflict + - overwrite_on_conflict + example: overwrite_on_conflict + type: string + x-enum-varnames: + - FAIL_ON_CONFLICT + - OVERWRITE_ON_CONFLICT + DatastoreItemValues: + description: >- + An array of items to add to the datastore, where each item is a set of + key-value pairs representing the item's data. Up to 100 items can be + updated in a single request. + example: + - data: example data + key: value + - data: example data2 + key: value2 + items: + additionalProperties: {} + description: >- + A single item's data as key-value pairs. Key names cannot exceed 63 + characters. + type: object + maxItems: 100 + type: array + ActionConnectionIntegration: + description: The definition of `ActionConnectionIntegration` object. + oneOf: + - $ref: '#/components/schemas/AWSIntegration' + - $ref: '#/components/schemas/AnthropicIntegration' + - $ref: '#/components/schemas/AsanaIntegration' + - $ref: '#/components/schemas/AzureIntegration' + - $ref: '#/components/schemas/CircleCIIntegration' + - $ref: '#/components/schemas/ClickupIntegration' + - $ref: '#/components/schemas/CloudflareIntegration' + - $ref: '#/components/schemas/ConfigCatIntegration' + - $ref: '#/components/schemas/DatadogIntegration' + - $ref: '#/components/schemas/FastlyIntegration' + - $ref: '#/components/schemas/FreshserviceIntegration' + - $ref: '#/components/schemas/GCPIntegration' + - $ref: '#/components/schemas/GeminiIntegration' + - $ref: '#/components/schemas/GitlabIntegration' + - $ref: '#/components/schemas/GreyNoiseIntegration' + - $ref: '#/components/schemas/HTTPIntegration' + - $ref: '#/components/schemas/LaunchDarklyIntegration' + - $ref: '#/components/schemas/NotionIntegration' + - $ref: '#/components/schemas/OktaIntegration' + - $ref: '#/components/schemas/OpenAIIntegration' + - $ref: '#/components/schemas/ServiceNowIntegration' + - $ref: '#/components/schemas/SplitIntegration' + - $ref: '#/components/schemas/StatsigIntegration' + - $ref: '#/components/schemas/VirusTotalIntegration' + ActionConnectionIntegrationUpdate: + description: The definition of `ActionConnectionIntegrationUpdate` object. + oneOf: + - $ref: '#/components/schemas/AWSIntegrationUpdate' + - $ref: '#/components/schemas/AnthropicIntegrationUpdate' + - $ref: '#/components/schemas/AsanaIntegrationUpdate' + - $ref: '#/components/schemas/AzureIntegrationUpdate' + - $ref: '#/components/schemas/CircleCIIntegrationUpdate' + - $ref: '#/components/schemas/ClickupIntegrationUpdate' + - $ref: '#/components/schemas/CloudflareIntegrationUpdate' + - $ref: '#/components/schemas/ConfigCatIntegrationUpdate' + - $ref: '#/components/schemas/DatadogIntegrationUpdate' + - $ref: '#/components/schemas/FastlyIntegrationUpdate' + - $ref: '#/components/schemas/FreshserviceIntegrationUpdate' + - $ref: '#/components/schemas/GCPIntegrationUpdate' + - $ref: '#/components/schemas/GeminiIntegrationUpdate' + - $ref: '#/components/schemas/GitlabIntegrationUpdate' + - $ref: '#/components/schemas/GreyNoiseIntegrationUpdate' + - $ref: '#/components/schemas/HTTPIntegrationUpdate' + - $ref: '#/components/schemas/LaunchDarklyIntegrationUpdate' + - $ref: '#/components/schemas/NotionIntegrationUpdate' + - $ref: '#/components/schemas/OktaIntegrationUpdate' + - $ref: '#/components/schemas/OpenAIIntegrationUpdate' + - $ref: '#/components/schemas/ServiceNowIntegrationUpdate' + - $ref: '#/components/schemas/SplitIntegrationUpdate' + - $ref: '#/components/schemas/StatsigIntegrationUpdate' + - $ref: '#/components/schemas/VirusTotalIntegrationUpdate' + AWSIntegration: + description: The definition of `AWSIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/AWSCredentials' + type: + $ref: '#/components/schemas/AWSIntegrationType' + required: + - type + - credentials + type: object + AnthropicIntegration: + description: The definition of the `AnthropicIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/AnthropicCredentials' + type: + $ref: '#/components/schemas/AnthropicIntegrationType' + required: + - type + - credentials + type: object + AsanaIntegration: + description: The definition of the `AsanaIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/AsanaCredentials' + type: + $ref: '#/components/schemas/AsanaIntegrationType' + required: + - type + - credentials + type: object + AzureIntegration: + description: The definition of the `AzureIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/AzureCredentials' + type: + $ref: '#/components/schemas/AzureIntegrationType' + required: + - type + - credentials + type: object + CircleCIIntegration: + description: The definition of the `CircleCIIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/CircleCICredentials' + type: + $ref: '#/components/schemas/CircleCIIntegrationType' + required: + - type + - credentials + type: object + ClickupIntegration: + description: The definition of the `ClickupIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/ClickupCredentials' + type: + $ref: '#/components/schemas/ClickupIntegrationType' + required: + - type + - credentials + type: object + CloudflareIntegration: + description: The definition of the `CloudflareIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/CloudflareCredentials' + type: + $ref: '#/components/schemas/CloudflareIntegrationType' + required: + - type + - credentials + type: object + ConfigCatIntegration: + description: The definition of the `ConfigCatIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/ConfigCatCredentials' + type: + $ref: '#/components/schemas/ConfigCatIntegrationType' + required: + - type + - credentials + type: object + DatadogIntegration: + description: The definition of the `DatadogIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/DatadogCredentials' + type: + $ref: '#/components/schemas/DatadogIntegrationType' + required: + - type + - credentials + type: object + FastlyIntegration: + description: The definition of the `FastlyIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/FastlyCredentials' + type: + $ref: '#/components/schemas/FastlyIntegrationType' + required: + - type + - credentials + type: object + FreshserviceIntegration: + description: The definition of the `FreshserviceIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/FreshserviceCredentials' + type: + $ref: '#/components/schemas/FreshserviceIntegrationType' + required: + - type + - credentials + type: object + GCPIntegration: + description: The definition of the `GCPIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/GCPCredentials' + type: + $ref: '#/components/schemas/GCPIntegrationType' + required: + - type + - credentials + type: object + GeminiIntegration: + description: The definition of the `GeminiIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/GeminiCredentials' + type: + $ref: '#/components/schemas/GeminiIntegrationType' + required: + - type + - credentials + type: object + GitlabIntegration: + description: The definition of the `GitlabIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/GitlabCredentials' + type: + $ref: '#/components/schemas/GitlabIntegrationType' + required: + - type + - credentials + type: object + GreyNoiseIntegration: + description: The definition of the `GreyNoiseIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/GreyNoiseCredentials' + type: + $ref: '#/components/schemas/GreyNoiseIntegrationType' + required: + - type + - credentials + type: object + HTTPIntegration: + description: The definition of `HTTPIntegration` object. + properties: + base_url: + description: Base HTTP url for the integration + example: http://datadoghq.com + type: string + credentials: + $ref: '#/components/schemas/HTTPCredentials' + type: + $ref: '#/components/schemas/HTTPIntegrationType' + required: + - type + - base_url + - credentials + type: object + LaunchDarklyIntegration: + description: The definition of the `LaunchDarklyIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/LaunchDarklyCredentials' + type: + $ref: '#/components/schemas/LaunchDarklyIntegrationType' + required: + - type + - credentials + type: object + NotionIntegration: + description: The definition of the `NotionIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/NotionCredentials' + type: + $ref: '#/components/schemas/NotionIntegrationType' + required: + - type + - credentials + type: object + OktaIntegration: + description: The definition of the `OktaIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/OktaCredentials' + type: + $ref: '#/components/schemas/OktaIntegrationType' + required: + - type + - credentials + type: object + OpenAIIntegration: + description: The definition of the `OpenAIIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/OpenAICredentials' + type: + $ref: '#/components/schemas/OpenAIIntegrationType' + required: + - type + - credentials + type: object + ServiceNowIntegration: + description: The definition of the `ServiceNowIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/ServiceNowCredentials' + type: + $ref: '#/components/schemas/ServiceNowIntegrationType' + required: + - type + - credentials + type: object + SplitIntegration: + description: The definition of the `SplitIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/SplitCredentials' + type: + $ref: '#/components/schemas/SplitIntegrationType' + required: + - type + - credentials + type: object + StatsigIntegration: + description: The definition of the `StatsigIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/StatsigCredentials' + type: + $ref: '#/components/schemas/StatsigIntegrationType' + required: + - type + - credentials + type: object + VirusTotalIntegration: + description: The definition of the `VirusTotalIntegration` object. + properties: + credentials: + $ref: '#/components/schemas/VirusTotalCredentials' + type: + $ref: '#/components/schemas/VirusTotalIntegrationType' + required: + - type + - credentials + type: object + AWSIntegrationUpdate: + description: The definition of `AWSIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/AWSCredentialsUpdate' + type: + $ref: '#/components/schemas/AWSIntegrationType' + required: + - type + type: object + AnthropicIntegrationUpdate: + description: The definition of the `AnthropicIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/AnthropicCredentialsUpdate' + type: + $ref: '#/components/schemas/AnthropicIntegrationType' + required: + - type + type: object + AsanaIntegrationUpdate: + description: The definition of the `AsanaIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/AsanaCredentialsUpdate' + type: + $ref: '#/components/schemas/AsanaIntegrationType' + required: + - type + type: object + AzureIntegrationUpdate: + description: The definition of the `AzureIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/AzureCredentialsUpdate' + type: + $ref: '#/components/schemas/AzureIntegrationType' + required: + - type + type: object + CircleCIIntegrationUpdate: + description: The definition of the `CircleCIIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/CircleCICredentialsUpdate' + type: + $ref: '#/components/schemas/CircleCIIntegrationType' + required: + - type + type: object + ClickupIntegrationUpdate: + description: The definition of the `ClickupIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/ClickupCredentialsUpdate' + type: + $ref: '#/components/schemas/ClickupIntegrationType' + required: + - type + type: object + CloudflareIntegrationUpdate: + description: The definition of the `CloudflareIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/CloudflareCredentialsUpdate' + type: + $ref: '#/components/schemas/CloudflareIntegrationType' + required: + - type + type: object + ConfigCatIntegrationUpdate: + description: The definition of the `ConfigCatIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/ConfigCatCredentialsUpdate' + type: + $ref: '#/components/schemas/ConfigCatIntegrationType' + required: + - type + type: object + DatadogIntegrationUpdate: + description: The definition of the `DatadogIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/DatadogCredentialsUpdate' + type: + $ref: '#/components/schemas/DatadogIntegrationType' + required: + - type + type: object + FastlyIntegrationUpdate: + description: The definition of the `FastlyIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/FastlyCredentialsUpdate' + type: + $ref: '#/components/schemas/FastlyIntegrationType' + required: + - type + type: object + FreshserviceIntegrationUpdate: + description: The definition of the `FreshserviceIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/FreshserviceCredentialsUpdate' + type: + $ref: '#/components/schemas/FreshserviceIntegrationType' + required: + - type + type: object + GCPIntegrationUpdate: + description: The definition of the `GCPIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/GCPCredentialsUpdate' + type: + $ref: '#/components/schemas/GCPIntegrationType' + required: + - type + type: object + GeminiIntegrationUpdate: + description: The definition of the `GeminiIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/GeminiCredentialsUpdate' + type: + $ref: '#/components/schemas/GeminiIntegrationType' + required: + - type + type: object + GitlabIntegrationUpdate: + description: The definition of the `GitlabIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/GitlabCredentialsUpdate' + type: + $ref: '#/components/schemas/GitlabIntegrationType' + required: + - type + type: object + GreyNoiseIntegrationUpdate: + description: The definition of the `GreyNoiseIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/GreyNoiseCredentialsUpdate' + type: + $ref: '#/components/schemas/GreyNoiseIntegrationType' + required: + - type + type: object + HTTPIntegrationUpdate: + description: The definition of `HTTPIntegrationUpdate` object. + properties: + base_url: + description: Base HTTP url for the integration + example: http://datadoghq.com + type: string + credentials: + $ref: '#/components/schemas/HTTPCredentialsUpdate' + type: + $ref: '#/components/schemas/HTTPIntegrationType' + required: + - type + type: object + LaunchDarklyIntegrationUpdate: + description: The definition of the `LaunchDarklyIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/LaunchDarklyCredentialsUpdate' + type: + $ref: '#/components/schemas/LaunchDarklyIntegrationType' + required: + - type + type: object + NotionIntegrationUpdate: + description: The definition of the `NotionIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/NotionCredentialsUpdate' + type: + $ref: '#/components/schemas/NotionIntegrationType' + required: + - type + type: object + OktaIntegrationUpdate: + description: The definition of the `OktaIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/OktaCredentialsUpdate' + type: + $ref: '#/components/schemas/OktaIntegrationType' + required: + - type + type: object + OpenAIIntegrationUpdate: + description: The definition of the `OpenAIIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/OpenAICredentialsUpdate' + type: + $ref: '#/components/schemas/OpenAIIntegrationType' + required: + - type + type: object + ServiceNowIntegrationUpdate: + description: The definition of the `ServiceNowIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/ServiceNowCredentialsUpdate' + type: + $ref: '#/components/schemas/ServiceNowIntegrationType' + required: + - type + type: object + SplitIntegrationUpdate: + description: The definition of the `SplitIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/SplitCredentialsUpdate' + type: + $ref: '#/components/schemas/SplitIntegrationType' + required: + - type + type: object + StatsigIntegrationUpdate: + description: The definition of the `StatsigIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/StatsigCredentialsUpdate' + type: + $ref: '#/components/schemas/StatsigIntegrationType' + required: + - type + type: object + VirusTotalIntegrationUpdate: + description: The definition of the `VirusTotalIntegrationUpdate` object. + properties: + credentials: + $ref: '#/components/schemas/VirusTotalCredentialsUpdate' + type: + $ref: '#/components/schemas/VirusTotalIntegrationType' + required: + - type + type: object + AWSCredentials: + description: The definition of `AWSCredentials` object. + oneOf: + - $ref: '#/components/schemas/AWSAssumeRole' + AWSIntegrationType: + description: The definition of `AWSIntegrationType` object. + enum: + - AWS + example: AWS + type: string + x-enum-varnames: + - AWS + AnthropicCredentials: + description: The definition of the `AnthropicCredentials` object. + oneOf: + - $ref: '#/components/schemas/AnthropicAPIKey' + AnthropicIntegrationType: + description: The definition of the `AnthropicIntegrationType` object. + enum: + - Anthropic + example: Anthropic + type: string + x-enum-varnames: + - ANTHROPIC + AsanaCredentials: + description: The definition of the `AsanaCredentials` object. + oneOf: + - $ref: '#/components/schemas/AsanaAccessToken' + AsanaIntegrationType: + description: The definition of the `AsanaIntegrationType` object. + enum: + - Asana + example: Asana + type: string + x-enum-varnames: + - ASANA + AzureCredentials: + description: The definition of the `AzureCredentials` object. + oneOf: + - $ref: '#/components/schemas/AzureTenant' + AzureIntegrationType: + description: The definition of the `AzureIntegrationType` object. + enum: + - Azure + example: Azure + type: string + x-enum-varnames: + - AZURE + CircleCICredentials: + description: The definition of the `CircleCICredentials` object. + oneOf: + - $ref: '#/components/schemas/CircleCIAPIKey' + CircleCIIntegrationType: + description: The definition of the `CircleCIIntegrationType` object. + enum: + - CircleCI + example: CircleCI + type: string + x-enum-varnames: + - CIRCLECI + ClickupCredentials: + description: The definition of the `ClickupCredentials` object. + oneOf: + - $ref: '#/components/schemas/ClickupAPIKey' + ClickupIntegrationType: + description: The definition of the `ClickupIntegrationType` object. + enum: + - Clickup + example: Clickup + type: string + x-enum-varnames: + - CLICKUP + CloudflareCredentials: + description: The definition of the `CloudflareCredentials` object. + oneOf: + - $ref: '#/components/schemas/CloudflareAPIToken' + - $ref: '#/components/schemas/CloudflareGlobalAPIToken' + CloudflareIntegrationType: + description: The definition of the `CloudflareIntegrationType` object. + enum: + - Cloudflare + example: Cloudflare + type: string + x-enum-varnames: + - CLOUDFLARE + ConfigCatCredentials: + description: The definition of the `ConfigCatCredentials` object. + oneOf: + - $ref: '#/components/schemas/ConfigCatSDKKey' + ConfigCatIntegrationType: + description: The definition of the `ConfigCatIntegrationType` object. + enum: + - ConfigCat + example: ConfigCat + type: string + x-enum-varnames: + - CONFIGCAT + DatadogCredentials: + description: The definition of the `DatadogCredentials` object. + oneOf: + - $ref: '#/components/schemas/DatadogAPIKey' + DatadogIntegrationType: + description: The definition of the `DatadogIntegrationType` object. + enum: + - Datadog + example: Datadog + type: string + x-enum-varnames: + - DATADOG + FastlyCredentials: + description: The definition of the `FastlyCredentials` object. + oneOf: + - $ref: '#/components/schemas/FastlyAPIKey' + FastlyIntegrationType: + description: The definition of the `FastlyIntegrationType` object. + enum: + - Fastly + example: Fastly + type: string + x-enum-varnames: + - FASTLY + FreshserviceCredentials: + description: The definition of the `FreshserviceCredentials` object. + oneOf: + - $ref: '#/components/schemas/FreshserviceAPIKey' + FreshserviceIntegrationType: + description: The definition of the `FreshserviceIntegrationType` object. + enum: + - Freshservice + example: Freshservice + type: string + x-enum-varnames: + - FRESHSERVICE + GCPCredentials: + description: The definition of the `GCPCredentials` object. + oneOf: + - $ref: '#/components/schemas/GCPServiceAccount' + GCPIntegrationType: + description: The definition of the `GCPIntegrationType` object. + enum: + - GCP + example: GCP + type: string + x-enum-varnames: + - GCP + GeminiCredentials: + description: The definition of the `GeminiCredentials` object. + oneOf: + - $ref: '#/components/schemas/GeminiAPIKey' + GeminiIntegrationType: + description: The definition of the `GeminiIntegrationType` object. + enum: + - Gemini + example: Gemini + type: string + x-enum-varnames: + - GEMINI + GitlabCredentials: + description: The definition of the `GitlabCredentials` object. + oneOf: + - $ref: '#/components/schemas/GitlabAPIKey' + GitlabIntegrationType: + description: The definition of the `GitlabIntegrationType` object. + enum: + - Gitlab + example: Gitlab + type: string + x-enum-varnames: + - GITLAB + GreyNoiseCredentials: + description: The definition of the `GreyNoiseCredentials` object. + oneOf: + - $ref: '#/components/schemas/GreyNoiseAPIKey' + GreyNoiseIntegrationType: + description: The definition of the `GreyNoiseIntegrationType` object. + enum: + - GreyNoise + example: GreyNoise + type: string + x-enum-varnames: + - GREYNOISE + HTTPCredentials: + description: The definition of `HTTPCredentials` object. + oneOf: + - $ref: '#/components/schemas/HTTPTokenAuth' + HTTPIntegrationType: + description: The definition of `HTTPIntegrationType` object. + enum: + - HTTP + example: HTTP + type: string + x-enum-varnames: + - HTTP + LaunchDarklyCredentials: + description: The definition of the `LaunchDarklyCredentials` object. + oneOf: + - $ref: '#/components/schemas/LaunchDarklyAPIKey' + LaunchDarklyIntegrationType: + description: The definition of the `LaunchDarklyIntegrationType` object. + enum: + - LaunchDarkly + example: LaunchDarkly + type: string + x-enum-varnames: + - LAUNCHDARKLY + NotionCredentials: + description: The definition of the `NotionCredentials` object. + oneOf: + - $ref: '#/components/schemas/NotionAPIKey' + NotionIntegrationType: + description: The definition of the `NotionIntegrationType` object. + enum: + - Notion + example: Notion + type: string + x-enum-varnames: + - NOTION + OktaCredentials: + description: The definition of the `OktaCredentials` object. + oneOf: + - $ref: '#/components/schemas/OktaAPIToken' + OktaIntegrationType: + description: The definition of the `OktaIntegrationType` object. + enum: + - Okta + example: Okta + type: string + x-enum-varnames: + - OKTA + OpenAICredentials: + description: The definition of the `OpenAICredentials` object. + oneOf: + - $ref: '#/components/schemas/OpenAIAPIKey' + OpenAIIntegrationType: + description: The definition of the `OpenAIIntegrationType` object. + enum: + - OpenAI + example: OpenAI + type: string + x-enum-varnames: + - OPENAI + ServiceNowCredentials: + description: The definition of the `ServiceNowCredentials` object. + oneOf: + - $ref: '#/components/schemas/ServiceNowBasicAuth' + ServiceNowIntegrationType: + description: The definition of the `ServiceNowIntegrationType` object. + enum: + - ServiceNow + example: ServiceNow + type: string + x-enum-varnames: + - SERVICENOW + SplitCredentials: + description: The definition of the `SplitCredentials` object. + oneOf: + - $ref: '#/components/schemas/SplitAPIKey' + SplitIntegrationType: + description: The definition of the `SplitIntegrationType` object. + enum: + - Split + example: Split + type: string + x-enum-varnames: + - SPLIT + StatsigCredentials: + description: The definition of the `StatsigCredentials` object. + oneOf: + - $ref: '#/components/schemas/StatsigAPIKey' + StatsigIntegrationType: + description: The definition of the `StatsigIntegrationType` object. + enum: + - Statsig + example: Statsig + type: string + x-enum-varnames: + - STATSIG + VirusTotalCredentials: + description: The definition of the `VirusTotalCredentials` object. + oneOf: + - $ref: '#/components/schemas/VirusTotalAPIKey' + VirusTotalIntegrationType: + description: The definition of the `VirusTotalIntegrationType` object. + enum: + - VirusTotal + example: VirusTotal + type: string + x-enum-varnames: + - VIRUSTOTAL + AWSCredentialsUpdate: + description: The definition of `AWSCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/AWSAssumeRoleUpdate' + AnthropicCredentialsUpdate: + description: The definition of the `AnthropicCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/AnthropicAPIKeyUpdate' + AsanaCredentialsUpdate: + description: The definition of the `AsanaCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/AsanaAccessTokenUpdate' + AzureCredentialsUpdate: + description: The definition of the `AzureCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/AzureTenantUpdate' + CircleCICredentialsUpdate: + description: The definition of the `CircleCICredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/CircleCIAPIKeyUpdate' + ClickupCredentialsUpdate: + description: The definition of the `ClickupCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/ClickupAPIKeyUpdate' + CloudflareCredentialsUpdate: + description: The definition of the `CloudflareCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/CloudflareAPITokenUpdate' + - $ref: '#/components/schemas/CloudflareGlobalAPITokenUpdate' + ConfigCatCredentialsUpdate: + description: The definition of the `ConfigCatCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/ConfigCatSDKKeyUpdate' + DatadogCredentialsUpdate: + description: The definition of the `DatadogCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/DatadogAPIKeyUpdate' + FastlyCredentialsUpdate: + description: The definition of the `FastlyCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/FastlyAPIKeyUpdate' + FreshserviceCredentialsUpdate: + description: The definition of the `FreshserviceCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/FreshserviceAPIKeyUpdate' + GCPCredentialsUpdate: + description: The definition of the `GCPCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/GCPServiceAccountUpdate' + GeminiCredentialsUpdate: + description: The definition of the `GeminiCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/GeminiAPIKeyUpdate' + GitlabCredentialsUpdate: + description: The definition of the `GitlabCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/GitlabAPIKeyUpdate' + GreyNoiseCredentialsUpdate: + description: The definition of the `GreyNoiseCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/GreyNoiseAPIKeyUpdate' + HTTPCredentialsUpdate: + description: The definition of `HTTPCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/HTTPTokenAuthUpdate' + LaunchDarklyCredentialsUpdate: + description: The definition of the `LaunchDarklyCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/LaunchDarklyAPIKeyUpdate' + NotionCredentialsUpdate: + description: The definition of the `NotionCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/NotionAPIKeyUpdate' + OktaCredentialsUpdate: + description: The definition of the `OktaCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/OktaAPITokenUpdate' + OpenAICredentialsUpdate: + description: The definition of the `OpenAICredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/OpenAIAPIKeyUpdate' + ServiceNowCredentialsUpdate: + description: The definition of the `ServiceNowCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/ServiceNowBasicAuthUpdate' + SplitCredentialsUpdate: + description: The definition of the `SplitCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/SplitAPIKeyUpdate' + StatsigCredentialsUpdate: + description: The definition of the `StatsigCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/StatsigAPIKeyUpdate' + VirusTotalCredentialsUpdate: + description: The definition of the `VirusTotalCredentialsUpdate` object. + oneOf: + - $ref: '#/components/schemas/VirusTotalAPIKeyUpdate' + AWSAssumeRole: + description: The definition of `AWSAssumeRole` object. + properties: + account_id: + description: AWS account the connection is created for + example: '111222333444' + pattern: ^\d{12}$ + type: string + external_id: + description: >- + External ID used to scope which connection can be used to assume the + role + example: 33a1011635c44b38a064cf14e82e1d8f + readOnly: true + type: string + principal_id: + description: AWS account that will assume the role + example: '123456789012' + readOnly: true + type: string + role: + description: Role to assume + example: my-role + type: string + type: + $ref: '#/components/schemas/AWSAssumeRoleType' + required: + - type + - account_id + - role + type: object + AnthropicAPIKey: + description: The definition of the `AnthropicAPIKey` object. + properties: + api_token: + description: The `AnthropicAPIKey` `api_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/AnthropicAPIKeyType' + required: + - type + - api_token + type: object + AsanaAccessToken: + description: The definition of the `AsanaAccessToken` object. + properties: + access_token: + description: The `AsanaAccessToken` `access_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/AsanaAccessTokenType' + required: + - type + - access_token + type: object + AzureTenant: + description: The definition of the `AzureTenant` object. + properties: + app_client_id: + description: >- + The Client ID, also known as the Application ID in Azure, is a + unique identifier for an application. It's used to identify the + application during the authentication process. Your Application + (client) ID is listed in the application's overview page. You can + navigate to your application via the Azure Directory. + example: '' + type: string + client_secret: + description: >- + The Client Secret is a confidential piece of information known only + to the application and Azure AD. It's used to prove the + application's identity. Your Client Secret is available from the + application’s secrets page. You can navigate to your application via + the Azure Directory. + example: '' + type: string + custom_scopes: + description: >- + If provided, the custom scope to be requested from Microsoft when + acquiring an OAuth 2 access token. This custom scope is used only in + conjunction with the HTTP action. A resource's scope is constructed + by using the identifier URI for the resource and .default, separated + by a forward slash (/) as follows:{identifierURI}/.default. + type: string + tenant_id: + description: >- + The Tenant ID, also known as the Directory ID in Azure, is a unique + identifier that represents an Azure AD instance. Your Tenant ID + (Directory ID) is listed in your Active Directory overview page + under the 'Tenant information' section. + example: '' + type: string + type: + $ref: '#/components/schemas/AzureTenantType' + required: + - type + - tenant_id + - app_client_id + - client_secret + type: object + CircleCIAPIKey: + description: The definition of the `CircleCIAPIKey` object. + properties: + api_token: + description: The `CircleCIAPIKey` `api_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/CircleCIAPIKeyType' + required: + - type + - api_token + type: object + ClickupAPIKey: + description: The definition of the `ClickupAPIKey` object. + properties: + api_token: + description: The `ClickupAPIKey` `api_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/ClickupAPIKeyType' + required: + - type + - api_token + type: object + CloudflareAPIToken: + description: The definition of the `CloudflareAPIToken` object. + properties: + api_token: + description: The `CloudflareAPIToken` `api_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/CloudflareAPITokenType' + required: + - type + - api_token + type: object + CloudflareGlobalAPIToken: + description: The definition of the `CloudflareGlobalAPIToken` object. + properties: + auth_email: + description: The `CloudflareGlobalAPIToken` `auth_email`. + example: '' + type: string + global_api_key: + description: The `CloudflareGlobalAPIToken` `global_api_key`. + example: '' + type: string + type: + $ref: '#/components/schemas/CloudflareGlobalAPITokenType' + required: + - type + - auth_email + - global_api_key + type: object + ConfigCatSDKKey: + description: The definition of the `ConfigCatSDKKey` object. + properties: + api_password: + description: The `ConfigCatSDKKey` `api_password`. + example: '' + type: string + api_username: + description: The `ConfigCatSDKKey` `api_username`. + example: '' + type: string + sdk_key: + description: The `ConfigCatSDKKey` `sdk_key`. + example: '' + type: string + type: + $ref: '#/components/schemas/ConfigCatSDKKeyType' + required: + - type + - sdk_key + - api_username + - api_password + type: object + DatadogAPIKey: + description: The definition of the `DatadogAPIKey` object. + properties: + api_key: + description: The `DatadogAPIKey` `api_key`. + example: '' + type: string + app_key: + description: The `DatadogAPIKey` `app_key`. + example: '' + type: string + datacenter: + description: The `DatadogAPIKey` `datacenter`. + example: '' + type: string + subdomain: + description: >- + Custom subdomain used for Datadog URLs generated with this + Connection. For example, if this org uses + `https://acme.datadoghq.com` to access Datadog, set this field to + `acme`. If this field is omitted, generated URLs will use the + default site URL for its datacenter (see + [https://docs.datadoghq.com/getting_started/site](https://docs.datadoghq.com/getting_started/site)). + type: string + type: + $ref: '#/components/schemas/DatadogAPIKeyType' + required: + - type + - datacenter + - api_key + - app_key + type: object + FastlyAPIKey: + description: The definition of the `FastlyAPIKey` object. + properties: + api_key: + description: The `FastlyAPIKey` `api_key`. + example: '' + type: string + type: + $ref: '#/components/schemas/FastlyAPIKeyType' + required: + - type + - api_key + type: object + FreshserviceAPIKey: + description: The definition of the `FreshserviceAPIKey` object. + properties: + api_key: + description: The `FreshserviceAPIKey` `api_key`. + example: '' + type: string + domain: + description: The `FreshserviceAPIKey` `domain`. + example: '' + type: string + type: + $ref: '#/components/schemas/FreshserviceAPIKeyType' + required: + - type + - domain + - api_key + type: object + GCPServiceAccount: + description: The definition of the `GCPServiceAccount` object. + properties: + private_key: + description: The `GCPServiceAccount` `private_key`. + example: '' + type: string + service_account_email: + description: The `GCPServiceAccount` `service_account_email`. + example: '' + type: string + type: + $ref: '#/components/schemas/GCPServiceAccountCredentialType' + required: + - type + - service_account_email + - private_key + type: object + GeminiAPIKey: + description: The definition of the `GeminiAPIKey` object. + properties: + api_key: + description: The `GeminiAPIKey` `api_key`. + example: '' + type: string + type: + $ref: '#/components/schemas/GeminiAPIKeyType' + required: + - type + - api_key + type: object + GitlabAPIKey: + description: The definition of the `GitlabAPIKey` object. + properties: + api_token: + description: The `GitlabAPIKey` `api_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/GitlabAPIKeyType' + required: + - type + - api_token + type: object + GreyNoiseAPIKey: + description: The definition of the `GreyNoiseAPIKey` object. + properties: + api_key: + description: The `GreyNoiseAPIKey` `api_key`. + example: '' + type: string + type: + $ref: '#/components/schemas/GreyNoiseAPIKeyType' + required: + - type + - api_key + type: object + HTTPTokenAuth: + description: The definition of `HTTPTokenAuth` object. + properties: + body: + $ref: '#/components/schemas/HTTPBody' + headers: + description: The `HTTPTokenAuth` `headers`. + items: + $ref: '#/components/schemas/HTTPHeader' + type: array + tokens: + description: The `HTTPTokenAuth` `tokens`. + items: + $ref: '#/components/schemas/HTTPToken' + type: array + type: + $ref: '#/components/schemas/HTTPTokenAuthType' + url_parameters: + description: The `HTTPTokenAuth` `url_parameters`. + items: + $ref: '#/components/schemas/UrlParam' + type: array + required: + - type + type: object + LaunchDarklyAPIKey: + description: The definition of the `LaunchDarklyAPIKey` object. + properties: + api_token: + description: The `LaunchDarklyAPIKey` `api_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/LaunchDarklyAPIKeyType' + required: + - type + - api_token + type: object + NotionAPIKey: + description: The definition of the `NotionAPIKey` object. + properties: + api_token: + description: The `NotionAPIKey` `api_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/NotionAPIKeyType' + required: + - type + - api_token + type: object + OktaAPIToken: + description: The definition of the `OktaAPIToken` object. + properties: + api_token: + description: The `OktaAPIToken` `api_token`. + example: '' + type: string + domain: + description: The `OktaAPIToken` `domain`. + example: '' + type: string + type: + $ref: '#/components/schemas/OktaAPITokenType' + required: + - type + - domain + - api_token + type: object + OpenAIAPIKey: + description: The definition of the `OpenAIAPIKey` object. + properties: + api_token: + description: The `OpenAIAPIKey` `api_token`. + example: '' + type: string + type: + $ref: '#/components/schemas/OpenAIAPIKeyType' + required: + - type + - api_token + type: object + ServiceNowBasicAuth: + description: The definition of the `ServiceNowBasicAuth` object. + properties: + instance: + description: The `ServiceNowBasicAuth` `instance`. + example: '' + type: string + password: + description: The `ServiceNowBasicAuth` `password`. + example: '' + type: string + type: + $ref: '#/components/schemas/ServiceNowBasicAuthType' + username: + description: The `ServiceNowBasicAuth` `username`. + example: '' + type: string + required: + - type + - instance + - username + - password + type: object + SplitAPIKey: + description: The definition of the `SplitAPIKey` object. + properties: + api_key: + description: The `SplitAPIKey` `api_key`. + example: '' + type: string + type: + $ref: '#/components/schemas/SplitAPIKeyType' + required: + - type + - api_key + type: object + StatsigAPIKey: + description: The definition of the `StatsigAPIKey` object. + properties: + api_key: + description: The `StatsigAPIKey` `api_key`. + example: '' + type: string + type: + $ref: '#/components/schemas/StatsigAPIKeyType' + required: + - type + - api_key + type: object + VirusTotalAPIKey: + description: The definition of the `VirusTotalAPIKey` object. + properties: + api_key: + description: The `VirusTotalAPIKey` `api_key`. + example: '' + type: string + type: + $ref: '#/components/schemas/VirusTotalAPIKeyType' + required: + - type + - api_key + type: object + AWSAssumeRoleUpdate: + description: The definition of `AWSAssumeRoleUpdate` object. + properties: + account_id: + description: AWS account the connection is created for + example: '111222333444' + pattern: ^\d{12}$ + type: string + generate_new_external_id: + description: The `AWSAssumeRoleUpdate` `generate_new_external_id`. + type: boolean + role: + description: Role to assume + example: my-role + type: string + type: + $ref: '#/components/schemas/AWSAssumeRoleType' + required: + - type + type: object + AnthropicAPIKeyUpdate: + description: The definition of the `AnthropicAPIKey` object. + properties: + api_token: + description: The `AnthropicAPIKeyUpdate` `api_token`. + type: string + type: + $ref: '#/components/schemas/AnthropicAPIKeyType' + required: + - type + type: object + AsanaAccessTokenUpdate: + description: The definition of the `AsanaAccessToken` object. + properties: + access_token: + description: The `AsanaAccessTokenUpdate` `access_token`. + type: string + type: + $ref: '#/components/schemas/AsanaAccessTokenType' + required: + - type + type: object + AzureTenantUpdate: + description: The definition of the `AzureTenant` object. + properties: + app_client_id: + description: >- + The Client ID, also known as the Application ID in Azure, is a + unique identifier for an application. It's used to identify the + application during the authentication process. Your Application + (client) ID is listed in the application's overview page. You can + navigate to your application via the Azure Directory. + type: string + client_secret: + description: >- + The Client Secret is a confidential piece of information known only + to the application and Azure AD. It's used to prove the + application's identity. Your Client Secret is available from the + application’s secrets page. You can navigate to your application via + the Azure Directory. + type: string + custom_scopes: + description: >- + If provided, the custom scope to be requested from Microsoft when + acquiring an OAuth 2 access token. This custom scope is used only in + conjunction with the HTTP action. A resource's scope is constructed + by using the identifier URI for the resource and .default, separated + by a forward slash (/) as follows:{identifierURI}/.default. + type: string + tenant_id: + description: >- + The Tenant ID, also known as the Directory ID in Azure, is a unique + identifier that represents an Azure AD instance. Your Tenant ID + (Directory ID) is listed in your Active Directory overview page + under the 'Tenant information' section. + type: string + type: + $ref: '#/components/schemas/AzureTenantType' + required: + - type + type: object + CircleCIAPIKeyUpdate: + description: The definition of the `CircleCIAPIKey` object. + properties: + api_token: + description: The `CircleCIAPIKeyUpdate` `api_token`. + type: string + type: + $ref: '#/components/schemas/CircleCIAPIKeyType' + required: + - type + type: object + ClickupAPIKeyUpdate: + description: The definition of the `ClickupAPIKey` object. + properties: + api_token: + description: The `ClickupAPIKeyUpdate` `api_token`. + type: string + type: + $ref: '#/components/schemas/ClickupAPIKeyType' + required: + - type + type: object + CloudflareAPITokenUpdate: + description: The definition of the `CloudflareAPIToken` object. + properties: + api_token: + description: The `CloudflareAPITokenUpdate` `api_token`. + type: string + type: + $ref: '#/components/schemas/CloudflareAPITokenType' + required: + - type + type: object + CloudflareGlobalAPITokenUpdate: + description: The definition of the `CloudflareGlobalAPIToken` object. + properties: + auth_email: + description: The `CloudflareGlobalAPITokenUpdate` `auth_email`. + type: string + global_api_key: + description: The `CloudflareGlobalAPITokenUpdate` `global_api_key`. + type: string + type: + $ref: '#/components/schemas/CloudflareGlobalAPITokenType' + required: + - type + type: object + ConfigCatSDKKeyUpdate: + description: The definition of the `ConfigCatSDKKey` object. + properties: + api_password: + description: The `ConfigCatSDKKeyUpdate` `api_password`. + type: string + api_username: + description: The `ConfigCatSDKKeyUpdate` `api_username`. + type: string + sdk_key: + description: The `ConfigCatSDKKeyUpdate` `sdk_key`. + type: string + type: + $ref: '#/components/schemas/ConfigCatSDKKeyType' + required: + - type + type: object + DatadogAPIKeyUpdate: + description: The definition of the `DatadogAPIKey` object. + properties: + api_key: + description: The `DatadogAPIKeyUpdate` `api_key`. + type: string + app_key: + description: The `DatadogAPIKeyUpdate` `app_key`. + type: string + datacenter: + description: The `DatadogAPIKeyUpdate` `datacenter`. + type: string + subdomain: + description: >- + Custom subdomain used for Datadog URLs generated with this + Connection. For example, if this org uses + `https://acme.datadoghq.com` to access Datadog, set this field to + `acme`. If this field is omitted, generated URLs will use the + default site URL for its datacenter (see + [https://docs.datadoghq.com/getting_started/site](https://docs.datadoghq.com/getting_started/site)). + type: string + type: + $ref: '#/components/schemas/DatadogAPIKeyType' + required: + - type + type: object + FastlyAPIKeyUpdate: + description: The definition of the `FastlyAPIKey` object. + properties: + api_key: + description: The `FastlyAPIKeyUpdate` `api_key`. + type: string + type: + $ref: '#/components/schemas/FastlyAPIKeyType' + required: + - type + type: object + FreshserviceAPIKeyUpdate: + description: The definition of the `FreshserviceAPIKey` object. + properties: + api_key: + description: The `FreshserviceAPIKeyUpdate` `api_key`. + type: string + domain: + description: The `FreshserviceAPIKeyUpdate` `domain`. + type: string + type: + $ref: '#/components/schemas/FreshserviceAPIKeyType' + required: + - type + type: object + GCPServiceAccountUpdate: + description: The definition of the `GCPServiceAccount` object. + properties: + private_key: + description: The `GCPServiceAccountUpdate` `private_key`. + type: string + service_account_email: + description: The `GCPServiceAccountUpdate` `service_account_email`. + type: string + type: + $ref: '#/components/schemas/GCPServiceAccountCredentialType' + required: + - type + type: object + GeminiAPIKeyUpdate: + description: The definition of the `GeminiAPIKey` object. + properties: + api_key: + description: The `GeminiAPIKeyUpdate` `api_key`. + type: string + type: + $ref: '#/components/schemas/GeminiAPIKeyType' + required: + - type + type: object + GitlabAPIKeyUpdate: + description: The definition of the `GitlabAPIKey` object. + properties: + api_token: + description: The `GitlabAPIKeyUpdate` `api_token`. + type: string + type: + $ref: '#/components/schemas/GitlabAPIKeyType' + required: + - type + type: object + GreyNoiseAPIKeyUpdate: + description: The definition of the `GreyNoiseAPIKey` object. + properties: + api_key: + description: The `GreyNoiseAPIKeyUpdate` `api_key`. + type: string + type: + $ref: '#/components/schemas/GreyNoiseAPIKeyType' + required: + - type + type: object + HTTPTokenAuthUpdate: + description: The definition of `HTTPTokenAuthUpdate` object. + properties: + body: + $ref: '#/components/schemas/HTTPBody' + headers: + description: The `HTTPTokenAuthUpdate` `headers`. + items: + $ref: '#/components/schemas/HTTPHeaderUpdate' + type: array + tokens: + description: The `HTTPTokenAuthUpdate` `tokens`. + items: + $ref: '#/components/schemas/HTTPTokenUpdate' + type: array + type: + $ref: '#/components/schemas/HTTPTokenAuthType' + url_parameters: + description: The `HTTPTokenAuthUpdate` `url_parameters`. + items: + $ref: '#/components/schemas/UrlParamUpdate' + type: array + required: + - type + type: object + LaunchDarklyAPIKeyUpdate: + description: The definition of the `LaunchDarklyAPIKey` object. + properties: + api_token: + description: The `LaunchDarklyAPIKeyUpdate` `api_token`. + type: string + type: + $ref: '#/components/schemas/LaunchDarklyAPIKeyType' + required: + - type + type: object + NotionAPIKeyUpdate: + description: The definition of the `NotionAPIKey` object. + properties: + api_token: + description: The `NotionAPIKeyUpdate` `api_token`. + type: string + type: + $ref: '#/components/schemas/NotionAPIKeyType' + required: + - type + type: object + OktaAPITokenUpdate: + description: The definition of the `OktaAPIToken` object. + properties: + api_token: + description: The `OktaAPITokenUpdate` `api_token`. + type: string + domain: + description: The `OktaAPITokenUpdate` `domain`. + type: string + type: + $ref: '#/components/schemas/OktaAPITokenType' + required: + - type + type: object + OpenAIAPIKeyUpdate: + description: The definition of the `OpenAIAPIKey` object. + properties: + api_token: + description: The `OpenAIAPIKeyUpdate` `api_token`. + type: string + type: + $ref: '#/components/schemas/OpenAIAPIKeyType' + required: + - type + type: object + ServiceNowBasicAuthUpdate: + description: The definition of the `ServiceNowBasicAuth` object. + properties: + instance: + description: The `ServiceNowBasicAuthUpdate` `instance`. + type: string + password: + description: The `ServiceNowBasicAuthUpdate` `password`. + type: string + type: + $ref: '#/components/schemas/ServiceNowBasicAuthType' + username: + description: The `ServiceNowBasicAuthUpdate` `username`. + type: string + required: + - type + type: object + SplitAPIKeyUpdate: + description: The definition of the `SplitAPIKey` object. + properties: + api_key: + description: The `SplitAPIKeyUpdate` `api_key`. + type: string + type: + $ref: '#/components/schemas/SplitAPIKeyType' + required: + - type + type: object + StatsigAPIKeyUpdate: + description: The definition of the `StatsigAPIKey` object. + properties: + api_key: + description: The `StatsigAPIKeyUpdate` `api_key`. + type: string + type: + $ref: '#/components/schemas/StatsigAPIKeyType' + required: + - type + type: object + VirusTotalAPIKeyUpdate: + description: The definition of the `VirusTotalAPIKey` object. + properties: + api_key: + description: The `VirusTotalAPIKeyUpdate` `api_key`. + type: string + type: + $ref: '#/components/schemas/VirusTotalAPIKeyType' + required: + - type + type: object + AWSAssumeRoleType: + description: The definition of `AWSAssumeRoleType` object. + enum: + - AWSAssumeRole + example: AWSAssumeRole + type: string + x-enum-varnames: + - AWSASSUMEROLE + AnthropicAPIKeyType: + description: The definition of the `AnthropicAPIKey` object. + enum: + - AnthropicAPIKey + example: AnthropicAPIKey + type: string + x-enum-varnames: + - ANTHROPICAPIKEY + AsanaAccessTokenType: + description: The definition of the `AsanaAccessToken` object. + enum: + - AsanaAccessToken + example: AsanaAccessToken + type: string + x-enum-varnames: + - ASANAACCESSTOKEN + AzureTenantType: + description: The definition of the `AzureTenant` object. + enum: + - AzureTenant + example: AzureTenant + type: string + x-enum-varnames: + - AZURETENANT + CircleCIAPIKeyType: + description: The definition of the `CircleCIAPIKey` object. + enum: + - CircleCIAPIKey + example: CircleCIAPIKey + type: string + x-enum-varnames: + - CIRCLECIAPIKEY + ClickupAPIKeyType: + description: The definition of the `ClickupAPIKey` object. + enum: + - ClickupAPIKey + example: ClickupAPIKey + type: string + x-enum-varnames: + - CLICKUPAPIKEY + CloudflareAPITokenType: + description: The definition of the `CloudflareAPIToken` object. + enum: + - CloudflareAPIToken + example: CloudflareAPIToken + type: string + x-enum-varnames: + - CLOUDFLAREAPITOKEN + CloudflareGlobalAPITokenType: + description: The definition of the `CloudflareGlobalAPIToken` object. + enum: + - CloudflareGlobalAPIToken + example: CloudflareGlobalAPIToken + type: string + x-enum-varnames: + - CLOUDFLAREGLOBALAPITOKEN + ConfigCatSDKKeyType: + description: The definition of the `ConfigCatSDKKey` object. + enum: + - ConfigCatSDKKey + example: ConfigCatSDKKey + type: string + x-enum-varnames: + - CONFIGCATSDKKEY + DatadogAPIKeyType: + description: The definition of the `DatadogAPIKey` object. + enum: + - DatadogAPIKey + example: DatadogAPIKey + type: string + x-enum-varnames: + - DATADOGAPIKEY + FastlyAPIKeyType: + description: The definition of the `FastlyAPIKey` object. + enum: + - FastlyAPIKey + example: FastlyAPIKey + type: string + x-enum-varnames: + - FASTLYAPIKEY + FreshserviceAPIKeyType: + description: The definition of the `FreshserviceAPIKey` object. + enum: + - FreshserviceAPIKey + example: FreshserviceAPIKey + type: string + x-enum-varnames: + - FRESHSERVICEAPIKEY + GCPServiceAccountCredentialType: + description: The definition of the `GCPServiceAccount` object. + enum: + - GCPServiceAccount + example: GCPServiceAccount + type: string + x-enum-varnames: + - GCPSERVICEACCOUNT + GeminiAPIKeyType: + description: The definition of the `GeminiAPIKey` object. + enum: + - GeminiAPIKey + example: GeminiAPIKey + type: string + x-enum-varnames: + - GEMINIAPIKEY + GitlabAPIKeyType: + description: The definition of the `GitlabAPIKey` object. + enum: + - GitlabAPIKey + example: GitlabAPIKey + type: string + x-enum-varnames: + - GITLABAPIKEY + GreyNoiseAPIKeyType: + description: The definition of the `GreyNoiseAPIKey` object. + enum: + - GreyNoiseAPIKey + example: GreyNoiseAPIKey + type: string + x-enum-varnames: + - GREYNOISEAPIKEY + HTTPBody: + description: The definition of `HTTPBody` object. + properties: + content: + description: Serialized body content + example: '{"some-json": "with-value"}' + type: string + content_type: + description: Content type of the body + example: application/json + type: string + type: object + HTTPHeader: + description: The definition of `HTTPHeader` object. + properties: + name: + description: The `HTTPHeader` `name`. + example: MyHttpHeader + pattern: ^[A-Za-z][A-Za-z\\d\\-\\_]*$ + type: string + value: + description: The `HTTPHeader` `value`. + example: Some header value + type: string + required: + - name + - value + type: object + HTTPToken: + description: The definition of `HTTPToken` object. + properties: + name: + description: The `HTTPToken` `name`. + example: MyToken + pattern: ^[A-Za-z][A-Za-z\\d]*$ + type: string + type: + $ref: '#/components/schemas/TokenType' + value: + description: The `HTTPToken` `value`. + example: Some Token Value + type: string + required: + - name + - value + - type + type: object + HTTPTokenAuthType: + description: The definition of `HTTPTokenAuthType` object. + enum: + - HTTPTokenAuth + example: HTTPTokenAuth + type: string + x-enum-varnames: + - HTTPTOKENAUTH + UrlParam: + description: The definition of `UrlParam` object. + properties: + name: + $ref: '#/components/schemas/TokenName' + example: MyUrlParameter + value: + description: The `UrlParam` `value`. + example: Some Url Parameter value + type: string + required: + - name + - value + type: object + LaunchDarklyAPIKeyType: + description: The definition of the `LaunchDarklyAPIKey` object. + enum: + - LaunchDarklyAPIKey + example: LaunchDarklyAPIKey + type: string + x-enum-varnames: + - LAUNCHDARKLYAPIKEY + NotionAPIKeyType: + description: The definition of the `NotionAPIKey` object. + enum: + - NotionAPIKey + example: NotionAPIKey + type: string + x-enum-varnames: + - NOTIONAPIKEY + OktaAPITokenType: + description: The definition of the `OktaAPIToken` object. + enum: + - OktaAPIToken + example: OktaAPIToken + type: string + x-enum-varnames: + - OKTAAPITOKEN + OpenAIAPIKeyType: + description: The definition of the `OpenAIAPIKey` object. + enum: + - OpenAIAPIKey + example: OpenAIAPIKey + type: string + x-enum-varnames: + - OPENAIAPIKEY + ServiceNowBasicAuthType: + description: The definition of the `ServiceNowBasicAuth` object. + enum: + - ServiceNowBasicAuth + example: ServiceNowBasicAuth + type: string + x-enum-varnames: + - SERVICENOWBASICAUTH + SplitAPIKeyType: + description: The definition of the `SplitAPIKey` object. + enum: + - SplitAPIKey + example: SplitAPIKey + type: string + x-enum-varnames: + - SPLITAPIKEY + StatsigAPIKeyType: + description: The definition of the `StatsigAPIKey` object. + enum: + - StatsigAPIKey + example: StatsigAPIKey + type: string + x-enum-varnames: + - STATSIGAPIKEY + VirusTotalAPIKeyType: + description: The definition of the `VirusTotalAPIKey` object. + enum: + - VirusTotalAPIKey + example: VirusTotalAPIKey + type: string + x-enum-varnames: + - VIRUSTOTALAPIKEY + HTTPHeaderUpdate: + description: The definition of `HTTPHeaderUpdate` object. + properties: + deleted: + description: Should the header be deleted. + type: boolean + name: + description: The `HTTPHeaderUpdate` `name`. + example: MyHttpHeader + pattern: ^[A-Za-z][A-Za-z\\d\\-\\_]*$ + type: string + value: + description: The `HTTPHeaderUpdate` `value`. + example: Updated Header Value + type: string + required: + - name + type: object + HTTPTokenUpdate: + description: The definition of `HTTPTokenUpdate` object. + properties: + deleted: + description: Should the header be deleted. + type: boolean + name: + description: The `HTTPToken` `name`. + example: MyToken + pattern: ^[A-Za-z][A-Za-z\\d]*$ + type: string + type: + $ref: '#/components/schemas/TokenType' + value: + description: The `HTTPToken` `value`. + example: Some Token Value + type: string + required: + - name + - type + - value + type: object + UrlParamUpdate: + description: The definition of `UrlParamUpdate` object. + properties: + deleted: + description: Should the header be deleted. + type: boolean + name: + $ref: '#/components/schemas/TokenName' + example: MyUrlParameter + value: + description: The `UrlParamUpdate` `value`. + example: Some Url Parameter value + type: string + required: + - name + type: object + TokenType: + description: The definition of `TokenType` object. + enum: + - SECRET + example: SECRET + type: string + x-enum-varnames: + - SECRET + TokenName: + description: Name for tokens. + example: MyTokenName + pattern: ^[A-Za-z][A-Za-z\\d]*$ + type: string + responses: + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + parameters: + ApplicationKeyId: + description: The ID of the app key + in: path + name: app_key_id + required: true + schema: + type: string + ConnectionId: + description: The ID of the action connection + in: path + name: connection_id + required: true + schema: + type: string + x-stackQL-resources: + datastores: + id: datadog.actions.datastores + name: datastores + title: Datastores + methods: + list_datastores: + operation: + $ref: '#/paths/~1api~1v2~1actions-datastores/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_datastore: + operation: + $ref: '#/paths/~1api~1v2~1actions-datastores/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_datastore: + operation: + $ref: '#/paths/~1api~1v2~1actions-datastores~1{datastore_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '200' + get_datastore: + operation: + $ref: '#/paths/~1api~1v2~1actions-datastores~1{datastore_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_datastore: + operation: + $ref: '#/paths/~1api~1v2~1actions-datastores~1{datastore_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/datastores/methods/get_datastore' + - $ref: >- + #/components/x-stackQL-resources/datastores/methods/list_datastores + insert: + - $ref: >- + #/components/x-stackQL-resources/datastores/methods/create_datastore + update: + - $ref: >- + #/components/x-stackQL-resources/datastores/methods/update_datastore + delete: + - $ref: >- + #/components/x-stackQL-resources/datastores/methods/delete_datastore + replace: [] + datastore_items: + id: datadog.actions.datastore_items + name: datastore_items + title: Datastore Items + methods: + delete_datastore_item: + operation: + $ref: >- + #/paths/~1api~1v2~1actions-datastores~1{datastore_id}~1items/delete + response: + mediaType: application/json + openAPIDocKey: '200' + list_datastore_items: + operation: + $ref: '#/paths/~1api~1v2~1actions-datastores~1{datastore_id}~1items/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_datastore_item: + operation: + $ref: '#/paths/~1api~1v2~1actions-datastores~1{datastore_id}~1items/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + bulk_write_datastore_items: + operation: + $ref: >- + #/paths/~1api~1v2~1actions-datastores~1{datastore_id}~1items~1bulk/post + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/datastore_items/methods/list_datastore_items + insert: + - $ref: >- + #/components/x-stackQL-resources/datastore_items/methods/bulk_write_datastore_items + update: + - $ref: >- + #/components/x-stackQL-resources/datastore_items/methods/update_datastore_item + delete: + - $ref: >- + #/components/x-stackQL-resources/datastore_items/methods/delete_datastore_item + replace: [] + app_key_registrations: + id: datadog.actions.app_key_registrations + name: app_key_registrations + title: App Key Registrations + methods: + list_app_key_registrations: + operation: + $ref: '#/paths/~1api~1v2~1actions~1app_key_registrations/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + unregister_app_key: + operation: + $ref: >- + #/paths/~1api~1v2~1actions~1app_key_registrations~1{app_key_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_app_key_registration: + operation: + $ref: >- + #/paths/~1api~1v2~1actions~1app_key_registrations~1{app_key_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + register_app_key: + operation: + $ref: >- + #/paths/~1api~1v2~1actions~1app_key_registrations~1{app_key_id}/put + response: + mediaType: application/json + openAPIDocKey: '201' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/app_key_registrations/methods/get_app_key_registration + - $ref: >- + #/components/x-stackQL-resources/app_key_registrations/methods/list_app_key_registrations + insert: [] + update: [] + delete: [] + replace: [] + connections: + id: datadog.actions.connections + name: connections + title: Connections + methods: + create_action_connection: + operation: + $ref: '#/paths/~1api~1v2~1actions~1connections/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_action_connection: + operation: + $ref: '#/paths/~1api~1v2~1actions~1connections~1{connection_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_action_connection: + operation: + $ref: '#/paths/~1api~1v2~1actions~1connections~1{connection_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_action_connection: + operation: + $ref: '#/paths/~1api~1v2~1actions~1connections~1{connection_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/connections/methods/get_action_connection + insert: + - $ref: >- + #/components/x-stackQL-resources/connections/methods/create_action_connection + update: + - $ref: >- + #/components/x-stackQL-resources/connections/methods/update_action_connection + delete: + - $ref: >- + #/components/x-stackQL-resources/connections/methods/delete_action_connection + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/apm.yaml b/providers/src/datadog/v00.00.00000/services/apm.yaml new file mode 100644 index 00000000..79619782 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/apm.yaml @@ -0,0 +1,2054 @@ +openapi: 3.0.0 +info: + title: apm API + description: datadog apm API + version: '1.0' +paths: + /api/v2/apm/config/metrics: + get: + description: Get the list of configured span-based metrics with their definitions. + operationId: ListSpansMetrics + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SpansMetricsResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all span-based metrics + tags: + - Spans Metrics + x-permission: + operator: OR + permissions: + - apm_read + post: + description: >- + Create a metric based on your ingested spans in your organization. + + Returns the span-based metric object from the request body when the + request is successful. + operationId: CreateSpansMetric + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SpansMetricCreateRequest' + description: The definition of the new span-based metric. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SpansMetricResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a span-based metric + tags: + - Spans Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - apm_generate_metrics + /api/v2/apm/config/metrics/{metric_id}: + delete: + description: Delete a specific span-based metric from your organization. + operationId: DeleteSpansMetric + parameters: + - $ref: '#/components/parameters/SpansMetricIDParameter' + responses: + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a span-based metric + tags: + - Spans Metrics + x-permission: + operator: OR + permissions: + - apm_generate_metrics + get: + description: Get a specific span-based metric from your organization. + operationId: GetSpansMetric + parameters: + - $ref: '#/components/parameters/SpansMetricIDParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SpansMetricResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a span-based metric + tags: + - Spans Metrics + x-permission: + operator: OR + permissions: + - apm_read + patch: + description: >- + Update a specific span-based metric from your organization. + + Returns the span-based metric object from the request body when the + request is successful. + operationId: UpdateSpansMetric + parameters: + - $ref: '#/components/parameters/SpansMetricIDParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SpansMetricUpdateRequest' + description: New definition of the span-based metric. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SpansMetricResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a span-based metric + tags: + - Spans Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - apm_generate_metrics + /api/v2/apm/config/retention-filters: + get: + description: Get the list of APM retention filters. + operationId: ListApmRetentionFilters + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RetentionFiltersResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List all APM retention filters + tags: + - APM Retention Filters + x-permission: + operator: OR + permissions: + - apm_retention_filter_read + - apm_pipelines_read + post: + description: >- + Create a retention filter to index spans in your organization. + + Returns the retention filter definition when the request is successful. + + + Default filters with types spans-errors-sampling-processor and + spans-appsec-sampling-processor cannot be created. + operationId: CreateApmRetentionFilter + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RetentionFilterCreateRequest' + description: The definition of the new retention filter. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RetentionFilterCreateResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a retention filter + tags: + - APM Retention Filters + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - apm_retention_filter_write + - apm_pipelines_write + /api/v2/apm/config/retention-filters-execution-order: + put: + description: Re-order the execution order of retention filters. + operationId: ReorderApmRetentionFilters + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ReorderRetentionFiltersRequest' + description: The list of retention filters in the new order. + required: true + responses: + '200': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Re-order retention filters + tags: + - APM Retention Filters + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - apm_retention_filter_write + - apm_pipelines_write + /api/v2/apm/config/retention-filters/{filter_id}: + delete: + description: >- + Delete a specific retention filter from your organization. + + + Default filters with types spans-errors-sampling-processor and + spans-appsec-sampling-processor cannot be deleted. + operationId: DeleteApmRetentionFilter + parameters: + - $ref: '#/components/parameters/RetentionFilterIdParam' + responses: + '200': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a retention filter + tags: + - APM Retention Filters + x-permission: + operator: OR + permissions: + - apm_retention_filter_write + - apm_pipelines_write + get: + description: Get an APM retention filter. + operationId: GetApmRetentionFilter + parameters: + - $ref: '#/components/parameters/RetentionFilterIdParam' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RetentionFilterResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a given APM retention filter + tags: + - APM Retention Filters + x-permission: + operator: OR + permissions: + - apm_retention_filter_read + - apm_pipelines_read + put: + description: >- + Update a retention filter from your organization. + + + Default filters (filters with types spans-errors-sampling-processor and + spans-appsec-sampling-processor) cannot be renamed or removed. + operationId: UpdateApmRetentionFilter + parameters: + - $ref: '#/components/parameters/RetentionFilterIdParam' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RetentionFilterUpdateRequest' + description: The updated definition of the retention filter. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RetentionFilterResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a retention filter + tags: + - APM Retention Filters + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - apm_retention_filter_write + - apm_pipelines_write + /api/v2/scorecard/outcomes: + get: + description: Fetches all rule outcomes. + operationId: ListScorecardOutcomes + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageOffset' + - description: Include related rule details in the response. + in: query + name: include + required: false + schema: + example: rule + type: string + - description: Return only specified values in the outcome attributes. + in: query + name: fields[outcome] + required: false + schema: + example: state, service_name + type: string + - description: Return only specified values in the included rule details. + in: query + name: fields[rule] + required: false + schema: + example: name + type: string + - description: Filter the outcomes on a specific service name. + in: query + name: filter[outcome][service_name] + required: false + schema: + example: web-store + type: string + - description: Filter the outcomes by a specific state. + in: query + name: filter[outcome][state] + required: false + schema: + example: fail + type: string + - description: Filter outcomes on whether a rule is enabled/disabled. + in: query + name: filter[rule][enabled] + required: false + schema: + example: true + type: boolean + - description: Filter outcomes based on rule ID. + in: query + name: filter[rule][id] + required: false + schema: + example: f4485c79-0762-449c-96cf-c31e54a659f6 + type: string + - description: Filter outcomes based on rule name. + in: query + name: filter[rule][name] + required: false + schema: + example: SLOs Defined + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OutcomesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_read + summary: List all rule outcomes + tags: + - Service Scorecards + x-pagination: + limitParam: page[size] + pageOffsetParam: page[offset] + resultsPath: data + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + post: + description: Updates multiple scorecard rule outcomes in a single batched request. + operationId: UpdateScorecardOutcomesAsync + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateOutcomesAsyncRequest' + description: Set of scorecard outcomes. + required: true + responses: + '202': + description: Accepted + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Update Scorecard outcomes asynchronously + tags: + - Service Scorecards + x-codegen-request-body-name: body + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/scorecard/outcomes/batch: + post: + description: Sets multiple service-rule outcomes in a single batched request. + operationId: CreateScorecardOutcomesBatch + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OutcomesBatchRequest' + description: Set of scorecard outcomes. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OutcomesBatchResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Create outcomes batch + tags: + - Service Scorecards + x-codegen-request-body-name: body + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/scorecard/rules: + get: + description: Fetch all rules. + operationId: ListScorecardRules + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageOffset' + - description: Include related scorecard details in the response. + in: query + name: include + required: false + schema: + example: scorecard + type: string + - description: Filter the rules on a rule ID. + in: query + name: filter[rule][id] + required: false + schema: + example: 37d2f990-c885-4972-949b-8b798213a166 + type: string + - description: Filter for enabled rules only. + in: query + name: filter[rule][enabled] + required: false + schema: + example: true + type: boolean + - description: Filter for custom rules only. + in: query + name: filter[rule][custom] + required: false + schema: + example: true + type: boolean + - description: Filter rules on the rule name. + in: query + name: filter[rule][name] + required: false + schema: + example: Code Repos Defined + type: string + - description: Filter rules on the rule description. + in: query + name: filter[rule][description] + required: false + schema: + example: Identifying + type: string + - description: Return only specific fields in the response for rule attributes. + in: query + name: fields[rule] + required: false + schema: + example: name, description + type: string + - description: >- + Return only specific fields in the included response for scorecard + attributes. + in: query + name: fields[scorecard] + required: false + schema: + example: name + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListRulesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_read + summary: List all rules + tags: + - Service Scorecards + x-pagination: + limitParam: page[size] + pageOffsetParam: page[offset] + resultsPath: data + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + post: + description: Creates a new rule. + operationId: CreateScorecardRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateRuleRequest' + description: Rule attributes. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/CreateRuleResponse' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Create a new rule + tags: + - Service Scorecards + x-codegen-request-body-name: body + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/scorecard/rules/{rule_id}: + delete: + description: Deletes a single rule. + operationId: DeleteScorecardRule + parameters: + - $ref: '#/components/parameters/RuleId' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Delete a rule + tags: + - Service Scorecards + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + put: + description: Updates an existing rule. + operationId: UpdateScorecardRule + parameters: + - $ref: '#/components/parameters/RuleId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateRuleRequest' + description: Rule attributes. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateRuleResponse' + description: Rule updated successfully + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Update an existing rule + tags: + - Service Scorecards + x-codegen-request-body-name: body + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). +components: + schemas: + SpansMetricsResponse: + description: All the available span-based metric objects. + properties: + data: + description: A list of span-based metric objects. + items: + $ref: '#/components/schemas/SpansMetricResponseData' + type: array + type: object + SpansMetricCreateRequest: + description: The new span-based metric body. + properties: + data: + $ref: '#/components/schemas/SpansMetricCreateData' + required: + - data + type: object + SpansMetricResponse: + description: The span-based metric object. + properties: + data: + $ref: '#/components/schemas/SpansMetricResponseData' + type: object + SpansMetricUpdateRequest: + description: The new span-based metric body. + properties: + data: + $ref: '#/components/schemas/SpansMetricUpdateData' + required: + - data + type: object + RetentionFiltersResponse: + description: An ordered list of retention filters. + properties: + data: + description: A list of retention filters objects. + items: + $ref: '#/components/schemas/RetentionFilterAll' + type: array + required: + - data + type: object + RetentionFilterCreateRequest: + description: The body of the retention filter to be created. + properties: + data: + $ref: '#/components/schemas/RetentionFilterCreateData' + required: + - data + type: object + RetentionFilterCreateResponse: + description: The retention filters definition. + properties: + data: + $ref: '#/components/schemas/RetentionFilter' + type: object + ReorderRetentionFiltersRequest: + description: A list of retention filters to reorder. + properties: + data: + description: A list of retention filters objects. + items: + $ref: '#/components/schemas/RetentionFilterWithoutAttributes' + type: array + required: + - data + type: object + RetentionFilterResponse: + description: The retention filters definition. + properties: + data: + $ref: '#/components/schemas/RetentionFilterAll' + type: object + RetentionFilterUpdateRequest: + description: The body of the retention filter to be updated. + properties: + data: + $ref: '#/components/schemas/RetentionFilterUpdateData' + required: + - data + type: object + OutcomesResponse: + description: Scorecard outcomes - the result of a rule for a service. + properties: + data: + $ref: '#/components/schemas/OutcomesResponseData' + included: + $ref: '#/components/schemas/OutcomesResponseIncluded' + links: + $ref: '#/components/schemas/OutcomesResponseLinks' + type: object + UpdateOutcomesAsyncRequest: + description: Scorecard outcomes batch request. + properties: + data: + $ref: '#/components/schemas/UpdateOutcomesAsyncRequestData' + type: object + OutcomesBatchRequest: + description: Scorecard outcomes batch request. + properties: + data: + $ref: '#/components/schemas/OutcomesBatchRequestData' + type: object + OutcomesBatchResponse: + description: Scorecard outcomes batch response. + properties: + data: + $ref: '#/components/schemas/OutcomesBatchResponseData' + meta: + $ref: '#/components/schemas/OutcomesBatchResponseMeta' + required: + - data + - meta + type: object + ListRulesResponse: + description: Scorecard rules response. + properties: + data: + $ref: '#/components/schemas/ListRulesResponseData' + links: + $ref: '#/components/schemas/ListRulesResponseLinks' + type: object + CreateRuleRequest: + description: Scorecard create rule request. + properties: + data: + $ref: '#/components/schemas/CreateRuleRequestData' + type: object + CreateRuleResponse: + description: Created rule in response. + properties: + data: + $ref: '#/components/schemas/CreateRuleResponseData' + type: object + UpdateRuleRequest: + description: Request to update a scorecard rule. + properties: + data: + $ref: '#/components/schemas/UpdateRuleRequestData' + type: object + UpdateRuleResponse: + description: The response from a rule update request. + properties: + data: + $ref: '#/components/schemas/UpdateRuleResponseData' + type: object + SpansMetricResponseData: + description: The span-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/SpansMetricResponseAttributes' + id: + $ref: '#/components/schemas/SpansMetricID' + type: + $ref: '#/components/schemas/SpansMetricType' + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + SpansMetricCreateData: + description: The new span-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/SpansMetricCreateAttributes' + id: + $ref: '#/components/schemas/SpansMetricID' + type: + $ref: '#/components/schemas/SpansMetricType' + required: + - id + - type + - attributes + type: object + SpansMetricUpdateData: + description: The new span-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/SpansMetricUpdateAttributes' + type: + $ref: '#/components/schemas/SpansMetricType' + required: + - type + - attributes + type: object + RetentionFilterAll: + description: The definition of the retention filter. + properties: + attributes: + $ref: '#/components/schemas/RetentionFilterAllAttributes' + id: + description: The ID of the retention filter. + example: 7RBOb7dLSYWI01yc3pIH8w + type: string + type: + $ref: '#/components/schemas/ApmRetentionFilterType' + required: + - id + - type + - attributes + type: object + RetentionFilterCreateData: + description: The body of the retention filter to be created. + properties: + attributes: + $ref: '#/components/schemas/RetentionFilterCreateAttributes' + type: + $ref: '#/components/schemas/ApmRetentionFilterType' + required: + - attributes + - type + type: object + RetentionFilter: + description: The definition of the retention filter. + properties: + attributes: + $ref: '#/components/schemas/RetentionFilterAttributes' + id: + description: The ID of the retention filter. + example: 7RBOb7dLSYWI01yc3pIH8w + type: string + type: + $ref: '#/components/schemas/ApmRetentionFilterType' + required: + - id + - type + - attributes + type: object + RetentionFilterWithoutAttributes: + description: The retention filter object . + properties: + id: + description: The ID of the retention filter. + example: 7RBOb7dLSYWI01yc3pIH8w + type: string + type: + $ref: '#/components/schemas/ApmRetentionFilterType' + required: + - id + - type + type: object + RetentionFilterUpdateData: + description: The body of the retention filter to be updated. + properties: + attributes: + $ref: '#/components/schemas/RetentionFilterUpdateAttributes' + id: + description: The ID of the retention filter. + example: retention-filter-id + type: string + type: + $ref: '#/components/schemas/ApmRetentionFilterType' + required: + - id + - attributes + - type + type: object + OutcomesResponseData: + description: List of rule outcomes. + items: + $ref: '#/components/schemas/OutcomesResponseDataItem' + type: array + OutcomesResponseIncluded: + description: Array of rule details. + items: + $ref: '#/components/schemas/OutcomesResponseIncludedItem' + type: array + OutcomesResponseLinks: + description: Links attributes. + properties: + next: + description: Link for the next set of results. + example: >- + /api/v2/scorecard/outcomes?include=rule&page%5Blimit%5D=100&page%5Boffset%5D=100 + type: string + type: object + UpdateOutcomesAsyncRequestData: + description: Scorecard outcomes batch request data. + properties: + attributes: + $ref: '#/components/schemas/UpdateOutcomesAsyncAttributes' + type: + $ref: '#/components/schemas/UpdateOutcomesAsyncType' + type: object + OutcomesBatchRequestData: + description: Scorecard outcomes batch request data. + properties: + attributes: + $ref: '#/components/schemas/OutcomesBatchAttributes' + type: + $ref: '#/components/schemas/OutcomesBatchType' + type: object + OutcomesBatchResponseData: + description: List of rule outcomes which were affected during the bulk operation. + items: + $ref: '#/components/schemas/OutcomesResponseDataItem' + type: array + OutcomesBatchResponseMeta: + description: Metadata pertaining to the bulk operation. + properties: + total_received: + description: >- + Total number of scorecard results received during the bulk + operation. + format: int64 + type: integer + total_updated: + description: >- + Total number of scorecard results modified during the bulk + operation. + format: int64 + type: integer + type: object + ListRulesResponseData: + description: Array of rule details. + items: + $ref: '#/components/schemas/ListRulesResponseDataItem' + type: array + ListRulesResponseLinks: + description: Links attributes. + properties: + next: + description: Link for the next set of rules. + example: >- + /api/v2/scorecard/rules?page%5Blimit%5D=2&page%5Boffset%5D=2&page%5Bsize%5D=2 + type: string + type: object + CreateRuleRequestData: + description: Scorecard create rule request data. + properties: + attributes: + $ref: '#/components/schemas/RuleAttributes' + type: + $ref: '#/components/schemas/RuleType' + type: object + CreateRuleResponseData: + description: Create rule response data. + properties: + attributes: + $ref: '#/components/schemas/RuleAttributes' + id: + $ref: '#/components/schemas/RuleId' + relationships: + $ref: '#/components/schemas/RelationshipToRule' + type: + $ref: '#/components/schemas/RuleType' + type: object + UpdateRuleRequestData: + description: Data for the request to update a scorecard rule. + properties: + attributes: + $ref: '#/components/schemas/RuleAttributes' + type: + $ref: '#/components/schemas/RuleType' + type: object + UpdateRuleResponseData: + description: The data for a rule update response. + properties: + attributes: + $ref: '#/components/schemas/RuleAttributes' + id: + $ref: '#/components/schemas/RuleId' + relationships: + $ref: '#/components/schemas/RelationshipToRule' + type: + $ref: '#/components/schemas/RuleType' + type: object + SpansMetricResponseAttributes: + description: The object describing a Datadog span-based metric. + properties: + compute: + $ref: '#/components/schemas/SpansMetricResponseCompute' + filter: + $ref: '#/components/schemas/SpansMetricResponseFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/SpansMetricResponseGroupBy' + type: array + type: object + SpansMetricID: + description: The name of the span-based metric. + example: my.metric + type: string + SpansMetricType: + default: spans_metrics + description: The type of resource. The value should always be spans_metrics. + enum: + - spans_metrics + example: spans_metrics + type: string + x-enum-varnames: + - SPANS_METRICS + SpansMetricCreateAttributes: + description: The object describing the Datadog span-based metric to create. + properties: + compute: + $ref: '#/components/schemas/SpansMetricCompute' + filter: + $ref: '#/components/schemas/SpansMetricFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/SpansMetricGroupBy' + type: array + required: + - compute + type: object + SpansMetricUpdateAttributes: + description: The span-based metric properties that will be updated. + properties: + compute: + $ref: '#/components/schemas/SpansMetricUpdateCompute' + filter: + $ref: '#/components/schemas/SpansMetricFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/SpansMetricGroupBy' + type: array + type: object + RetentionFilterAllAttributes: + description: The attributes of the retention filter. + properties: + created_at: + description: The creation timestamp of the retention filter. + format: int64 + type: integer + created_by: + description: The creator of the retention filter. + type: string + editable: + description: Shows whether the filter can be edited. + example: true + type: boolean + enabled: + description: The status of the retention filter (Enabled/Disabled). + example: true + type: boolean + execution_order: + description: The execution order of the retention filter. + format: int64 + type: integer + filter: + $ref: '#/components/schemas/SpansFilter' + filter_type: + $ref: '#/components/schemas/RetentionFilterAllType' + modified_at: + description: The modification timestamp of the retention filter. + format: int64 + type: integer + modified_by: + description: The modifier of the retention filter. + type: string + name: + description: The name of the retention filter. + example: my retention filter + type: string + rate: + description: |- + Sample rate to apply to spans going through this retention filter. + A value of 1.0 keeps all spans matching the query. + example: 1 + format: double + type: number + trace_rate: + description: >- + Sample rate to apply to traces containing spans going through this + retention filter. + + A value of 1.0 keeps all traces with spans matching the query. + example: 1 + format: double + type: number + type: object + ApmRetentionFilterType: + default: apm_retention_filter + description: The type of the resource. + enum: + - apm_retention_filter + example: apm_retention_filter + type: string + x-enum-varnames: + - apm_retention_filter + RetentionFilterCreateAttributes: + description: >- + The object describing the configuration of the retention filter to + create/update. + properties: + enabled: + description: Enable/Disable the retention filter. + example: true + type: boolean + filter: + $ref: '#/components/schemas/SpansFilterCreate' + filter_type: + $ref: '#/components/schemas/RetentionFilterType' + name: + description: The name of the retention filter. + example: my retention filter + type: string + rate: + description: |- + Sample rate to apply to spans going through this retention filter. + A value of 1.0 keeps all spans matching the query. + example: 1 + format: double + type: number + trace_rate: + description: >- + Sample rate to apply to traces containing spans going through this + retention filter. + + A value of 1.0 keeps all traces with spans matching the query. + example: 1 + format: double + type: number + required: + - name + - filter + - enabled + - filter_type + - rate + type: object + RetentionFilterAttributes: + description: The attributes of the retention filter. + properties: + created_at: + description: The creation timestamp of the retention filter. + format: int64 + type: integer + created_by: + description: The creator of the retention filter. + type: string + editable: + description: Shows whether the filter can be edited. + example: true + type: boolean + enabled: + description: The status of the retention filter (Enabled/Disabled). + example: true + type: boolean + execution_order: + description: The execution order of the retention filter. + format: int64 + type: integer + filter: + $ref: '#/components/schemas/SpansFilter' + filter_type: + $ref: '#/components/schemas/RetentionFilterType' + modified_at: + description: The modification timestamp of the retention filter. + format: int64 + type: integer + modified_by: + description: The modifier of the retention filter. + type: string + name: + description: The name of the retention filter. + example: my retention filter + type: string + rate: + description: |- + Sample rate to apply to spans going through this retention filter. + A value of 1.0 keeps all spans matching the query. + example: 1 + format: double + type: number + trace_rate: + description: >- + Sample rate to apply to traces containing spans going through this + retention filter. + + A value of 1.0 keeps all traces with spans matching the query. + example: 1 + format: double + type: number + type: object + RetentionFilterUpdateAttributes: + description: >- + The object describing the configuration of the retention filter to + create/update. + properties: + enabled: + description: Enable/Disable the retention filter. + example: true + type: boolean + filter: + $ref: '#/components/schemas/SpansFilterCreate' + filter_type: + $ref: '#/components/schemas/RetentionFilterAllType' + name: + description: The name of the retention filter. + example: my retention filter + type: string + rate: + description: |- + Sample rate to apply to spans going through this retention filter. + A value of 1.0 keeps all spans matching the query. + example: 1 + format: double + type: number + trace_rate: + description: >- + Sample rate to apply to traces containing spans going through this + retention filter. + + A value of 1.0 keeps all traces with spans matching the query. + example: 1 + format: double + type: number + required: + - name + - filter + - enabled + - filter_type + - rate + type: object + OutcomesResponseDataItem: + description: A single rule outcome. + properties: + attributes: + $ref: '#/components/schemas/OutcomesBatchResponseAttributes' + id: + description: The unique ID for a rule outcome. + type: string + relationships: + $ref: '#/components/schemas/RuleOutcomeRelationships' + type: + $ref: '#/components/schemas/OutcomeType' + type: object + OutcomesResponseIncludedItem: + description: Attributes of the included rule. + properties: + attributes: + $ref: '#/components/schemas/OutcomesResponseIncludedRuleAttributes' + id: + $ref: '#/components/schemas/RuleId' + type: + $ref: '#/components/schemas/RuleType' + type: object + UpdateOutcomesAsyncAttributes: + description: The JSON:API attributes for a batched set of scorecard outcomes. + properties: + results: + description: Set of scorecard outcomes to update asynchronously. + items: + $ref: '#/components/schemas/UpdateOutcomesAsyncRequestItem' + type: array + type: object + UpdateOutcomesAsyncType: + default: batched-outcome + description: The JSON:API type for scorecard outcomes. + enum: + - batched-outcome + example: batched-outcome + type: string + x-enum-varnames: + - BATCHED_OUTCOME + OutcomesBatchAttributes: + description: The JSON:API attributes for a batched set of scorecard outcomes. + properties: + results: + description: Set of scorecard outcomes to update. + items: + $ref: '#/components/schemas/OutcomesBatchRequestItem' + type: array + type: object + OutcomesBatchType: + default: batched-outcome + description: The JSON:API type for scorecard outcomes. + enum: + - batched-outcome + example: batched-outcome + type: string + x-enum-varnames: + - BATCHED_OUTCOME + ListRulesResponseDataItem: + description: Rule details. + properties: + attributes: + $ref: '#/components/schemas/RuleAttributes' + id: + $ref: '#/components/schemas/RuleId' + relationships: + $ref: '#/components/schemas/RelationshipToRule' + type: + $ref: '#/components/schemas/RuleType' + type: object + RuleAttributes: + description: Details of a rule. + properties: + category: + deprecated: true + description: The scorecard name to which this rule must belong. + type: string + created_at: + description: Creation time of the rule outcome. + format: date-time + type: string + custom: + description: Defines if the rule is a custom rule. + type: boolean + description: + description: Explanation of the rule. + type: string + enabled: + description: If enabled, the rule is calculated as part of the score. + example: true + type: boolean + level: + $ref: '#/components/schemas/RuleLevel' + modified_at: + description: Time of the last rule outcome modification. + format: date-time + type: string + name: + description: Name of the rule. + example: Team Defined + type: string + owner: + description: Owner of the rule. + type: string + scorecard_name: + description: The scorecard name to which this rule must belong. + example: Deployments automated via Deployment Trains + type: string + type: object + RuleType: + default: rule + description: The JSON:API type for scorecard rules. + enum: + - rule + example: rule + type: string + x-enum-varnames: + - RULE + RuleId: + description: The unique ID for a scorecard rule. + example: q8MQxk8TCqrHnWkx + type: string + RelationshipToRule: + description: Scorecard create rule response relationship. + properties: + scorecard: + $ref: '#/components/schemas/RelationshipToRuleData' + type: object + SpansMetricResponseCompute: + description: The compute rule to compute the span-based metric. + properties: + aggregation_type: + $ref: '#/components/schemas/SpansMetricComputeAggregationType' + include_percentiles: + $ref: '#/components/schemas/SpansMetricComputeIncludePercentiles' + path: + description: >- + The path to the value the span-based metric will aggregate on (only + used if the aggregation type is a "distribution"). + example: '@duration' + type: string + type: object + SpansMetricResponseFilter: + description: >- + The span-based metric filter. Spans matching this filter will be + aggregated in this metric. + properties: + query: + description: The search query - following the span search syntax. + example: '@http.status_code:200 service:my-service' + type: string + type: object + SpansMetricResponseGroupBy: + description: A group by rule. + properties: + path: + description: The path to the value the span-based metric will be aggregated over. + example: resource_name + type: string + tag_name: + description: >- + Eventual name of the tag that gets created. By default, the path + attribute is used as the tag name. + example: resource_name + type: string + type: object + SpansMetricCompute: + description: The compute rule to compute the span-based metric. + properties: + aggregation_type: + $ref: '#/components/schemas/SpansMetricComputeAggregationType' + include_percentiles: + $ref: '#/components/schemas/SpansMetricComputeIncludePercentiles' + path: + description: >- + The path to the value the span-based metric will aggregate on (only + used if the aggregation type is a "distribution"). + example: '@duration' + type: string + required: + - aggregation_type + type: object + SpansMetricFilter: + description: >- + The span-based metric filter. Spans matching this filter will be + aggregated in this metric. + properties: + query: + default: '*' + description: The search query - following the span search syntax. + example: '@http.status_code:200 service:my-service' + type: string + type: object + SpansMetricGroupBy: + description: A group by rule. + properties: + path: + description: The path to the value the span-based metric will be aggregated over. + example: resource_name + type: string + tag_name: + description: >- + Eventual name of the tag that gets created. By default, the path + attribute is used as the tag name. + example: resource_name + type: string + required: + - path + type: object + SpansMetricUpdateCompute: + description: The compute rule to compute the span-based metric. + properties: + include_percentiles: + $ref: '#/components/schemas/SpansMetricComputeIncludePercentiles' + type: object + SpansFilter: + description: The spans filter used to index spans. + properties: + query: + description: >- + The search query - following the [span search + syntax](https://docs.datadoghq.com/tracing/trace_explorer/query_syntax/). + example: '@http.status_code:200 service:my-service' + type: string + type: object + RetentionFilterAllType: + default: spans-sampling-processor + description: The type of retention filter. + enum: + - spans-sampling-processor + - spans-errors-sampling-processor + - spans-appsec-sampling-processor + example: spans-sampling-processor + type: string + x-enum-varnames: + - SPANS_SAMPLING_PROCESSOR + - SPANS_ERRORS_SAMPLING_PROCESSOR + - SPANS_APPSEC_SAMPLING_PROCESSOR + SpansFilterCreate: + description: The spans filter. Spans matching this filter will be indexed and stored. + properties: + query: + description: >- + The search query - following the [span search + syntax](https://docs.datadoghq.com/tracing/trace_explorer/query_syntax/). + example: '@http.status_code:200 service:my-service' + type: string + required: + - query + type: object + RetentionFilterType: + default: spans-sampling-processor + description: >- + The type of retention filter. The value should always be + spans-sampling-processor. + enum: + - spans-sampling-processor + example: spans-sampling-processor + type: string + x-enum-varnames: + - SPANS_SAMPLING_PROCESSOR + OutcomesBatchResponseAttributes: + description: The JSON:API attributes for an outcome. + properties: + created_at: + description: Creation time of the rule outcome. + format: date-time + type: string + modified_at: + description: Time of last rule outcome modification. + format: date-time + type: string + remarks: + description: >- + Any remarks regarding the scorecard rule's evaluation, and supports + HTML hyperlinks. + example: 'See: Services' + type: string + service_name: + description: The unique name for a service in the catalog. + example: my-service + type: string + state: + $ref: '#/components/schemas/State' + type: object + RuleOutcomeRelationships: + description: The JSON:API relationship to a scorecard rule. + properties: + rule: + $ref: '#/components/schemas/RelationshipToOutcome' + type: object + OutcomeType: + default: outcome + description: The JSON:API type for an outcome. + enum: + - outcome + example: outcome + type: string + x-enum-varnames: + - OUTCOME + OutcomesResponseIncludedRuleAttributes: + description: Details of a rule. + properties: + name: + description: Name of the rule. + example: Team Defined + type: string + scorecard_name: + description: The scorecard name to which this rule must belong. + example: Observability Best Practices + type: string + type: object + UpdateOutcomesAsyncRequestItem: + description: Scorecard outcome for a single entity and rule. + properties: + entity_reference: + $ref: '#/components/schemas/EntityReference' + remarks: + description: >- + Any remarks regarding the scorecard rule's evaluation. Supports HTML + hyperlinks. + example: 'See: Services' + type: string + rule_id: + $ref: '#/components/schemas/RuleId' + state: + $ref: '#/components/schemas/State' + required: + - rule_id + - entity_reference + - state + type: object + OutcomesBatchRequestItem: + description: >- + Scorecard outcome for a specific rule, for a given service within a + batched update. + properties: + remarks: + description: >- + Any remarks regarding the scorecard rule's evaluation, and supports + HTML hyperlinks. + example: 'See: Services' + type: string + rule_id: + $ref: '#/components/schemas/RuleId' + service_name: + description: The unique name for a service in the catalog. + example: my-service + type: string + state: + $ref: '#/components/schemas/State' + required: + - rule_id + - service_name + - state + type: object + RuleLevel: + description: The maturity level of the rule (1, 2, or 3). + example: 2 + format: int32 + maximum: 3 + minimum: 1 + type: integer + RelationshipToRuleData: + description: Relationship data for a rule. + properties: + data: + $ref: '#/components/schemas/RelationshipToRuleDataObject' + type: object + SpansMetricComputeAggregationType: + description: The type of aggregation to use. + enum: + - count + - distribution + example: distribution + type: string + x-enum-varnames: + - COUNT + - DISTRIBUTION + SpansMetricComputeIncludePercentiles: + description: >- + Toggle to include or exclude percentile aggregations for distribution + metrics. + + Only present when the `aggregation_type` is `distribution`. + example: false + type: boolean + State: + description: The state of the rule evaluation. + enum: + - pass + - fail + - skip + example: pass + type: string + x-enum-varnames: + - PASS + - FAIL + - SKIP + RelationshipToOutcome: + description: The JSON:API relationship to a scorecard outcome. + properties: + data: + $ref: '#/components/schemas/RelationshipToOutcomeData' + type: object + EntityReference: + description: The unique reference for an IDP entity. + example: service:my-service + type: string + RelationshipToRuleDataObject: + description: Rule relationship data. + properties: + id: + description: The unique ID for a scorecard. + example: q8MQxk8TCqrHnWkp + type: string + type: + $ref: '#/components/schemas/ScorecardType' + type: object + RelationshipToOutcomeData: + description: >- + The JSON:API relationship to an outcome, which returns the related rule + id. + properties: + id: + $ref: '#/components/schemas/RuleId' + type: + $ref: '#/components/schemas/RuleType' + type: object + ScorecardType: + default: scorecard + description: The JSON:API type for scorecard. + enum: + - scorecard + example: scorecard + type: string + x-enum-varnames: + - SCORECARD + responses: + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + ConflictResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + parameters: + SpansMetricIDParameter: + description: The name of the span-based metric. + in: path + name: metric_id + required: true + schema: + type: string + RetentionFilterIdParam: + description: The ID of the retention filter. + in: path + name: filter_id + required: true + schema: + type: string + PageSize: + description: Size for a given page. The maximum allowed value is 100. + in: query + name: page[size] + required: false + schema: + default: 10 + example: 10 + format: int64 + type: integer + PageOffset: + description: Specific offset to use as the beginning of the returned page. + in: query + name: page[offset] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + RuleId: + description: The ID of the rule. + in: path + name: rule_id + required: true + schema: + type: string + x-stackQL-resources: + spans_metrics: + id: datadog.apm.spans_metrics + name: spans_metrics + title: Spans Metrics + methods: + list_spans_metrics: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1metrics/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_spans_metric: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1metrics/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_spans_metric: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1metrics~1{metric_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_spans_metric: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1metrics~1{metric_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_spans_metric: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1metrics~1{metric_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/spans_metrics/methods/get_spans_metric + - $ref: >- + #/components/x-stackQL-resources/spans_metrics/methods/list_spans_metrics + insert: + - $ref: >- + #/components/x-stackQL-resources/spans_metrics/methods/create_spans_metric + update: + - $ref: >- + #/components/x-stackQL-resources/spans_metrics/methods/update_spans_metric + delete: + - $ref: >- + #/components/x-stackQL-resources/spans_metrics/methods/delete_spans_metric + replace: [] + retention_filters: + id: datadog.apm.retention_filters + name: retention_filters + title: Retention Filters + methods: + list_apm_retention_filters: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_apm_retention_filter: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters/post' + response: + mediaType: application/json + openAPIDocKey: '200' + reorder_apm_retention_filters: + operation: + $ref: >- + #/paths/~1api~1v2~1apm~1config~1retention-filters-execution-order/put + response: + mediaType: application/json + openAPIDocKey: '200' + delete_apm_retention_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1apm~1config~1retention-filters~1{filter_id}/delete + response: + mediaType: application/json + openAPIDocKey: '200' + get_apm_retention_filter: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters~1{filter_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_apm_retention_filter: + operation: + $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters~1{filter_id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/retention_filters/methods/get_apm_retention_filter + - $ref: >- + #/components/x-stackQL-resources/retention_filters/methods/list_apm_retention_filters + insert: + - $ref: >- + #/components/x-stackQL-resources/retention_filters/methods/create_apm_retention_filter + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/retention_filters/methods/delete_apm_retention_filter + replace: + - $ref: >- + #/components/x-stackQL-resources/retention_filters/methods/update_apm_retention_filter + scorecard_outcomes: + id: datadog.apm.scorecard_outcomes + name: scorecard_outcomes + title: Scorecard Outcomes + methods: + list_scorecard_outcomes: + operation: + $ref: '#/paths/~1api~1v2~1scorecard~1outcomes/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_scorecard_outcomes_async: + operation: + $ref: '#/paths/~1api~1v2~1scorecard~1outcomes/post' + response: + mediaType: application/json + openAPIDocKey: '202' + create_scorecard_outcomes_batch: + operation: + $ref: '#/paths/~1api~1v2~1scorecard~1outcomes~1batch/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/scorecard_outcomes/methods/list_scorecard_outcomes + insert: + - $ref: >- + #/components/x-stackQL-resources/scorecard_outcomes/methods/create_scorecard_outcomes_batch + update: [] + delete: [] + replace: [] + scorecard_rules: + id: datadog.apm.scorecard_rules + name: scorecard_rules + title: Scorecard Rules + methods: + list_scorecard_rules: + operation: + $ref: '#/paths/~1api~1v2~1scorecard~1rules/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_scorecard_rule: + operation: + $ref: '#/paths/~1api~1v2~1scorecard~1rules/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_scorecard_rule: + operation: + $ref: '#/paths/~1api~1v2~1scorecard~1rules~1{rule_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + update_scorecard_rule: + operation: + $ref: '#/paths/~1api~1v2~1scorecard~1rules~1{rule_id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/scorecard_rules/methods/list_scorecard_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/scorecard_rules/methods/create_scorecard_rule + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/scorecard_rules/methods/delete_scorecard_rule + replace: + - $ref: >- + #/components/x-stackQL-resources/scorecard_rules/methods/update_scorecard_rule +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/apm_retention_filters.yaml b/providers/src/datadog/v00.00.00000/services/apm_retention_filters.yaml deleted file mode 100644 index cf075ced..00000000 --- a/providers/src/datadog/v00.00.00000/services/apm_retention_filters.yaml +++ /dev/null @@ -1,1387 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - apm_retention_filters - description: APM_Retention_Filters -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - RetentionFiltersResponse: - description: An ordered list of retention filters. - properties: - data: - description: A list of retention filters objects. - items: - $ref: '#/components/schemas/RetentionFilterAll' - type: array - required: - - data - type: object - RetentionFilterAll: - description: The definition of the retention filter. - properties: - attributes: - $ref: '#/components/schemas/RetentionFilterAllAttributes' - id: - description: The ID of the retention filter. - example: 7RBOb7dLSYWI01yc3pIH8w - type: string - type: - $ref: '#/components/schemas/ApmRetentionFilterType' - required: - - id - - type - - attributes - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - RetentionFilterAllAttributes: - description: The attributes of the retention filter. - properties: - created_at: - description: The creation timestamp of the retention filter. - format: int64 - type: integer - created_by: - description: The creator of the retention filter. - type: string - editable: - description: Shows whether the filter can be edited. - example: true - type: boolean - enabled: - description: The status of the retention filter (Enabled/Disabled). - example: true - type: boolean - execution_order: - description: The execution order of the retention filter. - format: int64 - type: integer - filter: - $ref: '#/components/schemas/SpansFilter' - filter_type: - $ref: '#/components/schemas/RetentionFilterAllType' - modified_at: - description: The modification timestamp of the retention filter. - format: int64 - type: integer - modified_by: - description: The modifier of the retention filter. - type: string - name: - description: The name of the retention filter. - example: my retention filter - type: string - rate: - description: |- - Sample rate to apply to spans going through this retention filter, - a value of 1.0 keeps all spans matching the query. - example: 1 - format: double - type: number - type: object - ApmRetentionFilterType: - default: apm_retention_filter - description: The type of the resource. - enum: - - apm_retention_filter - example: apm_retention_filter - type: string - x-enum-varnames: - - apm_retention_filter - SpansFilter: - description: The spans filter used to index spans. - properties: - query: - description: 'The search query - following the [span search syntax](https://docs.datadoghq.com/tracing/trace_explorer/query_syntax/).' - example: '@http.status_code:200 service:my-service' - type: string - type: object - RetentionFilterAllType: - default: spans-sampling-processor - description: The type of retention filter. - enum: - - spans-sampling-processor - - spans-errors-sampling-processor - - spans-appsec-sampling-processor - type: string - x-enum-varnames: - - SPANS_SAMPLING_PROCESSOR - - SPANS_ERRORS_SAMPLING_PROCESSOR - - SPANS_APPSEC_SAMPLING_PROCESSOR - RetentionFilterCreateRequest: - description: The body of the retention filter to be created. - properties: - data: - $ref: '#/components/schemas/RetentionFilterCreateData' - required: - - data - type: object - RetentionFilterResponse: - description: The retention filters definition. - properties: - data: - $ref: '#/components/schemas/RetentionFilter' - type: object - RetentionFilterCreateData: - description: The body of the retention filter to be created. - properties: - attributes: - $ref: '#/components/schemas/RetentionFilterCreateAttributes' - type: - $ref: '#/components/schemas/ApmRetentionFilterType' - required: - - attributes - - type - type: object - RetentionFilter: - description: The definition of the retention filter. - properties: - attributes: - $ref: '#/components/schemas/RetentionFilterAttributes' - id: - description: The ID of the retention filter. - example: 7RBOb7dLSYWI01yc3pIH8w - type: string - type: - $ref: '#/components/schemas/ApmRetentionFilterType' - required: - - id - - type - - attributes - type: object - RetentionFilterCreateAttributes: - description: The object describing the configuration of the retention filter to create/update. - properties: - enabled: - description: Enable/Disable the retention filter. - example: true - type: boolean - filter: - $ref: '#/components/schemas/SpansFilterCreate' - filter_type: - $ref: '#/components/schemas/RetentionFilterType' - name: - description: The name of the retention filter. - example: my retention filter - type: string - rate: - description: |- - Sample rate to apply to spans going through this retention filter, - a value of 1.0 keeps all spans matching the query. - example: 1 - format: double - type: number - required: - - name - - filter - - enabled - - filter_type - - rate - type: object - RetentionFilterAttributes: - description: The attributes of the retention filter. - properties: - created_at: - description: The creation timestamp of the retention filter. - format: int64 - type: integer - created_by: - description: The creator of the retention filter. - type: string - editable: - description: Shows whether the filter can be edited. - example: true - type: boolean - enabled: - description: The status of the retention filter (Enabled/Disabled). - example: true - type: boolean - execution_order: - description: The execution order of the retention filter. - format: int64 - type: integer - filter: - $ref: '#/components/schemas/SpansFilter' - filter_type: - $ref: '#/components/schemas/RetentionFilterType' - modified_at: - description: The modification timestamp of the retention filter. - format: int64 - type: integer - modified_by: - description: The modifier of the retention filter. - type: string - name: - description: The name of the retention filter. - example: my retention filter - type: string - rate: - description: |- - Sample rate to apply to spans going through this retention filter, - a value of 1.0 keeps all spans matching the query. - example: 1 - format: double - type: number - type: object - SpansFilterCreate: - description: The spans filter. Spans matching this filter will be indexed and stored. - properties: - query: - description: 'The search query - following the [span search syntax](https://docs.datadoghq.com/tracing/trace_explorer/query_syntax/).' - example: '@http.status_code:200 service:my-service' - type: string - required: - - query - type: object - RetentionFilterType: - default: spans-sampling-processor - description: The type of retention filter. The value should always be spans-sampling-processor. - enum: - - spans-sampling-processor - example: spans-sampling-processor - type: string - x-enum-varnames: - - SPANS_SAMPLING_PROCESSOR - ReorderRetentionFiltersRequest: - description: A list of retention filters to reorder. - properties: - data: - description: A list of retention filters objects. - items: - $ref: '#/components/schemas/RetentionFilterWithoutAttributes' - type: array - required: - - data - type: object - RetentionFilterWithoutAttributes: - description: The retention filter object . - properties: - id: - description: The ID of the retention filter. - example: 7RBOb7dLSYWI01yc3pIH8w - type: string - type: - $ref: '#/components/schemas/ApmRetentionFilterType' - required: - - id - - type - type: object - RetentionFilterUpdateRequest: - description: The body of the retention filter to be updated. - properties: - data: - $ref: '#/components/schemas/RetentionFilterUpdateData' - required: - - data - type: object - RetentionFilterUpdateData: - description: The body of the retention filter to be updated. - properties: - attributes: - $ref: '#/components/schemas/RetentionFilterCreateAttributes' - id: - description: The ID of the retention filter. - example: retention-filter-id - type: string - type: - $ref: '#/components/schemas/ApmRetentionFilterType' - required: - - id - - attributes - - type - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ConflictResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - apm_retention_filters: - id: datadog.apm_retention_filters.apm_retention_filters - name: apm_retention_filters - title: Apm Retention Filters - methods: - list_apm_retention_filters: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_apm_retention_filters: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_apm_retention_filter: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters/post' - response: - mediaType: application/json - openAPIDocKey: '200' - reorder_apm_retention_filters: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters-execution-order/put' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_apm_retention_filter: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters~1{filter_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '200' - get_apm_retention_filter: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters~1{filter_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_apm_retention_filter: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters~1{filter_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_apm_retention_filter: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1retention-filters~1{filter_id}/put' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/apm_retention_filters/methods/get_apm_retention_filter' - - $ref: '#/components/x-stackQL-resources/apm_retention_filters/methods/list_apm_retention_filters' - insert: - - $ref: '#/components/x-stackQL-resources/apm_retention_filters/methods/create_apm_retention_filter' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/apm_retention_filters/methods/delete_apm_retention_filter' -paths: - /api/v2/apm/config/retention-filters: - get: - description: Get the list of APM retention filters. - operationId: ListApmRetentionFilters - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RetentionFiltersResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List all APM retention filters - tags: - - APM Retention Filters - post: - description: |- - Create a retention filter to index spans in your organization. - Returns the retention filter definition when the request is successful. - operationId: CreateApmRetentionFilter - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RetentionFilterCreateRequest' - description: The definition of the new retention filter. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RetentionFilterResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a retention filter - tags: - - APM Retention Filters - x-codegen-request-body-name: body - /api/v2/apm/config/retention-filters-execution-order: - put: - description: Re-order the execution order of retention filters. - operationId: ReorderApmRetentionFilters - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ReorderRetentionFiltersRequest' - description: The list of retention filters in the new order. - required: true - responses: - '200': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Re-order retention filters - tags: - - APM Retention Filters - x-codegen-request-body-name: body - '/api/v2/apm/config/retention-filters/{filter_id}': - delete: - description: Delete a specific retention filter from your organization. - operationId: DeleteApmRetentionFilter - parameters: - - $ref: '#/components/parameters/RetentionFilterIdParam' - responses: - '200': - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete a retention filter - tags: - - APM Retention Filters - get: - description: Get an APM retention filter. - operationId: GetApmRetentionFilter - parameters: - - $ref: '#/components/parameters/RetentionFilterIdParam' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RetentionFilterResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get a given APM retention filter - tags: - - APM Retention Filters - put: - description: Update a retention filter from your organization. - operationId: UpdateApmRetentionFilter - parameters: - - $ref: '#/components/parameters/RetentionFilterIdParam' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RetentionFilterUpdateRequest' - description: The updated definition of the retention filter. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RetentionFilterResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update a retention filter - tags: - - APM Retention Filters - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/audit.yaml b/providers/src/datadog/v00.00.00000/services/audit.yaml deleted file mode 100644 index 607fd5fd..00000000 --- a/providers/src/datadog/v00.00.00000/services/audit.yaml +++ /dev/null @@ -1,1237 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - audit - description: Search your Audit Logs events over HTTP. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - AuditLogsSort: - description: Sort parameters when querying events. - enum: - - timestamp - - '-timestamp' - type: string - x-enum-varnames: - - TIMESTAMP_ASCENDING - - TIMESTAMP_DESCENDING - AuditLogsEventsResponse: - description: Response object with all events matching the request and pagination information. - properties: - data: - description: Array of events matching the request. - items: - $ref: '#/components/schemas/AuditLogsEvent' - type: array - links: - $ref: '#/components/schemas/AuditLogsResponseLinks' - meta: - $ref: '#/components/schemas/AuditLogsResponseMetadata' - type: object - AuditLogsEvent: - description: Object description of an Audit Logs event after it is processed and stored by Datadog. - properties: - attributes: - $ref: '#/components/schemas/AuditLogsEventAttributes' - id: - description: Unique ID of the event. - example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA - type: string - type: - $ref: '#/components/schemas/AuditLogsEventType' - type: object - AuditLogsResponseLinks: - description: Links attributes. - properties: - next: - description: |- - Link for the next set of results. Note that the request can also be made using the - POST endpoint. - example: 'https://app.datadoghq.com/api/v2/audit/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==' - type: string - type: object - AuditLogsResponseMetadata: - description: The metadata associated with a request. - properties: - elapsed: - description: Time elapsed in milliseconds. - example: 132 - format: int64 - type: integer - page: - $ref: '#/components/schemas/AuditLogsResponsePage' - request_id: - description: The identifier of the request. - example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR - type: string - status: - $ref: '#/components/schemas/AuditLogsResponseStatus' - warnings: - description: |- - A list of warnings (non-fatal errors) encountered. Partial results may return if - warnings are present in the response. - items: - $ref: '#/components/schemas/AuditLogsWarning' - type: array - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - AuditLogsEventAttributes: - description: JSON object containing all event attributes and their associated values. - properties: - attributes: - additionalProperties: {} - description: JSON object of attributes from Audit Logs events. - example: - customAttribute: 123 - duration: 2345 - type: object - message: - description: Message of the event. - type: string - service: - description: |- - Name of the application or service generating Audit Logs events. - This name is used to correlate Audit Logs to APM, so make sure you specify the same - value when you use both products. - example: web-app - type: string - tags: - description: Array of tags associated with your event. - example: - - 'team:A' - items: - description: Tag associated with your event. - type: string - type: array - timestamp: - description: Timestamp of your event. - example: '2019-01-02T09:42:36.320Z' - format: date-time - type: string - type: object - AuditLogsEventType: - default: audit - description: Type of the event. - enum: - - audit - example: audit - type: string - x-enum-varnames: - - Audit - AuditLogsResponsePage: - description: Paging attributes. - properties: - after: - description: 'The cursor to use to get the next results, if any. To make the next request, use the same parameters with the addition of `page[cursor]`.' - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - type: object - AuditLogsResponseStatus: - description: The status of the response. - enum: - - done - - timeout - example: done - type: string - x-enum-varnames: - - DONE - - TIMEOUT - AuditLogsWarning: - description: Warning message indicating something that went wrong with the query. - properties: - code: - description: Unique code for this type of warning. - example: unknown_index - type: string - detail: - description: Detailed explanation of this specific warning. - example: 'indexes: foo, bar' - type: string - title: - description: Short human-readable summary of the warning. - example: 'One or several indexes are missing or invalid, results hold data from the other indexes' - type: string - type: object - AuditLogsSearchEventsRequest: - description: The request for a Audit Logs events list. - properties: - filter: - $ref: '#/components/schemas/AuditLogsQueryFilter' - options: - $ref: '#/components/schemas/AuditLogsQueryOptions' - page: - $ref: '#/components/schemas/AuditLogsQueryPageOptions' - sort: - $ref: '#/components/schemas/AuditLogsSort' - type: object - AuditLogsQueryFilter: - description: Search and filter query settings. - properties: - from: - default: now-15m - description: 'Minimum time for the requested events. Supports date, math, and regular timestamps (in milliseconds).' - example: now-15m - type: string - query: - default: '*' - description: Search query following the Audit Logs search syntax. - example: '@type:session AND @session.type:user' - type: string - to: - default: now - description: 'Maximum time for the requested events. Supports date, math, and regular timestamps (in milliseconds).' - example: now - type: string - type: object - AuditLogsQueryOptions: - description: |- - Global query options that are used during the query. - Note: Specify either timezone or time offset, not both. Otherwise, the query fails. - properties: - time_offset: - description: Time offset (in seconds) to apply to the query. - format: int64 - type: integer - timezone: - default: UTC - description: 'The timezone can be specified as GMT, UTC, an offset from UTC (like UTC+1), or as a Timezone Database identifier (like America/New_York).' - example: GMT - type: string - type: object - AuditLogsQueryPageOptions: - description: Paging attributes for listing events. - properties: - cursor: - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - limit: - default: 10 - description: Maximum number of events in the response. - example: 25 - format: int32 - maximum: 1000 - type: integer - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - audit_logs: - id: datadog.audit.audit_logs - name: audit_logs - title: Audit Logs - methods: - list_audit_logs: - operation: - $ref: '#/paths/~1api~1v2~1audit~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_audit_logs: - operation: - $ref: '#/paths/~1api~1v2~1audit~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - search_audit_logs: - operation: - $ref: '#/paths/~1api~1v2~1audit~1events~1search/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/audit_logs/methods/list_audit_logs' - insert: [] - update: [] - delete: [] -paths: - /api/v2/audit/events: - get: - description: |- - List endpoint returns events that match a Audit Logs search query. - [Results are paginated][1]. - - Use this endpoint to see your latest Audit Logs events. - - [1]: https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination - operationId: ListAuditLogs - parameters: - - description: Search query following Audit Logs syntax. - example: '@type:session @application_id:xxxx' - in: query - name: 'filter[query]' - required: false - schema: - type: string - - description: Minimum timestamp for requested events. - example: '2019-01-02T09:42:36.320Z' - in: query - name: 'filter[from]' - required: false - schema: - format: date-time - type: string - - description: Maximum timestamp for requested events. - example: '2019-01-03T09:42:36.320Z' - in: query - name: 'filter[to]' - required: false - schema: - format: date-time - type: string - - description: Order of events in results. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/AuditLogsSort' - - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - in: query - name: 'page[cursor]' - required: false - schema: - type: string - - description: Maximum number of events in the response. - example: 25 - in: query - name: 'page[limit]' - required: false - schema: - default: 10 - format: int32 - maximum: 1000 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/AuditLogsEventsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get a list of Audit Logs events - tags: - - Audit - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data - /api/v2/audit/events/search: - post: - description: |- - List endpoint returns Audit Logs events that match an Audit search query. - [Results are paginated][1]. - - Use this endpoint to build complex Audit Logs events filtering and search. - - [1]: https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination - operationId: SearchAuditLogs - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/AuditLogsSearchEventsRequest' - required: false - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/AuditLogsEventsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Search Audit Logs events - tags: - - Audit - x-codegen-request-body-name: body - x-pagination: - cursorParam: body.page.cursor - cursorPath: meta.page.after - limitParam: body.page.limit - resultsPath: data diff --git a/providers/src/datadog/v00.00.00000/services/authn_mappings.yaml b/providers/src/datadog/v00.00.00000/services/authn_mappings.yaml deleted file mode 100644 index 74343d00..00000000 --- a/providers/src/datadog/v00.00.00000/services/authn_mappings.yaml +++ /dev/null @@ -1,1517 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - authn_mappings - description: AuthN_Mappings -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - AuthNMappingsSort: - description: Sorting options for AuthN Mappings. - enum: - - created_at - - '-created_at' - - role_id - - '-role_id' - - saml_assertion_attribute_id - - '-saml_assertion_attribute_id' - - role.name - - '-role.name' - - saml_assertion_attribute.attribute_key - - '-saml_assertion_attribute.attribute_key' - - saml_assertion_attribute.attribute_value - - '-saml_assertion_attribute.attribute_value' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - ROLE_ID_ASCENDING - - ROLE_ID_DESCENDING - - SAML_ASSERTION_ATTRIBUTE_ID_ASCENDING - - SAML_ASSERTION_ATTRIBUTE_ID_DESCENDING - - ROLE_NAME_ASCENDING - - ROLE_NAME_DESCENDING - - SAML_ASSERTION_ATTRIBUTE_KEY_ASCENDING - - SAML_ASSERTION_ATTRIBUTE_KEY_DESCENDING - - SAML_ASSERTION_ATTRIBUTE_VALUE_ASCENDING - - SAML_ASSERTION_ATTRIBUTE_VALUE_DESCENDING - AuthNMappingsResponse: - description: Array of AuthN Mappings response. - properties: - data: - description: Array of returned AuthN Mappings. - items: - $ref: '#/components/schemas/AuthNMapping' - type: array - included: - description: Included data in the AuthN Mapping response. - items: - $ref: '#/components/schemas/AuthNMappingIncluded' - type: array - meta: - $ref: '#/components/schemas/ResponseMetaAttributes' - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - AuthNMapping: - description: The AuthN Mapping object returned by API. - properties: - attributes: - $ref: '#/components/schemas/AuthNMappingAttributes' - id: - description: ID of the AuthN Mapping. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - relationships: - $ref: '#/components/schemas/AuthNMappingRelationships' - type: - $ref: '#/components/schemas/AuthNMappingsType' - required: - - id - - type - type: object - AuthNMappingIncluded: - description: Included data in the AuthN Mapping response. - oneOf: - - $ref: '#/components/schemas/SAMLAssertionAttribute' - - $ref: '#/components/schemas/Role' - ResponseMetaAttributes: - description: Object describing meta attributes of response. - properties: - page: - $ref: '#/components/schemas/Pagination' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - AuthNMappingAttributes: - description: Attributes of AuthN Mapping. - properties: - attribute_key: - description: Key portion of a key/value pair of the attribute sent from the Identity Provider. - example: member-of - type: string - attribute_value: - description: Value portion of a key/value pair of the attribute sent from the Identity Provider. - example: Development - type: string - created_at: - description: Creation time of the AuthN Mapping. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last AuthN Mapping modification. - format: date-time - readOnly: true - type: string - saml_assertion_attribute_id: - description: The ID of the SAML assertion attribute. - example: '0' - type: string - type: object - AuthNMappingRelationships: - description: All relationships associated with AuthN Mapping. - properties: - role: - $ref: '#/components/schemas/RelationshipToRole' - saml_assertion_attribute: - $ref: '#/components/schemas/RelationshipToSAMLAssertionAttribute' - type: object - AuthNMappingsType: - default: authn_mappings - description: AuthN Mappings resource type. - enum: - - authn_mappings - example: authn_mappings - type: string - x-enum-varnames: - - AUTHN_MAPPINGS - SAMLAssertionAttribute: - description: SAML assertion attribute. - properties: - attributes: - $ref: '#/components/schemas/SAMLAssertionAttributeAttributes' - id: - description: The ID of the SAML assertion attribute. - example: '0' - type: string - type: - $ref: '#/components/schemas/SAMLAssertionAttributesType' - required: - - id - - type - type: object - Role: - description: Role object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/RoleAttributes' - id: - description: The unique identifier of the role. - type: string - relationships: - $ref: '#/components/schemas/RoleResponseRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - type: object - Pagination: - description: Pagination object. - properties: - total_count: - description: Total count. - format: int64 - type: integer - total_filtered_count: - description: Total count of elements matched by the filter. - format: int64 - type: integer - type: object - RelationshipToRole: - description: Relationship to role. - properties: - data: - $ref: '#/components/schemas/RelationshipToRoleData' - type: object - RelationshipToSAMLAssertionAttribute: - description: AuthN Mapping relationship to SAML Assertion Attribute. - properties: - data: - $ref: '#/components/schemas/RelationshipToSAMLAssertionAttributeData' - required: - - data - type: object - SAMLAssertionAttributeAttributes: - description: Key/Value pair of attributes used in SAML assertion attributes. - properties: - attribute_key: - description: Key portion of a key/value pair of the attribute sent from the Identity Provider. - example: member-of - type: string - attribute_value: - description: Value portion of a key/value pair of the attribute sent from the Identity Provider. - example: Development - type: string - type: object - SAMLAssertionAttributesType: - default: saml_assertion_attributes - description: SAML assertion attributes resource type. - enum: - - saml_assertion_attributes - example: saml_assertion_attributes - type: string - x-enum-varnames: - - SAML_ASSERTION_ATTRIBUTES - RoleAttributes: - description: Attributes of the role. - properties: - created_at: - description: Creation time of the role. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last role modification. - format: date-time - readOnly: true - type: string - name: - description: The name of the role. The name is neither unique nor a stable identifier of the role. - type: string - user_count: - description: Number of users with that role. - format: int64 - readOnly: true - type: integer - type: object - RoleResponseRelationships: - description: Relationships of the role object returned by the API. - properties: - permissions: - $ref: '#/components/schemas/RelationshipToPermissions' - type: object - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - RelationshipToSAMLAssertionAttributeData: - description: Data of AuthN Mapping relationship to SAML Assertion Attribute. - properties: - id: - description: The ID of the SAML assertion attribute. - example: '0' - type: string - type: - $ref: '#/components/schemas/SAMLAssertionAttributesType' - required: - - id - - type - type: object - RelationshipToPermissions: - description: Relationship to multiple permissions objects. - properties: - data: - description: Relationships to permission objects. - items: - $ref: '#/components/schemas/RelationshipToPermissionData' - type: array - type: object - RelationshipToPermissionData: - description: Relationship to permission object. - properties: - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - type: object - PermissionsType: - default: permissions - description: Permissions resource type. - enum: - - permissions - example: permissions - type: string - x-enum-varnames: - - PERMISSIONS - AuthNMappingCreateRequest: - description: Request for creating an AuthN Mapping. - properties: - data: - $ref: '#/components/schemas/AuthNMappingCreateData' - required: - - data - type: object - AuthNMappingResponse: - description: AuthN Mapping response from the API. - properties: - data: - $ref: '#/components/schemas/AuthNMapping' - included: - description: Included data in the AuthN Mapping response. - items: - $ref: '#/components/schemas/AuthNMappingIncluded' - type: array - type: object - AuthNMappingCreateData: - description: Data for creating an AuthN Mapping. - properties: - attributes: - $ref: '#/components/schemas/AuthNMappingCreateAttributes' - relationships: - $ref: '#/components/schemas/AuthNMappingCreateRelationships' - type: - $ref: '#/components/schemas/AuthNMappingsType' - required: - - type - type: object - AuthNMappingCreateAttributes: - description: Key/Value pair of attributes used for create request. - properties: - attribute_key: - description: Key portion of a key/value pair of the attribute sent from the Identity Provider. - example: member-of - type: string - attribute_value: - description: Value portion of a key/value pair of the attribute sent from the Identity Provider. - example: Development - type: string - type: object - AuthNMappingCreateRelationships: - description: Relationship of AuthN Mapping create object to Role. - properties: - role: - $ref: '#/components/schemas/RelationshipToRole' - type: object - AuthNMappingUpdateRequest: - description: Request to update an AuthN Mapping. - properties: - data: - $ref: '#/components/schemas/AuthNMappingUpdateData' - required: - - data - type: object - AuthNMappingUpdateData: - description: Data for updating an AuthN Mapping. - properties: - attributes: - $ref: '#/components/schemas/AuthNMappingUpdateAttributes' - id: - description: ID of the AuthN Mapping. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - relationships: - $ref: '#/components/schemas/AuthNMappingUpdateRelationships' - type: - $ref: '#/components/schemas/AuthNMappingsType' - required: - - id - - type - type: object - AuthNMappingUpdateAttributes: - description: Key/Value pair of attributes used for update request. - properties: - attribute_key: - description: Key portion of a key/value pair of the attribute sent from the Identity Provider. - example: member-of - type: string - attribute_value: - description: Value portion of a key/value pair of the attribute sent from the Identity Provider. - example: Development - type: string - type: object - AuthNMappingUpdateRelationships: - description: Relationship of AuthN Mapping update object to Role. - properties: - role: - $ref: '#/components/schemas/RelationshipToRole' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - mappings: - id: datadog.authn_mappings.mappings - name: mappings - title: Mappings - methods: - listauthn_mappings: - operation: - $ref: '#/paths/~1api~1v2~1authn_mappings/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _listauthn_mappings: - operation: - $ref: '#/paths/~1api~1v2~1authn_mappings/get' - response: - mediaType: application/json - openAPIDocKey: '200' - createauthn_mapping: - operation: - $ref: '#/paths/~1api~1v2~1authn_mappings/post' - response: - mediaType: application/json - openAPIDocKey: '200' - deleteauthn_mapping: - operation: - $ref: '#/paths/~1api~1v2~1authn_mappings~1{authn_mapping_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - getauthn_mapping: - operation: - $ref: '#/paths/~1api~1v2~1authn_mappings~1{authn_mapping_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _getauthn_mapping: - operation: - $ref: '#/paths/~1api~1v2~1authn_mappings~1{authn_mapping_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - updateauthn_mapping: - operation: - $ref: '#/paths/~1api~1v2~1authn_mappings~1{authn_mapping_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/mappings/methods/getauthn_mapping' - - $ref: '#/components/x-stackQL-resources/mappings/methods/listauthn_mappings' - insert: - - $ref: '#/components/x-stackQL-resources/mappings/methods/createauthn_mapping' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/mappings/methods/deleteauthn_mapping' -paths: - /api/v2/authn_mappings: - get: - description: List all AuthN Mappings in the org. - operationId: ListAuthNMappings - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - description: Sort AuthN Mappings depending on the given field. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/AuthNMappingsSort' - - description: Filter all mappings by the given string. - in: query - name: filter - required: false - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/AuthNMappingsResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: List all AuthN Mappings - tags: - - AuthN Mappings - x-permission: OPEN() - post: - description: Create an AuthN Mapping. - operationId: CreateAuthNMapping - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/AuthNMappingCreateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/AuthNMappingResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Create an AuthN Mapping - tags: - - AuthN Mappings - x-codegen-request-body-name: body - x-permission: OR(USER_ACCESS_MANAGE) - '/api/v2/authn_mappings/{authn_mapping_id}': - delete: - description: Delete an AuthN Mapping specified by AuthN Mapping UUID. - operationId: DeleteAuthNMapping - parameters: - - $ref: '#/components/parameters/AuthNMappingID' - responses: - '204': - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Delete an AuthN Mapping - tags: - - AuthN Mappings - x-permission: OR(USER_ACCESS_MANAGE) - get: - description: Get an AuthN Mapping specified by the AuthN Mapping UUID. - operationId: GetAuthNMapping - parameters: - - $ref: '#/components/parameters/AuthNMappingID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/AuthNMappingResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get an AuthN Mapping by UUID - tags: - - AuthN Mappings - x-permission: OPEN() - patch: - description: Edit an AuthN Mapping. - operationId: UpdateAuthNMapping - parameters: - - $ref: '#/components/parameters/AuthNMappingID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/AuthNMappingUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/AuthNMappingResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '409': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unprocessable Entity - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Edit an AuthN Mapping - tags: - - AuthN Mappings - x-codegen-request-body-name: body - x-permission: OR(USER_ACCESS_MANAGE) diff --git a/providers/src/datadog/v00.00.00000/services/catalog.yaml b/providers/src/datadog/v00.00.00000/services/catalog.yaml new file mode 100644 index 00000000..0dbeec71 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/catalog.yaml @@ -0,0 +1,2356 @@ +openapi: 3.0.0 +info: + title: catalog API + description: datadog catalog API + version: '1.0' +paths: + /api/v2/apicatalog/api: + get: + deprecated: true + description: List APIs and their IDs. + operationId: ListAPIs + parameters: + - description: Filter APIs by name + in: query + name: query + required: false + schema: + example: payments + type: string + - description: Number of items per page. + in: query + name: page[limit] + required: false + schema: + default: 20 + format: int64 + minimum: 1 + type: integer + - description: Offset for pagination. + in: query + name: page[offset] + required: false + schema: + default: 0 + format: int64 + minimum: 0 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListAPIsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_api_catalog_read + summary: List APIs + tags: + - API Management + x-permission: + operator: OR + permissions: + - apm_api_catalog_read + x-unstable: '**Note**: This endpoint is deprecated.' + /api/v2/apicatalog/api/{id}: + delete: + deprecated: true + description: Delete a specific API by ID. + operationId: DeleteOpenAPI + parameters: + - description: ID of the API to delete + in: path + name: id + required: true + schema: + $ref: '#/components/schemas/ApiID' + responses: + '204': + description: API deleted successfully + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: API not found error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_api_catalog_write + summary: Delete an API + tags: + - API Management + x-permission: + operator: OR + permissions: + - apm_api_catalog_write + x-unstable: '**Note**: This endpoint is deprecated.' + /api/v2/apicatalog/api/{id}/openapi: + get: + deprecated: true + description: >- + Retrieve information about a specific API in + [OpenAPI](https://spec.openapis.org/oas/latest.html) format file. + operationId: GetOpenAPI + parameters: + - description: ID of the API to retrieve + in: path + name: id + required: true + schema: + $ref: '#/components/schemas/ApiID' + responses: + '200': + content: + multipart/form-data: + schema: + format: binary + type: string + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: API not found error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_api_catalog_read + summary: Get an API + tags: + - API Management + x-permission: + operator: OR + permissions: + - apm_api_catalog_read + x-unstable: '**Note**: This endpoint is deprecated.' + put: + deprecated: true + description: > + Update information about a specific API. The given content will replace + all API content of the given ID. + + The ID is returned by the create API, or can be found in the URL in the + API catalog UI. + operationId: UpdateOpenAPI + parameters: + - description: ID of the API to modify + in: path + name: id + required: true + schema: + $ref: '#/components/schemas/ApiID' + requestBody: + content: + multipart/form-data: + schema: + $ref: '#/components/schemas/OpenAPIFile' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateOpenAPIResponse' + description: API updated successfully + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: API not found error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_api_catalog_write + summary: Update an API + tags: + - API Management + x-permission: + operator: OR + permissions: + - apm_api_catalog_write + x-unstable: '**Note**: This endpoint is deprecated.' + /api/v2/apicatalog/openapi: + post: + deprecated: true + description: > + Create a new API from the + [OpenAPI](https://spec.openapis.org/oas/latest.html) specification + given. + + See the [API Catalog + documentation](https://docs.datadoghq.com/api_catalog/add_metadata/) for + additional + + information about the possible metadata. + + It returns the created API ID. + operationId: CreateOpenAPI + requestBody: + content: + multipart/form-data: + schema: + $ref: '#/components/schemas/OpenAPIFile' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/CreateOpenAPIResponse' + description: API created successfully + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_api_catalog_write + summary: Create a new API + tags: + - API Management + x-permission: + operator: OR + permissions: + - apm_api_catalog_write + x-unstable: '**Note**: This endpoint is deprecated.' + /api/v2/catalog/entity: + get: + description: Get a list of entities from Software Catalog. + operationId: ListCatalogEntity + parameters: + - $ref: '#/components/parameters/PageOffset' + - description: Maximum number of entities in the response. + example: 100 + in: query + name: page[limit] + required: false + schema: + default: 100 + format: int64 + type: integer + - $ref: '#/components/parameters/FilterByID' + - $ref: '#/components/parameters/FilterByRef' + - $ref: '#/components/parameters/FilterByName' + - $ref: '#/components/parameters/FilterByKind' + - $ref: '#/components/parameters/FilterByOwner' + - $ref: '#/components/parameters/FilterByRelationType' + - $ref: '#/components/parameters/FilterByExcludeSnapshot' + - $ref: '#/components/parameters/Include' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListEntityCatalogResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_read + summary: Get a list of entities + tags: + - Software Catalog + x-pagination: + limitParam: page[limit] + pageOffsetParam: page[offset] + resultsPath: data + post: + description: Create or update entities in Software Catalog. + operationId: UpsertCatalogEntity + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpsertCatalogEntityRequest' + description: Entity YAML or JSON. + required: true + responses: + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/UpsertCatalogEntityResponse' + description: ACCEPTED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Create or update entities + tags: + - Software Catalog + x-codegen-request-body-name: body + /api/v2/catalog/entity/{entity_id}: + delete: + description: Delete a single entity in Software Catalog. + operationId: DeleteCatalogEntity + parameters: + - $ref: '#/components/parameters/EntityID' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Delete a single entity + tags: + - Software Catalog + /api/v2/catalog/kind: + get: + description: Get a list of entity kinds from Software Catalog. + operationId: ListCatalogKind + parameters: + - $ref: '#/components/parameters/PageOffset' + - description: Maximum number of kinds in the response. + example: 100 + in: query + name: page[limit] + required: false + schema: + default: 100 + format: int64 + type: integer + - $ref: '#/components/parameters/FilterByID' + - $ref: '#/components/parameters/FilterByName' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListKindCatalogResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_read + summary: Get a list of entity kinds + tags: + - Software Catalog + x-pagination: + limitParam: page[limit] + pageOffsetParam: page[offset] + resultsPath: data + post: + description: Create or update kinds in Software Catalog. + operationId: UpsertCatalogKind + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpsertCatalogKindRequest' + description: Kind YAML or JSON. + required: true + responses: + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/UpsertCatalogKindResponse' + description: ACCEPTED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Create or update kinds + tags: + - Software Catalog + x-codegen-request-body-name: body + /api/v2/catalog/kind/{kind_id}: + delete: + description: Delete a single kind in Software Catalog. + operationId: DeleteCatalogKind + parameters: + - $ref: '#/components/parameters/KindID' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Delete a single kind + tags: + - Software Catalog + /api/v2/catalog/relation: + get: + description: Get a list of entity relations from Software Catalog. + operationId: ListCatalogRelation + parameters: + - $ref: '#/components/parameters/PageOffset' + - description: Maximum number of relations in the response. + example: 100 + in: query + name: page[limit] + required: false + schema: + default: 100 + format: int64 + type: integer + - $ref: '#/components/parameters/FilterRelationByType' + - $ref: '#/components/parameters/FilterRelationByFromRef' + - $ref: '#/components/parameters/FilterRelationByToRef' + - $ref: '#/components/parameters/RelationInclude' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListRelationCatalogResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_read + summary: Get a list of entity relations + tags: + - Software Catalog + x-pagination: + limitParam: page[limit] + pageOffsetParam: page[offset] + resultsPath: data +components: + schemas: + ListAPIsResponse: + description: Response for `ListAPIs`. + properties: + data: + description: List of API items. + items: + $ref: '#/components/schemas/ListAPIsResponseData' + type: array + meta: + $ref: '#/components/schemas/ListAPIsResponseMeta' + type: object + JSONAPIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + items: + $ref: '#/components/schemas/JSONAPIErrorItem' + type: array + required: + - errors + type: object + ApiID: + description: API identifier. + example: 90646597-5fdb-4a17-a240-647003f8c028 + format: uuid + type: string + OpenAPIFile: + description: Object for API data in an `OpenAPI` format as a file. + properties: + openapi_spec_file: + description: Binary `OpenAPI` spec file + format: binary + type: string + type: object + UpdateOpenAPIResponse: + description: Response for `UpdateOpenAPI`. + properties: + data: + $ref: '#/components/schemas/UpdateOpenAPIResponseData' + type: object + CreateOpenAPIResponse: + description: Response for `CreateOpenAPI` operation. + properties: + data: + $ref: '#/components/schemas/CreateOpenAPIResponseData' + type: object + ListEntityCatalogResponse: + description: List entity response. + properties: + data: + $ref: '#/components/schemas/EntityResponseData' + included: + $ref: '#/components/schemas/ListEntityCatalogResponseIncluded' + links: + $ref: '#/components/schemas/ListEntityCatalogResponseLinks' + meta: + $ref: '#/components/schemas/EntityResponseMeta' + type: object + UpsertCatalogEntityRequest: + description: Create or update entity request. + oneOf: + - $ref: '#/components/schemas/EntityV3' + - $ref: '#/components/schemas/EntityRaw' + UpsertCatalogEntityResponse: + description: Upsert entity response. + properties: + data: + $ref: '#/components/schemas/EntityResponseData' + included: + $ref: '#/components/schemas/UpsertCatalogEntityResponseIncluded' + meta: + $ref: '#/components/schemas/EntityResponseMeta' + type: object + ListKindCatalogResponse: + description: List kind response. + properties: + data: + $ref: '#/components/schemas/KindResponseData' + meta: + $ref: '#/components/schemas/KindResponseMeta' + type: object + UpsertCatalogKindRequest: + description: Create or update kind request. + oneOf: + - $ref: '#/components/schemas/KindObj' + - $ref: '#/components/schemas/KindRaw' + UpsertCatalogKindResponse: + description: Upsert kind response. + properties: + data: + $ref: '#/components/schemas/KindResponseData' + meta: + $ref: '#/components/schemas/KindResponseMeta' + type: object + ListRelationCatalogResponse: + description: List entity relation response. + properties: + data: + $ref: '#/components/schemas/RelationResponseData' + included: + $ref: '#/components/schemas/ListRelationCatalogResponseIncluded' + links: + $ref: '#/components/schemas/ListRelationCatalogResponseLinks' + meta: + $ref: '#/components/schemas/RelationResponseMeta' + type: object + ListAPIsResponseData: + description: Data envelope for `ListAPIsResponse`. + properties: + attributes: + $ref: '#/components/schemas/ListAPIsResponseDataAttributes' + id: + $ref: '#/components/schemas/ApiID' + type: object + ListAPIsResponseMeta: + description: Metadata for `ListAPIsResponse`. + properties: + pagination: + $ref: '#/components/schemas/ListAPIsResponseMetaPagination' + type: object + JSONAPIErrorItem: + description: API error response body + properties: + detail: + description: >- + A human-readable explanation specific to this occurrence of the + error. + example: Missing required attribute in body + type: string + meta: + additionalProperties: {} + description: Non-standard meta-information about the error + type: object + source: + $ref: '#/components/schemas/JSONAPIErrorItemSource' + status: + description: Status code of the response. + example: '400' + type: string + title: + description: Short human-readable summary of the error. + example: Bad Request + type: string + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + UpdateOpenAPIResponseData: + description: Data envelope for `UpdateOpenAPIResponse`. + properties: + attributes: + $ref: '#/components/schemas/UpdateOpenAPIResponseAttributes' + id: + $ref: '#/components/schemas/ApiID' + type: object + CreateOpenAPIResponseData: + description: Data envelope for `CreateOpenAPIResponse`. + properties: + attributes: + $ref: '#/components/schemas/CreateOpenAPIResponseAttributes' + id: + $ref: '#/components/schemas/ApiID' + type: object + RelationType: + description: Supported relation types. + enum: + - RelationTypeOwns + - RelationTypeOwnedBy + - RelationTypeDependsOn + - RelationTypeDependencyOf + - RelationTypePartsOf + - RelationTypeHasPart + - RelationTypeOtherOwns + - RelationTypeOtherOwnedBy + - RelationTypeImplementedBy + - RelationTypeImplements + type: string + x-enum-varnames: + - RELATIONTYPEOWNS + - RELATIONTYPEOWNEDBY + - RELATIONTYPEDEPENDSON + - RELATIONTYPEDEPENDENCYOF + - RELATIONTYPEPARTSOF + - RELATIONTYPEHASPART + - RELATIONTYPEOTHEROWNS + - RELATIONTYPEOTHEROWNEDBY + - RELATIONTYPEIMPLEMENTEDBY + - RELATIONTYPEIMPLEMENTS + IncludeType: + description: Supported include types. + enum: + - schema + - raw_schema + - oncall + - incident + - relation + type: string + x-enum-varnames: + - SCHEMA + - RAW_SCHEMA + - ONCALL + - INCIDENT + - RELATION + EntityResponseData: + description: List of entity data. + items: + $ref: '#/components/schemas/EntityData' + type: array + ListEntityCatalogResponseIncluded: + description: List entity response included. + items: + $ref: '#/components/schemas/ListEntityCatalogResponseIncludedItem' + type: array + ListEntityCatalogResponseLinks: + description: List entity response links. + properties: + next: + description: Next link. + type: string + previous: + description: Previous link. + type: string + self: + description: Current link. + type: string + type: object + EntityResponseMeta: + description: Entity metadata. + properties: + count: + description: Total entities count. + format: int64 + type: integer + includeCount: + description: Total included data count. + format: int64 + type: integer + type: object + EntityV3: + description: Entity schema v3. + oneOf: + - $ref: '#/components/schemas/EntityV3Service' + - $ref: '#/components/schemas/EntityV3Datastore' + - $ref: '#/components/schemas/EntityV3Queue' + - $ref: '#/components/schemas/EntityV3System' + - $ref: '#/components/schemas/EntityV3API' + EntityRaw: + description: Entity definition in raw JSON or YAML representation. + example: | + apiVersion: v3 + kind: service + metadata: + name: myservice + type: string + UpsertCatalogEntityResponseIncluded: + description: Upsert entity response included. + items: + $ref: '#/components/schemas/UpsertCatalogEntityResponseIncludedItem' + type: array + KindResponseData: + description: List of kind responses. + items: + $ref: '#/components/schemas/KindData' + type: array + KindResponseMeta: + description: Kind response metadata. + properties: + count: + description: Total kinds count. + format: int64 + type: integer + type: object + KindObj: + description: Schema for kind. + properties: + description: + description: Short description of the kind. + type: string + displayName: + description: >- + The display name of the kind. Automatically generated if not + provided. + type: string + kind: + description: >- + The name of the kind to create or update. This must be in kebab-case + format. + example: my-job + type: string + required: + - kind + type: object + KindRaw: + description: Kind definition in raw JSON or YAML representation. + example: | + kind: service + displayName: Service + description: A service entity in the catalog. + type: string + RelationIncludeType: + description: Supported include types for relations. + enum: + - entity + - schema + type: string + x-enum-varnames: + - ENTITY + - SCHEMA + RelationResponseData: + description: Array of relation responses + items: + $ref: '#/components/schemas/RelationResponse' + type: array + ListRelationCatalogResponseIncluded: + description: List relation response included entities. + items: + $ref: '#/components/schemas/EntityData' + type: array + ListRelationCatalogResponseLinks: + description: List relation response links. + properties: + next: + description: Next link. + example: >- + /api/v2/catalog/relation?filter[from_ref]=service:service-catalog&include=entity&page[limit]=2&page[offset]=2 + type: string + previous: + description: Previous link. + type: string + self: + description: Current link. + example: >- + /api/v2/catalog/relation?filter[from_ref]=service:service-catalog&include=entity&page[limit]=2&page[offset]=0 + type: string + type: object + RelationResponseMeta: + description: Relation response metadata. + properties: + count: + description: Total relations count. + format: int64 + type: integer + includeCount: + description: Total included data count. + format: int64 + type: integer + type: object + ListAPIsResponseDataAttributes: + description: Attributes for `ListAPIsResponseData`. + properties: + name: + description: API name. + example: Payments API + type: string + type: object + ListAPIsResponseMetaPagination: + description: Pagination metadata information for `ListAPIsResponse`. + properties: + limit: + description: Number of items in the current page. + example: 20 + format: int64 + type: integer + offset: + description: Offset for pagination. + example: 0 + format: int64 + type: integer + total_count: + description: Total number of items. + example: 35 + format: int64 + type: integer + type: object + JSONAPIErrorItemSource: + description: References to the source of the error. + properties: + header: + description: >- + A string indicating the name of a single request header which caused + the error. + example: Authorization + type: string + parameter: + description: A string indicating which URI query parameter caused the error. + example: limit + type: string + pointer: + description: >- + A JSON pointer to the value in the request document that caused the + error. + example: /data/attributes/title + type: string + type: object + UpdateOpenAPIResponseAttributes: + description: Attributes for `UpdateOpenAPI`. + properties: + failed_endpoints: + description: List of endpoints which couldn't be parsed. + items: + $ref: '#/components/schemas/OpenAPIEndpoint' + type: array + type: object + CreateOpenAPIResponseAttributes: + description: Attributes for `CreateOpenAPI`. + properties: + failed_endpoints: + description: List of endpoints which couldn't be parsed. + items: + $ref: '#/components/schemas/OpenAPIEndpoint' + type: array + type: object + EntityData: + description: Entity data. + properties: + attributes: + $ref: '#/components/schemas/EntityAttributes' + id: + description: Entity ID. + type: string + meta: + $ref: '#/components/schemas/EntityMeta' + relationships: + $ref: '#/components/schemas/EntityRelationships' + type: + description: Entity. + type: string + type: object + ListEntityCatalogResponseIncludedItem: + description: List entity response included item. + oneOf: + - $ref: '#/components/schemas/EntityResponseIncludedSchema' + - $ref: '#/components/schemas/EntityResponseIncludedRawSchema' + - $ref: '#/components/schemas/EntityResponseIncludedRelatedEntity' + - $ref: '#/components/schemas/EntityResponseIncludedOncall' + - $ref: '#/components/schemas/EntityResponseIncludedIncident' + EntityV3Service: + additionalProperties: false + description: Schema for service entities. + properties: + apiVersion: + $ref: '#/components/schemas/EntityV3APIVersion' + datadog: + $ref: '#/components/schemas/EntityV3ServiceDatadog' + extensions: + additionalProperties: {} + description: >- + Custom extensions. This is the free-formed field to send client-side + metadata. No Datadog features are affected by this field. + type: object + integrations: + $ref: '#/components/schemas/EntityV3Integrations' + kind: + $ref: '#/components/schemas/EntityV3ServiceKind' + metadata: + $ref: '#/components/schemas/EntityV3Metadata' + spec: + $ref: '#/components/schemas/EntityV3ServiceSpec' + required: + - apiVersion + - kind + - metadata + type: object + EntityV3Datastore: + additionalProperties: false + description: Schema for datastore entities. + properties: + apiVersion: + $ref: '#/components/schemas/EntityV3APIVersion' + datadog: + $ref: '#/components/schemas/EntityV3DatastoreDatadog' + extensions: + additionalProperties: {} + description: >- + Custom extensions. This is the free-formed field to send client side + metadata. No Datadog features are affected by this field. + type: object + integrations: + $ref: '#/components/schemas/EntityV3Integrations' + kind: + $ref: '#/components/schemas/EntityV3DatastoreKind' + metadata: + $ref: '#/components/schemas/EntityV3Metadata' + spec: + $ref: '#/components/schemas/EntityV3DatastoreSpec' + required: + - apiVersion + - kind + - metadata + type: object + EntityV3Queue: + additionalProperties: false + description: Schema for queue entities. + properties: + apiVersion: + $ref: '#/components/schemas/EntityV3APIVersion' + datadog: + $ref: '#/components/schemas/EntityV3QueueDatadog' + extensions: + additionalProperties: {} + description: >- + Custom extensions. This is the free-formed field to send client-side + metadata. No Datadog features are affected by this field. + type: object + integrations: + $ref: '#/components/schemas/EntityV3Integrations' + kind: + $ref: '#/components/schemas/EntityV3QueueKind' + metadata: + $ref: '#/components/schemas/EntityV3Metadata' + spec: + $ref: '#/components/schemas/EntityV3QueueSpec' + required: + - apiVersion + - kind + - metadata + type: object + EntityV3System: + additionalProperties: false + description: Schema for system entities. + properties: + apiVersion: + $ref: '#/components/schemas/EntityV3APIVersion' + datadog: + $ref: '#/components/schemas/EntityV3SystemDatadog' + extensions: + additionalProperties: {} + description: >- + Custom extensions. This is the free-formed field to send client-side + metadata. No Datadog features are affected by this field. + type: object + integrations: + $ref: '#/components/schemas/EntityV3Integrations' + kind: + $ref: '#/components/schemas/EntityV3SystemKind' + metadata: + $ref: '#/components/schemas/EntityV3Metadata' + spec: + $ref: '#/components/schemas/EntityV3SystemSpec' + required: + - apiVersion + - kind + - metadata + type: object + EntityV3API: + additionalProperties: false + description: Schema for API entities. + properties: + apiVersion: + $ref: '#/components/schemas/EntityV3APIVersion' + datadog: + $ref: '#/components/schemas/EntityV3APIDatadog' + extensions: + additionalProperties: {} + description: >- + Custom extensions. This is the free-formed field to send client-side + metadata. No Datadog features are affected by this field. + type: object + integrations: + $ref: '#/components/schemas/EntityV3Integrations' + kind: + $ref: '#/components/schemas/EntityV3APIKind' + metadata: + $ref: '#/components/schemas/EntityV3Metadata' + spec: + $ref: '#/components/schemas/EntityV3APISpec' + required: + - apiVersion + - kind + - metadata + type: object + UpsertCatalogEntityResponseIncludedItem: + description: Upsert entity response included item. + oneOf: + - $ref: '#/components/schemas/EntityResponseIncludedSchema' + KindData: + description: >- + Schema that defines the structure of a Kind object in the Software + Catalog. + properties: + attributes: + $ref: '#/components/schemas/KindAttributes' + id: + description: >- + A read-only globally unique identifier for the entity generated by + Datadog. User supplied values are ignored. + example: 4b163705-23c0-4573-b2fb-f6cea2163fcb + minLength: 1 + type: string + meta: + $ref: '#/components/schemas/KindMetadata' + type: + description: Kind. + type: string + type: object + RelationResponse: + description: Relation response data. + properties: + attributes: + $ref: '#/components/schemas/RelationAttributes' + id: + description: Relation ID. + type: string + meta: + $ref: '#/components/schemas/RelationMeta' + relationships: + $ref: '#/components/schemas/RelationRelationships' + subtype: + description: Relation subtype. + type: string + type: + $ref: '#/components/schemas/RelationResponseType' + type: object + OpenAPIEndpoint: + description: Endpoint info extracted from an `OpenAPI` specification. + properties: + method: + description: The endpoint method. + type: string + path: + description: The endpoint path. + type: string + type: object + EntityAttributes: + description: Entity attributes. + properties: + apiVersion: + description: The API version. + type: string + description: + description: The description. + type: string + displayName: + description: The display name. + type: string + kind: + description: The kind. + type: string + name: + description: The name. + type: string + namespace: + description: The namespace. + type: string + owner: + description: The owner. + type: string + tags: + description: The tags. + items: + type: string + type: array + type: object + EntityMeta: + description: Entity metadata. + properties: + createdAt: + description: The creation time. + type: string + ingestionSource: + description: The ingestion source. + type: string + modifiedAt: + description: The modification time. + type: string + origin: + description: The origin. + type: string + type: object + EntityRelationships: + description: Entity relationships. + properties: + incidents: + $ref: '#/components/schemas/EntityToIncidents' + oncall: + $ref: '#/components/schemas/EntityToOncalls' + rawSchema: + $ref: '#/components/schemas/EntityToRawSchema' + relatedEntities: + $ref: '#/components/schemas/EntityToRelatedEntities' + schema: + $ref: '#/components/schemas/EntityToSchema' + type: object + EntityResponseIncludedSchema: + description: Included detail entity schema. + properties: + attributes: + $ref: '#/components/schemas/EntityResponseIncludedSchemaAttributes' + id: + description: Entity ID. + type: string + type: + $ref: '#/components/schemas/EntityResponseIncludedSchemaType' + type: object + EntityResponseIncludedRawSchema: + description: Included raw schema. + properties: + attributes: + $ref: '#/components/schemas/EntityResponseIncludedRawSchemaAttributes' + id: + description: Raw schema ID. + type: string + type: + $ref: '#/components/schemas/EntityResponseIncludedRawSchemaType' + type: object + EntityResponseIncludedRelatedEntity: + description: Included related entity. + properties: + attributes: + $ref: '#/components/schemas/EntityResponseIncludedRelatedEntityAttributes' + id: + description: Entity UUID. + type: string + meta: + $ref: '#/components/schemas/EntityResponseIncludedRelatedEntityMeta' + type: + $ref: '#/components/schemas/EntityResponseIncludedRelatedEntityType' + type: object + EntityResponseIncludedOncall: + description: Included oncall. + properties: + attributes: + $ref: '#/components/schemas/EntityResponseIncludedRelatedOncallAttributes' + id: + description: Oncall ID. + type: string + type: + $ref: '#/components/schemas/EntityResponseIncludedOncallType' + type: object + EntityResponseIncludedIncident: + description: Included incident. + properties: + attributes: + $ref: '#/components/schemas/EntityResponseIncludedRelatedIncidentAttributes' + id: + description: Incident ID. + type: string + type: + $ref: '#/components/schemas/EntityResponseIncludedIncidentType' + type: object + EntityV3APIVersion: + description: >- + The version of the schema data that was used to populate this entity's + data. This could be via the API, Terraform, or YAML file in a + repository. The field is known as schema-version in the previous + version. + enum: + - v3 + - v2.2 + - v2.1 + - v2 + example: v3 + type: string + x-enum-varnames: + - V3 + - V2_2 + - V2_1 + - V2 + EntityV3ServiceDatadog: + additionalProperties: false + description: Datadog product integrations for the service entity. + properties: + codeLocations: + $ref: '#/components/schemas/EntityV3DatadogCodeLocations' + events: + $ref: '#/components/schemas/EntityV3DatadogEvents' + logs: + $ref: '#/components/schemas/EntityV3DatadogLogs' + performanceData: + $ref: '#/components/schemas/EntityV3DatadogPerformance' + pipelines: + $ref: '#/components/schemas/EntityV3DatadogPipelines' + type: object + EntityV3Integrations: + additionalProperties: false + description: A base schema for defining third-party integrations. + properties: + opsgenie: + $ref: '#/components/schemas/EntityV3DatadogIntegrationOpsgenie' + pagerduty: + $ref: '#/components/schemas/EntityV3DatadogIntegrationPagerduty' + type: object + EntityV3ServiceKind: + description: The definition of Entity V3 Service Kind object. + enum: + - service + example: service + type: string + x-enum-varnames: + - SERVICE + EntityV3Metadata: + additionalProperties: false + description: The definition of Entity V3 Metadata object. + properties: + additionalOwners: + additionalProperties: false + description: The additional owners of the entity, usually a team. + items: + $ref: '#/components/schemas/EntityV3MetadataAdditionalOwnersItems' + type: array + contacts: + additionalProperties: false + description: A list of contacts for the entity. + items: + $ref: '#/components/schemas/EntityV3MetadataContactsItems' + type: array + description: + description: >- + Short description of the entity. The UI can leverage the description + for display. + type: string + displayName: + description: >- + User friendly name of the entity. The UI can leverage the display + name for display. + type: string + id: + description: >- + A read-only globally unique identifier for the entity generated by + Datadog. User supplied values are ignored. + example: 4b163705-23c0-4573-b2fb-f6cea2163fcb + minLength: 1 + type: string + inheritFrom: + description: The entity reference from which to inherit metadata + example: application:default/myapp + type: string + links: + additionalProperties: false + description: A list of links for the entity. + items: + $ref: '#/components/schemas/EntityV3MetadataLinksItems' + type: array + managed: + additionalProperties: {} + description: >- + A read-only set of Datadog managed attributes generated by Datadog. + User supplied values are ignored. + type: object + name: + description: Unique name given to an entity under the kind/namespace. + example: myService + minLength: 1 + type: string + namespace: + description: >- + Namespace is a part of unique identifier. It has a default value of + 'default'. + example: default + minLength: 1 + type: string + owner: + description: The owner of the entity, usually a team. + type: string + tags: + description: A set of custom tags. + example: + - this:tag + - that:tag + items: + type: string + type: array + required: + - name + type: object + EntityV3ServiceSpec: + additionalProperties: false + description: The definition of Entity V3 Service Spec object. + properties: + componentOf: + description: A list of components the service is a part of + items: + type: string + type: array + dependsOn: + description: A list of components the service depends on. + items: + type: string + type: array + languages: + description: The service's programming language. + items: + type: string + type: array + lifecycle: + description: The lifecycle state of the component. + minLength: 1 + type: string + tier: + description: The importance of the component. + minLength: 1 + type: string + type: + description: The type of service. + type: string + type: object + EntityV3DatastoreDatadog: + additionalProperties: false + description: Datadog product integrations for the datastore entity. + properties: + events: + $ref: '#/components/schemas/EntityV3DatadogEvents' + logs: + $ref: '#/components/schemas/EntityV3DatadogLogs' + performanceData: + $ref: '#/components/schemas/EntityV3DatadogPerformance' + type: object + EntityV3DatastoreKind: + description: The definition of Entity V3 Datastore Kind object. + enum: + - datastore + example: datastore + type: string + x-enum-varnames: + - DATASTORE + EntityV3DatastoreSpec: + additionalProperties: false + description: The definition of Entity V3 Datastore Spec object. + properties: + componentOf: + description: A list of components the datastore is a part of + items: + type: string + type: array + lifecycle: + description: The lifecycle state of the datastore. + minLength: 1 + type: string + tier: + description: The importance of the datastore. + minLength: 1 + type: string + type: + description: The type of datastore. + type: string + type: object + EntityV3QueueDatadog: + additionalProperties: false + description: Datadog product integrations for the datastore entity. + properties: + events: + $ref: '#/components/schemas/EntityV3DatadogEvents' + logs: + $ref: '#/components/schemas/EntityV3DatadogLogs' + performanceData: + $ref: '#/components/schemas/EntityV3DatadogPerformance' + type: object + EntityV3QueueKind: + description: The definition of Entity V3 Queue Kind object. + enum: + - queue + example: queue + type: string + x-enum-varnames: + - QUEUE + EntityV3QueueSpec: + additionalProperties: false + description: The definition of Entity V3 Queue Spec object. + properties: + componentOf: + description: A list of components the queue is a part of + items: + type: string + type: array + lifecycle: + description: The lifecycle state of the queue. + minLength: 1 + type: string + tier: + description: The importance of the queue. + minLength: 1 + type: string + type: + description: The type of queue. + type: string + type: object + EntityV3SystemDatadog: + additionalProperties: false + description: Datadog product integrations for the service entity. + properties: + events: + $ref: '#/components/schemas/EntityV3DatadogEvents' + logs: + $ref: '#/components/schemas/EntityV3DatadogLogs' + performanceData: + $ref: '#/components/schemas/EntityV3DatadogPerformance' + pipelines: + $ref: '#/components/schemas/EntityV3DatadogPipelines' + type: object + EntityV3SystemKind: + description: The definition of Entity V3 System Kind object. + enum: + - system + example: system + type: string + x-enum-varnames: + - SYSTEM + EntityV3SystemSpec: + additionalProperties: false + description: The definition of Entity V3 System Spec object. + properties: + components: + description: A list of components belongs to the system. + items: + type: string + type: array + lifecycle: + description: The lifecycle state of the component. + minLength: 1 + type: string + tier: + description: An entity reference to the owner of the component. + minLength: 1 + type: string + type: object + EntityV3APIDatadog: + additionalProperties: false + description: Datadog product integrations for the API entity. + properties: + codeLocations: + $ref: '#/components/schemas/EntityV3DatadogCodeLocations' + events: + $ref: '#/components/schemas/EntityV3DatadogEvents' + logs: + $ref: '#/components/schemas/EntityV3DatadogLogs' + performanceData: + $ref: '#/components/schemas/EntityV3DatadogPerformance' + pipelines: + $ref: '#/components/schemas/EntityV3DatadogPipelines' + type: object + EntityV3APIKind: + description: The definition of Entity V3 API Kind object. + enum: + - api + example: api + type: string + x-enum-varnames: + - API + EntityV3APISpec: + additionalProperties: false + description: The definition of Entity V3 API Spec object. + properties: + implementedBy: + description: Services which implemented the API. + items: + type: string + type: array + interface: + $ref: '#/components/schemas/EntityV3APISpecInterface' + lifecycle: + description: The lifecycle state of the component. + minLength: 1 + type: string + tier: + description: The importance of the component. + minLength: 1 + type: string + type: + description: The type of API. + type: string + type: object + KindAttributes: + description: Kind attributes. + properties: + description: + description: Short description of the kind. + type: string + displayName: + description: User friendly name of the kind. + type: string + name: + description: The kind name. + example: my-job + minLength: 1 + type: string + type: object + KindMetadata: + description: Kind metadata. + properties: + createdAt: + description: The creation time. + type: string + modifiedAt: + description: The modification time. + type: string + type: object + RelationAttributes: + description: Relation attributes. + properties: + from: + $ref: '#/components/schemas/RelationEntity' + to: + $ref: '#/components/schemas/RelationEntity' + type: + $ref: '#/components/schemas/RelationType' + type: object + RelationMeta: + description: Relation metadata. + properties: + createdAt: + description: Relation creation time. + format: date-time + type: string + definedBy: + description: Relation defined by. + type: string + modifiedAt: + description: Relation modification time. + format: date-time + type: string + source: + description: Relation source. + type: string + type: object + RelationRelationships: + description: Relation relationships. + properties: + fromEntity: + $ref: '#/components/schemas/RelationToEntity' + toEntity: + $ref: '#/components/schemas/RelationToEntity' + type: object + RelationResponseType: + description: Relation type. + enum: + - relation + type: string + x-enum-varnames: + - RELATION + EntityToIncidents: + description: Entity to incidents relationship. + properties: + data: + $ref: '#/components/schemas/RelationshipArray' + type: object + EntityToOncalls: + description: Entity to oncalls relationship. + properties: + data: + $ref: '#/components/schemas/RelationshipArray' + type: object + EntityToRawSchema: + description: Entity to raw schema relationship. + properties: + data: + $ref: '#/components/schemas/RelationshipItem' + type: object + EntityToRelatedEntities: + description: Entity to related entities relationship. + properties: + data: + $ref: '#/components/schemas/RelationshipArray' + type: object + EntityToSchema: + description: Entity to detail schema relationship. + properties: + data: + $ref: '#/components/schemas/RelationshipItem' + type: object + EntityResponseIncludedSchemaAttributes: + description: Included schema. + properties: + schema: + $ref: '#/components/schemas/EntityV3' + type: object + EntityResponseIncludedSchemaType: + description: Schema type. + enum: + - schema + type: string + x-enum-varnames: + - SCHEMA + EntityResponseIncludedRawSchemaAttributes: + description: Included raw schema attributes. + properties: + rawSchema: + description: Schema from user input in base64 encoding. + type: string + type: object + EntityResponseIncludedRawSchemaType: + description: Raw schema type. + enum: + - rawSchema + type: string + x-enum-varnames: + - RAW_SCHEMA + EntityResponseIncludedRelatedEntityAttributes: + description: Related entity attributes. + properties: + kind: + description: Entity kind. + type: string + name: + description: Entity name. + type: string + namespace: + description: Entity namespace. + type: string + type: + description: Entity relation type to the associated entity. + type: string + type: object + EntityResponseIncludedRelatedEntityMeta: + description: Included related entity meta. + properties: + createdAt: + description: Entity creation time. + format: date-time + type: string + defined_by: + description: Entity relation defined by. + type: string + modifiedAt: + description: Entity modification time. + format: date-time + type: string + source: + description: Entity relation source. + type: string + type: object + EntityResponseIncludedRelatedEntityType: + description: Related entity. + enum: + - relatedEntity + type: string + x-enum-varnames: + - RELATED_ENTITY + EntityResponseIncludedRelatedOncallAttributes: + description: Included related oncall attributes. + properties: + escalations: + $ref: '#/components/schemas/EntityResponseIncludedRelatedOncallEscalations' + provider: + description: Oncall provider. + type: string + type: object + EntityResponseIncludedOncallType: + description: Oncall type. + enum: + - oncall + type: string + x-enum-varnames: + - ONCALL + EntityResponseIncludedRelatedIncidentAttributes: + description: Incident attributes. + properties: + createdAt: + description: Incident creation time. + format: date-time + type: string + htmlURL: + description: Incident URL. + type: string + provider: + description: Incident provider. + type: string + status: + description: Incident status. + type: string + title: + description: Incident title. + type: string + type: object + EntityResponseIncludedIncidentType: + description: Incident description. + enum: + - incident + type: string + x-enum-varnames: + - INCIDENT + EntityV3DatadogCodeLocations: + additionalProperties: false + description: Schema for mapping source code locations to an entity. + items: + $ref: '#/components/schemas/EntityV3DatadogCodeLocationItem' + type: array + EntityV3DatadogEvents: + additionalProperties: false + description: Events associations. + items: + $ref: '#/components/schemas/EntityV3DatadogEventItem' + type: array + EntityV3DatadogLogs: + additionalProperties: false + description: Logs association. + items: + $ref: '#/components/schemas/EntityV3DatadogLogItem' + type: array + EntityV3DatadogPerformance: + additionalProperties: false + description: Performance stats association. + properties: + tags: + description: >- + A list of APM entity tags that associates the APM Stats data with + the entity. + items: + type: string + type: array + type: object + EntityV3DatadogPipelines: + additionalProperties: false + description: CI Pipelines association. + properties: + fingerprints: + description: >- + A list of CI Fingerprints that associate CI Pipelines with the + entity. + items: + type: string + type: array + type: object + EntityV3DatadogIntegrationOpsgenie: + additionalProperties: false + description: An Opsgenie integration schema. + properties: + region: + description: The region for the Opsgenie integration. + minLength: 1 + type: string + serviceURL: + description: The service URL for the Opsgenie integration. + example: https://www.opsgenie.com/service/shopping-cart + minLength: 1 + type: string + required: + - serviceURL + type: object + EntityV3DatadogIntegrationPagerduty: + additionalProperties: false + description: A PagerDuty integration schema. + properties: + serviceURL: + description: The service URL for the PagerDuty integration. + example: https://www.pagerduty.com/service-directory/Pshopping-cart + minLength: 1 + type: string + required: + - serviceURL + type: object + EntityV3MetadataAdditionalOwnersItems: + description: The definition of Entity V3 Metadata Additional Owners Items object. + properties: + name: + description: Team name. + example: '' + type: string + type: + description: Team type. + type: string + required: + - name + type: object + EntityV3MetadataContactsItems: + additionalProperties: false + description: The definition of Entity V3 Metadata Contacts Items object. + properties: + contact: + description: Contact value. + example: https://slack/ + type: string + name: + description: Contact name. + minLength: 2 + type: string + type: + description: Contact type. + example: slack + type: string + required: + - type + - contact + type: object + EntityV3MetadataLinksItems: + additionalProperties: false + description: The definition of Entity V3 Metadata Links Items object. + properties: + name: + description: Link name. + example: mylink + type: string + provider: + description: Link provider. + type: string + type: + default: other + description: Link type. + example: link + type: string + url: + description: Link URL. + example: https://mylink + type: string + required: + - name + - type + - url + type: object + EntityV3APISpecInterface: + additionalProperties: false + description: The API definition. + oneOf: + - $ref: '#/components/schemas/EntityV3APISpecInterfaceFileRef' + - $ref: '#/components/schemas/EntityV3APISpecInterfaceDefinition' + RelationEntity: + description: Relation entity reference. + properties: + kind: + description: Entity kind. + type: string + name: + description: Entity name. + type: string + namespace: + description: Entity namespace. + type: string + type: object + RelationToEntity: + description: Relation to entity. + properties: + data: + $ref: '#/components/schemas/RelationshipItem' + meta: + $ref: '#/components/schemas/EntityMeta' + type: object + RelationshipArray: + description: Relationships. + items: + $ref: '#/components/schemas/RelationshipItem' + type: array + RelationshipItem: + description: Relationship entry. + properties: + id: + description: Associated data ID. + type: string + type: + description: Relationship type. + type: string + type: object + EntityResponseIncludedRelatedOncallEscalations: + description: Oncall escalations. + items: + $ref: '#/components/schemas/EntityResponseIncludedRelatedOncallEscalationItem' + type: array + EntityV3DatadogCodeLocationItem: + additionalProperties: false + description: Code location item. + properties: + paths: + description: The paths (glob) to the source code of the service. + items: + type: string + type: array + repositoryURL: + description: The repository path of the source code of the entity. + type: string + type: object + EntityV3DatadogEventItem: + additionalProperties: false + description: Events association item. + properties: + name: + description: The name of the query. + type: string + query: + description: The query to run. + type: string + type: object + EntityV3DatadogLogItem: + additionalProperties: false + description: Log association item. + properties: + name: + description: The name of the query. + type: string + query: + description: The query to run. + type: string + type: object + EntityV3APISpecInterfaceFileRef: + additionalProperties: false + description: The definition of `EntityV3APISpecInterfaceFileRef` object. + properties: + fileRef: + description: The reference to the API definition file. + type: string + type: object + EntityV3APISpecInterfaceDefinition: + additionalProperties: false + description: The definition of `EntityV3APISpecInterfaceDefinition` object. + properties: + definition: + description: The API definition. + type: object + type: object + EntityResponseIncludedRelatedOncallEscalationItem: + description: Oncall escalation. + properties: + email: + description: Oncall email. + type: string + escalationLevel: + description: Oncall level. + format: int64 + type: integer + name: + description: Oncall name. + type: string + type: object + responses: + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + parameters: + PageOffset: + description: Specific offset to use as the beginning of the returned page. + in: query + name: page[offset] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + FilterByID: + description: Filter entities by UUID. + explode: true + in: query + name: filter[id] + required: false + schema: + type: string + FilterByRef: + description: Filter entities by reference + example: service:shopping-cart + explode: true + in: query + name: filter[ref] + required: false + schema: + type: string + FilterByName: + description: Filter entities by name. + explode: true + in: query + name: filter[name] + required: false + schema: + type: string + FilterByKind: + description: Filter entities by kind. + explode: true + in: query + name: filter[kind] + required: false + schema: + type: string + FilterByOwner: + description: Filter entities by owner. + explode: true + in: query + name: filter[owner] + required: false + schema: + type: string + FilterByRelationType: + description: Filter entities by relation type. + explode: true + in: query + name: filter[relation][type] + required: false + schema: + $ref: '#/components/schemas/RelationType' + FilterByExcludeSnapshot: + description: Filter entities by excluding snapshotted entities. + in: query + name: filter[exclude_snapshot] + required: false + schema: + type: string + Include: + description: Include relationship data. + explode: true + in: query + name: include + required: false + schema: + $ref: '#/components/schemas/IncludeType' + EntityID: + description: UUID or Entity Ref. + in: path + name: entity_id + required: true + schema: + example: service:myservice + type: string + KindID: + description: Entity kind. + in: path + name: kind_id + required: true + schema: + example: my-job + type: string + FilterRelationByType: + description: Filter relations by type. + explode: true + in: query + name: filter[type] + required: false + schema: + $ref: '#/components/schemas/RelationType' + FilterRelationByFromRef: + description: Filter relations by the reference of the first entity in the relation. + example: service:shopping-cart + explode: true + in: query + name: filter[from_ref] + required: false + schema: + type: string + FilterRelationByToRef: + description: Filter relations by the reference of the second entity in the relation. + example: service:shopping-cart + explode: true + in: query + name: filter[to_ref] + required: false + schema: + type: string + RelationInclude: + description: Include relationship data. + explode: true + in: query + name: include + required: false + schema: + $ref: '#/components/schemas/RelationIncludeType' + x-stackQL-resources: + apis: + id: datadog.catalog.apis + name: apis + title: Apis + methods: + list_apis: + operation: + $ref: '#/paths/~1api~1v2~1apicatalog~1api/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + delete_open_api: + operation: + $ref: '#/paths/~1api~1v2~1apicatalog~1api~1{id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_open_api: + operation: + $ref: '#/paths/~1api~1v2~1apicatalog~1api~1{id}~1openapi/get' + response: + mediaType: multipart/form-data + openAPIDocKey: '200' + update_open_api: + operation: + $ref: '#/paths/~1api~1v2~1apicatalog~1api~1{id}~1openapi/put' + response: + mediaType: application/json + openAPIDocKey: '200' + create_open_api: + operation: + $ref: '#/paths/~1api~1v2~1apicatalog~1openapi/post' + response: + mediaType: application/json + openAPIDocKey: '201' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/apis/methods/list_apis' + insert: + - $ref: '#/components/x-stackQL-resources/apis/methods/create_open_api' + update: [] + delete: + - $ref: '#/components/x-stackQL-resources/apis/methods/delete_open_api' + replace: + - $ref: '#/components/x-stackQL-resources/apis/methods/update_open_api' + catalog_entities: + id: datadog.catalog.catalog_entities + name: catalog_entities + title: Catalog Entities + methods: + list_catalog_entity: + operation: + $ref: '#/paths/~1api~1v2~1catalog~1entity/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + upsert_catalog_entity: + operation: + $ref: '#/paths/~1api~1v2~1catalog~1entity/post' + response: + mediaType: application/json + openAPIDocKey: '202' + delete_catalog_entity: + operation: + $ref: '#/paths/~1api~1v2~1catalog~1entity~1{entity_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/catalog_entities/methods/list_catalog_entity + insert: + - $ref: >- + #/components/x-stackQL-resources/catalog_entities/methods/upsert_catalog_entity + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/catalog_entities/methods/delete_catalog_entity + replace: [] + catalog_kinds: + id: datadog.catalog.catalog_kinds + name: catalog_kinds + title: Catalog Kinds + methods: + list_catalog_kind: + operation: + $ref: '#/paths/~1api~1v2~1catalog~1kind/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + upsert_catalog_kind: + operation: + $ref: '#/paths/~1api~1v2~1catalog~1kind/post' + response: + mediaType: application/json + openAPIDocKey: '202' + delete_catalog_kind: + operation: + $ref: '#/paths/~1api~1v2~1catalog~1kind~1{kind_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/catalog_kinds/methods/list_catalog_kind + insert: + - $ref: >- + #/components/x-stackQL-resources/catalog_kinds/methods/upsert_catalog_kind + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/catalog_kinds/methods/delete_catalog_kind + replace: [] + catalog_relations: + id: datadog.catalog.catalog_relations + name: catalog_relations + title: Catalog Relations + methods: + list_catalog_relation: + operation: + $ref: '#/paths/~1api~1v2~1catalog~1relation/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/catalog_relations/methods/list_catalog_relation + insert: [] + update: [] + delete: [] + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/ci_visibility.yaml b/providers/src/datadog/v00.00.00000/services/ci_visibility.yaml deleted file mode 100644 index 767a65a1..00000000 --- a/providers/src/datadog/v00.00.00000/services/ci_visibility.yaml +++ /dev/null @@ -1,2685 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - ci_visibility - description: CI_Visibility_Pipelines -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - CIAppCreatePipelineEventRequest: - description: Request object. - properties: - data: - $ref: '#/components/schemas/CIAppCreatePipelineEventRequestData' - type: object - HTTPCIAppErrors: - description: Errors occurred. - properties: - errors: - description: Structured errors. - items: - $ref: '#/components/schemas/HTTPCIAppError' - type: array - type: object - CIAppCreatePipelineEventRequestData: - description: Data of the pipeline event to create. - properties: - attributes: - $ref: '#/components/schemas/CIAppCreatePipelineEventRequestAttributes' - type: - $ref: '#/components/schemas/CIAppCreatePipelineEventRequestDataType' - type: object - HTTPCIAppError: - description: List of errors. - properties: - detail: - description: Error message. - example: Malformed payload - type: string - status: - description: Error code. - example: '400' - type: string - title: - description: Error title. - example: Bad Request - type: string - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - CIAppCreatePipelineEventRequestAttributes: - description: Attributes of the pipeline event to create. - properties: - env: - description: The Datadog environment. - type: string - resource: - $ref: '#/components/schemas/CIAppCreatePipelineEventRequestAttributesResource' - service: - description: 'If the CI provider is SaaS, use this to differentiate between instances.' - type: string - required: - - resource - type: object - CIAppCreatePipelineEventRequestDataType: - default: cipipeline_resource_request - description: Type of the event. - enum: - - cipipeline_resource_request - example: cipipeline_resource_request - type: string - x-enum-varnames: - - CIPIPELINE_RESOURCE_REQUEST - CIAppCreatePipelineEventRequestAttributesResource: - description: Details of the CI pipeline event. - example: Details TBD - oneOf: - - $ref: '#/components/schemas/CIAppPipelineEventPipeline' - - $ref: '#/components/schemas/CIAppPipelineEventStage' - - $ref: '#/components/schemas/CIAppPipelineEventJob' - - $ref: '#/components/schemas/CIAppPipelineEventStep' - CIAppPipelineEventPipeline: - description: 'Details of the top level pipeline, build, or workflow of your CI.' - properties: - end: - description: Time when the pipeline run finished. It cannot be older than 18 hours in the past from the current time. The time format must be RFC3339. - example: '2023-05-31T15:30:00Z' - format: date-time - type: string - error: - $ref: '#/components/schemas/CIAppCIError' - git: - $ref: '#/components/schemas/CIAppGitInfo' - is_manual: - description: Whether or not the pipeline was triggered manually by the user. - example: false - nullable: true - type: boolean - is_resumed: - description: Whether or not the pipeline was resumed after being blocked. - example: false - nullable: true - type: boolean - level: - $ref: '#/components/schemas/CIAppPipelineEventPipelineLevel' - metrics: - $ref: '#/components/schemas/CIAppPipelineEventMetrics' - name: - description: Name of the pipeline. All pipeline runs for the builds should have the same name. - example: Deploy to AWS - type: string - node: - $ref: '#/components/schemas/CIAppHostInfo' - parameters: - $ref: '#/components/schemas/CIAppPipelineEventParameters' - parent_pipeline: - $ref: '#/components/schemas/CIAppPipelineEventParentPipeline' - partial_retry: - description: |- - Whether or not the pipeline was a partial retry of a previous attempt. A partial retry is one - which only runs a subset of the original jobs. - example: false - type: boolean - pipeline_id: - description: |- - Any ID used in the provider to identify the pipeline run even if it is not unique across retries. - If the `pipeline_id` is unique, then both `unique_id` and `pipeline_id` can be set to the same value. - example: '#023' - type: string - previous_attempt: - $ref: '#/components/schemas/CIAppPipelineEventPreviousPipeline' - queue_time: - description: 'The queue time in milliseconds, if applicable.' - example: 1004 - format: int64 - minimum: 0 - nullable: true - type: integer - start: - description: Time when the pipeline run started (it should not include any queue time). The time format must be RFC3339. - example: '2023-05-31T15:30:00Z' - format: date-time - type: string - status: - $ref: '#/components/schemas/CIAppPipelineEventPipelineStatus' - tags: - $ref: '#/components/schemas/CIAppPipelineEventTags' - unique_id: - description: |- - UUID of the pipeline run. The ID has to be unique across retries and pipelines, - including partial retries. - example: 3eacb6f3-ff04-4e10-8a9c-46e6d054024a - type: string - url: - description: The URL to look at the pipeline in the CI provider UI. - example: 'https://my-ci-provider.example/pipelines/my-pipeline/run/1' - type: string - required: - - level - - unique_id - - name - - url - - start - - end - - status - - partial_retry - type: object - CIAppPipelineEventStage: - description: Details of a CI stage. - properties: - dependencies: - description: A list of stage IDs that this stage depends on. - example: - - f7e6a006-a029-46c3-b0cc-742c9d7d363b - - c8a69849-3c3b-4721-8b33-3e8ec2df1ebe - items: - description: A list of stage IDs. - type: string - nullable: true - type: array - end: - description: Time when the stage run finished. The time format must be RFC3339. - example: '2023-05-31T15:30:00Z' - format: date-time - type: string - error: - $ref: '#/components/schemas/CIAppCIError' - git: - $ref: '#/components/schemas/CIAppGitInfo' - id: - description: UUID for the stage. It has to be unique at least in the pipeline scope. - example: 562bdbbb-7cab-48c8-851c-b24ca14628bf - type: string - level: - $ref: '#/components/schemas/CIAppPipelineEventStageLevel' - metrics: - $ref: '#/components/schemas/CIAppPipelineEventMetrics' - name: - description: The name for the stage. - example: build - type: string - node: - $ref: '#/components/schemas/CIAppHostInfo' - parameters: - $ref: '#/components/schemas/CIAppPipelineEventParameters' - pipeline_name: - description: The parent pipeline name. - example: Build - type: string - pipeline_unique_id: - description: The parent pipeline UUID. - example: 76b572af-a078-42b2-a08a-cc28f98b944f - type: string - queue_time: - description: 'The queue time in milliseconds, if applicable.' - example: 1004 - format: int64 - minimum: 0 - nullable: true - type: integer - start: - description: Time when the stage run started (it should not include any queue time). The time format must be RFC3339. - example: '2023-05-31T15:30:00Z' - format: date-time - type: string - status: - $ref: '#/components/schemas/CIAppPipelineEventStageStatus' - tags: - $ref: '#/components/schemas/CIAppPipelineEventTags' - required: - - level - - id - - name - - pipeline_unique_id - - pipeline_name - - start - - end - - status - type: object - CIAppPipelineEventJob: - description: Details of a CI job. - properties: - dependencies: - description: A list of job IDs that this job depends on. - example: - - f7e6a006-a029-46c3-b0cc-742c9d7d363b - - c8a69849-3c3b-4721-8b33-3e8ec2df1ebe - items: - description: A list of job IDs. - type: string - nullable: true - type: array - end: - description: Time when the job run finished. The time format must be RFC3339. - example: '2023-05-31T15:30:00Z' - format: date-time - type: string - error: - $ref: '#/components/schemas/CIAppCIError' - git: - $ref: '#/components/schemas/CIAppGitInfo' - id: - description: The UUID for the job. It has to be unique within each pipeline execution. - example: c865bad4-de82-44b8-ade7-2c987528eb54 - type: string - level: - $ref: '#/components/schemas/CIAppPipelineEventJobLevel' - metrics: - $ref: '#/components/schemas/CIAppPipelineEventMetrics' - name: - description: The name for the job. - example: test - type: string - node: - $ref: '#/components/schemas/CIAppHostInfo' - parameters: - $ref: '#/components/schemas/CIAppPipelineEventParameters' - pipeline_name: - description: The parent pipeline name. - example: Build - type: string - pipeline_unique_id: - description: The parent pipeline UUID. - example: 76b572af-a078-42b2-a08a-cc28f98b944f - type: string - queue_time: - description: 'The queue time in milliseconds, if applicable.' - example: 1004 - format: int64 - minimum: 0 - nullable: true - type: integer - stage_id: - description: The parent stage UUID (if applicable). - nullable: true - type: string - stage_name: - description: The parent stage name (if applicable). - nullable: true - type: string - start: - description: Time when the job run instance started (it should not include any queue time). The time format must be RFC3339. - example: '2023-05-31T15:30:00Z' - format: date-time - type: string - status: - $ref: '#/components/schemas/CIAppPipelineEventJobStatus' - tags: - $ref: '#/components/schemas/CIAppPipelineEventTags' - url: - description: The URL to look at the job in the CI provider UI. - example: 'https://ci-platform.com/job/your-job-name/build/123' - type: string - required: - - level - - id - - name - - pipeline_unique_id - - pipeline_name - - start - - end - - status - - url - type: object - CIAppPipelineEventStep: - description: Details of a CI step. - properties: - end: - description: Time when the step run finished. The time format must be RFC3339. - example: '2023-05-31T15:30:00Z' - format: date-time - type: string - error: - $ref: '#/components/schemas/CIAppCIError' - git: - $ref: '#/components/schemas/CIAppGitInfo' - id: - description: UUID for the step. It has to be unique within each pipeline execution. - example: c2d517a8-4f3a-4b41-b4ae-69df0c864c79 - type: string - job_id: - description: The parent job UUID (if applicable). - nullable: true - type: string - job_name: - description: The parent job name (if applicable). - nullable: true - type: string - level: - $ref: '#/components/schemas/CIAppPipelineEventStepLevel' - metrics: - $ref: '#/components/schemas/CIAppPipelineEventMetrics' - name: - description: The name for the step. - example: test-server - type: string - node: - $ref: '#/components/schemas/CIAppHostInfo' - parameters: - $ref: '#/components/schemas/CIAppPipelineEventParameters' - pipeline_name: - description: The parent pipeline name. - example: Build - type: string - pipeline_unique_id: - description: The parent pipeline UUID. - example: 76b572af-a078-42b2-a08a-cc28f98b944f - type: string - stage_id: - description: The parent stage UUID (if applicable). - nullable: true - type: string - stage_name: - description: The parent stage name (if applicable). - nullable: true - type: string - start: - description: Time when the step run started. The time format must be RFC3339. - example: '2023-05-31T15:30:00Z' - format: date-time - type: string - status: - $ref: '#/components/schemas/CIAppPipelineEventStepStatus' - tags: - $ref: '#/components/schemas/CIAppPipelineEventTags' - url: - description: The URL to look at the step in the CI provider UI. - nullable: true - type: string - required: - - level - - id - - name - - pipeline_unique_id - - pipeline_name - - start - - end - - status - type: object - CIAppCIError: - description: Contains information of the CI error. - nullable: true - properties: - domain: - $ref: '#/components/schemas/CIAppCIErrorDomain' - message: - description: Error message. - maxLength: 5000 - nullable: true - type: string - stack: - description: The stack trace of the reported errors. - nullable: true - type: string - type: - description: Short description of the error type. - maxLength: 100 - nullable: true - type: string - type: object - CIAppGitInfo: - description: |- - If pipelines are triggered due to actions to a Git repository, then all payloads must contain this. - Note that either `tag` or `branch` has to be provided, but not both. - nullable: true - properties: - author_email: - description: The commit author email. - example: author@example.com - format: email - type: string - author_name: - description: The commit author name. - example: John Doe - nullable: true - type: string - author_time: - description: The commit author timestamp in RFC3339 format. - example: '2023-05-31T15:30:00Z' - nullable: true - type: string - branch: - description: The branch name (if a tag use the tag parameter). - example: feature-1 - nullable: true - type: string - commit_time: - description: The commit timestamp in RFC3339 format. - example: '2023-05-31T15:30:00Z' - nullable: true - type: string - committer_email: - description: The committer email. - example: committer@example.com - format: email - nullable: true - type: string - committer_name: - description: The committer name. - nullable: true - type: string - default_branch: - description: The Git repository's default branch. - example: main - nullable: true - type: string - message: - description: The commit message. - example: Instrumenting tests with CI Visibility. - nullable: true - type: string - repository_url: - description: The URL of the repository. - example: 'https://github.com/username/repository' - type: string - sha: - description: The git commit SHA. - example: da39a3ee5e6b4b0d3255bfef95601890afd80709 - pattern: '^[a-fA-F0-9]{40}$' - type: string - tag: - description: The tag name (if a branch use the branch parameter). - example: v1.0.0 - nullable: true - type: string - required: - - repository_url - - sha - - author_email - type: object - CIAppPipelineEventPipelineLevel: - default: pipeline - description: 'Used to distinguish between pipelines, stages, jobs, and steps.' - enum: - - pipeline - example: pipeline - type: string - x-enum-varnames: - - PIPELINE - CIAppPipelineEventMetrics: - description: 'A list of user-defined metrics. The metrics must follow the `key:value` pattern and the value must be numeric.' - example: - - 'bundle_size:370' - - 'build_time:50021' - items: - description: 'Metrics in the form of `key:value`. The value needs to be numeric.' - type: string - nullable: true - type: array - CIAppHostInfo: - description: 'Contains information of the host running the pipeline, stage, job, or step.' - nullable: true - properties: - hostname: - description: FQDN of the host. - example: www.example.com - type: string - labels: - description: A list of labels used to select or identify the node. - example: - - ubuntu-18.04 - - n2.large - items: - type: string - type: array - name: - description: Name for the host. - type: string - workspace: - description: The path where the code is checked out. - example: /home/workspace/code/my-repo - type: string - type: object - CIAppPipelineEventParameters: - additionalProperties: - type: string - description: A map of key-value parameters or environment variables that were defined for the pipeline. - example: - LOG_LEVEL: debug - nullable: true - type: object - CIAppPipelineEventParentPipeline: - description: 'If the pipeline is triggered as child of another pipeline, this should contain the details of the parent pipeline.' - nullable: true - properties: - id: - description: UUID of a pipeline. - example: 93bfeb70-af47-424d-908a-948d3f08e37f - type: string - url: - description: The URL to look at the pipeline in the CI provider UI. - example: 'https://ci-platform.com/pipelines/123456789' - type: string - required: - - id - type: object - CIAppPipelineEventPreviousPipeline: - description: 'If the pipeline is a retry, this should contain the details of the previous attempt.' - nullable: true - properties: - id: - description: UUID of a pipeline. - example: 93bfeb70-af47-424d-908a-948d3f08e37f - type: string - url: - description: The URL to look at the pipeline in the CI provider UI. - example: 'https://ci-platform.com/pipelines/123456789' - type: string - required: - - id - type: object - CIAppPipelineEventPipelineStatus: - description: The final status of the pipeline. - enum: - - success - - error - - canceled - - skipped - - blocked - example: success - type: string - x-enum-varnames: - - SUCCESS - - ERROR - - CANCELED - - SKIPPED - - BLOCKED - CIAppPipelineEventTags: - description: 'A list of user-defined tags. The tags must follow the `key:value` pattern.' - example: - - 'team:backend' - - 'type:deployment' - items: - description: 'Tags in the form of `key:value`.' - type: string - nullable: true - type: array - CIAppPipelineEventStageLevel: - default: stage - description: 'Used to distinguish between pipelines, stages, jobs and steps.' - enum: - - stage - example: stage - type: string - x-enum-varnames: - - STAGE - CIAppPipelineEventStageStatus: - description: The final status of the stage. - enum: - - success - - error - - canceled - - skipped - example: success - type: string - x-enum-varnames: - - SUCCESS - - ERROR - - CANCELED - - SKIPPED - CIAppPipelineEventJobLevel: - default: job - description: 'Used to distinguish between pipelines, stages, jobs, and steps.' - enum: - - job - example: job - type: string - x-enum-varnames: - - JOB - CIAppPipelineEventJobStatus: - description: The final status of the job. - enum: - - success - - error - - canceled - - skipped - example: success - type: string - x-enum-varnames: - - SUCCESS - - ERROR - - CANCELED - - SKIPPED - CIAppPipelineEventStepLevel: - default: step - description: 'Used to distinguish between pipelines, stages, jobs and steps.' - enum: - - step - example: step - type: string - x-enum-varnames: - - STEP - CIAppPipelineEventStepStatus: - description: The final status of the step. - enum: - - success - - error - example: success - type: string - x-enum-varnames: - - SUCCESS - - ERROR - CIAppCIErrorDomain: - description: Error category used to differentiate between issues related to the developer or provider environments. - enum: - - provider - - user - - unknown - type: string - x-enum-varnames: - - PROVIDER - - USER - - UNKNOWN - CIAppPipelinesAggregateRequest: - description: The object sent with the request to retrieve aggregation buckets of pipeline events from your organization. - properties: - compute: - description: The list of metrics or timeseries to compute for the retrieved buckets. - items: - $ref: '#/components/schemas/CIAppCompute' - type: array - filter: - $ref: '#/components/schemas/CIAppPipelinesQueryFilter' - group_by: - description: The rules for the group-by. - items: - $ref: '#/components/schemas/CIAppPipelinesGroupBy' - type: array - options: - $ref: '#/components/schemas/CIAppQueryOptions' - type: object - CIAppPipelinesAnalyticsAggregateResponse: - description: The response object for the pipeline events aggregate API endpoint. - properties: - data: - $ref: '#/components/schemas/CIAppPipelinesAggregationBucketsResponse' - links: - $ref: '#/components/schemas/CIAppResponseLinks' - meta: - $ref: '#/components/schemas/CIAppResponseMetadata' - type: object - CIAppCompute: - description: A compute rule to compute metrics or timeseries. - properties: - aggregation: - $ref: '#/components/schemas/CIAppAggregationFunction' - interval: - description: |- - The time buckets' size (only used for type=timeseries) - Defaults to a resolution of 150 points. - example: 5m - type: string - metric: - description: The metric to use. - example: '@duration' - type: string - type: - $ref: '#/components/schemas/CIAppComputeType' - required: - - aggregation - type: object - CIAppPipelinesQueryFilter: - description: The search and filter query settings. - properties: - from: - default: now-15m - description: 'The minimum time for the requested events; supports date, math, and regular timestamps (in milliseconds).' - example: now-15m - type: string - query: - default: '*' - description: The search query following the CI Visibility Explorer search syntax. - example: '@ci.provider.name:github AND @ci.status:error' - type: string - to: - default: now - description: 'The maximum time for the requested events, supports date, math, and regular timestamps (in milliseconds).' - example: now - type: string - type: object - CIAppPipelinesGroupBy: - description: A group-by rule. - properties: - facet: - description: The name of the facet to use (required). - example: '@ci.status' - type: string - histogram: - $ref: '#/components/schemas/CIAppGroupByHistogram' - limit: - default: 10 - description: The maximum buckets to return for this group-by. - format: int64 - type: integer - missing: - $ref: '#/components/schemas/CIAppGroupByMissing' - sort: - $ref: '#/components/schemas/CIAppAggregateSort' - total: - $ref: '#/components/schemas/CIAppGroupByTotal' - required: - - facet - type: object - CIAppQueryOptions: - description: |- - Global query options that are used during the query. - Only supply timezone or time offset, not both. Otherwise, the query fails. - properties: - time_offset: - description: The time offset (in seconds) to apply to the query. - format: int64 - type: integer - timezone: - default: UTC - description: 'The timezone can be specified as GMT, UTC, an offset from UTC (like UTC+1), or as a Timezone Database identifier (like America/New_York).' - example: GMT - type: string - type: object - CIAppPipelinesAggregationBucketsResponse: - description: The query results. - properties: - buckets: - description: 'The list of matching buckets, one item per bucket.' - items: - $ref: '#/components/schemas/CIAppPipelinesBucketResponse' - type: array - type: object - CIAppResponseLinks: - description: Links attributes. - properties: - next: - description: |- - Link for the next set of results. The request can also be made using the - POST endpoint. - example: 'https://app.datadoghq.com/api/v2/ci/tests/events?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==' - type: string - type: object - CIAppResponseMetadata: - description: The metadata associated with a request. - properties: - elapsed: - description: The time elapsed in milliseconds. - example: 132 - format: int64 - type: integer - request_id: - description: The identifier of the request. - example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR - type: string - status: - $ref: '#/components/schemas/CIAppResponseStatus' - warnings: - description: |- - A list of warnings (non-fatal errors) encountered. Partial results may return if - warnings are present in the response. - items: - $ref: '#/components/schemas/CIAppWarning' - type: array - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - CIAppAggregationFunction: - description: An aggregation function. - enum: - - count - - cardinality - - pc75 - - pc90 - - pc95 - - pc98 - - pc99 - - sum - - min - - max - - avg - - median - - latest - - earliest - - most_frequent - - delta - example: pc90 - type: string - x-enum-varnames: - - COUNT - - CARDINALITY - - PERCENTILE_75 - - PERCENTILE_90 - - PERCENTILE_95 - - PERCENTILE_98 - - PERCENTILE_99 - - SUM - - MIN - - MAX - - AVG - - MEDIAN - - LATEST - - EARLIEST - - MOST_FREQUENT - - DELTA - CIAppComputeType: - default: total - description: The type of compute. - enum: - - timeseries - - total - type: string - x-enum-varnames: - - TIMESERIES - - TOTAL - CIAppGroupByHistogram: - description: |- - Used to perform a histogram computation (only for measure facets). - At most, 100 buckets are allowed, the number of buckets is `(max - min)/interval`. - properties: - interval: - description: The bin size of the histogram buckets. - example: 10 - format: double - type: number - max: - description: |- - The maximum value for the measure used in the histogram - (values greater than this one are filtered out). - example: 100 - format: double - type: number - min: - description: |- - The minimum value for the measure used in the histogram - (values smaller than this one are filtered out). - example: 50 - format: double - type: number - required: - - interval - - min - - max - type: object - CIAppGroupByMissing: - description: The value to use for logs that don't have the facet used to group-by. - oneOf: - - $ref: '#/components/schemas/CIAppGroupByMissingString' - - $ref: '#/components/schemas/CIAppGroupByMissingNumber' - CIAppAggregateSort: - description: A sort rule. - example: - aggregation: count - order: asc - properties: - aggregation: - $ref: '#/components/schemas/CIAppAggregationFunction' - metric: - description: The metric to sort by (only used for `type=measure`). - example: '@duration' - type: string - order: - $ref: '#/components/schemas/CIAppSortOrder' - type: - $ref: '#/components/schemas/CIAppAggregateSortType' - type: object - CIAppGroupByTotal: - default: false - description: A resulting object to put the given computes in over all the matching records. - oneOf: - - $ref: '#/components/schemas/CIAppGroupByTotalBoolean' - - $ref: '#/components/schemas/CIAppGroupByTotalString' - - $ref: '#/components/schemas/CIAppGroupByTotalNumber' - CIAppPipelinesBucketResponse: - description: Bucket values. - properties: - by: - additionalProperties: - description: The values for each group-by. - description: The key-value pairs for each group-by. - example: - '@ci.provider.name': gitlab - '@ci.status': success - type: object - computes: - $ref: '#/components/schemas/CIAppComputes' - type: object - CIAppResponseStatus: - description: The status of the response. - enum: - - done - - timeout - example: done - type: string - x-enum-varnames: - - DONE - - TIMEOUT - CIAppWarning: - description: A warning message indicating something that went wrong with the query. - properties: - code: - description: A unique code for this type of warning. - example: unknown_index - type: string - detail: - description: A detailed explanation of this specific warning. - example: 'indexes: foo, bar' - type: string - title: - description: A short human-readable summary of the warning. - example: 'One or several indexes are missing or invalid, results hold data from the other indexes' - type: string - type: object - CIAppGroupByMissingString: - description: The missing value to use if there is a string valued facet. - type: string - CIAppGroupByMissingNumber: - description: The missing value to use if there is a number valued facet. - format: double - type: number - CIAppSortOrder: - description: 'The order to use, ascending or descending.' - enum: - - asc - - desc - example: asc - type: string - x-enum-varnames: - - ASCENDING - - DESCENDING - CIAppAggregateSortType: - default: alphabetical - description: The type of sorting algorithm. - enum: - - alphabetical - - measure - type: string - x-enum-varnames: - - ALPHABETICAL - - MEASURE - CIAppGroupByTotalBoolean: - description: 'If set to true, creates an additional bucket labeled "$facet_total".' - type: boolean - CIAppGroupByTotalString: - description: A string to use as the key value for the total bucket. - type: string - CIAppGroupByTotalNumber: - description: A number to use as the key value for the total bucket. - format: double - type: number - CIAppComputes: - additionalProperties: - $ref: '#/components/schemas/CIAppAggregateBucketValue' - description: 'A map of the metric name to value for regular compute, or a list of values for a timeseries.' - type: object - CIAppAggregateBucketValue: - description: 'A bucket value, can either be a timeseries or a single value.' - oneOf: - - $ref: '#/components/schemas/CIAppAggregateBucketValueSingleString' - - $ref: '#/components/schemas/CIAppAggregateBucketValueSingleNumber' - - $ref: '#/components/schemas/CIAppAggregateBucketValueTimeseries' - CIAppAggregateBucketValueSingleString: - description: A single string value. - type: string - CIAppAggregateBucketValueSingleNumber: - description: A single number value. - format: double - type: number - CIAppAggregateBucketValueTimeseries: - description: A timeseries array. - items: - $ref: '#/components/schemas/CIAppAggregateBucketValueTimeseriesPoint' - type: array - x-generate-alias-as-model: true - CIAppAggregateBucketValueTimeseriesPoint: - description: A timeseries point. - properties: - time: - description: The time value for this point. - example: '2020-06-08T11:55:00.123Z' - format: date-time - type: string - value: - description: The value for this point. - example: 19 - format: double - type: number - type: object - CIAppSort: - description: Sort parameters when querying events. - enum: - - timestamp - - '-timestamp' - type: string - x-enum-varnames: - - TIMESTAMP_ASCENDING - - TIMESTAMP_DESCENDING - CIAppPipelineEventsResponse: - description: Response object with all pipeline events matching the request and pagination information. - properties: - data: - description: Array of events matching the request. - items: - $ref: '#/components/schemas/CIAppPipelineEvent' - type: array - links: - $ref: '#/components/schemas/CIAppResponseLinks' - meta: - $ref: '#/components/schemas/CIAppResponseMetadataWithPagination' - type: object - CIAppPipelineEvent: - description: Object description of a pipeline event after being processed and stored by Datadog. - properties: - attributes: - $ref: '#/components/schemas/CIAppPipelineEventAttributes' - id: - description: Unique ID of the event. - example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA - type: string - type: - $ref: '#/components/schemas/CIAppPipelineEventTypeName' - type: object - CIAppResponseMetadataWithPagination: - description: The metadata associated with a request. - properties: - elapsed: - description: The time elapsed in milliseconds. - example: 132 - format: int64 - type: integer - page: - $ref: '#/components/schemas/CIAppResponsePage' - request_id: - description: The identifier of the request. - example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR - type: string - status: - $ref: '#/components/schemas/CIAppResponseStatus' - warnings: - description: |- - A list of warnings (non-fatal errors) encountered. Partial results may return if - warnings are present in the response. - items: - $ref: '#/components/schemas/CIAppWarning' - type: array - type: object - CIAppPipelineEventAttributes: - description: JSON object containing all event attributes and their associated values. - properties: - attributes: - additionalProperties: {} - description: JSON object of attributes from CI Visibility pipeline events. - example: - customAttribute: 123 - duration: 2345 - type: object - ci_level: - $ref: '#/components/schemas/CIAppPipelineLevel' - tags: - $ref: '#/components/schemas/TagsEventAttribute' - type: object - CIAppPipelineEventTypeName: - description: Type of the event. - enum: - - cipipeline - example: cipipeline - type: string - x-enum-varnames: - - CIPIPELINE - CIAppResponsePage: - description: Paging attributes. - properties: - after: - description: 'The cursor to use to get the next results, if any. To make the next request, use the same parameters with the addition of `page[cursor]`.' - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - type: object - CIAppPipelineLevel: - description: Pipeline execution level. - enum: - - pipeline - - stage - - job - - step - - custom - example: pipeline - type: string - x-enum-varnames: - - PIPELINE - - STAGE - - JOB - - STEP - - CUSTOM - TagsEventAttribute: - description: Array of tags associated with your event. - example: - - 'team:A' - items: - description: Tag associated with your event. - type: string - type: array - CIAppPipelineEventsRequest: - description: The request for a pipelines search. - properties: - filter: - $ref: '#/components/schemas/CIAppPipelinesQueryFilter' - options: - $ref: '#/components/schemas/CIAppQueryOptions' - page: - $ref: '#/components/schemas/CIAppQueryPageOptions' - sort: - $ref: '#/components/schemas/CIAppSort' - type: object - CIAppQueryPageOptions: - description: Paging attributes for listing events. - properties: - cursor: - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - limit: - default: 10 - description: Maximum number of events in the response. - example: 25 - format: int32 - maximum: 1000 - type: integer - type: object - CIAppTestsAggregateRequest: - description: The object sent with the request to retrieve aggregation buckets of test events from your organization. - properties: - compute: - description: The list of metrics or timeseries to compute for the retrieved buckets. - items: - $ref: '#/components/schemas/CIAppCompute' - type: array - filter: - $ref: '#/components/schemas/CIAppTestsQueryFilter' - group_by: - description: The rules for the group-by. - items: - $ref: '#/components/schemas/CIAppTestsGroupBy' - type: array - options: - $ref: '#/components/schemas/CIAppQueryOptions' - type: object - CIAppTestsAnalyticsAggregateResponse: - description: The response object for the test events aggregate API endpoint. - properties: - data: - $ref: '#/components/schemas/CIAppTestsAggregationBucketsResponse' - links: - $ref: '#/components/schemas/CIAppResponseLinks' - meta: - $ref: '#/components/schemas/CIAppResponseMetadataWithPagination' - type: object - CIAppTestsQueryFilter: - description: The search and filter query settings. - properties: - from: - default: now-15m - description: 'The minimum time for the requested events; supports date, math, and regular timestamps (in milliseconds).' - example: now-15m - type: string - query: - default: '*' - description: The search query following the CI Visibility Explorer search syntax. - example: '@test.service:web-ui-tests AND @test.status:fail' - type: string - to: - default: now - description: 'The maximum time for the requested events, supports date, math, and regular timestamps (in milliseconds).' - example: now - type: string - type: object - CIAppTestsGroupBy: - description: A group-by rule. - properties: - facet: - description: The name of the facet to use (required). - example: '@test.service' - type: string - histogram: - $ref: '#/components/schemas/CIAppGroupByHistogram' - limit: - default: 10 - description: The maximum buckets to return for this group-by. - format: int64 - type: integer - missing: - $ref: '#/components/schemas/CIAppGroupByMissing' - sort: - $ref: '#/components/schemas/CIAppAggregateSort' - total: - $ref: '#/components/schemas/CIAppGroupByTotal' - required: - - facet - type: object - CIAppTestsAggregationBucketsResponse: - description: The query results. - properties: - buckets: - description: 'The list of matching buckets, one item per bucket.' - items: - $ref: '#/components/schemas/CIAppTestsBucketResponse' - type: array - type: object - CIAppTestsBucketResponse: - description: Bucket values. - properties: - by: - additionalProperties: - description: The values for each group-by. - description: The key-value pairs for each group-by. - example: - '@test.service': web-ui-tests - '@test.status': skip - type: object - computes: - $ref: '#/components/schemas/CIAppComputes' - type: object - CIAppTestEventsResponse: - description: Response object with all test events matching the request and pagination information. - properties: - data: - description: Array of events matching the request. - items: - $ref: '#/components/schemas/CIAppTestEvent' - type: array - links: - $ref: '#/components/schemas/CIAppResponseLinks' - meta: - $ref: '#/components/schemas/CIAppResponseMetadataWithPagination' - type: object - CIAppTestEvent: - description: Object description of test event after being processed and stored by Datadog. - properties: - attributes: - $ref: '#/components/schemas/CIAppEventAttributes' - id: - description: Unique ID of the event. - example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA - type: string - type: - $ref: '#/components/schemas/CIAppTestEventTypeName' - type: object - CIAppEventAttributes: - description: JSON object containing all event attributes and their associated values. - properties: - attributes: - additionalProperties: {} - description: JSON object of attributes from CI Visibility test events. - example: - customAttribute: 123 - duration: 2345 - type: object - tags: - $ref: '#/components/schemas/TagsEventAttribute' - test_level: - $ref: '#/components/schemas/CIAppTestLevel' - type: object - CIAppTestEventTypeName: - description: Type of the event. - enum: - - citest - example: citest - type: string - x-enum-varnames: - - CITEST - CIAppTestLevel: - description: Test run level. - enum: - - session - - module - - suite - - test - example: test - type: string - x-enum-varnames: - - SESSION - - MODULE - - SUITE - - TEST - CIAppTestEventsRequest: - description: The request for a tests search. - properties: - filter: - $ref: '#/components/schemas/CIAppTestsQueryFilter' - options: - $ref: '#/components/schemas/CIAppQueryOptions' - page: - $ref: '#/components/schemas/CIAppQueryPageOptions' - sort: - $ref: '#/components/schemas/CIAppSort' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - app_pipeline_events: - id: datadog.ci_visibility.app_pipeline_events - name: app_pipeline_events - title: App Pipeline Events - methods: - create_ci_app_pipeline_event: - operation: - $ref: '#/paths/~1api~1v2~1ci~1pipeline/post' - response: - mediaType: application/json - openAPIDocKey: '202' - aggregate_ci_app_pipeline_events: - operation: - $ref: '#/paths/~1api~1v2~1ci~1pipelines~1analytics~1aggregate/post' - response: - mediaType: application/json - openAPIDocKey: '200' - list_ci_app_pipeline_events: - operation: - $ref: '#/paths/~1api~1v2~1ci~1pipelines~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_ci_app_pipeline_events: - operation: - $ref: '#/paths/~1api~1v2~1ci~1pipelines~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - search_ci_app_pipeline_events: - operation: - $ref: '#/paths/~1api~1v2~1ci~1pipelines~1events~1search/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/app_pipeline_events/methods/list_ci_app_pipeline_events' - insert: - - $ref: '#/components/x-stackQL-resources/app_pipeline_events/methods/create_ci_app_pipeline_event' - update: [] - delete: [] - app_test_events: - id: datadog.ci_visibility.app_test_events - name: app_test_events - title: App Test Events - methods: - aggregate_ci_app_test_events: - operation: - $ref: '#/paths/~1api~1v2~1ci~1tests~1analytics~1aggregate/post' - response: - mediaType: application/json - openAPIDocKey: '200' - list_ci_app_test_events: - operation: - $ref: '#/paths/~1api~1v2~1ci~1tests~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_ci_app_test_events: - operation: - $ref: '#/paths/~1api~1v2~1ci~1tests~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - search_ci_app_test_events: - operation: - $ref: '#/paths/~1api~1v2~1ci~1tests~1events~1search/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/app_test_events/methods/list_ci_app_test_events' - insert: [] - update: [] - delete: [] -paths: - /api/v2/ci/pipeline: - post: - description: |- - Send your pipeline event to your Datadog platform over HTTP. For details about how pipeline executions are modeled and what execution types we support, see [Pipeline Data Model And Execution Types](https://docs.datadoghq.com/continuous_integration/guides/pipeline_data_model/). - - Pipeline events can be submitted with a timestamp that is up to 18 hours in the past. - operationId: CreateCIAppPipelineEvent - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppCreatePipelineEventRequest' - required: true - responses: - '202': - content: - application/json: - schema: - type: object - description: Request accepted for processing - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPCIAppErrors' - description: Bad Request - '401': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPCIAppErrors' - description: Unauthorized - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPCIAppErrors' - description: Forbidden - '408': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPCIAppErrors' - description: Request Timeout - '413': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPCIAppErrors' - description: Payload Too Large - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPCIAppErrors' - description: Too Many Requests - '500': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPCIAppErrors' - description: Internal Server Error - '503': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPCIAppErrors' - description: Service Unavailable - security: - - apiKeyAuth: [] - summary: Send pipeline event - tags: - - CI Visibility Pipelines - x-codegen-request-body-name: body - x-unstable: |- - **Note:** This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/ci/pipelines/analytics/aggregate: - post: - description: Use this API endpoint to aggregate CI Visibility pipeline events into buckets of computed metrics and timeseries. - operationId: AggregateCIAppPipelineEvents - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppPipelinesAggregateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppPipelinesAnalyticsAggregateResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - ci_visibility_read - summary: Aggregate pipelines events - tags: - - CI Visibility Pipelines - x-codegen-request-body-name: body - /api/v2/ci/pipelines/events: - get: - description: |- - List endpoint returns CI Visibility pipeline events that match a [search query](https://docs.datadoghq.com/continuous_integration/explorer/search_syntax/). - [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). - - Use this endpoint to see your latest pipeline events. - operationId: ListCIAppPipelineEvents - parameters: - - description: Search query following log syntax. - example: '@ci.provider.name:github @ci.pipeline.name:Pull Request Labeler' - in: query - name: 'filter[query]' - required: false - schema: - type: string - - description: Minimum timestamp for requested events. - example: '2019-01-02T09:42:36.320Z' - in: query - name: 'filter[from]' - required: false - schema: - format: date-time - type: string - - description: Maximum timestamp for requested events. - example: '2019-01-03T09:42:36.320Z' - in: query - name: 'filter[to]' - required: false - schema: - format: date-time - type: string - - description: Order of events in results. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/CIAppSort' - - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - in: query - name: 'page[cursor]' - required: false - schema: - type: string - - description: Maximum number of events in the response. - example: 25 - in: query - name: 'page[limit]' - required: false - schema: - default: 10 - format: int32 - maximum: 1000 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppPipelineEventsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - ci_visibility_read - summary: Get a list of pipelines events - tags: - - CI Visibility Pipelines - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data - /api/v2/ci/pipelines/events/search: - post: - description: |- - List endpoint returns CI Visibility pipeline events that match a [search query](https://docs.datadoghq.com/continuous_integration/explorer/search_syntax/). - [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). - - Use this endpoint to build complex events filtering and search. - operationId: SearchCIAppPipelineEvents - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppPipelineEventsRequest' - required: false - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppPipelineEventsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - ci_visibility_read - summary: Search pipelines events - tags: - - CI Visibility Pipelines - x-codegen-request-body-name: body - x-pagination: - cursorParam: body.page.cursor - cursorPath: meta.page.after - limitParam: body.page.limit - resultsPath: data - /api/v2/ci/tests/analytics/aggregate: - post: - description: The API endpoint to aggregate CI Visibility test events into buckets of computed metrics and timeseries. - operationId: AggregateCIAppTestEvents - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppTestsAggregateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppTestsAnalyticsAggregateResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - ci_visibility_read - summary: Aggregate tests events - tags: - - CI Visibility Tests - x-codegen-request-body-name: body - /api/v2/ci/tests/events: - get: - description: |- - List endpoint returns CI Visibility test events that match a [log search query](https://docs.datadoghq.com/logs/explorer/search_syntax/). - [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). - - Use this endpoint to see your latest test events. - operationId: ListCIAppTestEvents - parameters: - - description: Search query following log syntax. - example: '@test.name:test_foo @test.suite:github.com/DataDog/dd-go/model' - in: query - name: 'filter[query]' - required: false - schema: - type: string - - description: Minimum timestamp for requested events. - example: '2019-01-02T09:42:36.320Z' - in: query - name: 'filter[from]' - required: false - schema: - format: date-time - type: string - - description: Maximum timestamp for requested events. - example: '2019-01-03T09:42:36.320Z' - in: query - name: 'filter[to]' - required: false - schema: - format: date-time - type: string - - description: Order of events in results. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/CIAppSort' - - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - in: query - name: 'page[cursor]' - required: false - schema: - type: string - - description: Maximum number of events in the response. - example: 25 - in: query - name: 'page[limit]' - required: false - schema: - default: 10 - format: int32 - maximum: 1000 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppTestEventsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - ci_visibility_read - summary: Get a list of tests events - tags: - - CI Visibility Tests - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data - /api/v2/ci/tests/events/search: - post: - description: |- - List endpoint returns CI Visibility test events that match a [log search query](https://docs.datadoghq.com/logs/explorer/search_syntax/). - [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). - - Use this endpoint to build complex events filtering and search. - operationId: SearchCIAppTestEvents - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppTestEventsRequest' - required: false - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CIAppTestEventsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - ci_visibility_read - summary: Search tests events - tags: - - CI Visibility Tests - x-codegen-request-body-name: body - x-pagination: - cursorParam: body.page.cursor - cursorPath: meta.page.after - limitParam: body.page.limit - resultsPath: data diff --git a/providers/src/datadog/v00.00.00000/services/cloud_costs.yaml b/providers/src/datadog/v00.00.00000/services/cloud_costs.yaml new file mode 100644 index 00000000..62ed7aaf --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/cloud_costs.yaml @@ -0,0 +1,2509 @@ +openapi: 3.0.0 +info: + title: cloud_costs API + description: datadog cloud_costs API + version: '1.0' +paths: + /api/v2/cost/aws_cur_config: + get: + description: List the AWS CUR configs. + operationId: ListCostAWSCURConfigs + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsCURConfigsResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_read + summary: List Cloud Cost Management AWS CUR configs + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_read + post: + description: Create a Cloud Cost Management account for an AWS CUR config. + operationId: CreateCostAWSCURConfig + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AwsCURConfigPostRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsCURConfigResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Create Cloud Cost Management AWS CUR config + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + /api/v2/cost/aws_cur_config/{cloud_account_id}: + delete: + description: Archive a Cloud Cost Management Account. + operationId: DeleteCostAWSCURConfig + parameters: + - $ref: '#/components/parameters/CloudAccountID' + responses: + '204': + description: No Content + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Delete Cloud Cost Management AWS CUR config + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + patch: + description: >- + Update the status (active/archived) and/or account filtering + configuration of an AWS CUR config. + operationId: UpdateCostAWSCURConfig + parameters: + - $ref: '#/components/parameters/CloudAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AwsCURConfigPatchRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsCURConfigsResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Update Cloud Cost Management AWS CUR config + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + /api/v2/cost/azure_uc_config: + get: + description: List the Azure configs. + operationId: ListCostAzureUCConfigs + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AzureUCConfigsResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_read + summary: List Cloud Cost Management Azure configs + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_read + post: + description: Create a Cloud Cost Management account for an Azure config. + operationId: CreateCostAzureUCConfigs + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AzureUCConfigPostRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AzureUCConfigPairsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Create Cloud Cost Management Azure configs + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + /api/v2/cost/azure_uc_config/{cloud_account_id}: + delete: + description: Archive a Cloud Cost Management Account. + operationId: DeleteCostAzureUCConfig + parameters: + - $ref: '#/components/parameters/CloudAccountID' + responses: + '204': + description: No Content + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Delete Cloud Cost Management Azure config + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + patch: + description: Update the status of an Azure config (active/archived). + operationId: UpdateCostAzureUCConfigs + parameters: + - $ref: '#/components/parameters/CloudAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AzureUCConfigPatchRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AzureUCConfigPairsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Update Cloud Cost Management Azure config + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + /api/v2/cost/budget: + put: + description: Create a new budget or update an existing one. + operationId: UpsertBudget + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/BudgetWithEntries' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/BudgetWithEntries' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Create or update a budget + tags: + - Cloud Cost Management + /api/v2/cost/budget/{budget_id}: + delete: + description: Delete a budget. + operationId: DeleteBudget + parameters: + - $ref: '#/components/parameters/BudgetID' + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Delete a budget + tags: + - Cloud Cost Management + get: + description: Get a budget. + operationId: GetBudget + parameters: + - $ref: '#/components/parameters/BudgetID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/BudgetWithEntries' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_read + summary: Get a budget + tags: + - Cloud Cost Management + /api/v2/cost/budgets: + get: + description: List budgets. + operationId: ListBudgets + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/BudgetArray' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_read + summary: List budgets + tags: + - Cloud Cost Management + /api/v2/cost/custom_costs: + get: + description: List the Custom Costs files. + operationId: ListCustomCostsFiles + parameters: + - description: Page number for pagination + in: query + name: page[number] + schema: + format: int64 + type: integer + - description: Page size for pagination + in: query + name: page[size] + schema: + default: 100 + format: int64 + type: integer + - description: Filter by file status + in: query + name: filter[status] + schema: + type: string + - description: Sort key with optional descending prefix + in: query + name: sort + schema: + default: created_at + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CustomCostsFileListResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_read + summary: List Custom Costs files + tags: + - Cloud Cost Management + put: + description: Upload a Custom Costs file. + operationId: UploadCustomCostsFile + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CustomCostsFileUploadRequest' + required: true + responses: + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/CustomCostsFileUploadResponse' + description: Accepted + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Upload Custom Costs file + tags: + - Cloud Cost Management + /api/v2/cost/custom_costs/{file_id}: + delete: + description: Delete the specified Custom Costs file. + operationId: DeleteCustomCostsFile + parameters: + - $ref: '#/components/parameters/FileID' + responses: + '204': + description: No Content + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Delete Custom Costs file + tags: + - Cloud Cost Management + get: + description: Fetch the specified Custom Costs file. + operationId: GetCustomCostsFile + parameters: + - $ref: '#/components/parameters/FileID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CustomCostsFileGetResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_read + summary: Get Custom Costs file + tags: + - Cloud Cost Management + /api/v2/cost/gcp_uc_config: + get: + description: List the GCP Usage Cost configs. + operationId: ListCostGCPUsageCostConfigs + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GCPUsageCostConfigsResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_read + summary: List Cloud Cost Management GCP Usage Cost configs + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_read + post: + description: Create a Cloud Cost Management account for an GCP Usage Cost config. + operationId: CreateCostGCPUsageCostConfig + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GCPUsageCostConfigPostRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GCPUsageCostConfigResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Create Cloud Cost Management GCP Usage Cost config + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + /api/v2/cost/gcp_uc_config/{cloud_account_id}: + delete: + description: Archive a Cloud Cost Management account. + operationId: DeleteCostGCPUsageCostConfig + parameters: + - $ref: '#/components/parameters/CloudAccountID' + responses: + '204': + description: No Content + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Delete Cloud Cost Management GCP Usage Cost config + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + patch: + description: Update the status of an GCP Usage Cost config (active/archived). + operationId: UpdateCostGCPUsageCostConfig + parameters: + - $ref: '#/components/parameters/CloudAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GCPUsageCostConfigPatchRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GCPUsageCostConfigResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cloud_cost_management_write + summary: Update Cloud Cost Management GCP Usage Cost config + tags: + - Cloud Cost Management + x-permission: + operator: OR + permissions: + - cloud_cost_management_write + /api/v2/cost_by_tag/active_billing_dimensions: + get: + description: >- + Get active billing dimensions for cost attribution. Cost data for a + given month becomes available no later than the 19th of the following + month. + operationId: GetActiveBillingDimensions + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/ActiveBillingDimensionsResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + summary: Get active billing dimensions for cost attribution + tags: + - Usage Metering + x-permission: + operator: OR + permissions: + - usage_read + /api/v2/cost_by_tag/monthly_cost_attribution: + get: + description: >- + Get monthly cost attribution by tag across multi-org and single root-org + accounts. + + Cost Attribution data for a given month becomes available no later than + the 19th of the following month. + + This API endpoint is paginated. To make sure you receive all records, + check if the value of `next_record_id` is + + set in the response. If it is, make another request and pass + `next_record_id` as a parameter. + + Pseudo code example: + + ``` + + response := GetMonthlyCostAttribution(start_month, end_month) + + cursor := response.metadata.pagination.next_record_id + + WHILE cursor != null BEGIN + sleep(5 seconds) # Avoid running into rate limit + response := GetMonthlyCostAttribution(start_month, end_month, next_record_id=cursor) + cursor := response.metadata.pagination.next_record_id + END + + ``` + + + This endpoint is only accessible for [parent-level + organizations](https://docs.datadoghq.com/account_management/multi_organization/). + This endpoint is not available in the Government (US1-FED) site. + operationId: GetMonthlyCostAttribution + parameters: + - description: >- + Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for + cost beginning in this month. + in: query + name: start_month + required: true + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for + cost ending this month. + in: query + name: end_month + required: false + schema: + format: date-time + type: string + - description: >- + Comma-separated list specifying cost types (e.g., + `_on_demand_cost`, + `_committed_cost`, + `_total_cost`) and the + + proportions (`_percentage_in_org`, + `_percentage_in_account`). Use `*` to retrieve + all fields. + + Example: + `infra_host_on_demand_cost,infra_host_percentage_in_account` + + To obtain the complete list of active billing dimensions that can be + used to replace + + `` in the field names, make a request to the [Get + active billing dimensions + API](https://docs.datadoghq.com/api/latest/usage-metering/#get-active-billing-dimensions-for-cost-attribution). + in: query + name: fields + required: true + schema: + type: string + - description: 'The direction to sort by: `[desc, asc]`.' + in: query + name: sort_direction + required: false + schema: + $ref: '#/components/schemas/SortDirection' + - description: >- + The billing dimension to sort by. Always sorted by total cost. + Example: `infra_host`. + in: query + name: sort_name + required: false + schema: + type: string + - description: >- + Comma separated list of tag keys used to group cost. If no value is + provided the cost will not be broken down by tags. + + To see which tags are available, look for the value of + `tag_config_source` in the API response. + in: query + name: tag_breakdown_keys + required: false + schema: + type: string + - description: >- + List following results with a next_record_id provided in the + previous query. + in: query + name: next_record_id + required: false + schema: + type: string + - description: Include child org cost in the response. Defaults to `true`. + in: query + name: include_descendants + required: false + schema: + default: true + type: boolean + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/MonthlyCostAttributionResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + - billing_read + summary: Get Monthly Cost Attribution + tags: + - Usage Metering + x-permission: + operator: AND + permissions: + - usage_read + - billing_read +components: + schemas: + AwsCURConfigsResponse: + description: List of AWS CUR configs. + properties: + data: + description: An AWS CUR config. + items: + $ref: '#/components/schemas/AwsCURConfig' + type: array + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + AwsCURConfigPostRequest: + description: AWS CUR config Post Request. + properties: + data: + $ref: '#/components/schemas/AwsCURConfigPostData' + required: + - data + type: object + AwsCURConfigResponse: + description: Response of AWS CUR config. + properties: + data: + $ref: '#/components/schemas/AwsCURConfig' + type: object + AwsCURConfigPatchRequest: + description: AWS CUR config Patch Request. + properties: + data: + $ref: '#/components/schemas/AwsCURConfigPatchData' + required: + - data + type: object + AzureUCConfigsResponse: + description: List of Azure accounts with configs. + properties: + data: + description: An Azure config pair. + items: + $ref: '#/components/schemas/AzureUCConfigPair' + type: array + type: object + AzureUCConfigPostRequest: + description: Azure config Post Request. + properties: + data: + $ref: '#/components/schemas/AzureUCConfigPostData' + required: + - data + type: object + AzureUCConfigPairsResponse: + description: Response of Azure config pair. + properties: + data: + $ref: '#/components/schemas/AzureUCConfigPair' + type: object + AzureUCConfigPatchRequest: + description: Azure config Patch Request. + properties: + data: + $ref: '#/components/schemas/AzureUCConfigPatchData' + required: + - data + type: object + BudgetWithEntries: + description: The definition of the `BudgetWithEntries` object. + properties: + data: + $ref: '#/components/schemas/BudgetWithEntriesData' + type: object + BudgetArray: + description: An array of budgets. + example: + data: + - attributes: + created_at: 1741011342772 + created_by: user1 + end_month: 202502 + metrics_query: aws.cost.amortized{service:ec2} by {service} + name: my budget + org_id: 123 + start_month: 202501 + total_amount: 1000 + updated_at: 1741011342772 + updated_by: user2 + id: 00000000-0a0a-0a0a-aaa0-00000000000a + type: budget + properties: + data: + description: The `BudgetArray` `data`. + items: + $ref: '#/components/schemas/Budget' + type: array + type: object + CustomCostsFileListResponse: + description: Response for List Custom Costs files. + properties: + data: + description: List of Custom Costs files. + items: + $ref: '#/components/schemas/CustomCostsFileMetadataHighLevel' + type: array + meta: + $ref: '#/components/schemas/CustomCostListResponseMeta' + type: object + CustomCostsFileUploadRequest: + description: Request for uploading a Custom Costs file. + items: + $ref: '#/components/schemas/CustomCostsFileLineItem' + type: array + CustomCostsFileUploadResponse: + description: Response for Uploaded Custom Costs files. + properties: + data: + $ref: '#/components/schemas/CustomCostsFileMetadataHighLevel' + meta: + $ref: '#/components/schemas/CustomCostUploadResponseMeta' + type: object + CustomCostsFileGetResponse: + description: Response for Get Custom Costs files. + properties: + data: + $ref: '#/components/schemas/CustomCostsFileMetadataWithContentHighLevel' + meta: + $ref: '#/components/schemas/CustomCostGetResponseMeta' + type: object + GCPUsageCostConfigsResponse: + description: List of GCP Usage Cost configs. + properties: + data: + description: A GCP Usage Cost config. + items: + $ref: '#/components/schemas/GCPUsageCostConfig' + type: array + type: object + GCPUsageCostConfigPostRequest: + description: GCP Usage Cost config post request. + properties: + data: + $ref: '#/components/schemas/GCPUsageCostConfigPostData' + required: + - data + type: object + GCPUsageCostConfigResponse: + description: Response of GCP Usage Cost config. + properties: + data: + $ref: '#/components/schemas/GCPUsageCostConfig' + type: object + GCPUsageCostConfigPatchRequest: + description: GCP Usage Cost config patch request. + properties: + data: + $ref: '#/components/schemas/GCPUsageCostConfigPatchData' + required: + - data + type: object + ActiveBillingDimensionsResponse: + description: Active billing dimensions response. + properties: + data: + $ref: '#/components/schemas/ActiveBillingDimensionsBody' + type: object + SortDirection: + default: desc + description: The direction to sort by. + enum: + - desc + - asc + type: string + x-enum-varnames: + - DESC + - ASC + MonthlyCostAttributionResponse: + description: Response containing the monthly cost attribution by tag(s). + properties: + data: + description: Response containing cost attribution. + items: + $ref: '#/components/schemas/MonthlyCostAttributionBody' + type: array + meta: + $ref: '#/components/schemas/MonthlyCostAttributionMeta' + type: object + AwsCURConfig: + description: AWS CUR config. + properties: + attributes: + $ref: '#/components/schemas/AwsCURConfigAttributes' + id: + description: The ID of the AWS CUR config. + type: string + type: + $ref: '#/components/schemas/AwsCURConfigType' + required: + - attributes + - type + type: object + AwsCURConfigPostData: + description: AWS CUR config Post data. + properties: + attributes: + $ref: '#/components/schemas/AwsCURConfigPostRequestAttributes' + type: + $ref: '#/components/schemas/AwsCURConfigPostRequestType' + required: + - attributes + - type + type: object + AwsCURConfigPatchData: + description: AWS CUR config Patch data. + properties: + attributes: + $ref: '#/components/schemas/AwsCURConfigPatchRequestAttributes' + type: + $ref: '#/components/schemas/AwsCURConfigPatchRequestType' + required: + - attributes + - type + type: object + AzureUCConfigPair: + description: Azure config pair. + properties: + attributes: + $ref: '#/components/schemas/AzureUCConfigPairAttributes' + id: + description: The ID of Cloud Cost Management account. + type: string + type: + $ref: '#/components/schemas/AzureUCConfigPairType' + required: + - attributes + - type + type: object + AzureUCConfigPostData: + description: Azure config Post data. + properties: + attributes: + $ref: '#/components/schemas/AzureUCConfigPostRequestAttributes' + type: + $ref: '#/components/schemas/AzureUCConfigPostRequestType' + required: + - attributes + - type + type: object + AzureUCConfigPatchData: + description: Azure config Patch data. + properties: + attributes: + $ref: '#/components/schemas/AzureUCConfigPatchRequestAttributes' + type: + $ref: '#/components/schemas/AzureUCConfigPatchRequestType' + required: + - attributes + - type + type: object + BudgetWithEntriesData: + description: A budget and all its entries. + properties: + attributes: + $ref: '#/components/schemas/BudgetAttributes' + id: + description: The `BudgetWithEntriesData` `id`. + example: 00000000-0a0a-0a0a-aaa0-00000000000a + type: string + type: + description: The type of the object, must be `budget`. + type: string + type: object + Budget: + description: A budget. + properties: + attributes: + $ref: '#/components/schemas/BudgetAttributes' + id: + description: The id of the budget. + type: string + type: + description: The type of the object, must be `budget`. + type: string + type: object + CustomCostsFileMetadataHighLevel: + description: JSON API format for a Custom Costs file. + properties: + attributes: + $ref: '#/components/schemas/CustomCostsFileMetadata' + id: + description: ID of the Custom Costs metadata. + type: string + type: + description: Type of the Custom Costs file metadata. + type: string + type: object + CustomCostListResponseMeta: + description: Meta for the response from the List Custom Costs endpoints. + properties: + total_filtered_count: + description: >- + Number of Custom Costs files returned by the List Custom Costs + endpoint + format: int64 + type: integer + version: + description: Version of Custom Costs file + type: string + type: object + CustomCostsFileLineItem: + description: Line item details from a Custom Costs file. + properties: + BilledCost: + description: Total cost in the cost file. + example: 100.5 + format: double + type: number + BillingCurrency: + description: Currency used in the Custom Costs file. + example: USD + type: string + ChargeDescription: + description: Description for the line item cost. + example: Monthly usage charge for my service + type: string + ChargePeriodEnd: + description: End date of the usage charge. + example: '2023-02-28' + pattern: ^\d{4}-\d{2}-\d{2}$ + type: string + ChargePeriodStart: + description: Start date of the usage charge. + example: '2023-02-01' + pattern: ^\d{4}-\d{2}-\d{2}$ + type: string + ProviderName: + description: Name of the provider for the line item. + type: string + Tags: + additionalProperties: + type: string + description: Additional tags for the line item. + type: object + type: object + CustomCostUploadResponseMeta: + description: Meta for the response from the Upload Custom Costs endpoints. + properties: + version: + description: Version of Custom Costs file + type: string + type: object + CustomCostsFileMetadataWithContentHighLevel: + description: JSON API format of for a Custom Costs file with content. + properties: + attributes: + $ref: '#/components/schemas/CustomCostsFileMetadataWithContent' + id: + description: ID of the Custom Costs metadata. + type: string + type: + description: Type of the Custom Costs file metadata. + type: string + type: object + CustomCostGetResponseMeta: + description: Meta for the response from the Get Custom Costs endpoints. + properties: + version: + description: Version of Custom Costs file + type: string + type: object + GCPUsageCostConfig: + description: GCP Usage Cost config. + properties: + attributes: + $ref: '#/components/schemas/GCPUsageCostConfigAttributes' + id: + description: The ID of the GCP Usage Cost config. + type: string + type: + $ref: '#/components/schemas/GCPUsageCostConfigType' + required: + - attributes + - type + type: object + GCPUsageCostConfigPostData: + description: GCP Usage Cost config post data. + properties: + attributes: + $ref: '#/components/schemas/GCPUsageCostConfigPostRequestAttributes' + type: + $ref: '#/components/schemas/GCPUsageCostConfigPostRequestType' + required: + - attributes + - type + type: object + GCPUsageCostConfigPatchData: + description: GCP Usage Cost config patch data. + properties: + attributes: + $ref: '#/components/schemas/GCPUsageCostConfigPatchRequestAttributes' + type: + $ref: '#/components/schemas/GCPUsageCostConfigPatchRequestType' + required: + - attributes + - type + type: object + ActiveBillingDimensionsBody: + description: Active billing dimensions data. + properties: + attributes: + $ref: '#/components/schemas/ActiveBillingDimensionsAttributes' + id: + description: Unique ID of the response. + type: string + type: + $ref: '#/components/schemas/ActiveBillingDimensionsType' + type: object + MonthlyCostAttributionBody: + description: Cost data. + properties: + attributes: + $ref: '#/components/schemas/MonthlyCostAttributionAttributes' + id: + description: Unique ID of the response. + type: string + type: + $ref: '#/components/schemas/CostAttributionType' + type: object + MonthlyCostAttributionMeta: + description: The object containing document metadata. + properties: + aggregates: + $ref: '#/components/schemas/CostAttributionAggregates' + pagination: + $ref: '#/components/schemas/MonthlyCostAttributionPagination' + type: object + AwsCURConfigAttributes: + description: Attributes for An AWS CUR config. + properties: + account_filters: + $ref: '#/components/schemas/AccountFilteringConfig' + account_id: + description: The AWS account ID. + example: '123456789123' + type: string + bucket_name: + description: The AWS bucket name used to store the Cost and Usage Report. + example: dd-cost-bucket + type: string + bucket_region: + description: The region the bucket is located in. + example: us-east-1 + type: string + created_at: + description: The timestamp when the AWS CUR config was created. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + error_messages: + description: The error messages for the AWS CUR config. + items: + type: string + type: array + months: + deprecated: true + description: The number of months the report has been backfilled. + format: int32 + maximum: 36 + type: integer + report_name: + description: The name of the Cost and Usage Report. + example: dd-report-name + type: string + report_prefix: + description: The report prefix used for the Cost and Usage Report. + example: dd-report-prefix + type: string + status: + description: The status of the AWS CUR. + example: active + type: string + status_updated_at: + description: The timestamp when the AWS CUR config status was updated. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + updated_at: + description: The timestamp when the AWS CUR config status was updated. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + required: + - account_id + - bucket_name + - bucket_region + - report_name + - report_prefix + - status + type: object + AwsCURConfigType: + default: aws_cur_config + description: Type of AWS CUR config. + enum: + - aws_cur_config + example: aws_cur_config + type: string + x-enum-varnames: + - AWS_CUR_CONFIG + AwsCURConfigPostRequestAttributes: + description: Attributes for AWS CUR config Post Request. + properties: + account_filters: + $ref: '#/components/schemas/AccountFilteringConfig' + account_id: + description: The AWS account ID. + example: '123456789123' + type: string + bucket_name: + description: The AWS bucket name used to store the Cost and Usage Report. + example: dd-cost-bucket + type: string + bucket_region: + description: The region the bucket is located in. + example: us-east-1 + type: string + months: + description: The month of the report. + format: int32 + maximum: 36 + type: integer + report_name: + description: The name of the Cost and Usage Report. + example: dd-report-name + type: string + report_prefix: + description: The report prefix used for the Cost and Usage Report. + example: dd-report-prefix + type: string + required: + - account_id + - bucket_name + - report_name + - report_prefix + type: object + AwsCURConfigPostRequestType: + default: aws_cur_config_post_request + description: Type of AWS CUR config Post Request. + enum: + - aws_cur_config_post_request + example: aws_cur_config_post_request + type: string + x-enum-varnames: + - AWS_CUR_CONFIG_POST_REQUEST + AwsCURConfigPatchRequestAttributes: + description: Attributes for AWS CUR config Patch Request. + properties: + account_filters: + $ref: '#/components/schemas/AccountFilteringConfig' + is_enabled: + description: Whether or not the Cloud Cost Management account is enabled. + example: true + type: boolean + type: object + AwsCURConfigPatchRequestType: + default: aws_cur_config_patch_request + description: Type of AWS CUR config Patch Request. + enum: + - aws_cur_config_patch_request + example: aws_cur_config_patch_request + type: string + x-enum-varnames: + - AWS_CUR_CONFIG_PATCH_REQUEST + AzureUCConfigPairAttributes: + description: Attributes for Azure config pair. + properties: + configs: + description: An Azure config. + items: + $ref: '#/components/schemas/AzureUCConfig' + type: array + id: + description: The ID of the Azure config pair. + type: string + required: + - configs + type: object + AzureUCConfigPairType: + default: azure_uc_configs + description: Type of Azure config pair. + enum: + - azure_uc_configs + example: azure_uc_configs + type: string + x-enum-varnames: + - AZURE_UC_CONFIGS + AzureUCConfigPostRequestAttributes: + description: Attributes for Azure config Post Request. + properties: + account_id: + description: The tenant ID of the azure account. + example: 1234abcd-1234-abcd-1234-1234abcd1234 + type: string + actual_bill_config: + $ref: '#/components/schemas/BillConfig' + amortized_bill_config: + $ref: '#/components/schemas/BillConfig' + client_id: + description: The client ID of the azure account. + example: 1234abcd-1234-abcd-1234-1234abcd1234 + type: string + is_enabled: + description: Whether or not the Cloud Cost Management account is enabled. + type: boolean + scope: + description: The scope of your observed subscription. + example: /subscriptions/1234abcd-1234-abcd-1234-1234abcd1234 + type: string + required: + - account_id + - actual_bill_config + - amortized_bill_config + - client_id + - scope + type: object + AzureUCConfigPostRequestType: + default: azure_uc_config_post_request + description: Type of Azure config Post Request. + enum: + - azure_uc_config_post_request + example: azure_uc_config_post_request + type: string + x-enum-varnames: + - AZURE_UC_CONFIG_POST_REQUEST + AzureUCConfigPatchRequestAttributes: + description: Attributes for Azure config Patch Request. + properties: + is_enabled: + description: Whether or not the Cloud Cost Management account is enabled. + example: true + type: boolean + required: + - is_enabled + type: object + AzureUCConfigPatchRequestType: + default: azure_uc_config_patch_request + description: Type of Azure config Patch Request. + enum: + - azure_uc_config_patch_request + example: azure_uc_config_patch_request + type: string + x-enum-varnames: + - AZURE_UC_CONFIG_PATCH_REQUEST + BudgetAttributes: + description: The attributes of a budget. + properties: + created_at: + description: The timestamp when the budget was created. + example: 1738258683590 + format: int64 + type: integer + created_by: + description: The id of the user that created the budget. + example: 00000000-0a0a-0a0a-aaa0-00000000000a + type: string + end_month: + description: The month when the budget ends. + example: 202502 + format: int64 + type: integer + entries: + description: The entries of the budget. + items: + $ref: '#/components/schemas/BudgetEntry' + type: array + metrics_query: + description: The cost query used to track against the budget. + example: aws.cost.amortized{service:ec2} by {service} + type: string + name: + description: The name of the budget. + example: my budget + type: string + org_id: + description: The id of the org the budget belongs to. + example: 123 + format: int64 + type: integer + start_month: + description: The month when the budget starts. + example: 202501 + format: int64 + type: integer + total_amount: + description: The sum of all budget entries' amounts. + example: 1000 + format: double + type: number + updated_at: + description: The timestamp when the budget was last updated. + example: 1738258683590 + format: int64 + type: integer + updated_by: + description: The id of the user that created the budget. + example: 00000000-0a0a-0a0a-aaa0-00000000000a + type: string + type: object + CustomCostsFileMetadata: + description: Schema of a Custom Costs metadata. + properties: + billed_cost: + description: Total cost in the cost file. + example: 100.5 + format: double + type: number + billing_currency: + description: Currency used in the Custom Costs file. + example: USD + type: string + charge_period: + $ref: '#/components/schemas/CustomCostsFileUsageChargePeriod' + name: + description: Name of the Custom Costs file. + example: my_file.json + type: string + provider_names: + description: Providers contained in the Custom Costs file. + items: + description: Name of the provider. + example: my_provider + type: string + type: array + status: + description: Status of the Custom Costs file. + example: active + type: string + uploaded_at: + description: >- + Timestamp, in millisecond, of the upload time of the Custom Costs + file. + example: 1704067200000 + format: double + type: number + uploaded_by: + $ref: '#/components/schemas/CustomCostsUser' + type: object + CustomCostsFileMetadataWithContent: + description: Schema of a cost file's metadata. + properties: + billed_cost: + description: Total cost in the cost file. + example: 100.5 + format: double + type: number + billing_currency: + description: Currency used in the Custom Costs file. + example: USD + type: string + charge_period: + $ref: '#/components/schemas/CustomCostsFileUsageChargePeriod' + content: + description: Detail of the line items from the Custom Costs file. + items: + $ref: '#/components/schemas/CustomCostsFileLineItem' + type: array + name: + description: Name of the Custom Costs file. + example: my_file.json + type: string + provider_names: + description: Providers contained in the Custom Costs file. + items: + description: Name of a provider. + example: my_provider + type: string + type: array + status: + description: Status of the Custom Costs file. + example: active + type: string + uploaded_at: + description: >- + Timestamp in millisecond of the upload time of the Custom Costs + file. + example: 1704067200000 + format: double + type: number + uploaded_by: + $ref: '#/components/schemas/CustomCostsUser' + type: object + GCPUsageCostConfigAttributes: + description: Attributes for a GCP Usage Cost config. + properties: + account_id: + description: The GCP account ID. + example: 123456_A123BC_12AB34 + type: string + bucket_name: + description: The GCP bucket name used to store the Usage Cost export. + example: dd-cost-bucket + type: string + created_at: + description: The timestamp when the GCP Usage Cost config was created. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + dataset: + description: The export dataset name used for the GCP Usage Cost Report. + example: billing + type: string + error_messages: + description: The error messages for the GCP Usage Cost config. + items: + type: string + nullable: true + type: array + export_prefix: + description: The export prefix used for the GCP Usage Cost Report. + example: datadog_cloud_cost_usage_export + type: string + export_project_name: + description: The name of the GCP Usage Cost Report. + example: dd-cloud-cost-report + type: string + months: + deprecated: true + description: The number of months the report has been backfilled. + format: int32 + maximum: 36 + type: integer + project_id: + description: The `project_id` of the GCP Usage Cost report. + example: my-project-123 + type: string + service_account: + description: The unique GCP service account email. + example: dd-ccm-gcp-integration@my-environment.iam.gserviceaccount.com + type: string + status: + description: The status of the GCP Usage Cost config. + example: active + type: string + status_updated_at: + description: The timestamp when the GCP Usage Cost config status was updated. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + updated_at: + description: The timestamp when the GCP Usage Cost config status was updated. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + required: + - account_id + - bucket_name + - dataset + - export_prefix + - export_project_name + - service_account + - status + type: object + GCPUsageCostConfigType: + default: gcp_uc_config + description: Type of GCP Usage Cost config. + enum: + - gcp_uc_config + example: gcp_uc_config + type: string + x-enum-varnames: + - GCP_UC_CONFIG + GCPUsageCostConfigPostRequestAttributes: + description: Attributes for GCP Usage Cost config post request. + properties: + billing_account_id: + description: The GCP account ID. + example: 123456_A123BC_12AB34 + type: string + bucket_name: + description: The GCP bucket name used to store the Usage Cost export. + example: dd-cost-bucket + type: string + export_dataset_name: + description: The export dataset name used for the GCP Usage Cost report. + example: billing + type: string + export_prefix: + description: The export prefix used for the GCP Usage Cost report. + example: datadog_cloud_cost_usage_export + type: string + export_project_name: + description: The name of the GCP Usage Cost report. + example: dd-cloud-cost-report + type: string + service_account: + description: The unique GCP service account email. + example: dd-ccm-gcp-integration@my-environment.iam.gserviceaccount.com + type: string + required: + - billing_account_id + - bucket_name + - export_project_name + - export_dataset_name + - service_account + type: object + GCPUsageCostConfigPostRequestType: + default: gcp_uc_config_post_request + description: Type of GCP Usage Cost config post request. + enum: + - gcp_uc_config_post_request + example: gcp_usage_cost_config_post_request + type: string + x-enum-varnames: + - GCP_USAGE_COST_CONFIG_POST_REQUEST + GCPUsageCostConfigPatchRequestAttributes: + description: Attributes for GCP Usage Cost config patch request. + properties: + is_enabled: + description: Whether or not the Cloud Cost Management account is enabled. + example: true + type: boolean + required: + - is_enabled + type: object + GCPUsageCostConfigPatchRequestType: + default: gcp_uc_config_patch_request + description: Type of GCP Usage Cost config patch request. + enum: + - gcp_uc_config_patch_request + example: gcp_uc_config_patch_request + type: string + x-enum-varnames: + - GCP_USAGE_COST_CONFIG_PATCH_REQUEST + ActiveBillingDimensionsAttributes: + description: List of active billing dimensions. + properties: + month: + description: >- + Datetime in ISO-8601 format, UTC, precise to hour: + `[YYYY-MM-DDThh]`. + format: date-time + type: string + values: + description: >- + List of active billing dimensions. Example: `[infra_host, apm_host, + serverless_infra]`. + items: + description: A given billing dimension in a list. + example: infra_host + type: string + type: array + type: object + ActiveBillingDimensionsType: + default: billing_dimensions + description: Type of active billing dimensions data. + enum: + - billing_dimensions + type: string + x-enum-varnames: + - BILLING_DIMENSIONS + MonthlyCostAttributionAttributes: + description: Cost Attribution by Tag for a given organization. + properties: + month: + description: >- + Datetime in ISO-8601 format, UTC, precise to hour: + `[YYYY-MM-DDThh]`. + format: date-time + type: string + org_name: + description: The name of the organization. + type: string + public_id: + description: The organization public ID. + type: string + tag_config_source: + description: >- + The source of the cost attribution tag configuration and the + selected tags in the format `::://////`. + type: string + tags: + $ref: '#/components/schemas/CostAttributionTagNames' + updated_at: + description: >- + Shows the most recent hour in the current months for all + organizations for which all costs were calculated. + type: string + values: + description: >- + Fields in Cost Attribution by tag(s). Example: + `infra_host_on_demand_cost`, `infra_host_committed_cost`, + `infra_host_total_cost`, `infra_host_percentage_in_org`, + `infra_host_percentage_in_account`. + type: object + type: object + CostAttributionType: + default: cost_by_tag + description: Type of cost attribution data. + enum: + - cost_by_tag + example: cost_by_tag + type: string + x-enum-varnames: + - COST_BY_TAG + CostAttributionAggregates: + description: An array of available aggregates. + items: + $ref: '#/components/schemas/CostAttributionAggregatesBody' + type: array + MonthlyCostAttributionPagination: + description: The metadata for the current pagination. + properties: + next_record_id: + description: >- + The cursor to use to get the next results, if any. To make the next + request, use the same parameters with the addition of the + `next_record_id`. + nullable: true + type: string + type: object + AccountFilteringConfig: + description: The account filtering configuration. + properties: + excluded_accounts: + description: >- + The AWS account IDs to be excluded from your billing dataset. This + field is used when `include_new_accounts` is `true`. + example: + - '123456789123' + - '123456789143' + items: + type: string + type: array + include_new_accounts: + description: >- + Whether or not to automatically include new member accounts by + default in your billing dataset. + example: true + type: boolean + included_accounts: + description: >- + The AWS account IDs to be included in your billing dataset. This + field is used when `include_new_accounts` is `false`. + example: + - '123456789123' + - '123456789143' + items: + type: string + type: array + type: object + AzureUCConfig: + description: Azure config. + properties: + account_id: + description: The tenant ID of the azure account. + example: 1234abcd-1234-abcd-1234-1234abcd1234 + type: string + client_id: + description: The client ID of the Azure account. + example: 1234abcd-1234-abcd-1234-1234abcd1234 + type: string + created_at: + description: The timestamp when the Azure config was created. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + dataset_type: + description: The dataset type of the Azure config. + example: actual + type: string + error_messages: + description: The error messages for the Azure config. + items: + type: string + type: array + export_name: + description: The name of the configured Azure Export. + example: dd-actual-export + type: string + export_path: + description: The path where the Azure Export is saved. + example: dd-export-path + type: string + id: + description: The ID of the Azure config. + type: string + months: + deprecated: true + description: The number of months the report has been backfilled. + format: int32 + maximum: 36 + type: integer + scope: + description: The scope of your observed subscription. + example: /subscriptions/1234abcd-1234-abcd-1234-1234abcd1234 + type: string + status: + description: The status of the Azure config. + example: active + type: string + status_updated_at: + description: The timestamp when the Azure config status was last updated. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + storage_account: + description: The name of the storage account where the Azure Export is saved. + example: dd-storage-account + type: string + storage_container: + description: The name of the storage container where the Azure Export is saved. + example: dd-storage-container + type: string + updated_at: + description: The timestamp when the Azure config was last updated. + pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}.\d{6}$ + type: string + required: + - account_id + - client_id + - dataset_type + - export_name + - export_path + - scope + - status + - storage_account + - storage_container + type: object + BillConfig: + description: Bill config. + properties: + export_name: + description: The name of the configured Azure Export. + example: dd-actual-export + type: string + export_path: + description: The path where the Azure Export is saved. + example: dd-export-path + type: string + storage_account: + description: The name of the storage account where the Azure Export is saved. + example: dd-storage-account + type: string + storage_container: + description: The name of the storage container where the Azure Export is saved. + example: dd-storage-container + type: string + required: + - export_name + - export_path + - storage_account + - storage_container + type: object + BudgetEntry: + description: The entry of a budget. + properties: + amount: + description: The `amount` of the budget entry. + example: 500 + format: double + type: number + month: + description: The `month` of the budget entry. + example: 202501 + format: int64 + type: integer + tag_filters: + description: The `tag_filters` of the budget entry. + items: + $ref: '#/components/schemas/TagFilter' + type: array + type: object + CustomCostsFileUsageChargePeriod: + description: Usage charge period of a Custom Costs file. + properties: + end: + description: End of the usage of the Custom Costs file. + example: 1706745600000 + format: double + type: number + start: + description: Start of the usage of the Custom Costs file. + example: 1704067200000 + format: double + type: number + type: object + CustomCostsUser: + description: Metadata of the user that has uploaded the Custom Costs file. + properties: + email: + description: The name of the Custom Costs file. + example: email.test@datadohq.com + type: string + icon: + description: The name of the Custom Costs file. + example: icon.png + type: string + name: + description: Name of the user. + example: Test User + type: string + type: object + CostAttributionTagNames: + additionalProperties: + description: >- + A list of values that are associated with each tag key. + + - An empty list means the resource use wasn't tagged with the + respective tag. + + - Multiple values means the respective tag was applied multiple times + on the resource. + + - An `` value means the resource was tagged with the respective + tag but did not have a value. + items: + description: A given tag in a list. + example: datadog-integrations-lab + type: string + type: array + description: >- + Tag keys and values. + + A `null` value here means that the requested tag breakdown cannot be + applied because it does not match the [tags + + configured for usage + attribution](https://docs.datadoghq.com/account_management/billing/usage_attribution/#getting-started). + + In this scenario the API returns the total cost, not broken down by + tags. + nullable: true + type: object + CostAttributionAggregatesBody: + description: The object containing the aggregates. + properties: + agg_type: + description: The aggregate type. + example: sum + type: string + field: + description: The field. + example: infra_host_committed_cost + type: string + value: + description: The value for a given field. + format: double + type: number + type: object + TagFilter: + description: Tag filter for the budget's entries. + properties: + tag_key: + description: The key of the tag. + example: service + type: string + tag_value: + description: The value of the tag. + example: ec2 + type: string + type: object + responses: + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + parameters: + CloudAccountID: + description: Cloud Account id. + in: path + name: cloud_account_id + required: true + schema: + format: int64 + type: integer + BudgetID: + description: Budget id. + in: path + name: budget_id + required: true + schema: + type: string + FileID: + description: File ID. + in: path + name: file_id + required: true + schema: + type: string + x-stackQL-resources: + aws_configs: + id: datadog.cloud_costs.aws_configs + name: aws_configs + title: Aws Configs + methods: + list_cost_awscurconfigs: + operation: + $ref: '#/paths/~1api~1v2~1cost~1aws_cur_config/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_cost_awscurconfig: + operation: + $ref: '#/paths/~1api~1v2~1cost~1aws_cur_config/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_cost_awscurconfig: + operation: + $ref: '#/paths/~1api~1v2~1cost~1aws_cur_config~1{cloud_account_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + update_cost_awscurconfig: + operation: + $ref: '#/paths/~1api~1v2~1cost~1aws_cur_config~1{cloud_account_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aws_configs/methods/list_cost_awscurconfigs + insert: + - $ref: >- + #/components/x-stackQL-resources/aws_configs/methods/create_cost_awscurconfig + update: + - $ref: >- + #/components/x-stackQL-resources/aws_configs/methods/update_cost_awscurconfig + delete: + - $ref: >- + #/components/x-stackQL-resources/aws_configs/methods/delete_cost_awscurconfig + replace: [] + azure_configs: + id: datadog.cloud_costs.azure_configs + name: azure_configs + title: Azure Configs + methods: + list_cost_azure_ucconfigs: + operation: + $ref: '#/paths/~1api~1v2~1cost~1azure_uc_config/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_cost_azure_ucconfigs: + operation: + $ref: '#/paths/~1api~1v2~1cost~1azure_uc_config/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_cost_azure_ucconfig: + operation: + $ref: >- + #/paths/~1api~1v2~1cost~1azure_uc_config~1{cloud_account_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + update_cost_azure_ucconfigs: + operation: + $ref: '#/paths/~1api~1v2~1cost~1azure_uc_config~1{cloud_account_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/azure_configs/methods/list_cost_azure_ucconfigs + insert: + - $ref: >- + #/components/x-stackQL-resources/azure_configs/methods/create_cost_azure_ucconfigs + update: + - $ref: >- + #/components/x-stackQL-resources/azure_configs/methods/update_cost_azure_ucconfigs + delete: + - $ref: >- + #/components/x-stackQL-resources/azure_configs/methods/delete_cost_azure_ucconfig + replace: [] + budgets: + id: datadog.cloud_costs.budgets + name: budgets + title: Budgets + methods: + upsert_budget: + operation: + $ref: '#/paths/~1api~1v2~1cost~1budget/put' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_budget: + operation: + $ref: '#/paths/~1api~1v2~1cost~1budget~1{budget_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_budget: + operation: + $ref: '#/paths/~1api~1v2~1cost~1budget~1{budget_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + list_budgets: + operation: + $ref: '#/paths/~1api~1v2~1cost~1budgets/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/budgets/methods/get_budget' + - $ref: '#/components/x-stackQL-resources/budgets/methods/list_budgets' + insert: [] + update: [] + delete: + - $ref: '#/components/x-stackQL-resources/budgets/methods/delete_budget' + replace: + - $ref: '#/components/x-stackQL-resources/budgets/methods/upsert_budget' + costs_files: + id: datadog.cloud_costs.costs_files + name: costs_files + title: Costs Files + methods: + list_custom_costs_files: + operation: + $ref: '#/paths/~1api~1v2~1cost~1custom_costs/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + upload_custom_costs_file: + operation: + $ref: '#/paths/~1api~1v2~1cost~1custom_costs/put' + response: + mediaType: application/json + openAPIDocKey: '202' + delete_custom_costs_file: + operation: + $ref: '#/paths/~1api~1v2~1cost~1custom_costs~1{file_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_custom_costs_file: + operation: + $ref: '#/paths/~1api~1v2~1cost~1custom_costs~1{file_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/costs_files/methods/get_custom_costs_file + - $ref: >- + #/components/x-stackQL-resources/costs_files/methods/list_custom_costs_files + insert: [] + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/costs_files/methods/delete_custom_costs_file + replace: [] + gcp_configs: + id: datadog.cloud_costs.gcp_configs + name: gcp_configs + title: Gcp Configs + methods: + list_cost_gcpusage_cost_configs: + operation: + $ref: '#/paths/~1api~1v2~1cost~1gcp_uc_config/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_cost_gcpusage_cost_config: + operation: + $ref: '#/paths/~1api~1v2~1cost~1gcp_uc_config/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_cost_gcpusage_cost_config: + operation: + $ref: '#/paths/~1api~1v2~1cost~1gcp_uc_config~1{cloud_account_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + update_cost_gcpusage_cost_config: + operation: + $ref: '#/paths/~1api~1v2~1cost~1gcp_uc_config~1{cloud_account_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/gcp_configs/methods/list_cost_gcpusage_cost_configs + insert: + - $ref: >- + #/components/x-stackQL-resources/gcp_configs/methods/create_cost_gcpusage_cost_config + update: + - $ref: >- + #/components/x-stackQL-resources/gcp_configs/methods/update_cost_gcpusage_cost_config + delete: + - $ref: >- + #/components/x-stackQL-resources/gcp_configs/methods/delete_cost_gcpusage_cost_config + replace: [] + active_billing_dimensions: + id: datadog.cloud_costs.active_billing_dimensions + name: active_billing_dimensions + title: Active Billing Dimensions + methods: + get_active_billing_dimensions: + operation: + $ref: '#/paths/~1api~1v2~1cost_by_tag~1active_billing_dimensions/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/active_billing_dimensions/methods/get_active_billing_dimensions + insert: [] + update: [] + delete: [] + replace: [] + monthly_cost_attribution: + id: datadog.cloud_costs.monthly_cost_attribution + name: monthly_cost_attribution + title: Monthly Cost Attribution + methods: + get_monthly_cost_attribution: + operation: + $ref: '#/paths/~1api~1v2~1cost_by_tag~1monthly_cost_attribution/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/monthly_cost_attribution/methods/get_monthly_cost_attribution + insert: [] + update: [] + delete: [] + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/cloud_workload_security.yaml b/providers/src/datadog/v00.00.00000/services/cloud_workload_security.yaml deleted file mode 100644 index bc02b556..00000000 --- a/providers/src/datadog/v00.00.00000/services/cloud_workload_security.yaml +++ /dev/null @@ -1,1334 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - cloud_workload_security - description: Cloud_Workload_Security -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - CloudWorkloadSecurityAgentRulesListResponse: - description: Response object that includes a list of Agent rule. - properties: - data: - description: A list of Agent rules objects. - items: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleData' - type: array - type: object - CloudWorkloadSecurityAgentRuleData: - description: Object for a single Agent rule. - properties: - attributes: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleAttributes' - id: - description: The ID of the Agent rule. - example: 3dd-0uc-h1s - type: string - type: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' - type: object - CloudWorkloadSecurityAgentRuleAttributes: - description: A Cloud Workload Security Agent rule returned by the API. - properties: - agentConstraint: - description: The version of the agent. - type: string - category: - description: The category of the Agent rule. - example: Process Activity - type: string - creationAuthorUuId: - description: The ID of the user who created the rule. - example: e51c9744-d158-11ec-ad23-da7ad0900002 - type: string - creationDate: - description: 'When the Agent rule was created, timestamp in milliseconds.' - example: 1624366480320 - format: int64 - type: integer - creator: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreatorAttributes' - defaultRule: - description: Whether the rule is included by default. - example: false - type: boolean - description: - description: The description of the Agent rule. - example: My Agent rule - type: string - enabled: - description: Whether the Agent rule is enabled. - example: true - type: boolean - expression: - description: The SECL expression of the Agent rule. - example: exec.file.name == \"sh\" - type: string - filters: - description: The platforms the Agent rule is supported on. - items: - type: string - type: array - name: - description: The name of the Agent rule. - example: my_agent_rule - type: string - updateAuthorUuId: - description: The ID of the user who updated the rule. - example: e51c9744-d158-11ec-ad23-da7ad0900002 - type: string - updateDate: - description: Timestamp in milliseconds when the Agent rule was last updated. - example: 1624366480320 - format: int64 - type: integer - updatedAt: - description: 'When the Agent rule was last updated, timestamp in milliseconds.' - example: 1624366480320 - format: int64 - type: integer - updater: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdaterAttributes' - version: - description: The version of the Agent rule. - example: 23 - format: int64 - type: integer - type: object - CloudWorkloadSecurityAgentRuleType: - default: agent_rule - description: The type of the resource. The value should always be `agent_rule`. - enum: - - agent_rule - example: agent_rule - type: string - x-enum-varnames: - - AGENT_RULE - CloudWorkloadSecurityAgentRuleCreatorAttributes: - description: The attributes of the user who created the Agent rule. - properties: - handle: - description: The handle of the user. - example: datadog.user@example.com - type: string - name: - description: The name of the user. - example: Datadog User - nullable: true - type: string - type: object - CloudWorkloadSecurityAgentRuleUpdaterAttributes: - description: The attributes of the user who last updated the Agent rule. - properties: - handle: - description: The handle of the user. - example: datadog.user@example.com - type: string - name: - description: The name of the user. - example: Datadog User - nullable: true - type: string - type: object - CloudWorkloadSecurityAgentRuleCreateRequest: - description: Request object that includes the Agent rule to create. - properties: - data: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateData' - required: - - data - type: object - CloudWorkloadSecurityAgentRuleResponse: - description: Response object that includes an Agent rule. - properties: - data: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleData' - type: object - CloudWorkloadSecurityAgentRuleCreateData: - description: Object for a single Agent rule. - properties: - attributes: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateAttributes' - type: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' - required: - - attributes - - type - type: object - CloudWorkloadSecurityAgentRuleCreateAttributes: - description: Create a new Cloud Workload Security Agent rule. - properties: - description: - description: The description of the Agent rule. - example: My Agent rule - type: string - enabled: - description: Whether the Agent rule is enabled. - example: true - type: boolean - expression: - description: The SECL expression of the Agent rule. - example: exec.file.name == \"sh\" - type: string - name: - description: The name of the Agent rule. - example: my_agent_rule - type: string - required: - - name - - expression - type: object - CloudWorkloadSecurityAgentRuleUpdateRequest: - description: Request object that includes the Agent rule with the attributes to update. - properties: - data: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateData' - required: - - data - type: object - CloudWorkloadSecurityAgentRuleUpdateData: - description: Object for a single Agent rule. - properties: - attributes: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateAttributes' - type: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' - required: - - attributes - - type - type: object - CloudWorkloadSecurityAgentRuleUpdateAttributes: - description: Update an existing Cloud Workload Security Agent rule. - properties: - description: - description: The description of the Agent rule. - example: My Agent rule - type: string - enabled: - description: Whether the Agent rule is enabled. - example: true - type: boolean - expression: - description: The SECL expression of the Agent rule. - example: exec.file.name == \"sh\" - type: string - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ConflictResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - ConcurrentModificationResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Concurrent Modification - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - cloud_workload_policy_files: - id: datadog.cloud_workload_security.cloud_workload_policy_files - name: cloud_workload_policy_files - title: Cloud Workload Policy Files - methods: - download_cloud_workload_policy_file: - operation: - $ref: '#/paths/~1api~1v2~1security~1cloud_workload~1policy~1download/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _download_cloud_workload_policy_file: - operation: - $ref: '#/paths/~1api~1v2~1security~1cloud_workload~1policy~1download/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: [] - insert: [] - update: [] - delete: [] - cloud_workload_security_agent_rules: - id: datadog.cloud_workload_security.cloud_workload_security_agent_rules - name: cloud_workload_security_agent_rules - title: Cloud Workload Security Agent Rules - methods: - list_cloud_workload_security_agent_rules: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_cloud_workload_security_agent_rules: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_cloud_workload_security_agent_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_cloud_workload_security_agent_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules~1{agent_rule_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_cloud_workload_security_agent_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules~1{agent_rule_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_cloud_workload_security_agent_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules~1{agent_rule_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_cloud_workload_security_agent_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules~1{agent_rule_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/get_cloud_workload_security_agent_rule' - - $ref: '#/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/list_cloud_workload_security_agent_rules' - insert: - - $ref: '#/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/create_cloud_workload_security_agent_rule' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/delete_cloud_workload_security_agent_rule' -paths: - /api/v2/security/cloud_workload/policy/download: - get: - description: |- - The download endpoint generates a Cloud Workload Security policy file from your currently active - Cloud Workload Security rules, and downloads them as a .policy file. This file can then be deployed to - your Agents to update the policy running in your environment. - operationId: DownloadCloudWorkloadPolicyFile - responses: - '200': - content: - application/yaml: - schema: - format: binary - type: string - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get the latest Cloud Workload Security policy - tags: - - Cloud Workload Security - /api/v2/security_monitoring/cloud_workload_security/agent_rules: - get: - description: Get the list of Agent rules. - operationId: ListCloudWorkloadSecurityAgentRules - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRulesListResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get all Cloud Workload Security Agent rules - tags: - - Cloud Workload Security - post: - description: Create a new Agent rule with the given parameters. - operationId: CreateCloudWorkloadSecurityAgentRule - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateRequest' - description: The definition of the new Agent rule. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a Cloud Workload Security Agent rule - tags: - - Cloud Workload Security - x-codegen-request-body-name: body - '/api/v2/security_monitoring/cloud_workload_security/agent_rules/{agent_rule_id}': - delete: - description: Delete a specific Agent rule. - operationId: DeleteCloudWorkloadSecurityAgentRule - parameters: - - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' - responses: - '204': - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete a Cloud Workload Security Agent rule - tags: - - Cloud Workload Security - get: - description: Get the details of a specific Agent rule. - operationId: GetCloudWorkloadSecurityAgentRule - parameters: - - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get a Cloud Workload Security Agent rule - tags: - - Cloud Workload Security - patch: - description: |- - Update a specific Agent rule. - Returns the Agent rule object when the request is successful. - operationId: UpdateCloudWorkloadSecurityAgentRule - parameters: - - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateRequest' - description: New definition of the Agent rule. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '409': - $ref: '#/components/responses/ConcurrentModificationResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update a Cloud Workload Security Agent rule - tags: - - Cloud Workload Security - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/cloudflare_integration.yaml b/providers/src/datadog/v00.00.00000/services/cloudflare_integration.yaml deleted file mode 100644 index c24a06e3..00000000 --- a/providers/src/datadog/v00.00.00000/services/cloudflare_integration.yaml +++ /dev/null @@ -1,1209 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - cloudflare_integration - description: Cloudflare_Integration -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - CloudflareAccountsResponse: - description: The expected response schema when getting Cloudflare accounts. - properties: - data: - description: 'The JSON:API data schema.' - items: - $ref: '#/components/schemas/CloudflareAccountResponseData' - type: array - type: object - CloudflareAccountResponseData: - description: Data object of a Cloudflare account. - properties: - attributes: - $ref: '#/components/schemas/CloudflareAccountResponseAttributes' - id: - description: 'The ID of the Cloudflare account, a hash of the account name.' - example: c1a8e059bfd1e911cf10b626340c9a54 - type: string - type: - $ref: '#/components/schemas/CloudflareAccountType' - required: - - attributes - - id - - type - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - CloudflareAccountResponseAttributes: - description: Attributes object of a Cloudflare account. - properties: - email: - description: The email associated with the Cloudflare account. - example: test-email@example.com - type: string - name: - description: The name of the Cloudflare account. - example: test-name - type: string - required: - - name - type: object - CloudflareAccountType: - default: cloudflare-accounts - description: 'The JSON:API type for this API. Should always be `cloudflare-accounts`.' - enum: - - cloudflare-accounts - example: cloudflare-accounts - type: string - x-enum-varnames: - - CLOUDFLARE_ACCOUNTS - CloudflareAccountCreateRequest: - description: Payload schema when adding a Cloudflare account. - properties: - data: - $ref: '#/components/schemas/CloudflareAccountCreateRequestData' - required: - - data - type: object - CloudflareAccountResponse: - description: The expected response schema when getting a Cloudflare account. - properties: - data: - $ref: '#/components/schemas/CloudflareAccountResponseData' - type: object - CloudflareAccountCreateRequestData: - description: Data object for creating a Cloudflare account. - properties: - attributes: - $ref: '#/components/schemas/CloudflareAccountCreateRequestAttributes' - type: - $ref: '#/components/schemas/CloudflareAccountType' - required: - - attributes - - type - type: object - CloudflareAccountCreateRequestAttributes: - description: Attributes object for creating a Cloudflare account. - properties: - api_key: - description: The API key (or token) for the Cloudflare account. - example: a94a8fe5ccb19ba61c4c0873d391e987982fbbd3 - type: string - email: - description: 'The email associated with the Cloudflare account. If an API key is provided (and not a token), this field is also required.' - example: test-email@example.com - type: string - name: - description: The name of the Cloudflare account. - example: test-name - type: string - required: - - api_key - - name - type: object - CloudflareAccountUpdateRequest: - description: Payload schema when updating a Cloudflare account. - properties: - data: - $ref: '#/components/schemas/CloudflareAccountUpdateRequestData' - required: - - data - type: object - CloudflareAccountUpdateRequestData: - description: Data object for updating a Cloudflare account. - properties: - attributes: - $ref: '#/components/schemas/CloudflareAccountUpdateRequestAttributes' - type: - $ref: '#/components/schemas/CloudflareAccountType' - type: object - CloudflareAccountUpdateRequestAttributes: - description: Attributes object for updating a Cloudflare account. - properties: - api_key: - description: The API key of the Cloudflare account. - example: a94a8fe5ccb19ba61c4c0873d391e987982fbbd3 - type: string - email: - description: 'The email associated with the Cloudflare account. If an API key is provided (and not a token), this field is also required.' - example: test-email@example.com - type: string - required: - - api_key - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - cloudflare_accounts: - id: datadog.cloudflare_integration.cloudflare_accounts - name: cloudflare_accounts - title: Cloudflare Accounts - methods: - list_cloudflare_accounts: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_cloudflare_accounts: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_cloudflare_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_cloudflare_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts~1{account_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_cloudflare_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts~1{account_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_cloudflare_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts~1{account_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_cloudflare_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts~1{account_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/cloudflare_accounts/methods/get_cloudflare_account' - - $ref: '#/components/x-stackQL-resources/cloudflare_accounts/methods/list_cloudflare_accounts' - insert: - - $ref: '#/components/x-stackQL-resources/cloudflare_accounts/methods/create_cloudflare_account' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/cloudflare_accounts/methods/delete_cloudflare_account' -paths: - /api/v2/integrations/cloudflare/accounts: - get: - description: List Cloudflare accounts. - operationId: ListCloudflareAccounts - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CloudflareAccountsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List Cloudflare accounts - tags: - - Cloudflare Integration - post: - description: Create a Cloudflare account. - operationId: CreateCloudflareAccount - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CloudflareAccountCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/CloudflareAccountResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Add Cloudflare account - tags: - - Cloudflare Integration - x-codegen-request-body-name: body - '/api/v2/integrations/cloudflare/accounts/{account_id}': - delete: - description: Delete a Cloudflare account. - operationId: DeleteCloudflareAccount - parameters: - - description: None - in: path - name: account_id - required: true - schema: - type: string - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete Cloudflare account - tags: - - Cloudflare Integration - get: - description: Get a Cloudflare account. - operationId: GetCloudflareAccount - parameters: - - description: None - in: path - name: account_id - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CloudflareAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get Cloudflare account - tags: - - Cloudflare Integration - patch: - description: Update a Cloudflare account. - operationId: UpdateCloudflareAccount - parameters: - - description: None - in: path - name: account_id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CloudflareAccountUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/CloudflareAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update Cloudflare account - tags: - - Cloudflare Integration - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/confluent_cloud.yaml b/providers/src/datadog/v00.00.00000/services/confluent_cloud.yaml deleted file mode 100644 index 309c09ba..00000000 --- a/providers/src/datadog/v00.00.00000/services/confluent_cloud.yaml +++ /dev/null @@ -1,1561 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - confluent_cloud - description: Confluent_Cloud -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ConfluentAccountsResponse: - description: Confluent account returned by the API. - properties: - data: - description: The Confluent account. - items: - $ref: '#/components/schemas/ConfluentAccountResponseData' - type: array - type: object - ConfluentAccountResponseData: - description: An API key and API secret pair that represents a Confluent account. - properties: - attributes: - $ref: '#/components/schemas/ConfluentAccountResponseAttributes' - id: - description: A randomly generated ID associated with a Confluent account. - example: account_id_abc123 - type: string - type: - $ref: '#/components/schemas/ConfluentAccountType' - required: - - attributes - - id - - type - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - ConfluentAccountResponseAttributes: - description: The attributes of a Confluent account. - properties: - api_key: - description: The API key associated with your Confluent account. - example: TESTAPIKEY123 - type: string - resources: - description: A list of Confluent resources associated with the Confluent account. - items: - $ref: '#/components/schemas/ConfluentResourceResponseAttributes' - type: array - tags: - description: 'A list of strings representing tags. Can be a single key, or key-value pairs separated by a colon.' - example: - - myTag - - 'myTag2:myValue' - items: - type: string - type: array - required: - - api_key - type: object - ConfluentAccountType: - default: confluent-cloud-accounts - description: 'The JSON:API type for this API. Should always be `confluent-cloud-accounts`.' - enum: - - confluent-cloud-accounts - example: confluent-cloud-accounts - type: string - x-enum-varnames: - - CONFLUENT_CLOUD_ACCOUNTS - ConfluentResourceResponseAttributes: - description: Model representation of a Confluent Cloud resource. - properties: - enable_custom_metrics: - default: false - description: 'Enable the `custom.consumer_lag_offset` metric, which contains extra metric tags.' - example: false - type: boolean - id: - description: The ID associated with the Confluent resource. - example: resource_id_abc123 - type: string - resource_type: - description: 'The resource type of the Resource. Can be `kafka`, `connector`, `ksql`, or `schema_registry`.' - example: kafka - type: string - tags: - description: 'A list of strings representing tags. Can be a single key, or key-value pairs separated by a colon.' - example: - - myTag - - 'myTag2:myValue' - items: - type: string - type: array - required: - - resource_type - type: object - ConfluentAccountCreateRequest: - description: Payload schema when adding a Confluent account. - properties: - data: - $ref: '#/components/schemas/ConfluentAccountCreateRequestData' - required: - - data - type: object - ConfluentAccountResponse: - description: The expected response schema when getting a Confluent account. - properties: - data: - $ref: '#/components/schemas/ConfluentAccountResponseData' - type: object - ConfluentAccountCreateRequestData: - description: The data body for adding a Confluent account. - properties: - attributes: - $ref: '#/components/schemas/ConfluentAccountCreateRequestAttributes' - type: - $ref: '#/components/schemas/ConfluentAccountType' - required: - - attributes - - type - type: object - ConfluentAccountCreateRequestAttributes: - description: Attributes associated with the account creation request. - properties: - api_key: - description: The API key associated with your Confluent account. - example: TESTAPIKEY123 - type: string - api_secret: - description: The API secret associated with your Confluent account. - example: test-api-secret-123 - type: string - resources: - description: A list of Confluent resources associated with the Confluent account. - items: - $ref: '#/components/schemas/ConfluentAccountResourceAttributes' - type: array - tags: - description: 'A list of strings representing tags. Can be a single key, or key-value pairs separated by a colon.' - example: - - myTag - - 'myTag2:myValue' - items: - type: string - type: array - required: - - api_key - - api_secret - type: object - ConfluentAccountResourceAttributes: - description: Attributes object for updating a Confluent resource. - properties: - enable_custom_metrics: - default: false - description: 'Enable the `custom.consumer_lag_offset` metric, which contains extra metric tags.' - example: false - type: boolean - id: - description: The ID associated with a Confluent resource. - example: resource-id-123 - type: string - resource_type: - description: 'The resource type of the Resource. Can be `kafka`, `connector`, `ksql`, or `schema_registry`.' - example: kafka - type: string - tags: - description: 'A list of strings representing tags. Can be a single key, or key-value pairs separated by a colon.' - example: - - myTag - - 'myTag2:myValue' - items: - type: string - type: array - required: - - resource_type - type: object - ConfluentAccountUpdateRequest: - description: 'The JSON:API request for updating a Confluent account.' - properties: - data: - $ref: '#/components/schemas/ConfluentAccountUpdateRequestData' - required: - - data - type: object - ConfluentAccountUpdateRequestData: - description: Data object for updating a Confluent account. - properties: - attributes: - $ref: '#/components/schemas/ConfluentAccountUpdateRequestAttributes' - type: - $ref: '#/components/schemas/ConfluentAccountType' - required: - - attributes - - type - type: object - ConfluentAccountUpdateRequestAttributes: - description: Attributes object for updating a Confluent account. - properties: - api_key: - description: The API key associated with your Confluent account. - example: TESTAPIKEY123 - type: string - api_secret: - description: The API secret associated with your Confluent account. - example: test-api-secret-123 - type: string - tags: - description: 'A list of strings representing tags. Can be a single key, or key-value pairs separated by a colon.' - example: - - myTag - - 'myTag2:myValue' - items: - type: string - type: array - required: - - api_key - - api_secret - type: object - ConfluentResourcesResponse: - description: Response schema when interacting with a list of Confluent resources. - properties: - data: - description: 'The JSON:API data attribute.' - items: - $ref: '#/components/schemas/ConfluentResourceResponseData' - type: array - type: object - ConfluentResourceResponseData: - description: Confluent Cloud resource data. - properties: - attributes: - $ref: '#/components/schemas/ConfluentResourceResponseAttributes' - id: - description: The ID associated with the Confluent resource. - example: resource_id_abc123 - type: string - type: - $ref: '#/components/schemas/ConfluentResourceType' - required: - - attributes - - type - - id - type: object - ConfluentResourceType: - default: confluent-cloud-resources - description: 'The JSON:API type for this request.' - enum: - - confluent-cloud-resources - example: confluent-cloud-resources - type: string - x-enum-varnames: - - CONFLUENT_CLOUD_RESOURCES - ConfluentResourceRequest: - description: 'The JSON:API request for updating a Confluent resource.' - properties: - data: - $ref: '#/components/schemas/ConfluentResourceRequestData' - required: - - data - type: object - ConfluentResourceResponse: - description: Response schema when interacting with a Confluent resource. - properties: - data: - $ref: '#/components/schemas/ConfluentResourceResponseData' - type: object - ConfluentResourceRequestData: - description: 'JSON:API request for updating a Confluent resource.' - properties: - attributes: - $ref: '#/components/schemas/ConfluentResourceRequestAttributes' - id: - description: The ID associated with a Confluent resource. - example: resource-id-123 - type: string - type: - $ref: '#/components/schemas/ConfluentResourceType' - required: - - attributes - - type - - id - type: object - ConfluentResourceRequestAttributes: - description: Attributes object for updating a Confluent resource. - properties: - enable_custom_metrics: - default: false - description: 'Enable the `custom.consumer_lag_offset` metric, which contains extra metric tags.' - example: false - type: boolean - resource_type: - description: 'The resource type of the Resource. Can be `kafka`, `connector`, `ksql`, or `schema_registry`.' - example: kafka - type: string - tags: - description: 'A list of strings representing tags. Can be a single key, or key-value pairs separated by a colon.' - example: - - myTag - - 'myTag2:myValue' - items: - type: string - type: array - required: - - resource_type - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - confluent_accounts: - id: datadog.confluent_cloud.confluent_accounts - name: confluent_accounts - title: Confluent Accounts - methods: - list_confluent_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_confluent_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_confluent_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_confluent_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_confluent_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_confluent_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_confluent_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/confluent_accounts/methods/get_confluent_account' - - $ref: '#/components/x-stackQL-resources/confluent_accounts/methods/list_confluent_account' - insert: - - $ref: '#/components/x-stackQL-resources/confluent_accounts/methods/create_confluent_account' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/confluent_accounts/methods/delete_confluent_account' - confluent_resources: - id: datadog.confluent_cloud.confluent_resources - name: confluent_resources - title: Confluent Resources - methods: - list_confluent_resource: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_confluent_resource: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_confluent_resource: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_confluent_resource: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources~1{resource_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_confluent_resource: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources~1{resource_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_confluent_resource: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources~1{resource_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_confluent_resource: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources~1{resource_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/confluent_resources/methods/get_confluent_resource' - - $ref: '#/components/x-stackQL-resources/confluent_resources/methods/list_confluent_resource' - insert: - - $ref: '#/components/x-stackQL-resources/confluent_resources/methods/create_confluent_resource' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/confluent_resources/methods/delete_confluent_resource' -paths: - /api/v2/integrations/confluent-cloud/accounts: - get: - description: List Confluent accounts. - operationId: ListConfluentAccount - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentAccountsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List Confluent accounts - tags: - - Confluent Cloud - post: - description: Create a Confluent account. - operationId: CreateConfluentAccount - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentAccountCreateRequest' - description: Confluent payload - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Add Confluent account - tags: - - Confluent Cloud - x-codegen-request-body-name: body - '/api/v2/integrations/confluent-cloud/accounts/{account_id}': - delete: - description: Delete a Confluent account with the provided account ID. - operationId: DeleteConfluentAccount - parameters: - - $ref: '#/components/parameters/ConfluentAccountID' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete Confluent account - tags: - - Confluent Cloud - get: - description: Get the Confluent account with the provided account ID. - operationId: GetConfluentAccount - parameters: - - $ref: '#/components/parameters/ConfluentAccountID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get Confluent account - tags: - - Confluent Cloud - patch: - description: Update the Confluent account with the provided account ID. - operationId: UpdateConfluentAccount - parameters: - - $ref: '#/components/parameters/ConfluentAccountID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentAccountUpdateRequest' - description: Confluent payload - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update Confluent account - tags: - - Confluent Cloud - x-codegen-request-body-name: body - '/api/v2/integrations/confluent-cloud/accounts/{account_id}/resources': - get: - description: Get a Confluent resource for the account associated with the provided ID. - operationId: ListConfluentResource - parameters: - - $ref: '#/components/parameters/ConfluentAccountID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentResourcesResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List Confluent Account resources - tags: - - Confluent Cloud - post: - description: Create a Confluent resource for the account associated with the provided ID. - operationId: CreateConfluentResource - parameters: - - $ref: '#/components/parameters/ConfluentAccountID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentResourceRequest' - description: Confluent payload - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentResourceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Add resource to Confluent account - tags: - - Confluent Cloud - x-codegen-request-body-name: body - '/api/v2/integrations/confluent-cloud/accounts/{account_id}/resources/{resource_id}': - delete: - description: Delete a Confluent resource with the provided resource id for the account associated with the provided account ID. - operationId: DeleteConfluentResource - parameters: - - $ref: '#/components/parameters/ConfluentAccountID' - - $ref: '#/components/parameters/ConfluentResourceID' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete resource from Confluent account - tags: - - Confluent Cloud - get: - description: Get a Confluent resource with the provided resource id for the account associated with the provided account ID. - operationId: GetConfluentResource - parameters: - - $ref: '#/components/parameters/ConfluentAccountID' - - $ref: '#/components/parameters/ConfluentResourceID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentResourceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get resource from Confluent account - tags: - - Confluent Cloud - patch: - description: Update a Confluent resource with the provided resource id for the account associated with the provided account ID. - operationId: UpdateConfluentResource - parameters: - - $ref: '#/components/parameters/ConfluentAccountID' - - $ref: '#/components/parameters/ConfluentResourceID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentResourceRequest' - description: Confluent payload - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ConfluentResourceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update resource in Confluent account - tags: - - Confluent Cloud - x-codegen-request-body-name: body - x-permission: - operator: OR - permissions: - - STANDARD diff --git a/providers/src/datadog/v00.00.00000/services/containers.yaml b/providers/src/datadog/v00.00.00000/services/containers.yaml deleted file mode 100644 index 8216dac5..00000000 --- a/providers/src/datadog/v00.00.00000/services/containers.yaml +++ /dev/null @@ -1,1581 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - containers - description: Container_Images -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ContainerImagesResponse: - description: List of Container Images. - properties: - data: - description: Array of Container Image objects. - items: - $ref: '#/components/schemas/ContainerImageItem' - type: array - links: - $ref: '#/components/schemas/ContainerImagesResponseLinks' - meta: - $ref: '#/components/schemas/ContainerImageMeta' - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - ContainerImageItem: - description: Possible Container Image models. - oneOf: - - $ref: '#/components/schemas/ContainerImage' - - $ref: '#/components/schemas/ContainerImageGroup' - ContainerImagesResponseLinks: - description: Pagination links. - properties: - first: - description: Link to the first page. - type: string - last: - description: Link to the last page. - nullable: true - type: string - next: - description: Link to the next page. - nullable: true - type: string - prev: - description: Link to previous page. - nullable: true - type: string - self: - description: Link to current page. - type: string - type: object - ContainerImageMeta: - description: Response metadata object. - properties: - pagination: - $ref: '#/components/schemas/ContainerImageMetaPage' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - ContainerImage: - description: Container Image object. - properties: - attributes: - $ref: '#/components/schemas/ContainerImageAttributes' - id: - description: Container Image ID. - type: string - type: - $ref: '#/components/schemas/ContainerImageType' - type: object - ContainerImageGroup: - description: Container Image Group object. - properties: - attributes: - $ref: '#/components/schemas/ContainerImageGroupAttributes' - id: - description: Container Image Group ID. - type: string - relationships: - $ref: '#/components/schemas/ContainerImageGroupRelationships' - type: - $ref: '#/components/schemas/ContainerImageGroupType' - type: object - ContainerImageMetaPage: - description: Paging attributes. - properties: - cursor: - description: 'The cursor used to get the current results, if any.' - type: string - limit: - description: Number of results returned - format: int32 - maximum: 10000 - minimum: 0 - type: integer - next_cursor: - description: 'The cursor used to get the next results, if any.' - type: string - prev_cursor: - description: 'The cursor used to get the previous results, if any.' - nullable: true - type: string - total: - description: Total number of records that match the query. - format: int64 - type: integer - type: - $ref: '#/components/schemas/ContainerImageMetaPageType' - type: object - ContainerImageAttributes: - description: Attributes for a Container Image. - properties: - container_count: - description: Number of containers running the image. - format: int64 - type: integer - image_flavors: - description: |- - List of platform-specific images associated with the image record. - The list contains more than 1 entry for multi-architecture images. - items: - $ref: '#/components/schemas/ContainerImageFlavor' - type: array - image_tags: - description: List of image tags associated with the Container Image. - items: - description: An image tag associated with the Container Image. - type: string - type: array - images_built_at: - description: |- - List of build times associated with the Container Image. - The list contains more than 1 entry for multi-architecture images. - items: - description: Time the platform-specific Container Image was built. - type: string - type: array - name: - description: Name of the Container Image. - type: string - os_architectures: - description: List of Operating System architectures supported by the Container Image. - items: - description: Operating System architecture supported by the Container Image. - example: amd64 - type: string - type: array - os_names: - description: List of Operating System names supported by the Container Image. - items: - description: Operating System supported by the Container Image. - example: linux - type: string - type: array - os_versions: - description: List of Operating System versions supported by the Container Image. - items: - description: Operating System version supported by the Container Image. - type: string - type: array - published_at: - description: Time the image was pushed to the container registry. - type: string - registry: - description: Registry the Container Image was pushed to. - type: string - repo_digest: - description: Digest of the compressed image manifest. - type: string - repository: - description: Repository where the Container Image is stored in. - type: string - short_image: - description: Short version of the Container Image name. - type: string - sizes: - description: |- - List of size for each platform-specific image associated with the image record. - The list contains more than 1 entry for multi-architecture images. - items: - description: Size of the platform-specific Container Image. - format: int64 - type: integer - type: array - sources: - description: List of sources where the Container Image was collected from. - items: - description: Source where the Container Image was collected from. - type: string - type: array - tags: - description: List of tags associated with the Container Image. - items: - description: A tag associated with the Container Image. - type: string - type: array - vulnerability_count: - $ref: '#/components/schemas/ContainerImageVulnerabilities' - type: object - ContainerImageType: - default: container_image - description: Type of Container Image. - enum: - - container_image - example: container_image - type: string - x-enum-varnames: - - CONTAINER_IMAGE - ContainerImageGroupAttributes: - description: Attributes for a Container Image Group. - properties: - count: - description: Number of Container Images in the group. - format: int64 - type: integer - name: - description: Name of the Container Image group. - type: string - tags: - description: Tags from the group name parsed in key/value format. - type: object - type: object - ContainerImageGroupRelationships: - description: Relationships inside a Container Image Group. - properties: - container_images: - $ref: '#/components/schemas/ContainerImageGroupImagesRelationshipsLink' - type: object - ContainerImageGroupType: - default: container_image_group - description: Type of Container Image Group. - enum: - - container_image_group - example: container_image_group - type: string - x-enum-varnames: - - CONTAINER_IMAGE_GROUP - ContainerImageMetaPageType: - default: cursor_limit - description: Type of Container Image pagination. - enum: - - cursor_limit - example: cursor_limit - type: string - x-enum-varnames: - - CURSOR_LIMIT - ContainerImageFlavor: - description: Container Image breakdown by supported platform. - properties: - built_at: - description: Time the platform-specific Container Image was built. - type: string - os_architecture: - description: Operating System architecture supported by the Container Image. - type: string - os_name: - description: Operating System name supported by the Container Image. - type: string - os_version: - description: Operating System version supported by the Container Image. - type: string - size: - description: Size of the platform-specific Container Image. - format: int64 - type: integer - type: object - ContainerImageVulnerabilities: - description: Vulnerability counts associated with the Container Image. - properties: - asset_id: - description: ID of the Container Image. - type: string - critical: - description: Number of vulnerabilities with CVSS Critical severity. - format: int64 - type: integer - high: - description: Number of vulnerabilities with CVSS High severity. - format: int64 - type: integer - low: - description: Number of vulnerabilities with CVSS Low severity. - format: int64 - type: integer - medium: - description: Number of vulnerabilities with CVSS Medium severity. - format: int64 - type: integer - none: - description: Number of vulnerabilities with CVSS None severity. - format: int64 - type: integer - unknown: - description: Number of vulnerabilities with an unknown CVSS severity. - format: int64 - type: integer - type: object - ContainerImageGroupImagesRelationshipsLink: - description: Relationships to Container Images inside a Container Image Group. - properties: - data: - $ref: '#/components/schemas/ContainerImageGroupRelationshipsData' - links: - $ref: '#/components/schemas/ContainerImageGroupRelationshipsLinks' - type: object - ContainerImageGroupRelationshipsData: - description: Links data. - items: - description: A link data. - type: string - type: array - ContainerImageGroupRelationshipsLinks: - description: Links attributes. - properties: - related: - description: Link to related Container Images. - type: string - type: object - ContainersResponse: - description: List of containers. - properties: - data: - description: Array of Container objects. - items: - $ref: '#/components/schemas/ContainerItem' - type: array - links: - $ref: '#/components/schemas/ContainersResponseLinks' - meta: - $ref: '#/components/schemas/ContainerMeta' - type: object - ContainerItem: - description: Possible Container models. - oneOf: - - $ref: '#/components/schemas/Container' - - $ref: '#/components/schemas/ContainerGroup' - ContainersResponseLinks: - description: Pagination links. - properties: - first: - description: Link to the first page. - type: string - last: - description: Link to the last page. - nullable: true - type: string - next: - description: Link to the next page. - nullable: true - type: string - prev: - description: Link to previous page. - nullable: true - type: string - self: - description: Link to current page. - type: string - type: object - ContainerMeta: - description: Response metadata object. - properties: - pagination: - $ref: '#/components/schemas/ContainerMetaPage' - type: object - Container: - description: Container object. - properties: - attributes: - $ref: '#/components/schemas/ContainerAttributes' - id: - description: Container ID. - type: string - type: - $ref: '#/components/schemas/ContainerType' - type: object - ContainerGroup: - description: Container group object. - properties: - attributes: - $ref: '#/components/schemas/ContainerGroupAttributes' - id: - description: Container Group ID. - type: string - relationships: - $ref: '#/components/schemas/ContainerGroupRelationships' - type: - $ref: '#/components/schemas/ContainerGroupType' - type: object - ContainerMetaPage: - description: Paging attributes. - properties: - cursor: - description: 'The cursor used to get the current results, if any.' - type: string - limit: - description: Number of results returned - format: int32 - maximum: 10000 - minimum: 0 - type: integer - next_cursor: - description: 'The cursor used to get the next results, if any.' - type: string - prev_cursor: - description: 'The cursor used to get the previous results, if any.' - nullable: true - type: string - total: - description: Total number of records that match the query. - format: int64 - type: integer - type: - $ref: '#/components/schemas/ContainerMetaPageType' - type: object - ContainerAttributes: - description: Attributes for a container. - properties: - container_id: - description: The ID of the container. - type: string - created_at: - description: Time the container was created. - type: string - host: - description: Hostname of the host running the container. - type: string - image_digest: - description: Digest of the compressed image manifest. - nullable: true - type: string - image_name: - description: Name of the associated container image. - type: string - image_tags: - description: List of image tags associated with the container image. - items: - type: string - nullable: true - type: array - name: - description: Name of the container. - type: string - started_at: - description: Time the container was started. - type: string - state: - description: State of the container. This depends on the container runtime. - type: string - tags: - description: List of tags associated with the container. - items: - type: string - type: array - type: object - ContainerType: - default: container - description: Type of container. - enum: - - container - example: container - type: string - x-enum-varnames: - - CONTAINER - ContainerGroupAttributes: - description: Attributes for a container group. - properties: - count: - description: Number of containers in the group. - format: int64 - type: integer - tags: - description: Tags from the group name parsed in key/value format. - type: object - type: object - ContainerGroupRelationships: - description: Relationships to containers inside a container group. - properties: - containers: - $ref: '#/components/schemas/ContainerGroupRelationshipsLink' - type: object - ContainerGroupType: - default: container_group - description: Type of container group. - enum: - - container_group - example: container_group - type: string - x-enum-varnames: - - CONTAINER_GROUP - ContainerMetaPageType: - default: cursor_limit - description: Type of Container pagination. - enum: - - cursor_limit - example: cursor_limit - type: string - x-enum-varnames: - - CURSOR_LIMIT - ContainerGroupRelationshipsLink: - description: Relationships to Containers inside a Container Group. - properties: - data: - $ref: '#/components/schemas/ContainerGroupRelationshipsData' - links: - $ref: '#/components/schemas/ContainerGroupRelationshipsLinks' - type: object - ContainerGroupRelationshipsData: - description: Links data. - items: - description: A link data. - type: string - type: array - ContainerGroupRelationshipsLinks: - description: Links attributes. - properties: - related: - description: Link to related containers. - type: string - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - images: - id: datadog.containers.images - name: images - title: Images - methods: - list_container_images: - operation: - $ref: '#/paths/~1api~1v2~1container_images/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_container_images: - operation: - $ref: '#/paths/~1api~1v2~1container_images/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/images/methods/list_container_images' - insert: [] - update: [] - delete: [] - containers: - id: datadog.containers.containers - name: containers - title: Containers - methods: - list_containers: - operation: - $ref: '#/paths/~1api~1v2~1containers/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_containers: - operation: - $ref: '#/paths/~1api~1v2~1containers/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/containers/methods/list_containers' - insert: [] - update: [] - delete: [] -paths: - /api/v2/container_images: - get: - description: Get all Container Images for your organization. - operationId: ListContainerImages - parameters: - - description: Comma-separated list of tags to filter Container Images by. - example: 'short_image:redis,status:running' - in: query - name: 'filter[tags]' - required: false - schema: - type: string - - description: Comma-separated list of tags to group Container Images by. - example: 'registry,image_tags' - in: query - name: group_by - required: false - schema: - type: string - - description: Attribute to sort Container Images by. - example: container_count - in: query - name: sort - required: false - schema: - type: string - - description: Maximum number of results returned. - in: query - name: 'page[size]' - required: false - schema: - default: 1000 - format: int32 - maximum: 10000 - minimum: 1 - type: integer - - description: |- - String to query the next page of results. - This key is provided with each valid response from the API in `meta.pagination.next_cursor`. - in: query - name: 'page[cursor]' - required: false - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ContainerImagesResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get all Container Images - tags: - - Container Images - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.pagination.next_cursor - limitParam: 'page[size]' - resultsPath: data - /api/v2/containers: - get: - description: Get all containers for your organization. - operationId: ListContainers - parameters: - - description: Comma-separated list of tags to filter containers by. - example: 'env:prod,short_image:cassandra' - in: query - name: 'filter[tags]' - required: false - schema: - type: string - - description: Comma-separated list of tags to group containers by. - example: 'datacenter,cluster' - in: query - name: group_by - required: false - schema: - type: string - - description: Attribute to sort containers by. - example: started_at - in: query - name: sort - required: false - schema: - type: string - - description: Maximum number of results returned. - in: query - name: 'page[size]' - required: false - schema: - default: 1000 - format: int32 - maximum: 10000 - minimum: 1 - type: integer - - description: |- - String to query the next page of results. - This key is provided with each valid response from the API in `meta.pagination.next_cursor`. - in: query - name: 'page[cursor]' - required: false - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ContainersResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get All Containers - tags: - - Containers - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.pagination.next_cursor - limitParam: 'page[size]' - resultsPath: data diff --git a/providers/src/datadog/v00.00.00000/services/dashboard_lists.yaml b/providers/src/datadog/v00.00.00000/services/dashboard_lists.yaml deleted file mode 100644 index c8c5d643..00000000 --- a/providers/src/datadog/v00.00.00000/services/dashboard_lists.yaml +++ /dev/null @@ -1,1303 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - dashboard_lists - description: Dashboard_Lists -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - DashboardListDeleteItemsRequest: - description: Request containing a list of dashboards to delete. - properties: - dashboards: - description: List of dashboards to delete from the dashboard list. - items: - $ref: '#/components/schemas/DashboardListItemRequest' - type: array - type: object - DashboardListDeleteItemsResponse: - description: Response containing a list of deleted dashboards. - properties: - deleted_dashboards_from_list: - description: List of dashboards deleted from the dashboard list. - items: - $ref: '#/components/schemas/DashboardListItemResponse' - type: array - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - DashboardListItemRequest: - description: A dashboard within a list. - properties: - id: - description: ID of the dashboard. - example: q5j-nti-fv6 - type: string - type: - $ref: '#/components/schemas/DashboardType' - required: - - type - - id - type: object - DashboardListItemResponse: - description: A dashboard within a list. - properties: - id: - description: ID of the dashboard. - example: q5j-nti-fv6 - readOnly: true - type: string - type: - $ref: '#/components/schemas/DashboardType' - required: - - type - - id - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - DashboardType: - description: The type of the dashboard. - enum: - - custom_timeboard - - custom_screenboard - - integration_screenboard - - integration_timeboard - - host_timeboard - example: host_timeboard - type: string - x-enum-varnames: - - CUSTOM_TIMEBOARD - - CUSTOM_SCREENBOARD - - INTEGRATION_SCREENBOARD - - INTEGRATION_TIMEBOARD - - HOST_TIMEBOARD - DashboardListItems: - description: Dashboards within a list. - properties: - dashboards: - description: List of dashboards in the dashboard list. - example: [] - items: - $ref: '#/components/schemas/DashboardListItem' - type: array - total: - description: Number of dashboards in the dashboard list. - format: int64 - readOnly: true - type: integer - required: - - dashboards - type: object - DashboardListItem: - description: A dashboard within a list. - properties: - author: - $ref: '#/components/schemas/Creator' - created: - description: Date of creation of the dashboard. - format: date-time - readOnly: true - type: string - icon: - description: URL to the icon of the dashboard. - nullable: true - readOnly: true - type: string - id: - description: ID of the dashboard. - example: q5j-nti-fv6 - type: string - integration_id: - description: The short name of the integration. - nullable: true - readOnly: true - type: string - is_favorite: - description: Whether or not the dashboard is in the favorites. - readOnly: true - type: boolean - is_read_only: - description: Whether or not the dashboard is read only. - readOnly: true - type: boolean - is_shared: - description: Whether the dashboard is publicly shared or not. - readOnly: true - type: boolean - modified: - description: Date of last edition of the dashboard. - format: date-time - readOnly: true - type: string - popularity: - description: Popularity of the dashboard. - format: int32 - maximum: 5 - readOnly: true - type: integer - tags: - description: List of team names representing ownership of a dashboard. - items: - description: 'The name of a Datadog team, formatted as `team:`' - type: string - maxItems: 5 - nullable: true - readOnly: true - type: array - title: - description: Title of the dashboard. - readOnly: true - type: string - type: - $ref: '#/components/schemas/DashboardType' - url: - description: URL path to the dashboard. - readOnly: true - type: string - required: - - type - - id - type: object - Creator: - description: Creator of the object. - properties: - email: - description: Email of the creator. - type: string - handle: - description: Handle of the creator. - type: string - name: - description: Name of the creator. - nullable: true - type: string - type: object - DashboardListAddItemsRequest: - description: Request containing a list of dashboards to add. - properties: - dashboards: - description: List of dashboards to add the dashboard list. - items: - $ref: '#/components/schemas/DashboardListItemRequest' - type: array - type: object - DashboardListAddItemsResponse: - description: Response containing a list of added dashboards. - properties: - added_dashboards_to_list: - description: List of dashboards added to the dashboard list. - items: - $ref: '#/components/schemas/DashboardListItemResponse' - type: array - type: object - DashboardListUpdateItemsRequest: - description: Request containing the list of dashboards to update to. - properties: - dashboards: - description: List of dashboards to update the dashboard list to. - items: - $ref: '#/components/schemas/DashboardListItemRequest' - type: array - type: object - DashboardListUpdateItemsResponse: - description: Response containing a list of updated dashboards. - properties: - dashboards: - description: List of dashboards in the dashboard list. - items: - $ref: '#/components/schemas/DashboardListItemResponse' - type: array - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - dashboard_list_items: - id: datadog.dashboard_lists.dashboard_list_items - name: dashboard_list_items - title: Dashboard List Items - methods: - delete_dashboard_list_items: - operation: - $ref: '#/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/delete' - response: - mediaType: application/json - openAPIDocKey: '200' - get_dashboard_list_items: - operation: - $ref: '#/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.dashboards - _get_dashboard_list_items: - operation: - $ref: '#/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_dashboard_list_items: - operation: - $ref: '#/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/post' - response: - mediaType: application/json - openAPIDocKey: '200' - update_dashboard_list_items: - operation: - $ref: '#/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/put' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/dashboard_list_items/methods/get_dashboard_list_items' - insert: - - $ref: '#/components/x-stackQL-resources/dashboard_list_items/methods/create_dashboard_list_items' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/dashboard_list_items/methods/delete_dashboard_list_items' -paths: - '/api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards': - delete: - description: Delete dashboards from an existing dashboard list. - operationId: DeleteDashboardListItems - parameters: - - description: ID of the dashboard list to delete items from. - in: path - name: dashboard_list_id - required: true - schema: - format: int64 - type: integer - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/DashboardListDeleteItemsRequest' - description: Dashboards to delete from the dashboard list. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DashboardListDeleteItemsResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete items from a dashboard list - tags: - - Dashboard Lists - x-codegen-request-body-name: body - get: - description: Fetch the dashboard list’s dashboard definitions. - operationId: GetDashboardListItems - parameters: - - description: ID of the dashboard list to get items from. - in: path - name: dashboard_list_id - required: true - schema: - format: int64 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DashboardListItems' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - dashboards_read - summary: Get items of a Dashboard List - tags: - - Dashboard Lists - post: - description: Add dashboards to an existing dashboard list. - operationId: CreateDashboardListItems - parameters: - - description: ID of the dashboard list to add items to. - in: path - name: dashboard_list_id - required: true - schema: - format: int64 - type: integer - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/DashboardListAddItemsRequest' - description: Dashboards to add to the dashboard list. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DashboardListAddItemsResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Add Items to a Dashboard List - tags: - - Dashboard Lists - x-codegen-request-body-name: body - put: - description: Update dashboards of an existing dashboard list. - operationId: UpdateDashboardListItems - parameters: - - description: ID of the dashboard list to update items from. - in: path - name: dashboard_list_id - required: true - schema: - format: int64 - type: integer - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/DashboardListUpdateItemsRequest' - description: New dashboards of the dashboard list. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DashboardListUpdateItemsResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update items of a dashboard list - tags: - - Dashboard Lists - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/dashboards.yaml b/providers/src/datadog/v00.00.00000/services/dashboards.yaml new file mode 100644 index 00000000..681b9ca7 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/dashboards.yaml @@ -0,0 +1,1300 @@ +openapi: 3.0.0 +info: + title: dashboards API + description: datadog dashboards API + version: '1.0' +paths: + /api/v2/dashboard/lists/manual/{dashboard_list_id}/dashboards: + delete: + description: Delete dashboards from an existing dashboard list. + operationId: DeleteDashboardListItems + parameters: + - description: ID of the dashboard list to delete items from. + in: path + name: dashboard_list_id + required: true + schema: + format: int64 + type: integer + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DashboardListDeleteItemsRequest' + description: Dashboards to delete from the dashboard list. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DashboardListDeleteItemsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete items from a dashboard list + tags: + - Dashboard Lists + x-codegen-request-body-name: body + get: + description: Fetch the dashboard list’s dashboard definitions. + operationId: GetDashboardListItems + parameters: + - description: ID of the dashboard list to get items from. + in: path + name: dashboard_list_id + required: true + schema: + format: int64 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DashboardListItems' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - dashboards_read + summary: Get items of a Dashboard List + tags: + - Dashboard Lists + x-permission: + operator: OR + permissions: + - dashboards_read + post: + description: Add dashboards to an existing dashboard list. + operationId: CreateDashboardListItems + parameters: + - description: ID of the dashboard list to add items to. + in: path + name: dashboard_list_id + required: true + schema: + format: int64 + type: integer + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DashboardListAddItemsRequest' + description: Dashboards to add to the dashboard list. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DashboardListAddItemsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Add Items to a Dashboard List + tags: + - Dashboard Lists + x-codegen-request-body-name: body + put: + description: Update dashboards of an existing dashboard list. + operationId: UpdateDashboardListItems + parameters: + - description: ID of the dashboard list to update items from. + in: path + name: dashboard_list_id + required: true + schema: + format: int64 + type: integer + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DashboardListUpdateItemsRequest' + description: New dashboards of the dashboard list. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DashboardListUpdateItemsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update items of a dashboard list + tags: + - Dashboard Lists + x-codegen-request-body-name: body + /api/v2/powerpacks: + get: + description: Get a list of all powerpacks. + operationId: ListPowerpacks + parameters: + - description: Maximum number of powerpacks in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 25 + format: int64 + maximum: 1000 + type: integer + - $ref: '#/components/parameters/PageOffset' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListPowerpacksResponse' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - dashboards_read + summary: Get all powerpacks + tags: + - Powerpack + x-pagination: + limitParam: page[limit] + pageOffsetParam: page[offset] + resultsPath: data + x-permission: + operator: OR + permissions: + - dashboards_read + post: + description: Create a powerpack. + operationId: CreatePowerpack + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/Powerpack' + description: Create a powerpack request body. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PowerpackResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - dashboards_write + summary: Create a new powerpack + tags: + - Powerpack + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - dashboards_write + /api/v2/powerpacks/{powerpack_id}: + delete: + description: Delete a powerpack. + operationId: DeletePowerpack + parameters: + - description: Powerpack id + in: path + name: powerpack_id + required: true + schema: + type: string + responses: + '204': + description: OK + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Powerpack Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - dashboards_write + summary: Delete a powerpack + tags: + - Powerpack + x-permission: + operator: OR + permissions: + - dashboards_write + get: + description: Get a powerpack. + operationId: GetPowerpack + parameters: + - description: ID of the powerpack. + in: path + name: powerpack_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PowerpackResponse' + description: OK + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Powerpack Not Found. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - dashboards_read + summary: Get a Powerpack + tags: + - Powerpack + x-permission: + operator: OR + permissions: + - dashboards_read + patch: + description: Update a powerpack. + operationId: UpdatePowerpack + parameters: + - description: ID of the powerpack. + in: path + name: powerpack_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/Powerpack' + description: Update a powerpack request body. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PowerpackResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Powerpack Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - dashboards_write + summary: Update a powerpack + tags: + - Powerpack + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - dashboards_write +components: + schemas: + DashboardListDeleteItemsRequest: + description: Request containing a list of dashboards to delete. + properties: + dashboards: + description: List of dashboards to delete from the dashboard list. + items: + $ref: '#/components/schemas/DashboardListItemRequest' + type: array + type: object + DashboardListDeleteItemsResponse: + description: Response containing a list of deleted dashboards. + properties: + deleted_dashboards_from_list: + description: List of dashboards deleted from the dashboard list. + items: + $ref: '#/components/schemas/DashboardListItemResponse' + type: array + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + DashboardListItems: + description: Dashboards within a list. + properties: + dashboards: + description: List of dashboards in the dashboard list. + example: [] + items: + $ref: '#/components/schemas/DashboardListItem' + type: array + total: + description: Number of dashboards in the dashboard list. + format: int64 + readOnly: true + type: integer + required: + - dashboards + type: object + DashboardListAddItemsRequest: + description: Request containing a list of dashboards to add. + properties: + dashboards: + description: List of dashboards to add the dashboard list. + items: + $ref: '#/components/schemas/DashboardListItemRequest' + type: array + type: object + DashboardListAddItemsResponse: + description: Response containing a list of added dashboards. + properties: + added_dashboards_to_list: + description: List of dashboards added to the dashboard list. + items: + $ref: '#/components/schemas/DashboardListItemResponse' + type: array + type: object + DashboardListUpdateItemsRequest: + description: Request containing the list of dashboards to update to. + properties: + dashboards: + description: List of dashboards to update the dashboard list to. + items: + $ref: '#/components/schemas/DashboardListItemRequest' + type: array + type: object + DashboardListUpdateItemsResponse: + description: Response containing a list of updated dashboards. + properties: + dashboards: + description: List of dashboards in the dashboard list. + items: + $ref: '#/components/schemas/DashboardListItemResponse' + type: array + type: object + ListPowerpacksResponse: + description: Response object which includes all powerpack configurations. + properties: + data: + description: List of powerpack definitions. + items: + $ref: '#/components/schemas/PowerpackData' + type: array + included: + description: Array of objects related to the users. + items: + $ref: '#/components/schemas/User' + type: array + links: + $ref: '#/components/schemas/PowerpackResponseLinks' + meta: + $ref: '#/components/schemas/PowerpacksResponseMeta' + type: object + Powerpack: + description: >- + Powerpacks are templated groups of dashboard widgets you can save from + an existing dashboard and turn into reusable packs in the widget tray. + properties: + data: + $ref: '#/components/schemas/PowerpackData' + type: object + PowerpackResponse: + description: Response object which includes a single powerpack configuration. + properties: + data: + $ref: '#/components/schemas/PowerpackData' + included: + description: Array of objects related to the users. + items: + $ref: '#/components/schemas/User' + type: array + readOnly: true + type: object + DashboardListItemRequest: + description: A dashboard within a list. + properties: + id: + description: ID of the dashboard. + example: q5j-nti-fv6 + type: string + type: + $ref: '#/components/schemas/DashboardType' + required: + - type + - id + type: object + DashboardListItemResponse: + description: A dashboard within a list. + properties: + id: + description: ID of the dashboard. + example: q5j-nti-fv6 + readOnly: true + type: string + type: + $ref: '#/components/schemas/DashboardType' + required: + - type + - id + type: object + DashboardListItem: + description: A dashboard within a list. + properties: + author: + $ref: '#/components/schemas/Creator' + created: + description: Date of creation of the dashboard. + format: date-time + readOnly: true + type: string + icon: + description: URL to the icon of the dashboard. + nullable: true + readOnly: true + type: string + id: + description: ID of the dashboard. + example: q5j-nti-fv6 + type: string + integration_id: + description: The short name of the integration. + nullable: true + readOnly: true + type: string + is_favorite: + description: Whether or not the dashboard is in the favorites. + readOnly: true + type: boolean + is_read_only: + description: Whether or not the dashboard is read only. + readOnly: true + type: boolean + is_shared: + description: Whether the dashboard is publicly shared or not. + readOnly: true + type: boolean + modified: + description: Date of last edition of the dashboard. + format: date-time + readOnly: true + type: string + popularity: + description: Popularity of the dashboard. + format: int32 + maximum: 5 + readOnly: true + type: integer + tags: + description: List of team names representing ownership of a dashboard. + items: + description: The name of a Datadog team, formatted as `team:` + type: string + maxItems: 5 + nullable: true + readOnly: true + type: array + title: + description: Title of the dashboard. + readOnly: true + type: string + type: + $ref: '#/components/schemas/DashboardType' + url: + description: URL path to the dashboard. + readOnly: true + type: string + required: + - type + - id + type: object + PowerpackData: + description: Powerpack data object. + properties: + attributes: + $ref: '#/components/schemas/PowerpackAttributes' + id: + description: ID of the powerpack. + type: string + relationships: + $ref: '#/components/schemas/PowerpackRelationships' + type: + description: Type of widget, must be powerpack. + example: powerpack + type: string + type: object + User: + description: User object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/UserAttributes' + id: + description: ID of the user. + type: string + relationships: + $ref: '#/components/schemas/UserResponseRelationships' + type: + $ref: '#/components/schemas/UsersType' + type: object + PowerpackResponseLinks: + description: Links attributes. + properties: + first: + description: Link to last page. + type: string + last: + description: Link to first page. + example: >- + https://app.datadoghq.com/api/v2/powerpacks?page[offset]=0&page[limit]=25 + nullable: true + type: string + next: + description: Link for the next set of results. + example: >- + https://app.datadoghq.com/api/v2/powerpacks?page[offset]=25&page[limit]=25 + type: string + prev: + description: Link for the previous set of results. + nullable: true + type: string + self: + description: Link to current page. + example: https://app.datadoghq.com/api/v2/powerpacks + type: string + type: object + PowerpacksResponseMeta: + description: Powerpack response metadata. + properties: + pagination: + $ref: '#/components/schemas/PowerpacksResponseMetaPagination' + type: object + DashboardType: + description: The type of the dashboard. + enum: + - custom_timeboard + - custom_screenboard + - integration_screenboard + - integration_timeboard + - host_timeboard + example: host_timeboard + type: string + x-enum-varnames: + - CUSTOM_TIMEBOARD + - CUSTOM_SCREENBOARD + - INTEGRATION_SCREENBOARD + - INTEGRATION_TIMEBOARD + - HOST_TIMEBOARD + Creator: + description: Creator of the object. + properties: + email: + description: Email of the creator. + type: string + handle: + description: Handle of the creator. + type: string + name: + description: Name of the creator. + nullable: true + type: string + type: object + PowerpackAttributes: + description: Powerpack attribute object. + properties: + description: + description: Description of this powerpack. + example: Powerpack for ABC + type: string + group_widget: + $ref: '#/components/schemas/PowerpackGroupWidget' + name: + description: Name of the powerpack. + example: Sample Powerpack + type: string + tags: + description: List of tags to identify this powerpack. + example: + - tag:foo1 + items: + maxLength: 80 + type: string + maxItems: 8 + type: array + template_variables: + description: List of template variables for this powerpack. + example: + - defaults: + - '*' + name: test + items: + $ref: '#/components/schemas/PowerpackTemplateVariable' + type: array + required: + - group_widget + - name + type: object + PowerpackRelationships: + description: Powerpack relationship object. + properties: + author: + $ref: '#/components/schemas/RelationshipToUser' + type: object + UserAttributes: + description: Attributes of user object returned by the API. + properties: + created_at: + description: Creation time of the user. + format: date-time + type: string + disabled: + description: Whether the user is disabled. + type: boolean + email: + description: Email of the user. + type: string + handle: + description: Handle of the user. + type: string + icon: + description: URL of the user's icon. + type: string + mfa_enabled: + description: If user has MFA enabled. + readOnly: true + type: boolean + modified_at: + description: Time that the user was last modified. + format: date-time + type: string + name: + description: Name of the user. + nullable: true + type: string + service_account: + description: Whether the user is a service account. + type: boolean + status: + description: Status of the user. + type: string + title: + description: Title of the user. + nullable: true + type: string + verified: + description: Whether the user is verified. + type: boolean + type: object + UserResponseRelationships: + description: Relationships of the user object returned by the API. + properties: + org: + $ref: '#/components/schemas/RelationshipToOrganization' + other_orgs: + $ref: '#/components/schemas/RelationshipToOrganizations' + other_users: + $ref: '#/components/schemas/RelationshipToUsers' + roles: + $ref: '#/components/schemas/RelationshipToRoles' + type: object + UsersType: + default: users + description: Users resource type. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + PowerpacksResponseMetaPagination: + description: Powerpack response pagination metadata. + properties: + first_offset: + description: The first offset. + format: int64 + type: integer + last_offset: + description: The last offset. + format: int64 + nullable: true + type: integer + limit: + description: Pagination limit. + format: int64 + type: integer + next_offset: + description: The next offset. + format: int64 + type: integer + offset: + description: The offset. + format: int64 + type: integer + prev_offset: + description: The previous offset. + format: int64 + type: integer + total: + description: Total results. + format: int64 + type: integer + type: + description: Offset type. + type: string + type: object + PowerpackGroupWidget: + description: Powerpack group widget definition object. + properties: + definition: + $ref: '#/components/schemas/PowerpackGroupWidgetDefinition' + layout: + $ref: '#/components/schemas/PowerpackGroupWidgetLayout' + live_span: + $ref: '#/components/schemas/WidgetLiveSpan' + required: + - definition + type: object + PowerpackTemplateVariable: + description: Powerpack template variables. + properties: + available_values: + description: >- + The list of values that the template variable drop-down is limited + to. + example: + - my-host + - host1 + - host2 + items: + description: Template variable value. + type: string + nullable: true + type: array + defaults: + description: >- + One or many template variable default values within the saved view, + which are unioned together using `OR` if more than one is specified. + items: + description: One or many default values of the template variable. + minLength: 1 + type: string + type: array + name: + description: The name of the variable. + example: datacenter + type: string + prefix: + description: >- + The tag prefix associated with the variable. Only tags with this + prefix appear in the variable drop-down. + example: host + nullable: true + type: string + required: + - name + type: object + RelationshipToUser: + description: Relationship to user. + properties: + data: + $ref: '#/components/schemas/RelationshipToUserData' + required: + - data + type: object + RelationshipToOrganization: + description: Relationship to an organization. + properties: + data: + $ref: '#/components/schemas/RelationshipToOrganizationData' + required: + - data + type: object + RelationshipToOrganizations: + description: Relationship to organizations. + properties: + data: + description: Relationships to organization objects. + example: [] + items: + $ref: '#/components/schemas/RelationshipToOrganizationData' + type: array + required: + - data + type: object + RelationshipToUsers: + description: Relationship to users. + properties: + data: + description: Relationships to user objects. + example: [] + items: + $ref: '#/components/schemas/RelationshipToUserData' + type: array + required: + - data + type: object + RelationshipToRoles: + description: Relationship to roles. + properties: + data: + description: An array containing type and the unique identifier of a role. + items: + $ref: '#/components/schemas/RelationshipToRoleData' + type: array + type: object + PowerpackGroupWidgetDefinition: + description: Powerpack group widget object. + properties: + layout_type: + description: Layout type of widgets. + example: ordered + type: string + show_title: + description: >- + Boolean indicating whether powerpack group title should be visible + or not. + example: true + type: boolean + title: + description: Name for the group widget. + example: Sample Powerpack + type: string + type: + description: Type of widget, must be group. + example: group + type: string + widgets: + description: Widgets inside the powerpack. + example: + - definition: + content: example + type: note + layout: + height: 5 + width: 10 + x: 0 + 'y': 0 + items: + $ref: '#/components/schemas/PowerpackInnerWidgets' + type: array + required: + - widgets + - layout_type + - type + type: object + PowerpackGroupWidgetLayout: + description: Powerpack group widget layout. + properties: + height: + description: The height of the widget. Should be a non-negative integer. + example: 0 + format: int64 + minimum: 0 + type: integer + width: + description: The width of the widget. Should be a non-negative integer. + example: 0 + format: int64 + minimum: 0 + type: integer + x: + description: >- + The position of the widget on the x (horizontal) axis. Should be a + non-negative integer. + example: 0 + format: int64 + minimum: 0 + type: integer + 'y': + description: >- + The position of the widget on the y (vertical) axis. Should be a + non-negative integer. + example: 0 + format: int64 + minimum: 0 + type: integer + required: + - x + - 'y' + - width + - height + type: object + WidgetLiveSpan: + description: The available timeframes depend on the widget you are using. + enum: + - 1m + - 5m + - 10m + - 15m + - 30m + - 1h + - 4h + - 1d + - 2d + - 1w + - 1mo + - 3mo + - 6mo + - 1y + - alert + example: 5m + type: string + x-enum-varnames: + - PAST_ONE_MINUTE + - PAST_FIVE_MINUTES + - PAST_TEN_MINUTES + - PAST_FIFTEEN_MINUTES + - PAST_THIRTY_MINUTES + - PAST_ONE_HOUR + - PAST_FOUR_HOURS + - PAST_ONE_DAY + - PAST_TWO_DAYS + - PAST_ONE_WEEK + - PAST_ONE_MONTH + - PAST_THREE_MONTHS + - PAST_SIX_MONTHS + - PAST_ONE_YEAR + - ALERT + RelationshipToUserData: + description: Relationship to user object. + properties: + id: + description: A unique identifier that represents the user. + example: 00000000-0000-0000-2345-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + required: + - id + - type + type: object + RelationshipToOrganizationData: + description: Relationship to organization object. + properties: + id: + description: ID of the organization. + example: 00000000-0000-beef-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/OrganizationsType' + required: + - id + - type + type: object + RelationshipToRoleData: + description: Relationship to role object. + properties: + id: + description: The unique identifier of the role. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + type: + $ref: '#/components/schemas/RolesType' + type: object + PowerpackInnerWidgets: + description: Powerpack group widget definition of individual widgets. + properties: + definition: + additionalProperties: {} + description: Information about widget. + example: + definition: + content: example + type: note + type: object + layout: + $ref: '#/components/schemas/PowerpackInnerWidgetLayout' + required: + - definition + type: object + OrganizationsType: + default: orgs + description: Organizations resource type. + enum: + - orgs + example: orgs + type: string + x-enum-varnames: + - ORGS + RolesType: + default: roles + description: Roles type. + enum: + - roles + example: roles + type: string + x-enum-varnames: + - ROLES + PowerpackInnerWidgetLayout: + description: Powerpack inner widget layout. + properties: + height: + description: The height of the widget. Should be a non-negative integer. + example: 0 + format: int64 + minimum: 0 + type: integer + width: + description: The width of the widget. Should be a non-negative integer. + example: 0 + format: int64 + minimum: 0 + type: integer + x: + description: >- + The position of the widget on the x (horizontal) axis. Should be a + non-negative integer. + example: 0 + format: int64 + minimum: 0 + type: integer + 'y': + description: >- + The position of the widget on the y (vertical) axis. Should be a + non-negative integer. + example: 0 + format: int64 + minimum: 0 + type: integer + required: + - x + - 'y' + - width + - height + type: object + responses: + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + parameters: + PageOffset: + description: Specific offset to use as the beginning of the returned page. + in: query + name: page[offset] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + x-stackQL-resources: + dashboard_list_items: + id: datadog.dashboards.dashboard_list_items + name: dashboard_list_items + title: Dashboard List Items + methods: + delete_dashboard_list_items: + operation: + $ref: >- + #/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/delete + response: + mediaType: application/json + openAPIDocKey: '200' + get_dashboard_list_items: + operation: + $ref: >- + #/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.dashboards + create_dashboard_list_items: + operation: + $ref: >- + #/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/post + response: + mediaType: application/json + openAPIDocKey: '200' + update_dashboard_list_items: + operation: + $ref: >- + #/paths/~1api~1v2~1dashboard~1lists~1manual~1{dashboard_list_id}~1dashboards/put + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/dashboard_list_items/methods/get_dashboard_list_items + insert: + - $ref: >- + #/components/x-stackQL-resources/dashboard_list_items/methods/create_dashboard_list_items + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/dashboard_list_items/methods/delete_dashboard_list_items + replace: + - $ref: >- + #/components/x-stackQL-resources/dashboard_list_items/methods/update_dashboard_list_items + powerpacks: + id: datadog.dashboards.powerpacks + name: powerpacks + title: Powerpacks + methods: + list_powerpacks: + operation: + $ref: '#/paths/~1api~1v2~1powerpacks/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_powerpack: + operation: + $ref: '#/paths/~1api~1v2~1powerpacks/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_powerpack: + operation: + $ref: '#/paths/~1api~1v2~1powerpacks~1{powerpack_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_powerpack: + operation: + $ref: '#/paths/~1api~1v2~1powerpacks~1{powerpack_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_powerpack: + operation: + $ref: '#/paths/~1api~1v2~1powerpacks~1{powerpack_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/powerpacks/methods/get_powerpack' + - $ref: >- + #/components/x-stackQL-resources/powerpacks/methods/list_powerpacks + insert: + - $ref: >- + #/components/x-stackQL-resources/powerpacks/methods/create_powerpack + update: + - $ref: >- + #/components/x-stackQL-resources/powerpacks/methods/update_powerpack + delete: + - $ref: >- + #/components/x-stackQL-resources/powerpacks/methods/delete_powerpack + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/digital_experience.yaml b/providers/src/datadog/v00.00.00000/services/digital_experience.yaml new file mode 100644 index 00000000..6db6ec58 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/digital_experience.yaml @@ -0,0 +1,2247 @@ +openapi: 3.0.0 +info: + title: digital_experience API + description: datadog digital_experience API + version: '1.0' +paths: + /api/v2/rum/analytics/aggregate: + post: + description: >- + The API endpoint to aggregate RUM events into buckets of computed + metrics and timeseries. + operationId: AggregateRUMEvents + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RUMAggregateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RUMAnalyticsAggregateResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Aggregate RUM events + tags: + - RUM + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - rum_apps_read + /api/v2/rum/applications: + get: + description: List all the RUM applications in your organization. + operationId: GetRUMApplications + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RUMApplicationsResponse' + description: OK + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List all the RUM applications + tags: + - RUM + x-permission: + operator: OR + permissions: + - rum_apps_read + post: + description: Create a new RUM application in your organization. + operationId: CreateRUMApplication + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RUMApplicationCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RUMApplicationResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a new RUM application + tags: + - RUM + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - rum_apps_write + /api/v2/rum/applications/{app_id}/relationships/retention_filters: + patch: + description: >- + Order RUM retention filters for a RUM application. + + Returns RUM retention filter objects without attributes from the request + body when the request is successful. + operationId: OrderRetentionFilters + parameters: + - $ref: '#/components/parameters/RumApplicationIDParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RumRetentionFiltersOrderRequest' + description: New definition of the RUM retention filter. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RumRetentionFiltersOrderResponse' + description: Ordered + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Order RUM retention filters + tags: + - Rum Retention Filters + x-codegen-request-body-name: body + /api/v2/rum/applications/{app_id}/retention_filters: + get: + description: Get the list of RUM retention filters for a RUM application. + operationId: ListRetentionFilters + parameters: + - $ref: '#/components/parameters/RumApplicationIDParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RumRetentionFiltersResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all RUM retention filters + tags: + - Rum Retention Filters + post: + description: >- + Create a RUM retention filter for a RUM application. + + Returns RUM retention filter objects from the request body when the + request is successful. + operationId: CreateRetentionFilter + parameters: + - $ref: '#/components/parameters/RumApplicationIDParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RumRetentionFilterCreateRequest' + description: The definition of the new RUM retention filter. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/RumRetentionFilterResponse' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a RUM retention filter + tags: + - Rum Retention Filters + x-codegen-request-body-name: body + /api/v2/rum/applications/{app_id}/retention_filters/{rf_id}: + delete: + description: Delete a RUM retention filter for a RUM application. + operationId: DeleteRetentionFilter + parameters: + - $ref: '#/components/parameters/RumApplicationIDParameter' + - $ref: '#/components/parameters/RumRetentionFilterIDParameter' + responses: + '204': + description: No Content + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a RUM retention filter + tags: + - Rum Retention Filters + get: + description: Get a RUM retention filter for a RUM application. + operationId: GetRetentionFilter + parameters: + - $ref: '#/components/parameters/RumApplicationIDParameter' + - $ref: '#/components/parameters/RumRetentionFilterIDParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RumRetentionFilterResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a RUM retention filter + tags: + - Rum Retention Filters + patch: + description: >- + Update a RUM retention filter for a RUM application. + + Returns RUM retention filter objects from the request body when the + request is successful. + operationId: UpdateRetentionFilter + parameters: + - $ref: '#/components/parameters/RumApplicationIDParameter' + - $ref: '#/components/parameters/RumRetentionFilterIDParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RumRetentionFilterUpdateRequest' + description: New definition of the RUM retention filter. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RumRetentionFilterResponse' + description: Updated + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a RUM retention filter + tags: + - Rum Retention Filters + x-codegen-request-body-name: body + /api/v2/rum/applications/{id}: + delete: + description: Delete an existing RUM application in your organization. + operationId: DeleteRUMApplication + parameters: + - description: RUM application ID. + in: path + name: id + required: true + schema: + type: string + responses: + '204': + description: No Content + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a RUM application + tags: + - RUM + x-permission: + operator: OR + permissions: + - rum_apps_write + get: + description: Get the RUM application with given ID in your organization. + operationId: GetRUMApplication + parameters: + - description: RUM application ID. + in: path + name: id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RUMApplicationResponse' + description: OK + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a RUM application + tags: + - RUM + x-permission: + operator: OR + permissions: + - rum_apps_read + patch: + description: Update the RUM application with given ID in your organization. + operationId: UpdateRUMApplication + parameters: + - description: RUM application ID. + in: path + name: id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RUMApplicationUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RUMApplicationResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unprocessable Entity. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a RUM application + tags: + - RUM + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - rum_apps_write + /api/v2/rum/config/metrics: + get: + description: Get the list of configured rum-based metrics with their definitions. + operationId: ListRumMetrics + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RumMetricsResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all rum-based metrics + tags: + - Rum Metrics + post: + description: >- + Create a metric based on your organization's RUM data. + + Returns the rum-based metric object from the request body when the + request is successful. + operationId: CreateRumMetric + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RumMetricCreateRequest' + description: The definition of the new rum-based metric. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/RumMetricResponse' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a rum-based metric + tags: + - Rum Metrics + x-codegen-request-body-name: body + /api/v2/rum/config/metrics/{metric_id}: + delete: + description: Delete a specific rum-based metric from your organization. + operationId: DeleteRumMetric + parameters: + - $ref: '#/components/parameters/RumMetricIDParameter' + responses: + '204': + description: No Content + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a rum-based metric + tags: + - Rum Metrics + get: + description: Get a specific rum-based metric from your organization. + operationId: GetRumMetric + parameters: + - $ref: '#/components/parameters/RumMetricIDParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RumMetricResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a rum-based metric + tags: + - Rum Metrics + patch: + description: >- + Update a specific rum-based metric from your organization. + + Returns the rum-based metric object from the request body when the + request is successful. + operationId: UpdateRumMetric + parameters: + - $ref: '#/components/parameters/RumMetricIDParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RumMetricUpdateRequest' + description: New definition of the rum-based metric. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RumMetricResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a rum-based metric + tags: + - Rum Metrics + x-codegen-request-body-name: body + /api/v2/rum/events: + get: + description: >- + List endpoint returns events that match a RUM search query. + + [Results are paginated][1]. + + + Use this endpoint to see your latest RUM events. + + + [1]: + https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination + operationId: ListRUMEvents + parameters: + - description: Search query following RUM syntax. + example: '@type:session @application_id:xxxx' + in: query + name: filter[query] + required: false + schema: + type: string + - description: Minimum timestamp for requested events. + example: '2019-01-02T09:42:36.320Z' + in: query + name: filter[from] + required: false + schema: + format: date-time + type: string + - description: Maximum timestamp for requested events. + example: '2019-01-03T09:42:36.320Z' + in: query + name: filter[to] + required: false + schema: + format: date-time + type: string + - description: Order of events in results. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/RUMSort' + - description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + in: query + name: page[cursor] + required: false + schema: + type: string + - description: Maximum number of events in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 10 + format: int32 + maximum: 1000 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RUMEventsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a list of RUM events + tags: + - RUM + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + x-permission: + operator: OR + permissions: + - rum_apps_read + /api/v2/rum/events/search: + post: + description: >- + List endpoint returns RUM events that match a RUM search query. + + [Results are paginated][1]. + + + Use this endpoint to build complex RUM events filtering and search. + + + [1]: + https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination + operationId: SearchRUMEvents + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RUMSearchEventsRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RUMEventsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Search RUM events + tags: + - RUM + x-codegen-request-body-name: body + x-pagination: + cursorParam: body.page.cursor + cursorPath: meta.page.after + limitParam: body.page.limit + resultsPath: data + x-permission: + operator: OR + permissions: + - rum_apps_read +components: + schemas: + RUMAggregateRequest: + description: >- + The object sent with the request to retrieve aggregation buckets of RUM + events from your organization. + properties: + compute: + description: >- + The list of metrics or timeseries to compute for the retrieved + buckets. + items: + $ref: '#/components/schemas/RUMCompute' + type: array + filter: + $ref: '#/components/schemas/RUMQueryFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/RUMGroupBy' + type: array + options: + $ref: '#/components/schemas/RUMQueryOptions' + page: + $ref: '#/components/schemas/RUMQueryPageOptions' + type: object + RUMAnalyticsAggregateResponse: + description: The response object for the RUM events aggregate API endpoint. + properties: + data: + $ref: '#/components/schemas/RUMAggregationBucketsResponse' + links: + $ref: '#/components/schemas/RUMResponseLinks' + meta: + $ref: '#/components/schemas/RUMResponseMetadata' + type: object + RUMApplicationsResponse: + description: RUM applications response. + properties: + data: + description: RUM applications array response. + items: + $ref: '#/components/schemas/RUMApplicationList' + type: array + type: object + RUMApplicationCreateRequest: + description: RUM application creation request attributes. + properties: + data: + $ref: '#/components/schemas/RUMApplicationCreate' + required: + - data + type: object + RUMApplicationResponse: + description: RUM application response. + properties: + data: + $ref: '#/components/schemas/RUMApplication' + type: object + RumRetentionFiltersOrderRequest: + description: >- + The list of RUM retention filter IDs along with their corresponding type + to reorder. + + All retention filter IDs should be included in the list created for a + RUM application. + properties: + data: + description: A list of RUM retention filter IDs along with type. + items: + $ref: '#/components/schemas/RumRetentionFiltersOrderData' + type: array + type: object + RumRetentionFiltersOrderResponse: + description: The list of RUM retention filter IDs along with type. + properties: + data: + description: A list of RUM retention filter IDs along with type. + items: + $ref: '#/components/schemas/RumRetentionFiltersOrderData' + type: array + type: object + RumRetentionFiltersResponse: + description: All RUM retention filters for a RUM application. + properties: + data: + description: A list of RUM retention filters. + items: + $ref: '#/components/schemas/RumRetentionFilterData' + type: array + type: object + RumRetentionFilterCreateRequest: + description: The RUM retention filter body to create. + properties: + data: + $ref: '#/components/schemas/RumRetentionFilterCreateData' + required: + - data + type: object + RumRetentionFilterResponse: + description: The RUM retention filter object. + properties: + data: + $ref: '#/components/schemas/RumRetentionFilterData' + type: object + RumRetentionFilterUpdateRequest: + description: The RUM retention filter body to update. + properties: + data: + $ref: '#/components/schemas/RumRetentionFilterUpdateData' + required: + - data + type: object + RUMApplicationUpdateRequest: + description: RUM application update request. + properties: + data: + $ref: '#/components/schemas/RUMApplicationUpdate' + required: + - data + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + RumMetricsResponse: + description: All the available rum-based metric objects. + properties: + data: + description: A list of rum-based metric objects. + items: + $ref: '#/components/schemas/RumMetricResponseData' + type: array + type: object + RumMetricCreateRequest: + description: The new rum-based metric body. + properties: + data: + $ref: '#/components/schemas/RumMetricCreateData' + required: + - data + type: object + RumMetricResponse: + description: The rum-based metric object. + properties: + data: + $ref: '#/components/schemas/RumMetricResponseData' + type: object + RumMetricUpdateRequest: + description: The new rum-based metric body. + properties: + data: + $ref: '#/components/schemas/RumMetricUpdateData' + required: + - data + type: object + RUMSort: + description: Sort parameters when querying events. + enum: + - timestamp + - '-timestamp' + type: string + x-enum-varnames: + - TIMESTAMP_ASCENDING + - TIMESTAMP_DESCENDING + RUMEventsResponse: + description: >- + Response object with all events matching the request and pagination + information. + properties: + data: + description: Array of events matching the request. + items: + $ref: '#/components/schemas/RUMEvent' + type: array + links: + $ref: '#/components/schemas/RUMResponseLinks' + meta: + $ref: '#/components/schemas/RUMResponseMetadata' + type: object + RUMSearchEventsRequest: + description: The request for a RUM events list. + properties: + filter: + $ref: '#/components/schemas/RUMQueryFilter' + options: + $ref: '#/components/schemas/RUMQueryOptions' + page: + $ref: '#/components/schemas/RUMQueryPageOptions' + sort: + $ref: '#/components/schemas/RUMSort' + type: object + RUMCompute: + description: A compute rule to compute metrics or timeseries. + properties: + aggregation: + $ref: '#/components/schemas/RUMAggregationFunction' + interval: + description: |- + The time buckets' size (only used for type=timeseries) + Defaults to a resolution of 150 points. + example: 5m + type: string + metric: + description: The metric to use. + example: '@duration' + type: string + type: + $ref: '#/components/schemas/RUMComputeType' + required: + - aggregation + type: object + RUMQueryFilter: + description: The search and filter query settings. + properties: + from: + default: now-15m + description: >- + The minimum time for the requested events; supports date (in [ISO + 8601](https://www.w3.org/TR/NOTE-datetime) format with full date, + hours, minutes, and the `Z` UTC indicator - seconds and fractional + seconds are optional), math, and regular timestamps (in + milliseconds). + example: now-15m + type: string + query: + default: '*' + description: The search query following the RUM search syntax. + example: '@type:session AND @session.type:user' + type: string + to: + default: now + description: >- + The maximum time for the requested events; supports date (in [ISO + 8601](https://www.w3.org/TR/NOTE-datetime) format with full date, + hours, minutes, and the `Z` UTC indicator - seconds and fractional + seconds are optional), math, and regular timestamps (in + milliseconds). + example: now + type: string + type: object + RUMGroupBy: + description: A group-by rule. + properties: + facet: + description: The name of the facet to use (required). + example: '@view.time_spent' + type: string + histogram: + $ref: '#/components/schemas/RUMGroupByHistogram' + limit: + default: 10 + description: The maximum buckets to return for this group-by. + format: int64 + type: integer + missing: + $ref: '#/components/schemas/RUMGroupByMissing' + sort: + $ref: '#/components/schemas/RUMAggregateSort' + total: + $ref: '#/components/schemas/RUMGroupByTotal' + required: + - facet + type: object + RUMQueryOptions: + description: >- + Global query options that are used during the query. + + Note: Only supply timezone or time offset, not both. Otherwise, the + query fails. + properties: + time_offset: + description: The time offset (in seconds) to apply to the query. + format: int64 + type: integer + timezone: + default: UTC + description: >- + The timezone can be specified as GMT, UTC, an offset from UTC (like + UTC+1), or as a Timezone Database identifier (like + America/New_York). + example: GMT + type: string + type: object + RUMQueryPageOptions: + description: Paging attributes for listing events. + properties: + cursor: + description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + limit: + default: 10 + description: Maximum number of events in the response. + example: 25 + format: int32 + maximum: 1000 + type: integer + type: object + RUMAggregationBucketsResponse: + description: The query results. + properties: + buckets: + description: The list of matching buckets, one item per bucket. + items: + $ref: '#/components/schemas/RUMBucketResponse' + type: array + type: object + RUMResponseLinks: + description: Links attributes. + properties: + next: + description: >- + Link for the next set of results. Note that the request can also be + made using the + + POST endpoint. + example: >- + https://app.datadoghq.com/api/v2/rum/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + RUMResponseMetadata: + description: The metadata associated with a request. + properties: + elapsed: + description: The time elapsed in milliseconds. + example: 132 + format: int64 + type: integer + page: + $ref: '#/components/schemas/RUMResponsePage' + request_id: + description: The identifier of the request. + example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR + type: string + status: + $ref: '#/components/schemas/RUMResponseStatus' + warnings: + description: >- + A list of warnings (non-fatal errors) encountered. Partial results + may return if + + warnings are present in the response. + items: + $ref: '#/components/schemas/RUMWarning' + type: array + type: object + RUMApplicationList: + description: RUM application list. + properties: + attributes: + $ref: '#/components/schemas/RUMApplicationListAttributes' + id: + description: RUM application ID. + example: abcd1234-0000-0000-abcd-1234abcd5678 + type: string + type: + $ref: '#/components/schemas/RUMApplicationListType' + required: + - attributes + - type + type: object + RUMApplicationCreate: + description: RUM application creation. + properties: + attributes: + $ref: '#/components/schemas/RUMApplicationCreateAttributes' + type: + $ref: '#/components/schemas/RUMApplicationCreateType' + required: + - attributes + - type + type: object + RUMApplication: + description: RUM application. + properties: + attributes: + $ref: '#/components/schemas/RUMApplicationAttributes' + id: + description: RUM application ID. + example: abcd1234-0000-0000-abcd-1234abcd5678 + type: string + type: + $ref: '#/components/schemas/RUMApplicationType' + required: + - attributes + - id + - type + type: object + RumRetentionFiltersOrderData: + description: The RUM retention filter data for ordering. + properties: + id: + $ref: '#/components/schemas/RumRetentionFilterID' + type: + $ref: '#/components/schemas/RumRetentionFilterType' + required: + - id + - type + type: object + RumRetentionFilterData: + description: The RUM retention filter. + properties: + attributes: + $ref: '#/components/schemas/RumRetentionFilterAttributes' + id: + $ref: '#/components/schemas/RumRetentionFilterID' + type: + $ref: '#/components/schemas/RumRetentionFilterType' + type: object + RumRetentionFilterCreateData: + description: The new RUM retention filter properties to create. + properties: + attributes: + $ref: '#/components/schemas/RumRetentionFilterCreateAttributes' + type: + $ref: '#/components/schemas/RumRetentionFilterType' + required: + - type + - attributes + type: object + RumRetentionFilterUpdateData: + description: The new RUM retention filter properties to update. + properties: + attributes: + $ref: '#/components/schemas/RumRetentionFilterUpdateAttributes' + id: + $ref: '#/components/schemas/RumRetentionFilterID' + type: + $ref: '#/components/schemas/RumRetentionFilterType' + required: + - id + - type + - attributes + type: object + RUMApplicationUpdate: + description: RUM application update. + properties: + attributes: + $ref: '#/components/schemas/RUMApplicationUpdateAttributes' + id: + description: RUM application ID. + example: abcd1234-0000-0000-abcd-1234abcd5678 + type: string + type: + $ref: '#/components/schemas/RUMApplicationUpdateType' + required: + - id + - type + type: object + RumMetricResponseData: + description: The rum-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/RumMetricResponseAttributes' + id: + $ref: '#/components/schemas/RumMetricID' + type: + $ref: '#/components/schemas/RumMetricType' + type: object + RumMetricCreateData: + description: The new rum-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/RumMetricCreateAttributes' + id: + $ref: '#/components/schemas/RumMetricID' + type: + $ref: '#/components/schemas/RumMetricType' + required: + - id + - type + - attributes + type: object + RumMetricUpdateData: + description: The new rum-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/RumMetricUpdateAttributes' + id: + $ref: '#/components/schemas/RumMetricID' + type: + $ref: '#/components/schemas/RumMetricType' + required: + - type + - attributes + type: object + RUMEvent: + description: >- + Object description of a RUM event after being processed and stored by + Datadog. + properties: + attributes: + $ref: '#/components/schemas/RUMEventAttributes' + id: + description: Unique ID of the event. + example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA + type: string + type: + $ref: '#/components/schemas/RUMEventType' + type: object + RUMAggregationFunction: + description: An aggregation function. + enum: + - count + - cardinality + - pc75 + - pc90 + - pc95 + - pc98 + - pc99 + - sum + - min + - max + - avg + - median + example: pc90 + type: string + x-enum-varnames: + - COUNT + - CARDINALITY + - PERCENTILE_75 + - PERCENTILE_90 + - PERCENTILE_95 + - PERCENTILE_98 + - PERCENTILE_99 + - SUM + - MIN + - MAX + - AVG + - MEDIAN + RUMComputeType: + default: total + description: The type of compute. + enum: + - timeseries + - total + type: string + x-enum-varnames: + - TIMESERIES + - TOTAL + RUMGroupByHistogram: + description: >- + Used to perform a histogram computation (only for measure facets). + + Note: At most 100 buckets are allowed, the number of buckets is (max - + min)/interval. + properties: + interval: + description: The bin size of the histogram buckets. + example: 10 + format: double + type: number + max: + description: |- + The maximum value for the measure used in the histogram + (values greater than this one are filtered out). + example: 100 + format: double + type: number + min: + description: |- + The minimum value for the measure used in the histogram + (values smaller than this one are filtered out). + example: 50 + format: double + type: number + required: + - interval + - min + - max + type: object + RUMGroupByMissing: + description: The value to use for logs that don't have the facet used to group by. + oneOf: + - $ref: '#/components/schemas/RUMGroupByMissingString' + - $ref: '#/components/schemas/RUMGroupByMissingNumber' + RUMAggregateSort: + description: A sort rule. + example: + aggregation: count + order: asc + properties: + aggregation: + $ref: '#/components/schemas/RUMAggregationFunction' + metric: + description: The metric to sort by (only used for `type=measure`). + example: '@duration' + type: string + order: + $ref: '#/components/schemas/RUMSortOrder' + type: + $ref: '#/components/schemas/RUMAggregateSortType' + type: object + RUMGroupByTotal: + default: false + description: >- + A resulting object to put the given computes in over all the matching + records. + oneOf: + - $ref: '#/components/schemas/RUMGroupByTotalBoolean' + - $ref: '#/components/schemas/RUMGroupByTotalString' + - $ref: '#/components/schemas/RUMGroupByTotalNumber' + RUMBucketResponse: + description: Bucket values. + properties: + by: + additionalProperties: + description: The values for each group-by. + type: string + description: The key-value pairs for each group-by. + example: + '@session.type': user + '@type': view + type: object + computes: + additionalProperties: + $ref: '#/components/schemas/RUMAggregateBucketValue' + description: >- + A map of the metric name to value for regular compute, or a list of + values for a timeseries. + type: object + type: object + RUMResponsePage: + description: Paging attributes. + properties: + after: + description: >- + The cursor to use to get the next results, if any. To make the next + request, use the same parameters with the addition of + `page[cursor]`. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + RUMResponseStatus: + description: The status of the response. + enum: + - done + - timeout + example: done + type: string + x-enum-varnames: + - DONE + - TIMEOUT + RUMWarning: + description: A warning message indicating something that went wrong with the query. + properties: + code: + description: A unique code for this type of warning. + example: unknown_index + type: string + detail: + description: A detailed explanation of this specific warning. + example: 'indexes: foo, bar' + type: string + title: + description: A short human-readable summary of the warning. + example: >- + One or several indexes are missing or invalid, results hold data + from the other indexes + type: string + type: object + RUMApplicationListAttributes: + description: RUM application list attributes. + properties: + application_id: + description: ID of the RUM application. + example: abcd1234-0000-0000-abcd-1234abcd5678 + type: string + created_at: + description: Timestamp in ms of the creation date. + example: 1659479836169 + format: int64 + type: integer + created_by_handle: + description: Handle of the creator user. + example: john.doe + type: string + hash: + description: Hash of the RUM application. Optional. + type: string + is_active: + description: Indicates if the RUM application is active. + example: true + type: boolean + name: + description: Name of the RUM application. + example: my_rum_application + type: string + org_id: + description: Org ID of the RUM application. + example: 999 + format: int32 + maximum: 2147483647 + type: integer + product_scales: + $ref: '#/components/schemas/RUMProductScales' + type: + description: >- + Type of the RUM application. Supported values are `browser`, `ios`, + `android`, `react-native`, `flutter`, `roku`, `electron`, `unity`, + `kotlin-multiplatform`. + example: browser + type: string + updated_at: + description: Timestamp in ms of the last update date. + example: 1659479836169 + format: int64 + type: integer + updated_by_handle: + description: Handle of the updater user. + example: jane.doe + type: string + required: + - application_id + - created_at + - created_by_handle + - name + - org_id + - type + - updated_at + - updated_by_handle + type: object + RUMApplicationListType: + default: rum_application + description: RUM application list type. + enum: + - rum_application + example: rum_application + type: string + x-enum-varnames: + - RUM_APPLICATION + RUMApplicationCreateAttributes: + description: RUM application creation attributes. + properties: + name: + description: Name of the RUM application. + example: my_new_rum_application + type: string + product_analytics_retention_state: + $ref: '#/components/schemas/RUMProductAnalyticsRetentionState' + rum_event_processing_state: + $ref: '#/components/schemas/RUMEventProcessingState' + type: + description: >- + Type of the RUM application. Supported values are `browser`, `ios`, + `android`, `react-native`, `flutter`, `roku`, `electron`, `unity`, + `kotlin-multiplatform`. + example: browser + type: string + required: + - name + type: object + RUMApplicationCreateType: + default: rum_application_create + description: RUM application creation type. + enum: + - rum_application_create + example: rum_application_create + type: string + x-enum-varnames: + - RUM_APPLICATION_CREATE + RUMApplicationAttributes: + description: RUM application attributes. + properties: + application_id: + description: ID of the RUM application. + example: abcd1234-0000-0000-abcd-1234abcd5678 + type: string + client_token: + description: Client token of the RUM application. + example: abcd1234efgh5678ijkl90abcd1234efgh0 + type: string + created_at: + description: Timestamp in ms of the creation date. + example: 1659479836169 + format: int64 + type: integer + created_by_handle: + description: Handle of the creator user. + example: john.doe + type: string + hash: + description: Hash of the RUM application. Optional. + type: string + is_active: + description: Indicates if the RUM application is active. + example: true + type: boolean + name: + description: Name of the RUM application. + example: my_rum_application + type: string + org_id: + description: Org ID of the RUM application. + example: 999 + format: int32 + maximum: 2147483647 + type: integer + product_scales: + $ref: '#/components/schemas/RUMProductScales' + type: + description: >- + Type of the RUM application. Supported values are `browser`, `ios`, + `android`, `react-native`, `flutter`, `roku`, `electron`, `unity`, + `kotlin-multiplatform`. + example: browser + type: string + updated_at: + description: Timestamp in ms of the last update date. + example: 1659479836169 + format: int64 + type: integer + updated_by_handle: + description: Handle of the updater user. + example: jane.doe + type: string + required: + - application_id + - client_token + - created_at + - created_by_handle + - name + - org_id + - type + - updated_at + - updated_by_handle + type: object + RUMApplicationType: + default: rum_application + description: RUM application response type. + enum: + - rum_application + example: rum_application + type: string + x-enum-varnames: + - RUM_APPLICATION + RumRetentionFilterID: + description: ID of retention filter in UUID. + example: 051601eb-54a0-abc0-03f9-cc02efa18892 + type: string + RumRetentionFilterType: + default: retention_filters + description: The type of the resource. The value should always be retention_filters. + enum: + - retention_filters + example: retention_filters + type: string + x-enum-varnames: + - RETENTION_FILTERS + RumRetentionFilterAttributes: + description: The object describing attributes of a RUM retention filter. + properties: + enabled: + $ref: '#/components/schemas/RumRetentionFilterEnabled' + event_type: + $ref: '#/components/schemas/RumRetentionFilterEventType' + name: + $ref: '#/components/schemas/RunRetentionFilterName' + query: + $ref: '#/components/schemas/RumRetentionFilterQuery' + sample_rate: + $ref: '#/components/schemas/RumRetentionFilterSampleRate' + type: object + RumRetentionFilterCreateAttributes: + description: The object describing attributes of a RUM retention filter to create. + properties: + enabled: + $ref: '#/components/schemas/RumRetentionFilterEnabled' + event_type: + $ref: '#/components/schemas/RumRetentionFilterEventType' + name: + $ref: '#/components/schemas/RunRetentionFilterName' + query: + $ref: '#/components/schemas/RumRetentionFilterQuery' + sample_rate: + $ref: '#/components/schemas/RumRetentionFilterSampleRate' + required: + - event_type + - name + - sample_rate + type: object + RumRetentionFilterUpdateAttributes: + description: The object describing attributes of a RUM retention filter to update. + properties: + enabled: + $ref: '#/components/schemas/RumRetentionFilterEnabled' + event_type: + $ref: '#/components/schemas/RumRetentionFilterEventType' + name: + $ref: '#/components/schemas/RunRetentionFilterName' + query: + $ref: '#/components/schemas/RumRetentionFilterQuery' + sample_rate: + $ref: '#/components/schemas/RumRetentionFilterSampleRate' + type: object + RUMApplicationUpdateAttributes: + description: RUM application update attributes. + properties: + name: + description: Name of the RUM application. + example: updated_name_for_my_existing_rum_application + type: string + product_analytics_retention_state: + $ref: '#/components/schemas/RUMProductAnalyticsRetentionState' + rum_event_processing_state: + $ref: '#/components/schemas/RUMEventProcessingState' + type: + description: >- + Type of the RUM application. Supported values are `browser`, `ios`, + `android`, `react-native`, `flutter`, `roku`, `electron`, `unity`, + `kotlin-multiplatform`. + example: browser + type: string + type: object + RUMApplicationUpdateType: + default: rum_application_update + description: RUM application update type. + enum: + - rum_application_update + example: rum_application_update + type: string + x-enum-varnames: + - RUM_APPLICATION_UPDATE + RumMetricResponseAttributes: + description: The object describing a Datadog rum-based metric. + properties: + compute: + $ref: '#/components/schemas/RumMetricResponseCompute' + event_type: + $ref: '#/components/schemas/RumMetricEventType' + filter: + $ref: '#/components/schemas/RumMetricResponseFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/RumMetricResponseGroupBy' + type: array + uniqueness: + $ref: '#/components/schemas/RumMetricResponseUniqueness' + type: object + RumMetricID: + description: The name of the rum-based metric. + example: rum.sessions.webui.count + type: string + RumMetricType: + default: rum_metrics + description: The type of the resource. The value should always be rum_metrics. + enum: + - rum_metrics + example: rum_metrics + type: string + x-enum-varnames: + - RUM_METRICS + RumMetricCreateAttributes: + description: The object describing the Datadog rum-based metric to create. + properties: + compute: + $ref: '#/components/schemas/RumMetricCompute' + event_type: + $ref: '#/components/schemas/RumMetricEventType' + filter: + $ref: '#/components/schemas/RumMetricFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/RumMetricGroupBy' + type: array + uniqueness: + $ref: '#/components/schemas/RumMetricUniqueness' + required: + - event_type + - compute + type: object + RumMetricUpdateAttributes: + description: The rum-based metric properties that will be updated. + properties: + compute: + $ref: '#/components/schemas/RumMetricUpdateCompute' + filter: + $ref: '#/components/schemas/RumMetricFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/RumMetricGroupBy' + type: array + type: object + RUMEventAttributes: + description: JSON object containing all event attributes and their associated values. + properties: + attributes: + additionalProperties: {} + description: JSON object of attributes from RUM events. + example: + customAttribute: 123 + duration: 2345 + type: object + service: + description: >- + The name of the application or service generating RUM events. + + It is used to switch from RUM to APM, so make sure you define the + same + + value when you use both products. + example: web-app + type: string + tags: + description: Array of tags associated with your event. + example: + - team:A + items: + description: Tag associated with your event. + type: string + type: array + timestamp: + description: Timestamp of your event. + example: '2019-01-02T09:42:36.320Z' + format: date-time + type: string + type: object + RUMEventType: + default: rum + description: Type of the event. + enum: + - rum + example: rum + type: string + x-enum-varnames: + - RUM + RUMGroupByMissingString: + description: The missing value to use if there is string valued facet. + type: string + RUMGroupByMissingNumber: + description: The missing value to use if there is a number valued facet. + format: double + type: number + RUMSortOrder: + description: The order to use, ascending or descending. + enum: + - asc + - desc + example: asc + type: string + x-enum-varnames: + - ASCENDING + - DESCENDING + RUMAggregateSortType: + default: alphabetical + description: The type of sorting algorithm. + enum: + - alphabetical + - measure + type: string + x-enum-varnames: + - ALPHABETICAL + - MEASURE + RUMGroupByTotalBoolean: + description: If set to true, creates an additional bucket labeled "$facet_total". + type: boolean + RUMGroupByTotalString: + description: A string to use as the key value for the total bucket. + type: string + RUMGroupByTotalNumber: + description: A number to use as the key value for the total bucket. + format: double + type: number + RUMAggregateBucketValue: + description: A bucket value, can be either a timeseries or a single value. + oneOf: + - $ref: '#/components/schemas/RUMAggregateBucketValueSingleString' + - $ref: '#/components/schemas/RUMAggregateBucketValueSingleNumber' + - $ref: '#/components/schemas/RUMAggregateBucketValueTimeseries' + RUMProductScales: + description: Product Scales configuration for the RUM application. + properties: + product_analytics_retention_scale: + $ref: '#/components/schemas/RUMProductAnalyticsRetentionScale' + rum_event_processing_scale: + $ref: '#/components/schemas/RUMEventProcessingScale' + type: object + RUMProductAnalyticsRetentionState: + description: >- + Controls the retention policy for Product Analytics data derived from + RUM events. + enum: + - MAX + - NONE + example: MAX + type: string + x-enum-descriptions: + - >- + Store Product Analytics data for the maximum available retention + period + - Do not store Product Analytics data + x-enum-varnames: + - MAX + - NONE + RUMEventProcessingState: + description: >- + Configures which RUM events are processed and stored for the + application. + enum: + - ALL + - ERROR_FOCUSED_MODE + - NONE + example: ALL + type: string + x-enum-descriptions: + - >- + Process and store all RUM events (sessions, views, actions, resources, + errors) + - Process and store only error events and related critical events + - Disable RUM event processing—no events are stored + x-enum-varnames: + - ALL + - ERROR_FOCUSED_MODE + - NONE + RumRetentionFilterEnabled: + description: Whether the retention filter is enabled. + example: true + type: boolean + RumRetentionFilterEventType: + description: The type of RUM events to filter on. + enum: + - session + - view + - action + - error + - resource + - long_task + - vital + example: session + type: string + x-enum-varnames: + - SESSION + - VIEW + - ACTION + - ERROR + - RESOURCE + - LONG_TASK + - VITAL + RunRetentionFilterName: + description: The name of a RUM retention filter. + example: Retention filter for session + type: string + RumRetentionFilterQuery: + description: The query string for a RUM retention filter. + example: '@session.has_replay:true' + type: string + RumRetentionFilterSampleRate: + description: The sample rate for a RUM retention filter, between 0 and 100. + example: 25 + format: int64 + maximum: 100 + minimum: 0 + type: integer + RumMetricResponseCompute: + description: The compute rule to compute the rum-based metric. + properties: + aggregation_type: + $ref: '#/components/schemas/RumMetricComputeAggregationType' + include_percentiles: + $ref: '#/components/schemas/RumMetricComputeIncludePercentiles' + path: + description: |- + The path to the value the rum-based metric will aggregate on. + Only present when `aggregation_type` is `distribution`. + example: '@duration' + type: string + type: object + RumMetricEventType: + description: The type of RUM events to filter on. + enum: + - session + - view + - action + - error + - resource + - long_task + - vital + example: session + type: string + x-enum-varnames: + - SESSION + - VIEW + - ACTION + - ERROR + - RESOURCE + - LONG_TASK + - VITAL + RumMetricResponseFilter: + description: >- + The rum-based metric filter. RUM events matching this filter will be + aggregated in this metric. + properties: + query: + description: The search query - following the RUM search syntax. + example: service:web* AND @http.status_code:[200 TO 299] + type: string + type: object + RumMetricResponseGroupBy: + description: A group by rule. + properties: + path: + description: The path to the value the rum-based metric will be aggregated over. + example: '@http.status_code' + type: string + tag_name: + description: >- + Eventual name of the tag that gets created. By default, `path` is + used as the tag name. + example: status_code + type: string + type: object + RumMetricResponseUniqueness: + description: >- + The rule to count updatable events. Is only set if `event_type` is + `session` or `view`. + properties: + when: + $ref: '#/components/schemas/RumMetricUniquenessWhen' + type: object + RumMetricCompute: + description: The compute rule to compute the rum-based metric. + properties: + aggregation_type: + $ref: '#/components/schemas/RumMetricComputeAggregationType' + include_percentiles: + $ref: '#/components/schemas/RumMetricComputeIncludePercentiles' + path: + description: |- + The path to the value the rum-based metric will aggregate on. + Only present when `aggregation_type` is `distribution`. + example: '@duration' + type: string + required: + - aggregation_type + type: object + RumMetricFilter: + description: >- + The rum-based metric filter. Events matching this filter will be + aggregated in this metric. + properties: + query: + default: '*' + description: The search query - following the RUM search syntax. + example: '@service:web-ui: ' + type: string + required: + - query + type: object + RumMetricGroupBy: + description: A group by rule. + properties: + path: + description: The path to the value the rum-based metric will be aggregated over. + example: '@browser.name' + type: string + tag_name: + description: >- + Eventual name of the tag that gets created. By default, `path` is + used as the tag name. + example: browser_name + type: string + required: + - path + type: object + RumMetricUniqueness: + description: >- + The rule to count updatable events. Is only set if `event_type` is + `sessions` or `views`. + properties: + when: + $ref: '#/components/schemas/RumMetricUniquenessWhen' + required: + - when + type: object + RumMetricUpdateCompute: + description: The compute rule to compute the rum-based metric. + properties: + include_percentiles: + $ref: '#/components/schemas/RumMetricComputeIncludePercentiles' + type: object + RUMAggregateBucketValueSingleString: + description: A single string value. + type: string + RUMAggregateBucketValueSingleNumber: + description: A single number value. + format: double + type: number + RUMAggregateBucketValueTimeseries: + description: A timeseries array. + items: + $ref: '#/components/schemas/RUMAggregateBucketValueTimeseriesPoint' + type: array + x-generate-alias-as-model: true + RUMProductAnalyticsRetentionScale: + description: Product Analytics retention scale configuration. + properties: + last_modified_at: + description: Timestamp in milliseconds when this scale was last modified. + example: 1747922145974 + format: int64 + type: integer + state: + $ref: '#/components/schemas/RUMProductAnalyticsRetentionState' + type: object + RUMEventProcessingScale: + description: RUM event processing scale configuration. + properties: + last_modified_at: + description: Timestamp in milliseconds when this scale was last modified. + example: 1721897494108 + format: int64 + type: integer + state: + $ref: '#/components/schemas/RUMEventProcessingState' + type: object + RumMetricComputeAggregationType: + description: The type of aggregation to use. + enum: + - count + - distribution + example: distribution + type: string + x-enum-varnames: + - COUNT + - DISTRIBUTION + RumMetricComputeIncludePercentiles: + description: >- + Toggle to include or exclude percentile aggregations for distribution + metrics. + + Only present when `aggregation_type` is `distribution`. + example: true + type: boolean + RumMetricUniquenessWhen: + description: >- + When to count updatable events. `match` when the event is first seen, or + `end` when the event is complete. + enum: + - match + - end + example: match + type: string + x-enum-varnames: + - WHEN_MATCH + - WHEN_END + RUMAggregateBucketValueTimeseriesPoint: + description: A timeseries point. + properties: + time: + description: The time value for this point. + example: '2020-06-08T11:55:00.123Z' + format: date-time + type: string + value: + description: The value for this point. + example: 19 + format: double + type: number + type: object + responses: + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + ConflictResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + parameters: + RumApplicationIDParameter: + description: RUM application ID. + in: path + name: app_id + required: true + schema: + type: string + RumRetentionFilterIDParameter: + description: Retention filter ID. + in: path + name: rf_id + required: true + schema: + type: string + RumMetricIDParameter: + description: The name of the rum-based metric. + in: path + name: metric_id + required: true + schema: + type: string + x-stackQL-resources: + rum_events: + id: datadog.digital_experience.rum_events + name: rum_events + title: Rum Events + methods: + aggregate_rumevents: + operation: + $ref: '#/paths/~1api~1v2~1rum~1analytics~1aggregate/post' + response: + mediaType: application/json + openAPIDocKey: '200' + list_rumevents: + operation: + $ref: '#/paths/~1api~1v2~1rum~1events/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + search_rumevents: + operation: + $ref: '#/paths/~1api~1v2~1rum~1events~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/rum_events/methods/list_rumevents' + insert: [] + update: [] + delete: [] + replace: [] + rum_applications: + id: datadog.digital_experience.rum_applications + name: rum_applications + title: Rum Applications + methods: + get_rumapplications: + operation: + $ref: '#/paths/~1api~1v2~1rum~1applications/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_rumapplication: + operation: + $ref: '#/paths/~1api~1v2~1rum~1applications/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_rumapplication: + operation: + $ref: '#/paths/~1api~1v2~1rum~1applications~1{id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_rumapplication: + operation: + $ref: '#/paths/~1api~1v2~1rum~1applications~1{id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_rumapplication: + operation: + $ref: '#/paths/~1api~1v2~1rum~1applications~1{id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/rum_applications/methods/get_rumapplication + - $ref: >- + #/components/x-stackQL-resources/rum_applications/methods/get_rumapplications + insert: + - $ref: >- + #/components/x-stackQL-resources/rum_applications/methods/create_rumapplication + update: + - $ref: >- + #/components/x-stackQL-resources/rum_applications/methods/update_rumapplication + delete: + - $ref: >- + #/components/x-stackQL-resources/rum_applications/methods/delete_rumapplication + replace: [] + rum_retention_filters: + id: datadog.digital_experience.rum_retention_filters + name: rum_retention_filters + title: Rum Retention Filters + methods: + order_retention_filters: + operation: + $ref: >- + #/paths/~1api~1v2~1rum~1applications~1{app_id}~1relationships~1retention_filters/patch + response: + mediaType: application/json + openAPIDocKey: '200' + list_retention_filters: + operation: + $ref: >- + #/paths/~1api~1v2~1rum~1applications~1{app_id}~1retention_filters/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_retention_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1rum~1applications~1{app_id}~1retention_filters/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_retention_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1rum~1applications~1{app_id}~1retention_filters~1{rf_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_retention_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1rum~1applications~1{app_id}~1retention_filters~1{rf_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_retention_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1rum~1applications~1{app_id}~1retention_filters~1{rf_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/rum_retention_filters/methods/get_retention_filter + - $ref: >- + #/components/x-stackQL-resources/rum_retention_filters/methods/list_retention_filters + insert: + - $ref: >- + #/components/x-stackQL-resources/rum_retention_filters/methods/create_retention_filter + update: + - $ref: >- + #/components/x-stackQL-resources/rum_retention_filters/methods/update_retention_filter + delete: + - $ref: >- + #/components/x-stackQL-resources/rum_retention_filters/methods/delete_retention_filter + replace: [] + rum_metrics: + id: datadog.digital_experience.rum_metrics + name: rum_metrics + title: Rum Metrics + methods: + list_rum_metrics: + operation: + $ref: '#/paths/~1api~1v2~1rum~1config~1metrics/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_rum_metric: + operation: + $ref: '#/paths/~1api~1v2~1rum~1config~1metrics/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_rum_metric: + operation: + $ref: '#/paths/~1api~1v2~1rum~1config~1metrics~1{metric_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_rum_metric: + operation: + $ref: '#/paths/~1api~1v2~1rum~1config~1metrics~1{metric_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_rum_metric: + operation: + $ref: '#/paths/~1api~1v2~1rum~1config~1metrics~1{metric_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/rum_metrics/methods/get_rum_metric + - $ref: >- + #/components/x-stackQL-resources/rum_metrics/methods/list_rum_metrics + insert: + - $ref: >- + #/components/x-stackQL-resources/rum_metrics/methods/create_rum_metric + update: + - $ref: >- + #/components/x-stackQL-resources/rum_metrics/methods/update_rum_metric + delete: + - $ref: >- + #/components/x-stackQL-resources/rum_metrics/methods/delete_rum_metric + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/dora_metrics.yaml b/providers/src/datadog/v00.00.00000/services/dora_metrics.yaml deleted file mode 100644 index 46ca83e6..00000000 --- a/providers/src/datadog/v00.00.00000/services/dora_metrics.yaml +++ /dev/null @@ -1,1214 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - dora_metrics - description: DORA_Metrics -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - DORADeploymentRequest: - description: Request to create a DORA deployment event. - properties: - data: - $ref: '#/components/schemas/DORADeploymentRequestData' - required: - - data - type: object - DORADeploymentResponse: - description: Response after receiving a DORA deployment event. - properties: - data: - $ref: '#/components/schemas/DORADeploymentResponseData' - required: - - data - type: object - JSONAPIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - $ref: '#/components/schemas/JSONAPIErrorItem' - type: array - required: - - errors - type: object - DORADeploymentRequestData: - description: 'The JSON:API data.' - properties: - attributes: - $ref: '#/components/schemas/DORADeploymentRequestAttributes' - required: - - attributes - type: object - DORADeploymentResponseData: - description: 'The JSON:API data.' - properties: - id: - description: The ID of the received DORA deployment event. - example: 4242fcdd31586083 - type: string - type: - $ref: '#/components/schemas/DORADeploymentType' - required: - - id - type: object - JSONAPIErrorItem: - description: API error response body - properties: - detail: - description: A human-readable explanation specific to this occurrence of the error. - example: Missing required attribute in body - type: string - status: - description: Status code of the response. - example: '400' - type: string - title: - description: Short human-readable summary of the error. - example: Bad Request - type: string - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - DORADeploymentRequestAttributes: - description: Attributes to create a DORA deployment event. - properties: - finished_at: - description: Unix timestamp in nanoseconds when the deployment finished. It should not be older than 3 hours. - example: 1693491984000000000 - format: int64 - type: integer - git: - $ref: '#/components/schemas/DORAGitInfo' - id: - description: Deployment ID. - type: string - service: - description: Service name from a service available in the Service Catalog. - example: shopist - type: string - started_at: - description: Unix timestamp in nanoseconds when the deployment started. - example: 1693491974000000000 - format: int64 - type: integer - version: - description: 'Version to correlate with [APM Deployment Tracking](https://docs.datadoghq.com/tracing/services/deployment_tracking/).' - example: v1.12.07 - type: string - required: - - service - - started_at - - finished_at - type: object - DORADeploymentType: - default: dora_deployment - description: 'JSON:API type for DORA deployment events.' - enum: - - dora_deployment - example: dora_deployment - type: string - x-enum-varnames: - - DORA_DEPLOYMENT - DORAGitInfo: - description: Git info for DORA Metrics events. - properties: - commit_sha: - $ref: '#/components/schemas/GitCommitSHA' - repository_url: - $ref: '#/components/schemas/GitRepositoryURL' - required: - - repository_url - - commit_sha - type: object - GitCommitSHA: - description: Git Commit SHA. - example: 66adc9350f2cc9b250b69abddab733dd55e1a588 - pattern: '^[a-fA-F0-9]{40,}$' - type: string - GitRepositoryURL: - description: Git Repository URL - example: 'https://github.com/organization/example-repository' - type: string - DORAIncidentRequest: - description: Request to create a DORA incident event. - properties: - data: - $ref: '#/components/schemas/DORAIncidentRequestData' - required: - - data - type: object - DORAIncidentResponse: - description: Response after receiving a DORA incident event. - properties: - data: - $ref: '#/components/schemas/DORAIncidentResponseData' - required: - - data - type: object - DORAIncidentRequestData: - description: 'The JSON:API data.' - properties: - attributes: - $ref: '#/components/schemas/DORAIncidentRequestAttributes' - required: - - attributes - type: object - DORAIncidentResponseData: - description: Response after receiving a DORA incident event. - properties: - id: - description: The ID of the received DORA incident event. - example: 4242fcdd31586083 - type: string - type: - $ref: '#/components/schemas/DORAIncidentType' - required: - - id - type: object - DORAIncidentRequestAttributes: - description: Attributes to create a DORA incident event. - properties: - finished_at: - description: Unix timestamp in nanoseconds when the incident finished. It should not be older than 3 hours. - example: 1693491984000000000 - format: int64 - type: integer - git: - $ref: '#/components/schemas/DORAGitInfo' - id: - description: Incident ID - type: string - name: - description: Incident name. - example: Webserver is down failing all requests - type: string - service: - description: Service name from a service available in the Service Catalog. - example: shopist - type: string - severity: - description: Incident severity. - example: High - type: string - started_at: - description: Unix timestamp in nanoseconds when the incident started. - example: 1693491974000000000 - format: int64 - type: integer - version: - description: 'Version to correlate with [APM Deployment Tracking](https://docs.datadoghq.com/tracing/services/deployment_tracking/).' - example: v1.12.07 - type: string - required: - - service - - started_at - type: object - DORAIncidentType: - default: dora_incident - description: 'JSON:API type for DORA incident events.' - enum: - - dora_incident - example: dora_incident - type: string - x-enum-varnames: - - DORA_INCIDENT - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - deployments: - id: datadog.dora_metrics.deployments - name: deployments - title: Deployments - methods: - create_dora_deployment: - operation: - $ref: '#/paths/~1api~1v2~1dora~1deployment/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: [] - insert: - - $ref: '#/components/x-stackQL-resources/deployments/methods/create_dora_deployment' - update: [] - delete: [] - incidents: - id: datadog.dora_metrics.incidents - name: incidents - title: Incidents - methods: - create_dora_incident: - operation: - $ref: '#/paths/~1api~1v2~1dora~1incident/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: [] - insert: - - $ref: '#/components/x-stackQL-resources/incidents/methods/create_dora_incident' - update: [] - delete: [] -paths: - /api/v2/dora/deployment: - post: - description: |- - Use this API endpoint to provide data about deployments for DORA metrics. - - This is necessary for: - - Deployment Frequency - - Change Lead Time - - Change Failure Rate - operationId: CreateDORADeployment - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/DORADeploymentRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DORADeploymentResponse' - description: OK - '202': - content: - application/json: - schema: - $ref: '#/components/schemas/DORADeploymentResponse' - description: OK - but delayed due to incident - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: Bad Request - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - summary: Send a deployment event for DORA Metrics - tags: - - DORA Metrics - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in private beta. - If you want to request access, complete the [form](https://forms.gle/Eqq6uXfGjYxmqpjDA). - /api/v2/dora/incident: - post: - description: |- - Use this API endpoint to provide data about incidents for DORA metrics. - - This is necessary for: - - Change Failure Rate - - Time to Restore - operationId: CreateDORAIncident - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/DORAIncidentRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DORAIncidentResponse' - description: OK - '202': - content: - application/json: - schema: - $ref: '#/components/schemas/DORAIncidentResponse' - description: OK - but delayed due to incident - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: Bad Request - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - summary: Send an incident event for DORA Metrics - tags: - - DORA Metrics - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in private beta. - If you want to request access, complete the [form](https://forms.gle/Eqq6uXfGjYxmqpjDA). diff --git a/providers/src/datadog/v00.00.00000/services/downtimes.yaml b/providers/src/datadog/v00.00.00000/services/downtimes.yaml deleted file mode 100644 index 6823062e..00000000 --- a/providers/src/datadog/v00.00.00000/services/downtimes.yaml +++ /dev/null @@ -1,2025 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - downtimes - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ListDowntimesResponse: - description: Response for retrieving all downtimes. - properties: - data: - description: An array of downtimes. - items: - $ref: '#/components/schemas/DowntimeResponseData' - type: array - included: - description: Array of objects related to the downtimes. - items: - $ref: '#/components/schemas/DowntimeResponseIncludedItem' - type: array - meta: - $ref: '#/components/schemas/DowntimeMeta' - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - DowntimeResponseData: - description: Downtime data. - properties: - attributes: - $ref: '#/components/schemas/DowntimeResponseAttributes' - id: - description: The downtime ID. - example: 00000000-0000-1234-0000-000000000000 - type: string - relationships: - $ref: '#/components/schemas/DowntimeRelationships' - type: - $ref: '#/components/schemas/DowntimeResourceType' - type: object - DowntimeResponseIncludedItem: - description: An object related to a downtime. - oneOf: - - $ref: '#/components/schemas/User' - - $ref: '#/components/schemas/DowntimeMonitorIncludedItem' - DowntimeMeta: - description: Pagination metadata returned by the API. - properties: - page: - $ref: '#/components/schemas/DowntimeMetaPage' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - DowntimeResponseAttributes: - description: Downtime details. - properties: - canceled: - description: Time that the downtime was canceled. - example: '2020-01-02T03:04:05.282979+0000' - format: date-time - nullable: true - type: string - created: - description: Creation time of the downtime. - example: '2020-01-02T03:04:05.282979+0000' - format: date-time - type: string - display_timezone: - $ref: '#/components/schemas/DowntimeDisplayTimezone' - message: - $ref: '#/components/schemas/DowntimeMessage' - modified: - description: Time that the downtime was last modified. - example: '2020-01-02T03:04:05.282979+0000' - format: date-time - type: string - monitor_identifier: - $ref: '#/components/schemas/DowntimeMonitorIdentifier' - mute_first_recovery_notification: - $ref: '#/components/schemas/DowntimeMuteFirstRecoveryNotification' - notify_end_states: - $ref: '#/components/schemas/DowntimeNotifyEndStates' - notify_end_types: - $ref: '#/components/schemas/DowntimeNotifyEndTypes' - schedule: - $ref: '#/components/schemas/DowntimeScheduleResponse' - scope: - $ref: '#/components/schemas/DowntimeScope' - status: - $ref: '#/components/schemas/DowntimeStatus' - type: object - DowntimeRelationships: - description: All relationships associated with downtime. - properties: - created_by: - $ref: '#/components/schemas/DowntimeRelationshipsCreatedBy' - monitor: - $ref: '#/components/schemas/DowntimeRelationshipsMonitor' - type: object - DowntimeResourceType: - default: downtime - description: Downtime resource type. - enum: - - downtime - example: downtime - type: string - x-enum-varnames: - - DOWNTIME - User: - description: User object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserAttributes' - id: - description: ID of the user. - type: string - relationships: - $ref: '#/components/schemas/UserResponseRelationships' - type: - $ref: '#/components/schemas/UsersType' - type: object - DowntimeMonitorIncludedItem: - description: Information about the monitor identified by the downtime. - properties: - attributes: - $ref: '#/components/schemas/DowntimeMonitorIncludedAttributes' - id: - description: ID of the monitor identified by the downtime. - example: 12345 - format: int64 - type: integer - type: - $ref: '#/components/schemas/DowntimeIncludedMonitorType' - type: object - DowntimeMetaPage: - description: Object containing the total filtered count. - properties: - total_filtered_count: - description: Total count of elements matched by the filter. - format: int64 - type: integer - type: object - DowntimeDisplayTimezone: - default: UTC - description: |- - The timezone in which to display the downtime's start and end times in Datadog applications. This is not used - as an offset for scheduling. - example: America/New_York - nullable: true - type: string - DowntimeMessage: - description: |- - A message to include with notifications for this downtime. Email notifications can be sent to specific users - by using the same `@username` notation as events. - example: Message about the downtime - nullable: true - type: string - DowntimeMonitorIdentifier: - description: Monitor identifier for the downtime. - oneOf: - - $ref: '#/components/schemas/DowntimeMonitorIdentifierId' - - $ref: '#/components/schemas/DowntimeMonitorIdentifierTags' - DowntimeMuteFirstRecoveryNotification: - description: If the first recovery notification during a downtime should be muted. - example: false - type: boolean - DowntimeNotifyEndStates: - description: States that will trigger a monitor notification when the `notify_end_types` action occurs. - example: - - alert - - warn - items: - $ref: '#/components/schemas/DowntimeNotifyEndStateTypes' - type: array - DowntimeNotifyEndTypes: - description: Actions that will trigger a monitor notification if the downtime is in the `notify_end_types` state. - example: - - canceled - - expired - items: - $ref: '#/components/schemas/DowntimeNotifyEndStateActions' - type: array - DowntimeScheduleResponse: - description: |- - The schedule that defines when the monitor starts, stops, and recurs. There are two types of schedules: - one-time and recurring. Recurring schedules may have up to five RRULE-based recurrences. If no schedules are - provided, the downtime will begin immediately and never end. - oneOf: - - $ref: '#/components/schemas/DowntimeScheduleRecurrencesResponse' - - $ref: '#/components/schemas/DowntimeScheduleOneTimeResponse' - DowntimeScope: - description: 'The scope to which the downtime applies. Must follow the [common search syntax](https://docs.datadoghq.com/logs/explorer/search_syntax/).' - example: 'env:(staging OR prod) AND datacenter:us-east-1' - type: string - DowntimeStatus: - description: The current status of the downtime. - enum: - - active - - canceled - - ended - - scheduled - example: active - type: string - x-enum-varnames: - - ACTIVE - - CANCELED - - ENDED - - SCHEDULED - DowntimeRelationshipsCreatedBy: - description: The user who created the downtime. - properties: - data: - $ref: '#/components/schemas/DowntimeRelationshipsCreatedByData' - type: object - DowntimeRelationshipsMonitor: - description: The monitor identified by the downtime. - properties: - data: - $ref: '#/components/schemas/DowntimeRelationshipsMonitorData' - type: object - UserAttributes: - description: Attributes of user object returned by the API. - properties: - created_at: - description: Creation time of the user. - format: date-time - type: string - disabled: - description: Whether the user is disabled. - type: boolean - email: - description: Email of the user. - type: string - handle: - description: Handle of the user. - type: string - icon: - description: URL of the user's icon. - type: string - modified_at: - description: Time that the user was last modified. - format: date-time - type: string - name: - description: Name of the user. - nullable: true - type: string - service_account: - description: Whether the user is a service account. - type: boolean - status: - description: Status of the user. - type: string - title: - description: Title of the user. - nullable: true - type: string - verified: - description: Whether the user is verified. - type: boolean - type: object - UserResponseRelationships: - description: Relationships of the user object returned by the API. - properties: - org: - $ref: '#/components/schemas/RelationshipToOrganization' - other_orgs: - $ref: '#/components/schemas/RelationshipToOrganizations' - other_users: - $ref: '#/components/schemas/RelationshipToUsers' - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - UsersType: - default: users - description: Users resource type. - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - DowntimeMonitorIncludedAttributes: - description: Attributes of the monitor identified by the downtime. - properties: - name: - description: The name of the monitor identified by the downtime. - example: A monitor name - type: string - type: object - DowntimeIncludedMonitorType: - default: monitors - description: Monitor resource type. - enum: - - monitors - example: monitors - type: string - x-enum-varnames: - - MONITORS - DowntimeMonitorIdentifierId: - additionalProperties: {} - description: Object of the monitor identifier. - properties: - monitor_id: - description: ID of the monitor to prevent notifications. - example: 123 - format: int64 - type: integer - required: - - monitor_id - type: object - DowntimeMonitorIdentifierTags: - additionalProperties: {} - description: Object of the monitor tags. - properties: - monitor_tags: - description: |- - A list of monitor tags. For example, tags that are applied directly to monitors, - not tags that are used in monitor queries (which are filtered by the scope parameter), to which the downtime applies. - The resulting downtime applies to monitors that match **all** provided monitor tags. Setting `monitor_tags` - to `[*]` configures the downtime to mute all monitors for the given scope. - example: - - 'service:postgres' - - 'team:frontend' - items: - description: A list of monitor tags. - example: 'service:postgres' - type: string - minItems: 1 - type: array - required: - - monitor_tags - type: object - DowntimeNotifyEndStateTypes: - description: State that will trigger a monitor notification when the `notify_end_types` action occurs. - enum: - - alert - - no data - - warn - example: alert - type: string - x-enum-varnames: - - ALERT - - NO_DATA - - WARN - DowntimeNotifyEndStateActions: - description: Action that will trigger a monitor notification if the downtime is in the `notify_end_types` state. - enum: - - canceled - - expired - example: canceled - type: string - x-enum-varnames: - - CANCELED - - EXPIRED - DowntimeScheduleRecurrencesResponse: - description: A recurring downtime schedule definition. - properties: - current_downtime: - $ref: '#/components/schemas/DowntimeScheduleCurrentDowntimeResponse' - recurrences: - description: A list of downtime recurrences. - items: - $ref: '#/components/schemas/DowntimeScheduleRecurrenceResponse' - maxItems: 5 - minItems: 1 - type: array - timezone: - default: UTC - description: |- - The timezone in which to schedule the downtime. This affects recurring start and end dates. - Must match `display_timezone`. - example: America/New_York - type: string - required: - - recurrences - type: object - DowntimeScheduleOneTimeResponse: - description: A one-time downtime definition. - properties: - end: - description: ISO-8601 Datetime to end the downtime. - example: '2020-01-02T03:04:00.000Z' - format: date-time - nullable: true - type: string - start: - description: ISO-8601 Datetime to start the downtime. - example: '2020-01-02T03:04:00.000Z' - format: date-time - type: string - required: - - start - type: object - DowntimeRelationshipsCreatedByData: - description: Data for the user who created the downtime. - nullable: true - properties: - id: - description: User ID of the downtime creator. - example: 00000000-0000-1234-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - type: object - DowntimeRelationshipsMonitorData: - description: Data for the monitor. - nullable: true - properties: - id: - description: Monitor ID of the downtime. - example: '12345' - type: string - type: - $ref: '#/components/schemas/DowntimeIncludedMonitorType' - type: object - RelationshipToOrganization: - description: Relationship to an organization. - properties: - data: - $ref: '#/components/schemas/RelationshipToOrganizationData' - required: - - data - type: object - RelationshipToOrganizations: - description: Relationship to organizations. - properties: - data: - description: Relationships to organization objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToOrganizationData' - type: array - required: - - data - type: object - RelationshipToUsers: - description: Relationship to users. - properties: - data: - description: Relationships to user objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToUserData' - type: array - required: - - data - type: object - RelationshipToRoles: - description: Relationship to roles. - properties: - data: - description: An array containing type and the unique identifier of a role. - items: - $ref: '#/components/schemas/RelationshipToRoleData' - type: array - type: object - DowntimeScheduleCurrentDowntimeResponse: - description: |- - The most recent actual start and end dates for a recurring downtime. For a canceled downtime, - this is the previously occurring downtime. For active downtimes, this is the ongoing downtime, and for scheduled - downtimes it is the upcoming downtime. - properties: - end: - description: The end of the current downtime. - example: '2020-01-02T03:04:00.000Z' - format: date-time - nullable: true - type: string - start: - description: The start of the current downtime. - example: '2020-01-02T03:04:00.000Z' - format: date-time - type: string - type: object - DowntimeScheduleRecurrenceResponse: - description: An RRULE-based recurring downtime. - properties: - duration: - $ref: '#/components/schemas/DowntimeScheduleRecurrenceDuration' - rrule: - $ref: '#/components/schemas/DowntimeScheduleRecurrenceRrule' - start: - description: |- - ISO-8601 Datetime to start the downtime. Must not include a UTC offset. If not provided, the - downtime starts the moment it is created. - example: '2020-01-02T03:04' - type: string - type: object - RelationshipToOrganizationData: - description: Relationship to organization object. - properties: - id: - description: ID of the organization. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - id - - type - type: object - RelationshipToUserData: - description: Relationship to user object. - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - DowntimeScheduleRecurrenceDuration: - description: 'The length of the downtime. Must begin with an integer and end with one of ''m'', ''h'', d'', or ''w''.' - example: 123d - type: string - DowntimeScheduleRecurrenceRrule: - description: |- - The `RRULE` standard for defining recurring events. - For example, to have a recurring event on the first day of each month, set the type to `rrule` and set the `FREQ` to `MONTHLY` and `BYMONTHDAY` to `1`. - Most common `rrule` options from the [iCalendar Spec](https://tools.ietf.org/html/rfc5545) are supported. - - **Note**: Attributes specifying the duration in `RRULE` are not supported (for example, `DTSTART`, `DTEND`, `DURATION`). - More examples available in this [downtime guide](https://docs.datadoghq.com/monitors/guide/suppress-alert-with-downtimes/?tab=api). - example: FREQ=MONTHLY;BYSETPOS=3;BYDAY=WE;INTERVAL=1 - type: string - OrganizationsType: - default: orgs - description: Organizations resource type. - enum: - - orgs - example: orgs - type: string - x-enum-varnames: - - ORGS - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - DowntimeCreateRequest: - description: Request for creating a downtime. - properties: - data: - $ref: '#/components/schemas/DowntimeCreateRequestData' - required: - - data - type: object - DowntimeResponse: - description: |- - Downtiming gives you greater control over monitor notifications by - allowing you to globally exclude scopes from alerting. - Downtime settings, which can be scheduled with start and end times, - prevent all alerting related to specified Datadog tags. - properties: - data: - $ref: '#/components/schemas/DowntimeResponseData' - included: - description: Array of objects related to the downtime that the user requested. - items: - $ref: '#/components/schemas/DowntimeResponseIncludedItem' - type: array - type: object - DowntimeCreateRequestData: - description: Object to create a downtime. - properties: - attributes: - $ref: '#/components/schemas/DowntimeCreateRequestAttributes' - type: - $ref: '#/components/schemas/DowntimeResourceType' - required: - - type - - attributes - type: object - DowntimeCreateRequestAttributes: - description: Downtime details. - properties: - display_timezone: - $ref: '#/components/schemas/DowntimeDisplayTimezone' - message: - $ref: '#/components/schemas/DowntimeMessage' - monitor_identifier: - $ref: '#/components/schemas/DowntimeMonitorIdentifier' - mute_first_recovery_notification: - $ref: '#/components/schemas/DowntimeMuteFirstRecoveryNotification' - notify_end_states: - $ref: '#/components/schemas/DowntimeNotifyEndStates' - notify_end_types: - $ref: '#/components/schemas/DowntimeNotifyEndTypes' - schedule: - $ref: '#/components/schemas/DowntimeScheduleCreateRequest' - scope: - $ref: '#/components/schemas/DowntimeScope' - required: - - scope - - monitor_identifier - type: object - DowntimeScheduleCreateRequest: - description: Schedule for the downtime. - oneOf: - - $ref: '#/components/schemas/DowntimeScheduleRecurrencesCreateRequest' - - $ref: '#/components/schemas/DowntimeScheduleOneTimeCreateUpdateRequest' - DowntimeScheduleRecurrencesCreateRequest: - description: A recurring downtime schedule definition. - properties: - recurrences: - description: A list of downtime recurrences. - items: - $ref: '#/components/schemas/DowntimeScheduleRecurrenceCreateUpdateRequest' - type: array - timezone: - default: UTC - description: The timezone in which to schedule the downtime. - example: America/New_York - type: string - required: - - recurrences - type: object - DowntimeScheduleOneTimeCreateUpdateRequest: - additionalProperties: {} - description: A one-time downtime definition. - properties: - end: - description: |- - ISO-8601 Datetime to end the downtime. Must include a UTC offset of zero. If not provided, the - downtime continues forever. - example: '2020-01-02T03:04:00.000Z' - format: date-time - nullable: true - type: string - start: - description: |- - ISO-8601 Datetime to start the downtime. Must include a UTC offset of zero. If not provided, the - downtime starts the moment it is created. - example: '2020-01-02T03:04:00.000Z' - format: date-time - nullable: true - type: string - type: object - DowntimeScheduleRecurrenceCreateUpdateRequest: - additionalProperties: {} - description: An object defining the recurrence of the downtime. - properties: - duration: - $ref: '#/components/schemas/DowntimeScheduleRecurrenceDuration' - rrule: - $ref: '#/components/schemas/DowntimeScheduleRecurrenceRrule' - start: - description: |- - ISO-8601 Datetime to start the downtime. Must not include a UTC offset. If not provided, the - downtime starts the moment it is created. - example: '2020-01-02T03:04' - nullable: true - type: string - required: - - duration - - rrule - type: object - DowntimeUpdateRequest: - description: Request for editing a downtime. - properties: - data: - $ref: '#/components/schemas/DowntimeUpdateRequestData' - required: - - data - type: object - DowntimeUpdateRequestData: - description: Object to update a downtime. - properties: - attributes: - $ref: '#/components/schemas/DowntimeUpdateRequestAttributes' - id: - description: ID of this downtime. - example: 00000000-0000-1234-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/DowntimeResourceType' - required: - - id - - type - - attributes - type: object - DowntimeUpdateRequestAttributes: - description: Attributes of the downtime to update. - properties: - display_timezone: - $ref: '#/components/schemas/DowntimeDisplayTimezone' - message: - $ref: '#/components/schemas/DowntimeMessage' - monitor_identifier: - $ref: '#/components/schemas/DowntimeMonitorIdentifier' - mute_first_recovery_notification: - $ref: '#/components/schemas/DowntimeMuteFirstRecoveryNotification' - notify_end_states: - $ref: '#/components/schemas/DowntimeNotifyEndStates' - notify_end_types: - $ref: '#/components/schemas/DowntimeNotifyEndTypes' - schedule: - $ref: '#/components/schemas/DowntimeScheduleUpdateRequest' - scope: - $ref: '#/components/schemas/DowntimeScope' - type: object - DowntimeScheduleUpdateRequest: - description: Schedule for the downtime. - oneOf: - - $ref: '#/components/schemas/DowntimeScheduleRecurrencesUpdateRequest' - - $ref: '#/components/schemas/DowntimeScheduleOneTimeCreateUpdateRequest' - DowntimeScheduleRecurrencesUpdateRequest: - description: A recurring downtime schedule definition. - properties: - recurrences: - description: A list of downtime recurrences. - items: - $ref: '#/components/schemas/DowntimeScheduleRecurrenceCreateUpdateRequest' - type: array - timezone: - default: UTC - description: The timezone in which to schedule the downtime. - example: America/New_York - type: string - type: object - MonitorDowntimeMatchResponse: - description: Response for retrieving all downtime matches for a monitor. - properties: - data: - description: An array of downtime matches. - items: - $ref: '#/components/schemas/MonitorDowntimeMatchResponseData' - type: array - meta: - $ref: '#/components/schemas/DowntimeMeta' - type: object - MonitorDowntimeMatchResponseData: - description: A downtime match. - properties: - attributes: - $ref: '#/components/schemas/MonitorDowntimeMatchResponseAttributes' - id: - description: The downtime ID. - example: 00000000-0000-1234-0000-000000000000 - nullable: true - type: string - type: - $ref: '#/components/schemas/MonitorDowntimeMatchResourceType' - type: object - MonitorDowntimeMatchResponseAttributes: - description: Downtime match details. - properties: - end: - description: The end of the downtime. - example: '2020-01-02T03:04:00.000Z' - format: date-time - nullable: true - type: string - groups: - description: An array of groups associated with the downtime. - example: - - 'service:postgres' - - 'team:frontend' - items: - description: An array of groups. - example: 'service:postgres' - type: string - type: array - scope: - $ref: '#/components/schemas/DowntimeScope' - start: - description: The start of the downtime. - example: '2020-01-02T03:04:00.000Z' - format: date-time - type: string - type: object - MonitorDowntimeMatchResourceType: - default: downtime_match - description: Monitor Downtime Match resource type. - enum: - - downtime_match - example: downtime_match - type: string - x-enum-varnames: - - DOWNTIME_MATCH - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - downtimes: - id: datadog.downtimes.downtimes - name: downtimes - title: Downtimes - methods: - list_downtimes: - operation: - $ref: '#/paths/~1api~1v2~1downtime/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_downtimes: - operation: - $ref: '#/paths/~1api~1v2~1downtime/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_downtime: - operation: - $ref: '#/paths/~1api~1v2~1downtime/post' - response: - mediaType: application/json - openAPIDocKey: '200' - cancel_downtime: - operation: - $ref: '#/paths/~1api~1v2~1downtime~1{downtime_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_downtime: - operation: - $ref: '#/paths/~1api~1v2~1downtime~1{downtime_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_downtime: - operation: - $ref: '#/paths/~1api~1v2~1downtime~1{downtime_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_downtime: - operation: - $ref: '#/paths/~1api~1v2~1downtime~1{downtime_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/downtimes/methods/get_downtime' - - $ref: '#/components/x-stackQL-resources/downtimes/methods/list_downtimes' - insert: - - $ref: '#/components/x-stackQL-resources/downtimes/methods/create_downtime' - update: [] - delete: [] - monitor_downtimes: - id: datadog.downtimes.monitor_downtimes - name: monitor_downtimes - title: Monitor Downtimes - methods: - list_monitor_downtimes: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1{monitor_id}~1downtime_matches/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_monitor_downtimes: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1{monitor_id}~1downtime_matches/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/monitor_downtimes/methods/list_monitor_downtimes' - insert: [] - update: [] - delete: [] -paths: - /api/v2/downtime: - get: - description: Get all scheduled downtimes. - operationId: ListDowntimes - parameters: - - description: Only return downtimes that are active when the request is made. - in: query - name: current_only - required: false - schema: - type: boolean - - description: |- - Comma-separated list of resource paths for related resources to include in the response. Supported resource - paths are `created_by` and `monitor`. - in: query - name: include - required: false - schema: - example: 'created_by,monitor' - type: string - - $ref: '#/components/parameters/PageOffset' - - description: Maximum number of downtimes in the response. - example: 100 - in: query - name: 'page[limit]' - required: false - schema: - default: 30 - format: int64 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ListDowntimesResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - monitors_downtime - summary: Get all downtimes - tags: - - Downtimes - x-pagination: - limitParam: 'page[limit]' - pageOffsetParam: 'page[offset]' - resultsPath: data - post: - description: Schedule a downtime. - operationId: CreateDowntime - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/DowntimeCreateRequest' - description: Schedule a downtime request body. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DowntimeResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - monitors_downtime - summary: Schedule a downtime - tags: - - Downtimes - x-codegen-request-body-name: body - '/api/v2/downtime/{downtime_id}': - delete: - description: Cancel a downtime. - operationId: CancelDowntime - parameters: - - description: ID of the downtime to cancel. - in: path - name: downtime_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - responses: - '204': - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Downtime not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - monitors_downtime - summary: Cancel a downtime - tags: - - Downtimes - get: - description: Get downtime detail by `downtime_id`. - operationId: GetDowntime - parameters: - - description: ID of the downtime to fetch. - in: path - name: downtime_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - - description: |- - Comma-separated list of resource paths for related resources to include in the response. Supported resource - paths are `created_by` and `monitor`. - in: query - name: include - required: false - schema: - example: 'created_by,monitor' - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DowntimeResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - monitors_downtime - summary: Get a downtime - tags: - - Downtimes - patch: - description: Update a downtime by `downtime_id`. - operationId: UpdateDowntime - parameters: - - description: ID of the downtime to update. - in: path - name: downtime_id - required: true - schema: - example: 00e000000-0000-1234-0000-000000000000 - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/DowntimeUpdateRequest' - description: Update a downtime request body. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/DowntimeResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Downtime not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - monitors_downtime - summary: Update a downtime - tags: - - Downtimes - x-codegen-request-body-name: body - '/api/v2/monitor/{monitor_id}/downtime_matches': - get: - description: Get all active downtimes for the specified monitor. - operationId: ListMonitorDowntimes - parameters: - - description: The id of the monitor. - in: path - name: monitor_id - required: true - schema: - format: int64 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MonitorDowntimeMatchResponse' - description: OK - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Monitor Not Found error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - monitors_downtime - summary: Get active downtimes for a monitor - tags: - - Downtimes - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/events.yaml b/providers/src/datadog/v00.00.00000/services/events.yaml deleted file mode 100644 index 9d36fea2..00000000 --- a/providers/src/datadog/v00.00.00000/services/events.yaml +++ /dev/null @@ -1,1415 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - events - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - EventsSort: - description: The sort parameters when querying events. - enum: - - timestamp - - '-timestamp' - type: string - x-enum-varnames: - - TIMESTAMP_ASCENDING - - TIMESTAMP_DESCENDING - EventsListResponse: - description: The response object with all events matching the request and pagination information. - properties: - data: - description: An array of events matching the request. - items: - $ref: '#/components/schemas/EventResponse' - type: array - links: - $ref: '#/components/schemas/EventsListResponseLinks' - meta: - $ref: '#/components/schemas/EventsResponseMetadata' - type: object - EventResponse: - description: The object description of an event after being processed and stored by Datadog. - properties: - attributes: - $ref: '#/components/schemas/EventResponseAttributes' - id: - description: the unique ID of the event. - example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA - type: string - type: - $ref: '#/components/schemas/EventType' - type: object - EventsListResponseLinks: - description: Links attributes. - properties: - next: - description: |- - Link for the next set of results. Note that the request can also be made using the - POST endpoint. - example: 'https://app.datadoghq.com/api/v2/events?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==' - type: string - type: object - EventsResponseMetadata: - description: The metadata associated with a request. - properties: - elapsed: - description: The time elapsed in milliseconds. - example: 132 - format: int64 - type: integer - page: - $ref: '#/components/schemas/EventsResponseMetadataPage' - request_id: - description: The identifier of the request. - example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR - type: string - status: - description: The request status. - example: done - type: string - warnings: - description: |- - A list of warnings (non-fatal errors) encountered. Partial results might be returned if - warnings are present in the response. - items: - $ref: '#/components/schemas/EventsWarning' - type: array - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - EventResponseAttributes: - description: The object description of an event response attribute. - properties: - attributes: - $ref: '#/components/schemas/EventAttributes' - message: - description: The message of the event. - type: string - tags: - description: An array of tags associated with the event. - example: - - 'team:A' - items: - description: The tag associated with the event. - type: string - type: array - timestamp: - description: The timestamp of the event. - example: '2019-01-02T09:42:36.320Z' - format: date-time - type: string - type: object - EventType: - default: event - description: Type of the event. - enum: - - event - example: event - type: string - x-enum-varnames: - - EVENT - EventsResponseMetadataPage: - description: Pagination attributes. - properties: - after: - description: |- - The cursor to use to get the next results, if any. To make the next request, use the same - parameters with the addition of the `page[cursor]`. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - type: object - EventsWarning: - description: A warning message indicating something is wrong with the query. - properties: - code: - description: A unique code for this type of warning. - example: unknown_index - type: string - detail: - description: A detailed explanation of this specific warning. - example: 'indexes: foo, bar' - type: string - title: - description: A short human-readable summary of the warning. - example: One or several indexes are missing or invalid. Results hold data from the other indexes. - type: string - type: object - EventAttributes: - description: Object description of attributes from your event. - properties: - aggregation_key: - description: Aggregation key of the event. - type: string - date_happened: - description: |- - POSIX timestamp of the event. Must be sent as an integer (no quotation marks). - Limited to events no older than 18 hours. - format: int64 - type: integer - device_name: - description: A device name. - type: string - duration: - description: The duration between the triggering of the event and its recovery in nanoseconds. - format: int64 - type: integer - event_object: - description: The event title. - example: Did you hear the news today? - type: string - evt: - $ref: '#/components/schemas/Event' - hostname: - description: |- - Host name to associate with the event. - Any tags associated with the host are also applied to this event. - type: string - monitor: - $ref: '#/components/schemas/MonitorType' - monitor_groups: - description: List of groups referred to in the event. - items: - description: Group referred to in the event. - type: string - nullable: true - type: array - monitor_id: - description: 'ID of the monitor that triggered the event. When an event isn''t related to a monitor, this field is empty.' - format: int64 - nullable: true - type: integer - priority: - $ref: '#/components/schemas/EventPriority' - related_event_id: - description: Related event ID. - format: int64 - type: integer - service: - description: Service that triggered the event. - example: datadog-api - type: string - source_type_name: - description: |- - The type of event being posted. - For example, `nagios`, `hudson`, `jenkins`, `my_apps`, `chef`, `puppet`, `git` or `bitbucket`. - The list of standard source attribute values is [available here](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). - type: string - sourcecategory: - description: 'Identifier for the source of the event, such as a monitor alert, an externally-submitted event, or an integration.' - type: string - status: - $ref: '#/components/schemas/EventStatusType' - tags: - description: A list of tags to apply to the event. - example: - - 'environment:test' - items: - description: A tag. - type: string - type: array - timestamp: - description: POSIX timestamp of your event in milliseconds. - example: 1652274265000 - format: int64 - type: integer - title: - description: The event title. - example: Oh boy! - type: string - type: object - Event: - description: The metadata associated with a request. - properties: - id: - description: Event ID. - example: '6509751066204996294' - type: string - name: - description: The event name. - type: string - source_id: - description: Event source ID. - example: 36 - format: int64 - type: integer - type: - description: Event type. - example: error_tracking_alert - type: string - type: object - MonitorType: - description: Attributes from the monitor that triggered the event. - nullable: true - properties: - created_at: - description: The POSIX timestamp of the monitor's creation in nanoseconds. - example: 1646318692000 - format: int64 - type: integer - group_status: - description: Monitor group status used when there is no `result_groups`. - format: int32 - maximum: 2147483647 - type: integer - groups: - description: Groups to which the monitor belongs. - items: - description: A group. - type: string - type: array - id: - description: The monitor ID. - format: int64 - type: integer - message: - description: The monitor message. - type: string - modified: - description: The monitor's last-modified timestamp. - format: int64 - type: integer - name: - description: The monitor name. - type: string - query: - description: The query that triggers the alert. - type: string - tags: - description: A list of tags attached to the monitor. - example: - - 'environment:test' - items: - description: A tag. - type: string - type: array - templated_name: - description: The templated name of the monitor before resolving any template variables. - type: string - type: - description: The monitor type. - type: string - type: object - EventPriority: - description: 'The priority of the event''s monitor. For example, `normal` or `low`.' - enum: - - normal - - low - example: normal - nullable: true - type: string - x-enum-varnames: - - NORMAL - - LOW - EventStatusType: - description: |- - If an alert event is enabled, its status is one of the following: - `failure`, `error`, `warning`, `info`, `success`, `user_update`, - `recommendation`, or `snapshot`. - enum: - - failure - - error - - warning - - info - - success - - user_update - - recommendation - - snapshot - example: info - type: string - x-enum-varnames: - - FAILURE - - ERROR - - WARNING - - INFO - - SUCCESS - - USER_UPDATE - - RECOMMENDATION - - SNAPSHOT - EventsListRequest: - description: The object sent with the request to retrieve a list of events from your organization. - properties: - filter: - $ref: '#/components/schemas/EventsQueryFilter' - options: - $ref: '#/components/schemas/EventsQueryOptions' - page: - $ref: '#/components/schemas/EventsRequestPage' - sort: - $ref: '#/components/schemas/EventsSort' - type: object - EventsQueryFilter: - description: The search and filter query settings. - properties: - from: - default: now-15m - description: The minimum time for the requested events. Supports date math and regular timestamps in milliseconds. - example: now-15m - type: string - query: - default: '*' - description: The search query following the event search syntax. - example: 'service:web* AND @http.status_code:[200 TO 299]' - type: string - to: - default: now - description: The maximum time for the requested events. Supports date math and regular timestamps in milliseconds. - example: now - type: string - type: object - EventsQueryOptions: - description: |- - The global query options that are used. Either provide a timezone or a time offset but not both, - otherwise the query fails. - properties: - timeOffset: - description: The time offset to apply to the query in seconds. - format: int64 - type: integer - timezone: - default: UTC - description: 'The timezone can be specified as GMT, UTC, an offset from UTC (like UTC+1), or as a Timezone Database identifier (like America/New_York).' - example: GMT - type: string - type: object - EventsRequestPage: - description: Pagination settings. - properties: - cursor: - description: The returned paging point to use to get the next results. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - limit: - default: 10 - description: The maximum number of logs in the response. - example: 25 - format: int32 - maximum: 1000 - type: integer - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - events: - id: datadog.events.events - name: events - title: Events - methods: - list_events: - operation: - $ref: '#/paths/~1api~1v2~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_events: - operation: - $ref: '#/paths/~1api~1v2~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - search_events: - operation: - $ref: '#/paths/~1api~1v2~1events~1search/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/events/methods/list_events' - insert: [] - update: [] - delete: [] -paths: - /api/v2/events: - get: - description: |- - List endpoint returns events that match an events search query. - [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). - - Use this endpoint to see your latest events. - operationId: ListEvents - parameters: - - description: Search query following events syntax. - in: query - name: 'filter[query]' - required: false - schema: - type: string - - description: Minimum timestamp for requested events. - in: query - name: 'filter[from]' - required: false - schema: - type: string - - description: Maximum timestamp for requested events. - in: query - name: 'filter[to]' - required: false - schema: - type: string - - description: Order of events in results. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/EventsSort' - - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - in: query - name: 'page[cursor]' - required: false - schema: - type: string - - description: Maximum number of events in the response. - example: 25 - in: query - name: 'page[limit]' - required: false - schema: - default: 10 - format: int32 - maximum: 1000 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/EventsListResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - events_read - summary: Get a list of events - tags: - - Events - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data - /api/v2/events/search: - post: - description: |- - List endpoint returns events that match an events search query. - [Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). - - Use this endpoint to build complex events filtering and search. - operationId: SearchEvents - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/EventsListRequest' - required: false - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/EventsListResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - events_read - summary: Search events - tags: - - Events - x-codegen-request-body-name: body - x-pagination: - cursorParam: body.page.cursor - cursorPath: meta.page.after - limitParam: body.page.limit - resultsPath: data diff --git a/providers/src/datadog/v00.00.00000/services/fastly_integration.yaml b/providers/src/datadog/v00.00.00000/services/fastly_integration.yaml deleted file mode 100644 index 79b47a09..00000000 --- a/providers/src/datadog/v00.00.00000/services/fastly_integration.yaml +++ /dev/null @@ -1,1455 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - fastly_integration - description: Fastly_Integration -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - FastlyAccountsResponse: - description: The expected response schema when getting Fastly accounts. - properties: - data: - description: 'The JSON:API data schema.' - items: - $ref: '#/components/schemas/FastlyAccountResponseData' - type: array - type: object - FastlyAccountResponseData: - description: Data object of a Fastly account. - properties: - attributes: - $ref: '#/components/schemas/FastlyAccounResponseAttributes' - id: - description: 'The ID of the Fastly account, a hash of the account name.' - example: abc123 - type: string - type: - $ref: '#/components/schemas/FastlyAccountType' - required: - - attributes - - id - - type - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - FastlyAccounResponseAttributes: - description: Attributes object of a Fastly account. - properties: - name: - description: The name of the Fastly account. - example: test-name - type: string - services: - description: A list of services belonging to the parent account. - items: - $ref: '#/components/schemas/FastlyService' - type: array - required: - - name - type: object - FastlyAccountType: - default: fastly-accounts - description: 'The JSON:API type for this API. Should always be `fastly-accounts`.' - enum: - - fastly-accounts - example: fastly-accounts - type: string - x-enum-varnames: - - FASTLY_ACCOUNTS - FastlyService: - description: The schema representation of a Fastly service. - properties: - id: - description: The id of the Fastly service - example: 6abc7de6893AbcDe9fghIj - type: string - tags: - description: A list of tags for the Fastly service. - example: - - myTag - - 'myTag2:myValue' - items: - type: string - type: array - required: - - id - type: object - FastlyAccountCreateRequest: - description: Payload schema when adding a Fastly account. - properties: - data: - $ref: '#/components/schemas/FastlyAccountCreateRequestData' - required: - - data - type: object - FastlyAccountResponse: - description: The expected response schema when getting a Fastly account. - properties: - data: - $ref: '#/components/schemas/FastlyAccountResponseData' - type: object - FastlyAccountCreateRequestData: - description: Data object for creating a Fastly account. - properties: - attributes: - $ref: '#/components/schemas/FastlyAccountCreateRequestAttributes' - type: - $ref: '#/components/schemas/FastlyAccountType' - required: - - attributes - - type - type: object - FastlyAccountCreateRequestAttributes: - description: Attributes object for creating a Fastly account. - properties: - api_key: - description: The API key for the Fastly account. - example: ABCDEFG123 - type: string - name: - description: The name of the Fastly account. - example: test-name - type: string - services: - description: A list of services belonging to the parent account. - items: - $ref: '#/components/schemas/FastlyService' - type: array - required: - - api_key - - name - type: object - FastlyAccountUpdateRequest: - description: Payload schema when updating a Fastly account. - properties: - data: - $ref: '#/components/schemas/FastlyAccountUpdateRequestData' - required: - - data - type: object - FastlyAccountUpdateRequestData: - description: Data object for updating a Fastly account. - properties: - attributes: - $ref: '#/components/schemas/FastlyAccountUpdateRequestAttributes' - type: - $ref: '#/components/schemas/FastlyAccountType' - type: object - FastlyAccountUpdateRequestAttributes: - description: Attributes object for updating a Fastly account. - properties: - api_key: - description: The API key of the Fastly account. - example: ABCDEFG123 - type: string - type: object - FastlyServicesResponse: - description: The expected response schema when getting Fastly services. - properties: - data: - description: 'The JSON:API data schema.' - items: - $ref: '#/components/schemas/FastlyServiceResponse' - type: array - type: object - FastlyServiceResponse: - description: The expected response schema when getting a Fastly service. - properties: - data: - $ref: '#/components/schemas/FastlyServiceData' - type: object - FastlyServiceData: - description: Data object for Fastly service requests. - properties: - attributes: - $ref: '#/components/schemas/FastlyServiceAttributes' - id: - description: The ID of the Fastly service. - example: abc123 - type: string - type: - $ref: '#/components/schemas/FastlyServiceType' - required: - - id - - type - type: object - FastlyServiceAttributes: - description: Attributes object for Fastly service requests. - properties: - tags: - description: A list of tags for the Fastly service. - example: - - myTag - - 'myTag2:myValue' - items: - type: string - type: array - type: object - FastlyServiceType: - default: fastly-services - description: 'The JSON:API type for this API. Should always be `fastly-services`.' - enum: - - fastly-services - example: fastly-services - type: string - x-enum-varnames: - - FASTLY_SERVICES - FastlyServiceRequest: - description: Payload schema for Fastly service requests. - properties: - data: - $ref: '#/components/schemas/FastlyServiceData' - required: - - data - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - fastly_accounts: - id: datadog.fastly_integration.fastly_accounts - name: fastly_accounts - title: Fastly Accounts - methods: - list_fastly_accounts: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_fastly_accounts: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_fastly_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_fastly_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_fastly_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_fastly_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_fastly_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/fastly_accounts/methods/get_fastly_account' - - $ref: '#/components/x-stackQL-resources/fastly_accounts/methods/list_fastly_accounts' - insert: - - $ref: '#/components/x-stackQL-resources/fastly_accounts/methods/create_fastly_account' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/fastly_accounts/methods/delete_fastly_account' - fastly_services: - id: datadog.fastly_integration.fastly_services - name: fastly_services - title: Fastly Services - methods: - list_fastly_services: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_fastly_services: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_fastly_service: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_fastly_service: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services~1{service_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_fastly_service: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services~1{service_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_fastly_service: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services~1{service_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_fastly_service: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services~1{service_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/fastly_services/methods/get_fastly_service' - - $ref: '#/components/x-stackQL-resources/fastly_services/methods/list_fastly_services' - insert: - - $ref: '#/components/x-stackQL-resources/fastly_services/methods/create_fastly_service' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/fastly_services/methods/delete_fastly_service' -paths: - /api/v2/integrations/fastly/accounts: - get: - description: List Fastly accounts. - operationId: ListFastlyAccounts - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyAccountsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List Fastly accounts - tags: - - Fastly Integration - post: - description: Create a Fastly account. - operationId: CreateFastlyAccount - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyAccountCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyAccountResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Add Fastly account - tags: - - Fastly Integration - x-codegen-request-body-name: body - '/api/v2/integrations/fastly/accounts/{account_id}': - delete: - description: Delete a Fastly account. - operationId: DeleteFastlyAccount - parameters: - - $ref: '#/components/parameters/FastlyAccountID' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete Fastly account - tags: - - Fastly Integration - get: - description: Get a Fastly account. - operationId: GetFastlyAccount - parameters: - - $ref: '#/components/parameters/FastlyAccountID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get Fastly account - tags: - - Fastly Integration - patch: - description: Update a Fastly account. - operationId: UpdateFastlyAccount - parameters: - - $ref: '#/components/parameters/FastlyAccountID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyAccountUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update Fastly account - tags: - - Fastly Integration - x-codegen-request-body-name: body - '/api/v2/integrations/fastly/accounts/{account_id}/services': - get: - description: List Fastly services for an account. - operationId: ListFastlyServices - parameters: - - $ref: '#/components/parameters/FastlyAccountID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyServicesResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List Fastly services - tags: - - Fastly Integration - post: - description: Create a Fastly service for an account. - operationId: CreateFastlyService - parameters: - - $ref: '#/components/parameters/FastlyAccountID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyServiceRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyServiceResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Add Fastly service - tags: - - Fastly Integration - x-codegen-request-body-name: body - '/api/v2/integrations/fastly/accounts/{account_id}/services/{service_id}': - delete: - description: Delete a Fastly service for an account. - operationId: DeleteFastlyService - parameters: - - $ref: '#/components/parameters/FastlyAccountID' - - $ref: '#/components/parameters/FastlyServiceID' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete Fastly service - tags: - - Fastly Integration - get: - description: Get a Fastly service for an account. - operationId: GetFastlyService - parameters: - - $ref: '#/components/parameters/FastlyAccountID' - - $ref: '#/components/parameters/FastlyServiceID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyServiceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get Fastly service - tags: - - Fastly Integration - patch: - description: Update a Fastly service for an account. - operationId: UpdateFastlyService - parameters: - - $ref: '#/components/parameters/FastlyAccountID' - - $ref: '#/components/parameters/FastlyServiceID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyServiceRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/FastlyServiceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update Fastly service - tags: - - Fastly Integration - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/gcp_integration.yaml b/providers/src/datadog/v00.00.00000/services/gcp_integration.yaml deleted file mode 100644 index 06a4a591..00000000 --- a/providers/src/datadog/v00.00.00000/services/gcp_integration.yaml +++ /dev/null @@ -1,1272 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - gcp_integration - description: GCP_Integration -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - GCPSTSServiceAccountsResponse: - description: Object containing all your STS enabled accounts. - properties: - data: - description: Array of GCP STS enabled service accounts. - items: - $ref: '#/components/schemas/GCPSTSServiceAccount' - type: array - type: object - GCPSTSServiceAccount: - description: Info on your service account. - properties: - attributes: - $ref: '#/components/schemas/GCPSTSServiceAccountAttributes' - id: - description: Your service account's unique ID. - example: d291291f-12c2-22g4-j290-123456678897 - type: string - meta: - $ref: '#/components/schemas/GCPServiceAccountMeta' - type: - $ref: '#/components/schemas/GCPServiceAccountType' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - GCPSTSServiceAccountAttributes: - description: Attributes associated with your service account. - properties: - account_tags: - description: Tags to be associated with GCP metrics and service checks from your account. - items: - description: Account Level Tag - type: string - type: array - automute: - description: Silence monitors for expected GCE instance shutdowns. - type: boolean - client_email: - description: Your service account email address. - example: datadog-service-account@test-project.iam.gserviceaccount.com - type: string - host_filters: - description: Your Host Filters. - items: - description: Host Filters - type: string - type: array - is_cspm_enabled: - description: 'When enabled, Datadog will activate the Cloud Security Monitoring product for this service account. Note: This requires resource_collection_enabled to be set to true.' - type: boolean - is_security_command_center_enabled: - default: false - description: 'When enabled, Datadog will attempt to collect Security Command Center Findings. Note: This requires additional permissions on the service account.' - example: true - type: boolean - resource_collection_enabled: - default: false - description: 'When enabled, Datadog scans for all resources in your GCP environment.' - type: boolean - type: object - GCPServiceAccountMeta: - description: Additional information related to your service account. - properties: - accessible_projects: - description: The current list of projects accessible from your service account. - items: - description: List of GCP projects. - type: string - type: array - type: object - GCPServiceAccountType: - default: gcp_service_account - description: The type of account. - enum: - - gcp_service_account - example: gcp_service_account - type: string - x-enum-varnames: - - GCP_SERVICE_ACCOUNT - GCPSTSServiceAccountCreateRequest: - description: Data on your newly generated service account. - properties: - data: - $ref: '#/components/schemas/GCPSTSServiceAccountData' - type: object - GCPSTSServiceAccountResponse: - description: The account creation response. - properties: - data: - $ref: '#/components/schemas/GCPSTSServiceAccount' - type: object - GCPSTSServiceAccountData: - description: Additional metadata on your generated service account. - properties: - attributes: - $ref: '#/components/schemas/GCPSTSServiceAccountAttributes' - type: - $ref: '#/components/schemas/GCPServiceAccountType' - type: object - GCPSTSServiceAccountUpdateRequest: - description: Service account info. - properties: - data: - $ref: '#/components/schemas/GCPSTSServiceAccountUpdateRequestData' - type: object - GCPSTSServiceAccountUpdateRequestData: - description: Data on your service account. - properties: - attributes: - $ref: '#/components/schemas/GCPSTSServiceAccountAttributes' - id: - description: Your service account's unique ID. - example: d291291f-12c2-22g4-j290-123456678897 - type: string - type: - $ref: '#/components/schemas/GCPServiceAccountType' - type: object - GCPSTSDelegateAccountResponse: - description: Your delegate service account response data. - properties: - data: - $ref: '#/components/schemas/GCPSTSDelegateAccount' - type: object - GCPSTSDelegateAccount: - description: Datadog principal service account info. - properties: - attributes: - $ref: '#/components/schemas/GCPSTSDelegateAccountAttributes' - id: - description: The ID of the delegate service account. - example: ddgci-1a19n28hb1a812221893@datadog-gci-sts-us5-prod.iam.gserviceaccount.com - type: string - type: - $ref: '#/components/schemas/GCPSTSDelegateAccountType' - type: object - GCPSTSDelegateAccountAttributes: - description: Your delegate account attributes. - properties: - delegate_account_email: - description: Your organization's Datadog principal email address. - example: ddgci-1a19n28hb1a812221893@datadog-gci-sts-us5-prod.iam.gserviceaccount.com - type: string - type: object - GCPSTSDelegateAccountType: - default: gcp_sts_delegate - description: The type of account. - enum: - - gcp_sts_delegate - example: gcp_sts_delegate - type: string - x-enum-varnames: - - GCP_STS_DELEGATE - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - UnauthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unauthorized - ConflictResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - sts_accounts: - id: datadog.gcp_integration.sts_accounts - name: sts_accounts - title: Sts Accounts - methods: - list_gcpsts_accounts: - operation: - $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_gcpsts_accounts: - operation: - $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_gcpsts_account: - operation: - $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_gcpsts_account: - operation: - $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts~1{account_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - update_gcpsts_account: - operation: - $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts~1{account_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '201' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/sts_accounts/methods/list_gcpsts_accounts' - insert: - - $ref: '#/components/x-stackQL-resources/sts_accounts/methods/create_gcpsts_account' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/sts_accounts/methods/delete_gcpsts_account' - sts_delegates: - id: datadog.gcp_integration.sts_delegates - name: sts_delegates - title: Sts Delegates - methods: - get_gcpsts_delegate: - operation: - $ref: '#/paths/~1api~1v2~1integration~1gcp~1sts_delegate/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_gcpsts_delegate: - operation: - $ref: '#/paths/~1api~1v2~1integration~1gcp~1sts_delegate/get' - response: - mediaType: application/json - openAPIDocKey: '200' - make_gcpsts_delegate: - operation: - $ref: '#/paths/~1api~1v2~1integration~1gcp~1sts_delegate/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/sts_delegates/methods/get_gcpsts_delegate' - insert: [] - update: [] - delete: [] -paths: - /api/v2/integration/gcp/accounts: - get: - description: List all GCP STS-enabled service accounts configured in your Datadog account. - operationId: ListGCPSTSAccounts - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/GCPSTSServiceAccountsResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List all GCP STS-enabled service accounts - tags: - - GCP Integration - post: - description: Create a new entry within Datadog for your STS enabled service account. - operationId: CreateGCPSTSAccount - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/GCPSTSServiceAccountCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/GCPSTSServiceAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a new entry for your service account - tags: - - GCP Integration - x-codegen-request-body-name: body - '/api/v2/integration/gcp/accounts/{account_id}': - delete: - description: Delete an STS enabled GCP account from within Datadog. - operationId: DeleteGCPSTSAccount - parameters: - - $ref: '#/components/parameters/GCPSTSServiceAccountID' - responses: - '204': - description: No Content - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete an STS enabled GCP Account - tags: - - GCP Integration - patch: - description: Update an STS enabled service account. - operationId: UpdateGCPSTSAccount - parameters: - - $ref: '#/components/parameters/GCPSTSServiceAccountID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/GCPSTSServiceAccountUpdateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/GCPSTSServiceAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update STS Service Account - tags: - - GCP Integration - x-codegen-request-body-name: body - /api/v2/integration/gcp/sts_delegate: - get: - description: List your Datadog-GCP STS delegate account configured in your Datadog account. - operationId: GetGCPSTSDelegate - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/GCPSTSDelegateAccountResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List delegate account - tags: - - GCP Integration - x-codegen-request-body-name: body - post: - description: Create a Datadog GCP principal. - operationId: MakeGCPSTSDelegate - requestBody: - content: - application/json: - schema: - example: {} - type: object - description: Create a delegate service account within Datadog. - required: false - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/GCPSTSDelegateAccountResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a Datadog GCP principal - tags: - - GCP Integration - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/incidents.yaml b/providers/src/datadog/v00.00.00000/services/incidents.yaml deleted file mode 100644 index 1c8908cc..00000000 --- a/providers/src/datadog/v00.00.00000/services/incidents.yaml +++ /dev/null @@ -1,4424 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - incidents - description: Manage incident response. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - IncidentsResponse: - description: Response with a list of incidents. - properties: - data: - description: An array of incidents. - example: - - attributes: - created: '2020-04-21T15:34:08.627205+00:00' - creation_idempotency_key: null - customer_impact_duration: 0 - customer_impact_end: null - customer_impact_scope: null - customer_impact_start: null - customer_impacted: false - detected: '2020-04-14T00:00:00+00:00' - modified: '2020-09-17T14:16:58.696424+00:00' - public_id: 1 - resolved: null - severity: SEV-1 - time_to_detect: 0 - time_to_internal_response: 0 - time_to_repair: 0 - time_to_resolve: 0 - title: Example Incident - id: 00000000-aaaa-0000-0000-000000000000 - relationships: - attachments: - data: - - id: 00000000-9999-0000-0000-000000000000 - type: incident_attachments - - id: 00000000-1234-0000-0000-000000000000 - type: incident_attachments - commander_user: - data: - id: 00000000-0000-0000-cccc-000000000000 - type: users - created_by_user: - data: - id: 00000000-0000-0000-cccc-000000000000 - type: users - integrations: - data: - - id: 00000000-0000-0000-4444-000000000000 - type: incident_integrations - - id: 00000000-0000-0000-5555-000000000000 - type: incident_integrations - last_modified_by_user: - data: - id: 00000000-0000-0000-cccc-000000000000 - type: users - type: incidents - - attributes: - created: '2020-04-21T15:34:08.627205+00:00' - creation_idempotency_key: null - customer_impact_duration: 0 - customer_impact_end: null - customer_impact_scope: null - customer_impact_start: null - customer_impacted: false - detected: '2020-04-14T00:00:00+00:00' - modified: '2020-09-17T14:16:58.696424+00:00' - public_id: 2 - resolved: null - severity: SEV-5 - time_to_detect: 0 - time_to_internal_response: 0 - time_to_repair: 0 - time_to_resolve: 0 - title: Example Incident 2 - id: 00000000-1111-0000-0000-000000000000 - relationships: - attachments: - data: - - id: 00000000-9999-0000-0000-000000000000 - type: incident_attachments - commander_user: - data: - id: 00000000-aaaa-0000-0000-000000000000 - type: users - created_by_user: - data: - id: 00000000-aaaa-0000-0000-000000000000 - type: users - integrations: - data: - - id: 00000000-0000-0000-0001-000000000000 - type: incident_integrations - - id: 00000000-0000-0000-0002-000000000000 - type: incident_integrations - last_modified_by_user: - data: - id: 00000000-aaaa-0000-0000-000000000000 - type: users - type: incidents - items: - $ref: '#/components/schemas/IncidentResponseData' - type: array - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentResponseIncludedItem' - readOnly: true - type: array - meta: - $ref: '#/components/schemas/IncidentResponseMeta' - required: - - data - type: object - IncidentResponseData: - description: Incident data from a response. - properties: - attributes: - $ref: '#/components/schemas/IncidentResponseAttributes' - id: - description: The incident's ID. - example: 00000000-0000-0000-1234-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentResponseRelationships' - type: - $ref: '#/components/schemas/IncidentType' - required: - - id - - type - type: object - IncidentResponseIncludedItem: - description: An object related to an incident that is included in the response. - oneOf: - - $ref: '#/components/schemas/User' - - $ref: '#/components/schemas/IncidentAttachmentData' - IncidentResponseMeta: - description: The metadata object containing pagination metadata. - properties: - pagination: - $ref: '#/components/schemas/IncidentResponseMetaPagination' - readOnly: true - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - IncidentResponseAttributes: - description: The incident's attributes from a response. - properties: - archived: - description: Timestamp of when the incident was archived. - format: date-time - nullable: true - readOnly: true - type: string - case_id: - description: The incident case id. - format: int64 - nullable: true - type: integer - created: - description: Timestamp when the incident was created. - format: date-time - readOnly: true - type: string - customer_impact_duration: - description: |- - Length of the incident's customer impact in seconds. - Equals the difference between `customer_impact_start` and `customer_impact_end`. - format: int64 - readOnly: true - type: integer - customer_impact_end: - description: Timestamp when customers were no longer impacted by the incident. - format: date-time - nullable: true - type: string - customer_impact_scope: - description: A summary of the impact customers experienced during the incident. - example: An example customer impact scope - nullable: true - type: string - customer_impact_start: - description: Timestamp when customers began being impacted by the incident. - format: date-time - nullable: true - type: string - customer_impacted: - description: A flag indicating whether the incident caused customer impact. - example: false - type: boolean - detected: - description: Timestamp when the incident was detected. - format: date-time - nullable: true - type: string - fields: - additionalProperties: - $ref: '#/components/schemas/IncidentFieldAttributes' - description: A condensed view of the user-defined fields attached to incidents. - example: - severity: - type: dropdown - value: SEV-5 - type: object - modified: - description: Timestamp when the incident was last modified. - format: date-time - readOnly: true - type: string - non_datadog_creator: - $ref: '#/components/schemas/IncidentNonDatadogCreator' - notification_handles: - description: Notification handles that will be notified of the incident during update. - items: - $ref: '#/components/schemas/IncidentNotificationHandle' - nullable: true - type: array - public_id: - description: The monotonically increasing integer ID for the incident. - example: 1 - format: int64 - type: integer - resolved: - description: Timestamp when the incident's state was last changed from active or stable to resolved or completed. - format: date-time - nullable: true - type: string - severity: - $ref: '#/components/schemas/IncidentSeverity' - state: - description: The state incident. - nullable: true - type: string - time_to_detect: - description: |- - The amount of time in seconds to detect the incident. - Equals the difference between `customer_impact_start` and `detected`. - format: int64 - readOnly: true - type: integer - time_to_internal_response: - description: The amount of time in seconds to call incident after detection. Equals the difference of `detected` and `created`. - format: int64 - readOnly: true - type: integer - time_to_repair: - description: The amount of time in seconds to resolve customer impact after detecting the issue. Equals the difference between `customer_impact_end` and `detected`. - format: int64 - readOnly: true - type: integer - time_to_resolve: - description: The amount of time in seconds to resolve the incident after it was created. Equals the difference between `created` and `resolved`. - format: int64 - readOnly: true - type: integer - title: - description: 'The title of the incident, which summarizes what happened.' - example: A test incident title - type: string - visibility: - description: The incident visibility status. - nullable: true - type: string - required: - - title - type: object - IncidentResponseRelationships: - description: The incident's relationships from a response. - properties: - attachments: - $ref: '#/components/schemas/RelationshipToIncidentAttachment' - commander_user: - $ref: '#/components/schemas/NullableRelationshipToUser' - created_by_user: - $ref: '#/components/schemas/RelationshipToUser' - impacts: - $ref: '#/components/schemas/RelationshipToIncidentImpacts' - integrations: - $ref: '#/components/schemas/RelationshipToIncidentIntegrationMetadatas' - last_modified_by_user: - $ref: '#/components/schemas/RelationshipToUser' - responders: - $ref: '#/components/schemas/RelationshipToIncidentResponders' - user_defined_fields: - $ref: '#/components/schemas/RelationshipToIncidentUserDefinedFields' - type: object - IncidentType: - default: incidents - description: Incident resource type. - enum: - - incidents - example: incidents - type: string - x-enum-varnames: - - INCIDENTS - User: - description: User object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserAttributes' - id: - description: ID of the user. - type: string - relationships: - $ref: '#/components/schemas/UserResponseRelationships' - type: - $ref: '#/components/schemas/UsersType' - type: object - IncidentAttachmentData: - description: A single incident attachment. - example: - attributes: - attachment: - documentUrl: '' - title: Postmortem IR-123 - attachment_type: postmortem - id: 00000000-abcd-0002-0000-000000000000 - relationships: - last_modified_by_user: - data: - id: 00000000-0000-0000-cccc-000000000000 - type: users - type: incident_attachments - properties: - attributes: - $ref: '#/components/schemas/IncidentAttachmentAttributes' - id: - description: A unique identifier that represents the incident attachment. - example: 00000000-abcd-0001-0000-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentAttachmentRelationships' - type: - $ref: '#/components/schemas/IncidentAttachmentType' - required: - - type - - attributes - - id - - relationships - type: object - IncidentResponseMetaPagination: - description: Pagination properties. - properties: - next_offset: - description: The index of the first element in the next page of results. Equal to page size added to the current offset. - example: 1000 - format: int64 - type: integer - offset: - description: The index of the first element in the results. - example: 10 - format: int64 - type: integer - size: - description: Maximum size of pages to return. - example: 1000 - format: int64 - type: integer - type: object - IncidentFieldAttributes: - description: 'Dynamic fields for which selections can be made, with field names as keys.' - oneOf: - - $ref: '#/components/schemas/IncidentFieldAttributesSingleValue' - - $ref: '#/components/schemas/IncidentFieldAttributesMultipleValue' - required: - - type - IncidentNonDatadogCreator: - description: Incident's non Datadog creator. - nullable: true - properties: - image_48_px: - description: Non Datadog creator `48px` image. - type: string - name: - description: Non Datadog creator name. - type: string - type: object - IncidentNotificationHandle: - description: A notification handle that will be notified at incident creation. - properties: - display_name: - description: The name of the notified handle. - example: Jane Doe - type: string - handle: - description: The email address used for the notification. - example: '@test.user@test.com' - type: string - type: object - IncidentSeverity: - description: The incident severity. - enum: - - UNKNOWN - - SEV-1 - - SEV-2 - - SEV-3 - - SEV-4 - - SEV-5 - example: UNKNOWN - type: string - x-enum-varnames: - - UNKNOWN - - SEV_1 - - SEV_2 - - SEV_3 - - SEV_4 - - SEV_5 - RelationshipToIncidentAttachment: - description: A relationship reference for attachments. - properties: - data: - description: An array of incident attachments. - items: - $ref: '#/components/schemas/RelationshipToIncidentAttachmentData' - type: array - required: - - data - type: object - NullableRelationshipToUser: - description: Relationship to user. - nullable: true - properties: - data: - $ref: '#/components/schemas/NullableRelationshipToUserData' - required: - - data - type: object - RelationshipToUser: - description: Relationship to user. - properties: - data: - $ref: '#/components/schemas/RelationshipToUserData' - required: - - data - type: object - RelationshipToIncidentImpacts: - description: Relationship to impacts. - properties: - data: - description: An array of incident impacts. - items: - $ref: '#/components/schemas/RelationshipToIncidentImpactData' - type: array - required: - - data - type: object - RelationshipToIncidentIntegrationMetadatas: - description: A relationship reference for multiple integration metadata objects. - example: - data: - - id: 00000000-abcd-0005-0000-000000000000 - type: incident_integrations - - id: 00000000-abcd-0006-0000-000000000000 - type: incident_integrations - properties: - data: - description: Integration metadata relationship array - example: - - id: 00000000-abcd-0003-0000-000000000000 - type: incident_integrations - - id: 00000000-abcd-0004-0000-000000000000 - type: incident_integrations - items: - $ref: '#/components/schemas/RelationshipToIncidentIntegrationMetadataData' - type: array - required: - - data - type: object - RelationshipToIncidentResponders: - description: Relationship to incident responders. - properties: - data: - description: An array of incident responders. - items: - $ref: '#/components/schemas/RelationshipToIncidentResponderData' - type: array - required: - - data - type: object - RelationshipToIncidentUserDefinedFields: - description: Relationship to incident user defined fields. - properties: - data: - description: An array of user defined fields. - items: - $ref: '#/components/schemas/RelationshipToIncidentUserDefinedFieldData' - type: array - required: - - data - type: object - UserAttributes: - description: Attributes of user object returned by the API. - properties: - created_at: - description: Creation time of the user. - format: date-time - type: string - disabled: - description: Whether the user is disabled. - type: boolean - email: - description: Email of the user. - type: string - handle: - description: Handle of the user. - type: string - icon: - description: URL of the user's icon. - type: string - modified_at: - description: Time that the user was last modified. - format: date-time - type: string - name: - description: Name of the user. - nullable: true - type: string - service_account: - description: Whether the user is a service account. - type: boolean - status: - description: Status of the user. - type: string - title: - description: Title of the user. - nullable: true - type: string - verified: - description: Whether the user is verified. - type: boolean - type: object - UserResponseRelationships: - description: Relationships of the user object returned by the API. - properties: - org: - $ref: '#/components/schemas/RelationshipToOrganization' - other_orgs: - $ref: '#/components/schemas/RelationshipToOrganizations' - other_users: - $ref: '#/components/schemas/RelationshipToUsers' - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - UsersType: - default: users - description: Users resource type. - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - IncidentAttachmentAttributes: - description: The attributes object for an attachment. - oneOf: - - $ref: '#/components/schemas/IncidentAttachmentPostmortemAttributes' - - $ref: '#/components/schemas/IncidentAttachmentLinkAttributes' - IncidentAttachmentRelationships: - description: The incident attachment's relationships. - properties: - last_modified_by_user: - $ref: '#/components/schemas/RelationshipToUser' - type: object - IncidentAttachmentType: - default: incident_attachments - description: The incident attachment resource type. - enum: - - incident_attachments - example: incident_attachments - type: string - x-enum-varnames: - - INCIDENT_ATTACHMENTS - IncidentFieldAttributesSingleValue: - description: A field with a single value selected. - properties: - type: - $ref: '#/components/schemas/IncidentFieldAttributesSingleValueType' - value: - description: The single value selected for this field. - example: SEV-1 - nullable: true - type: string - type: object - IncidentFieldAttributesMultipleValue: - description: A field with potentially multiple values selected. - properties: - type: - $ref: '#/components/schemas/IncidentFieldAttributesValueType' - value: - description: The multiple values selected for this field. - example: - - '1.0' - - '1.1' - items: - description: A value which has been selected for the parent field. - example: '1.1' - type: string - nullable: true - type: array - type: object - RelationshipToIncidentAttachmentData: - description: The attachment relationship data. - properties: - id: - description: A unique identifier that represents the attachment. - example: 00000000-0000-abcd-1000-000000000000 - type: string - type: - $ref: '#/components/schemas/IncidentAttachmentType' - required: - - id - - type - type: object - NullableRelationshipToUserData: - description: Relationship to user object. - nullable: true - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - RelationshipToUserData: - description: Relationship to user object. - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - RelationshipToIncidentImpactData: - description: Relationship to impact object. - properties: - id: - description: A unique identifier that represents the impact. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/IncidentImpactsType' - required: - - id - - type - type: object - RelationshipToIncidentIntegrationMetadataData: - description: A relationship reference for an integration metadata object. - example: - id: 00000000-abcd-0002-0000-000000000000 - type: incident_integrations - properties: - id: - description: A unique identifier that represents the integration metadata. - example: 00000000-abcd-0001-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/IncidentIntegrationMetadataType' - required: - - id - - type - type: object - RelationshipToIncidentResponderData: - description: Relationship to impact object. - properties: - id: - description: A unique identifier that represents the responder. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/IncidentRespondersType' - required: - - id - - type - type: object - RelationshipToIncidentUserDefinedFieldData: - description: Relationship to impact object. - properties: - id: - description: A unique identifier that represents the responder. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/IncidentUserDefinedFieldType' - required: - - id - - type - type: object - RelationshipToOrganization: - description: Relationship to an organization. - properties: - data: - $ref: '#/components/schemas/RelationshipToOrganizationData' - required: - - data - type: object - RelationshipToOrganizations: - description: Relationship to organizations. - properties: - data: - description: Relationships to organization objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToOrganizationData' - type: array - required: - - data - type: object - RelationshipToUsers: - description: Relationship to users. - properties: - data: - description: Relationships to user objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToUserData' - type: array - required: - - data - type: object - RelationshipToRoles: - description: Relationship to roles. - properties: - data: - description: An array containing type and the unique identifier of a role. - items: - $ref: '#/components/schemas/RelationshipToRoleData' - type: array - type: object - IncidentAttachmentPostmortemAttributes: - description: The attributes object for a postmortem attachment. - properties: - attachment: - $ref: '#/components/schemas/IncidentAttachmentsPostmortemAttributesAttachmentObject' - attachment_type: - $ref: '#/components/schemas/IncidentAttachmentPostmortemAttachmentType' - required: - - attachment_type - - attachment - type: object - IncidentAttachmentLinkAttributes: - description: The attributes object for a link attachment. - properties: - attachment: - $ref: '#/components/schemas/IncidentAttachmentLinkAttributesAttachmentObject' - attachment_type: - $ref: '#/components/schemas/IncidentAttachmentLinkAttachmentType' - modified: - description: Timestamp when the incident attachment link was last modified. - format: date-time - readOnly: true - type: string - required: - - attachment_type - - attachment - type: object - IncidentFieldAttributesSingleValueType: - default: dropdown - description: Type of the single value field definitions. - enum: - - dropdown - - textbox - example: dropdown - type: string - x-enum-varnames: - - DROPDOWN - - TEXTBOX - IncidentFieldAttributesValueType: - default: multiselect - description: Type of the multiple value field definitions. - enum: - - multiselect - - textarray - - metrictag - - autocomplete - example: multiselect - type: string - x-enum-varnames: - - MULTISELECT - - TEXTARRAY - - METRICTAG - - AUTOCOMPLETE - IncidentImpactsType: - description: The incident impacts type. - enum: - - incident_impacts - example: incident_impacts - type: string - x-enum-varnames: - - INCIDENT_IMPACTS - IncidentIntegrationMetadataType: - default: incident_integrations - description: Integration metadata resource type. - enum: - - incident_integrations - example: incident_integrations - type: string - x-enum-varnames: - - INCIDENT_INTEGRATIONS - IncidentRespondersType: - description: The incident responders type. - enum: - - incident_responders - example: incident_responders - type: string - x-enum-varnames: - - INCIDENT_RESPONDERS - IncidentUserDefinedFieldType: - description: The incident user defined fields type. - enum: - - user_defined_field - example: user_defined_field - type: string - x-enum-varnames: - - USER_DEFINED_FIELD - RelationshipToOrganizationData: - description: Relationship to organization object. - properties: - id: - description: ID of the organization. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - id - - type - type: object - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - IncidentAttachmentsPostmortemAttributesAttachmentObject: - description: The postmortem attachment. - properties: - documentUrl: - description: The URL of this notebook attachment. - example: 'https://app.datadoghq.com/notebook/123' - type: string - title: - description: The title of this postmortem attachment. - example: Postmortem IR-123 - type: string - required: - - documentUrl - - title - type: object - IncidentAttachmentPostmortemAttachmentType: - default: postmortem - description: The type of postmortem attachment attributes. - enum: - - postmortem - example: postmortem - type: string - x-enum-varnames: - - POSTMORTEM - IncidentAttachmentLinkAttributesAttachmentObject: - description: The link attachment. - properties: - documentUrl: - description: The URL of this link attachment. - example: 'https://www.example.com/webstore-failure-runbook' - type: string - title: - description: The title of this link attachment. - example: Runbook for webstore service failures - type: string - required: - - documentUrl - - title - type: object - IncidentAttachmentLinkAttachmentType: - default: link - description: The type of link attachment attributes. - enum: - - link - example: link - type: string - x-enum-varnames: - - LINK - OrganizationsType: - default: orgs - description: Organizations resource type. - enum: - - orgs - example: orgs - type: string - x-enum-varnames: - - ORGS - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - IncidentCreateRequest: - description: Create request for an incident. - properties: - data: - $ref: '#/components/schemas/IncidentCreateData' - required: - - data - type: object - IncidentResponse: - description: Response with an incident. - properties: - data: - $ref: '#/components/schemas/IncidentResponseData' - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentResponseIncludedItem' - readOnly: true - type: array - required: - - data - type: object - IncidentCreateData: - description: Incident data for a create request. - properties: - attributes: - $ref: '#/components/schemas/IncidentCreateAttributes' - relationships: - $ref: '#/components/schemas/IncidentCreateRelationships' - type: - $ref: '#/components/schemas/IncidentType' - required: - - type - - attributes - type: object - IncidentCreateAttributes: - description: The incident's attributes for a create request. - properties: - customer_impact_scope: - description: 'Required if `customer_impacted:"true"`. A summary of the impact customers experienced during the incident.' - example: Example customer impact scope - type: string - customer_impacted: - description: A flag indicating whether the incident caused customer impact. - example: false - type: boolean - fields: - additionalProperties: - $ref: '#/components/schemas/IncidentFieldAttributes' - description: A condensed view of the user-defined fields for which to create initial selections. - example: - severity: - type: dropdown - value: SEV-5 - type: object - initial_cells: - description: An array of initial timeline cells to be placed at the beginning of the incident timeline. - items: - $ref: '#/components/schemas/IncidentTimelineCellCreateAttributes' - type: array - notification_handles: - description: Notification handles that will be notified of the incident at creation. - items: - $ref: '#/components/schemas/IncidentNotificationHandle' - type: array - title: - description: 'The title of the incident, which summarizes what happened.' - example: A test incident title - type: string - required: - - title - - customer_impacted - type: object - IncidentCreateRelationships: - description: The relationships the incident will have with other resources once created. - properties: - commander_user: - $ref: '#/components/schemas/NullableRelationshipToUser' - required: - - commander_user - type: object - IncidentTimelineCellCreateAttributes: - description: The timeline cell's attributes for a create request. - oneOf: - - $ref: '#/components/schemas/IncidentTimelineCellMarkdownCreateAttributes' - IncidentTimelineCellMarkdownCreateAttributes: - description: Timeline cell data for Markdown timeline cells for a create request. - properties: - cell_type: - $ref: '#/components/schemas/IncidentTimelineCellMarkdownContentType' - content: - $ref: '#/components/schemas/IncidentTimelineCellMarkdownCreateAttributesContent' - important: - default: false - description: A flag indicating whether the timeline cell is important and should be highlighted. - example: false - type: boolean - required: - - content - - cell_type - type: object - IncidentTimelineCellMarkdownContentType: - default: markdown - description: Type of the Markdown timeline cell. - enum: - - markdown - example: markdown - type: string - x-enum-varnames: - - MARKDOWN - IncidentTimelineCellMarkdownCreateAttributesContent: - description: The Markdown timeline cell contents. - properties: - content: - description: The Markdown content of the cell. - example: An example timeline cell message. - nullable: false - type: string - type: object - IncidentSearchResponse: - description: Response with incidents and facets. - properties: - data: - $ref: '#/components/schemas/IncidentSearchResponseData' - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentResponseIncludedItem' - readOnly: true - type: array - meta: - $ref: '#/components/schemas/IncidentSearchResponseMeta' - required: - - data - type: object - IncidentSearchResponseData: - description: Data returned by an incident search. - properties: - attributes: - $ref: '#/components/schemas/IncidentSearchResponseAttributes' - type: - $ref: '#/components/schemas/IncidentSearchResultsType' - type: object - IncidentSearchResponseMeta: - description: The metadata object containing pagination metadata. - properties: - pagination: - $ref: '#/components/schemas/IncidentResponseMetaPagination' - readOnly: true - type: object - IncidentSearchResponseAttributes: - description: Attributes returned by an incident search. - properties: - facets: - $ref: '#/components/schemas/IncidentSearchResponseFacetsData' - incidents: - description: Incidents returned by the search. - items: - $ref: '#/components/schemas/IncidentSearchResponseIncidentsData' - type: array - total: - description: Number of incidents returned by the search. - example: 10 - format: int32 - maximum: 2147483647 - type: integer - required: - - facets - - incidents - - total - type: object - IncidentSearchResultsType: - default: incidents_search_results - description: Incident search result type. - enum: - - incidents_search_results - example: incidents_search_results - type: string - x-enum-varnames: - - INCIDENTS_SEARCH_RESULTS - IncidentSearchResponseFacetsData: - description: Facet data for incidents returned by a search query. - properties: - commander: - description: Facet data for incident commander users. - items: - $ref: '#/components/schemas/IncidentSearchResponseUserFacetData' - type: array - created_by: - description: Facet data for incident creator users. - items: - $ref: '#/components/schemas/IncidentSearchResponseUserFacetData' - type: array - fields: - description: Facet data for incident property fields. - items: - $ref: '#/components/schemas/IncidentSearchResponsePropertyFieldFacetData' - type: array - impact: - description: Facet data for incident impact attributes. - items: - $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' - type: array - last_modified_by: - description: Facet data for incident last modified by users. - items: - $ref: '#/components/schemas/IncidentSearchResponseUserFacetData' - type: array - postmortem: - description: Facet data for incident postmortem existence. - items: - $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' - type: array - responder: - description: Facet data for incident responder users. - items: - $ref: '#/components/schemas/IncidentSearchResponseUserFacetData' - type: array - severity: - description: Facet data for incident severity attributes. - items: - $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' - type: array - state: - description: Facet data for incident state attributes. - items: - $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' - type: array - time_to_repair: - description: Facet data for incident time to repair metrics. - items: - $ref: '#/components/schemas/IncidentSearchResponseNumericFacetData' - type: array - time_to_resolve: - description: Facet data for incident time to resolve metrics. - items: - $ref: '#/components/schemas/IncidentSearchResponseNumericFacetData' - type: array - type: object - IncidentSearchResponseIncidentsData: - description: Incident returned by the search. - properties: - data: - $ref: '#/components/schemas/IncidentResponseData' - required: - - data - type: object - IncidentSearchResponseUserFacetData: - description: Facet data for user attributes of an incident. - properties: - count: - $ref: '#/components/schemas/IncidentSearchResponseFacetCount' - email: - description: Email of the user. - example: datadog.user@example.com - type: string - handle: - description: Handle of the user. - example: '@datadog.user@example.com' - type: string - name: - description: Name of the user. - example: Datadog User - type: string - uuid: - description: ID of the user. - example: 773b045d-ccf8-4808-bd3b-955ef6a8c940 - type: string - type: object - IncidentSearchResponsePropertyFieldFacetData: - description: Facet data for the incident property fields. - properties: - aggregates: - $ref: '#/components/schemas/IncidentSearchResponseNumericFacetDataAggregates' - facets: - description: Facet data for the property field of an incident. - items: - $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' - type: array - name: - description: Name of the incident property field. - example: Severity - type: string - required: - - facets - - name - type: object - IncidentSearchResponseFieldFacetData: - description: Facet value and number of occurrences for a property field of an incident. - properties: - count: - $ref: '#/components/schemas/IncidentSearchResponseFacetCount' - name: - description: The facet value appearing in search results. - example: SEV-2 - type: string - type: object - IncidentSearchResponseNumericFacetData: - description: Facet data numeric attributes of an incident. - properties: - aggregates: - $ref: '#/components/schemas/IncidentSearchResponseNumericFacetDataAggregates' - name: - description: Name of the incident property field. - example: time_to_repair - type: string - required: - - name - - aggregates - type: object - IncidentSearchResponseFacetCount: - description: Count of the facet value appearing in search results. - example: 5 - format: int32 - maximum: 2147483647 - type: integer - IncidentSearchResponseNumericFacetDataAggregates: - description: Aggregate information for numeric incident data. - properties: - max: - description: Maximum value of the numeric aggregates. - example: 1234 - format: double - nullable: true - type: number - min: - description: Minimum value of the numeric aggregates. - example: 20 - format: double - nullable: true - type: number - type: object - IncidentUpdateRequest: - description: Update request for an incident. - properties: - data: - $ref: '#/components/schemas/IncidentUpdateData' - required: - - data - type: object - IncidentUpdateData: - description: Incident data for an update request. - properties: - attributes: - $ref: '#/components/schemas/IncidentUpdateAttributes' - id: - description: The incident's ID. - example: 00000000-0000-0000-4567-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentUpdateRelationships' - type: - $ref: '#/components/schemas/IncidentType' - required: - - id - - type - type: object - IncidentUpdateAttributes: - description: The incident's attributes for an update request. - properties: - customer_impact_end: - description: Timestamp when customers were no longer impacted by the incident. - format: date-time - nullable: true - type: string - customer_impact_scope: - description: A summary of the impact customers experienced during the incident. - example: Example customer impact scope - type: string - customer_impact_start: - description: Timestamp when customers began being impacted by the incident. - format: date-time - nullable: true - type: string - customer_impacted: - description: A flag indicating whether the incident caused customer impact. - example: false - type: boolean - detected: - description: Timestamp when the incident was detected. - format: date-time - nullable: true - type: string - fields: - additionalProperties: - $ref: '#/components/schemas/IncidentFieldAttributes' - description: A condensed view of the user-defined fields for which to update selections. - example: - severity: - type: dropdown - value: SEV-5 - type: object - notification_handles: - description: Notification handles that will be notified of the incident during update. - items: - $ref: '#/components/schemas/IncidentNotificationHandle' - type: array - title: - description: 'The title of the incident, which summarizes what happened.' - example: A test incident title - type: string - type: object - IncidentUpdateRelationships: - description: The incident's relationships for an update request. - properties: - commander_user: - $ref: '#/components/schemas/NullableRelationshipToUser' - integrations: - $ref: '#/components/schemas/RelationshipToIncidentIntegrationMetadatas' - postmortem: - $ref: '#/components/schemas/RelationshipToIncidentPostmortem' - type: object - RelationshipToIncidentPostmortem: - description: A relationship reference for postmortems. - example: - data: - id: 00000000-0000-abcd-3000-000000000000 - type: incident_postmortems - properties: - data: - $ref: '#/components/schemas/RelationshipToIncidentPostmortemData' - required: - - data - type: object - RelationshipToIncidentPostmortemData: - description: The postmortem relationship data. - example: - id: 00000000-0000-abcd-2000-000000000000 - type: incident_postmortems - properties: - id: - description: A unique identifier that represents the postmortem. - example: 00000000-0000-abcd-1000-000000000000 - type: string - type: - $ref: '#/components/schemas/IncidentPostmortemType' - required: - - id - - type - type: object - IncidentPostmortemType: - default: incident_postmortems - description: Incident postmortem resource type. - enum: - - incident_postmortems - example: incident_postmortems - type: string - x-enum-varnames: - - INCIDENT_POSTMORTEMS - IncidentAttachmentsResponse: - description: The response object containing an incident's attachments. - properties: - data: - description: An array of incident attachments. - items: - $ref: '#/components/schemas/IncidentAttachmentData' - type: array - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentAttachmentsResponseIncludedItem' - type: array - required: - - data - type: object - IncidentAttachmentsResponseIncludedItem: - description: An object related to an attachment that is included in the response. - oneOf: - - $ref: '#/components/schemas/User' - IncidentAttachmentUpdateRequest: - description: The update request for an incident's attachments. - properties: - data: - description: |- - An array of incident attachments. An attachment object without an "id" key indicates that you want to - create that attachment. An attachment object without an "attributes" key indicates that you want to - delete that attachment. An attachment object with both the "id" key and a populated "attributes" object - indicates that you want to update that attachment. - example: - - attributes: - attachment: - documentUrl: 'https://app.datadoghq.com/notebook/123' - title: Postmortem IR-123 - attachment_type: postmortem - id: 00000000-abcd-0002-0000-000000000000 - type: incident_attachments - - attributes: - attachment: - documentUrl: 'https://www.example.com/webstore-failure-runbook' - title: Runbook for webstore service failures - attachment_type: link - type: incident_attachments - - id: 00000000-abcd-0003-0000-000000000000 - type: incident_attachments - items: - $ref: '#/components/schemas/IncidentAttachmentUpdateData' - type: array - required: - - data - type: object - IncidentAttachmentUpdateResponse: - description: The response object containing the created or updated incident attachments. - properties: - data: - description: |- - An array of incident attachments. Only the attachments that were created or updated by the request are - returned. - items: - $ref: '#/components/schemas/IncidentAttachmentData' - type: array - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentAttachmentsResponseIncludedItem' - type: array - required: - - data - type: object - IncidentAttachmentUpdateData: - description: A single incident attachment. - properties: - attributes: - $ref: '#/components/schemas/IncidentAttachmentUpdateAttributes' - id: - description: A unique identifier that represents the incident attachment. - example: 00000000-abcd-0001-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/IncidentAttachmentType' - required: - - type - type: object - IncidentAttachmentUpdateAttributes: - description: Incident attachment attributes. - oneOf: - - $ref: '#/components/schemas/IncidentAttachmentPostmortemAttributes' - - $ref: '#/components/schemas/IncidentAttachmentLinkAttributes' - IncidentIntegrationMetadataListResponse: - description: Response with a list of incident integration metadata. - properties: - data: - description: An array of incident integration metadata. - items: - $ref: '#/components/schemas/IncidentIntegrationMetadataResponseData' - type: array - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentIntegrationMetadataResponseIncludedItem' - readOnly: true - type: array - meta: - $ref: '#/components/schemas/IncidentResponseMeta' - required: - - data - type: object - IncidentIntegrationMetadataResponseData: - description: Incident integration metadata from a response. - properties: - attributes: - $ref: '#/components/schemas/IncidentIntegrationMetadataAttributes' - id: - description: The incident integration metadata's ID. - example: 00000000-0000-0000-1234-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentIntegrationRelationships' - type: - $ref: '#/components/schemas/IncidentIntegrationMetadataType' - required: - - id - - type - type: object - IncidentIntegrationMetadataResponseIncludedItem: - description: An object related to an incident integration metadata that is included in the response. - oneOf: - - $ref: '#/components/schemas/User' - IncidentIntegrationMetadataAttributes: - description: Incident integration metadata's attributes for a create request. - properties: - created: - description: Timestamp when the incident todo was created. - format: date-time - readOnly: true - type: string - incident_id: - description: UUID of the incident this integration metadata is connected to. - example: 00000000-aaaa-0000-0000-000000000000 - type: string - integration_type: - description: |- - A number indicating the type of integration this metadata is for. 1 indicates Slack; - 8 indicates Jira. - example: 1 - format: int32 - maximum: 9 - type: integer - metadata: - $ref: '#/components/schemas/IncidentIntegrationMetadataMetadata' - modified: - description: Timestamp when the incident todo was last modified. - format: date-time - readOnly: true - type: string - status: - description: |- - A number indicating the status of this integration metadata. 0 indicates unknown; - 1 indicates pending; 2 indicates complete; 3 indicates manually created; - 4 indicates manually updated; 5 indicates failed. - format: int32 - maximum: 5 - type: integer - required: - - integration_type - - metadata - type: object - IncidentIntegrationRelationships: - description: The incident's integration relationships from a response. - properties: - created_by_user: - $ref: '#/components/schemas/RelationshipToUser' - last_modified_by_user: - $ref: '#/components/schemas/RelationshipToUser' - type: object - IncidentIntegrationMetadataMetadata: - description: Incident integration metadata's metadata attribute. - oneOf: - - $ref: '#/components/schemas/SlackIntegrationMetadata' - - $ref: '#/components/schemas/JiraIntegrationMetadata' - SlackIntegrationMetadata: - description: Incident integration metadata for the Slack integration. - properties: - channels: - description: Array of Slack channels in this integration metadata. - example: [] - items: - $ref: '#/components/schemas/SlackIntegrationMetadataChannelItem' - type: array - required: - - channels - type: object - JiraIntegrationMetadata: - description: Incident integration metadata for the Jira integration. - properties: - issues: - description: Array of Jira issues in this integration metadata. - example: [] - items: - $ref: '#/components/schemas/JiraIntegrationMetadataIssuesItem' - type: array - required: - - issues - type: object - SlackIntegrationMetadataChannelItem: - description: Item in the Slack integration metadata channel array. - properties: - channel_id: - description: Slack channel ID. - example: C0123456789 - type: string - channel_name: - description: Name of the Slack channel. - example: '#example-channel-name' - type: string - redirect_url: - description: URL redirecting to the Slack channel. - example: 'https://slack.com/app_redirect?channel=C0123456789&team=T01234567' - type: string - team_id: - description: Slack team ID. - example: T01234567 - type: string - required: - - channel_id - - channel_name - - redirect_url - type: object - JiraIntegrationMetadataIssuesItem: - description: Item in the Jira integration metadata issue array. - properties: - account: - description: URL of issue's Jira account. - example: 'https://example.atlassian.net' - type: string - issue_key: - description: Jira issue's issue key. - example: PROJ-123 - type: string - issuetype_id: - description: Jira issue's issue type. - example: '1000' - type: string - project_key: - description: Jira issue's project keys. - example: PROJ - type: string - redirect_url: - description: URL redirecting to the Jira issue. - example: 'https://example.atlassian.net/browse/PROJ-123' - type: string - required: - - project_key - - account - type: object - IncidentIntegrationMetadataCreateRequest: - description: Create request for an incident integration metadata. - properties: - data: - $ref: '#/components/schemas/IncidentIntegrationMetadataCreateData' - required: - - data - type: object - IncidentIntegrationMetadataResponse: - description: Response with an incident integration metadata. - properties: - data: - $ref: '#/components/schemas/IncidentIntegrationMetadataResponseData' - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentIntegrationMetadataResponseIncludedItem' - readOnly: true - type: array - required: - - data - type: object - IncidentIntegrationMetadataCreateData: - description: Incident integration metadata data for a create request. - properties: - attributes: - $ref: '#/components/schemas/IncidentIntegrationMetadataAttributes' - type: - $ref: '#/components/schemas/IncidentIntegrationMetadataType' - required: - - type - - attributes - type: object - IncidentIntegrationMetadataPatchRequest: - description: Patch request for an incident integration metadata. - properties: - data: - $ref: '#/components/schemas/IncidentIntegrationMetadataPatchData' - required: - - data - type: object - IncidentIntegrationMetadataPatchData: - description: Incident integration metadata data for a patch request. - properties: - attributes: - $ref: '#/components/schemas/IncidentIntegrationMetadataAttributes' - type: - $ref: '#/components/schemas/IncidentIntegrationMetadataType' - required: - - type - - attributes - type: object - IncidentTodoListResponse: - description: Response with a list of incident todos. - properties: - data: - description: An array of incident todos. - items: - $ref: '#/components/schemas/IncidentTodoResponseData' - type: array - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentTodoResponseIncludedItem' - readOnly: true - type: array - meta: - $ref: '#/components/schemas/IncidentResponseMeta' - required: - - data - type: object - IncidentTodoResponseData: - description: Incident todo response data. - properties: - attributes: - $ref: '#/components/schemas/IncidentTodoAttributes' - id: - description: The incident todo's ID. - example: 00000000-0000-0000-1234-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentTodoRelationships' - type: - $ref: '#/components/schemas/IncidentTodoType' - required: - - id - - type - type: object - IncidentTodoResponseIncludedItem: - description: An object related to an incident todo that is included in the response. - oneOf: - - $ref: '#/components/schemas/User' - IncidentTodoAttributes: - description: Incident todo's attributes. - properties: - assignees: - $ref: '#/components/schemas/IncidentTodoAssigneeArray' - completed: - description: Timestamp when the todo was completed. - example: '2023-03-06T22:00:00.000000+00:00' - nullable: true - type: string - content: - description: The follow-up task's content. - example: Restore lost data. - type: string - created: - description: Timestamp when the incident todo was created. - format: date-time - readOnly: true - type: string - due_date: - description: Timestamp when the todo should be completed by. - example: '2023-07-10T05:00:00.000000+00:00' - nullable: true - type: string - incident_id: - description: UUID of the incident this todo is connected to. - example: 00000000-aaaa-0000-0000-000000000000 - type: string - modified: - description: Timestamp when the incident todo was last modified. - format: date-time - readOnly: true - type: string - required: - - content - - assignees - type: object - IncidentTodoRelationships: - description: The incident's relationships from a response. - properties: - created_by_user: - $ref: '#/components/schemas/RelationshipToUser' - last_modified_by_user: - $ref: '#/components/schemas/RelationshipToUser' - type: object - IncidentTodoType: - default: incident_todos - description: Todo resource type. - enum: - - incident_todos - example: incident_todos - type: string - x-enum-varnames: - - INCIDENT_TODOS - IncidentTodoAssigneeArray: - description: Array of todo assignees. - items: - $ref: '#/components/schemas/IncidentTodoAssignee' - type: array - IncidentTodoAssignee: - description: A todo assignee. - example: '@test.user@test.com' - oneOf: - - $ref: '#/components/schemas/IncidentTodoAssigneeHandle' - - $ref: '#/components/schemas/IncidentTodoAnonymousAssignee' - IncidentTodoAssigneeHandle: - description: Assignee's @-handle. - example: '@test.user@test.com' - type: string - IncidentTodoAnonymousAssignee: - description: Anonymous assignee entity. - properties: - icon: - description: URL for assignee's icon. - example: 'https://a.slack-edge.com/80588/img/slackbot_48.png' - type: string - id: - description: Anonymous assignee's ID. - example: USLACKBOT - type: string - name: - description: Assignee's name. - example: Slackbot - type: string - source: - $ref: '#/components/schemas/IncidentTodoAnonymousAssigneeSource' - required: - - id - - icon - - name - - source - type: object - IncidentTodoAnonymousAssigneeSource: - default: slack - description: The source of the anonymous assignee. - enum: - - slack - - microsoft_teams - example: slack - type: string - x-enum-varnames: - - SLACK - - MICROSOFT_TEAMS - IncidentTodoCreateRequest: - description: Create request for an incident todo. - properties: - data: - $ref: '#/components/schemas/IncidentTodoCreateData' - required: - - data - type: object - IncidentTodoResponse: - description: Response with an incident todo. - properties: - data: - $ref: '#/components/schemas/IncidentTodoResponseData' - included: - description: Included related resources that the user requested. - items: - $ref: '#/components/schemas/IncidentTodoResponseIncludedItem' - readOnly: true - type: array - required: - - data - type: object - IncidentTodoCreateData: - description: Incident todo data for a create request. - properties: - attributes: - $ref: '#/components/schemas/IncidentTodoAttributes' - type: - $ref: '#/components/schemas/IncidentTodoType' - required: - - type - - attributes - type: object - IncidentTodoPatchRequest: - description: Patch request for an incident todo. - properties: - data: - $ref: '#/components/schemas/IncidentTodoPatchData' - required: - - data - type: object - IncidentTodoPatchData: - description: Incident todo data for a patch request. - properties: - attributes: - $ref: '#/components/schemas/IncidentTodoAttributes' - type: - $ref: '#/components/schemas/IncidentTodoType' - required: - - type - - attributes - type: object - IncidentServicesResponse: - description: Response with a list of incident service payloads. - properties: - data: - description: An array of incident services. - example: - - id: 00000000-0000-0000-0000-000000000000 - type: services - items: - $ref: '#/components/schemas/IncidentServiceResponseData' - type: array - included: - description: Included related resources which the user requested. - items: - $ref: '#/components/schemas/IncidentServiceIncludedItems' - readOnly: true - type: array - meta: - $ref: '#/components/schemas/IncidentResponseMeta' - required: - - data - type: object - IncidentServiceResponseData: - description: Incident Service data from responses. - properties: - attributes: - $ref: '#/components/schemas/IncidentServiceResponseAttributes' - id: - description: The incident service's ID. - example: 00000000-0000-0000-0000-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentServiceRelationships' - type: - $ref: '#/components/schemas/IncidentServiceType' - required: - - id - - type - type: object - IncidentServiceIncludedItems: - description: An object related to an incident service which is present in the included payload. - oneOf: - - $ref: '#/components/schemas/User' - IncidentServiceResponseAttributes: - description: The incident service's attributes from a response. - properties: - created: - description: Timestamp of when the incident service was created. - format: date-time - readOnly: true - type: string - modified: - description: Timestamp of when the incident service was modified. - format: date-time - readOnly: true - type: string - name: - description: Name of the incident service. - example: service name - type: string - type: object - IncidentServiceRelationships: - description: The incident service's relationships. - properties: - created_by: - $ref: '#/components/schemas/RelationshipToUser' - last_modified_by: - $ref: '#/components/schemas/RelationshipToUser' - readOnly: true - type: object - IncidentServiceType: - default: services - description: Incident service resource type. - enum: - - services - example: services - type: string - x-enum-varnames: - - SERVICES - IncidentServiceCreateRequest: - description: Create request with an incident service payload. - properties: - data: - $ref: '#/components/schemas/IncidentServiceCreateData' - required: - - data - type: object - IncidentServiceResponse: - description: Response with an incident service payload. - properties: - data: - $ref: '#/components/schemas/IncidentServiceResponseData' - included: - description: Included objects from relationships. - items: - $ref: '#/components/schemas/IncidentServiceIncludedItems' - readOnly: true - type: array - required: - - data - type: object - IncidentServiceCreateData: - description: Incident Service payload for create requests. - properties: - attributes: - $ref: '#/components/schemas/IncidentServiceCreateAttributes' - relationships: - $ref: '#/components/schemas/IncidentServiceRelationships' - type: - $ref: '#/components/schemas/IncidentServiceType' - required: - - type - type: object - IncidentServiceCreateAttributes: - description: The incident service's attributes for a create request. - properties: - name: - description: Name of the incident service. - example: an example service name - type: string - required: - - name - type: object - IncidentServiceUpdateRequest: - description: Update request with an incident service payload. - properties: - data: - $ref: '#/components/schemas/IncidentServiceUpdateData' - required: - - data - type: object - IncidentServiceUpdateData: - description: Incident Service payload for update requests. - properties: - attributes: - $ref: '#/components/schemas/IncidentServiceUpdateAttributes' - id: - description: The incident service's ID. - example: 00000000-0000-0000-0000-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentServiceRelationships' - type: - $ref: '#/components/schemas/IncidentServiceType' - required: - - type - type: object - IncidentServiceUpdateAttributes: - description: The incident service's attributes for an update request. - properties: - name: - description: Name of the incident service. - example: an example service name - type: string - required: - - name - type: object - IncidentTeamsResponse: - description: Response with a list of incident team payloads. - properties: - data: - description: An array of incident teams. - example: - - attributes: - name: team name - id: 00000000-7ea3-0000-0000-000000000000 - type: teams - items: - $ref: '#/components/schemas/IncidentTeamResponseData' - type: array - included: - description: Included related resources which the user requested. - items: - $ref: '#/components/schemas/IncidentTeamIncludedItems' - readOnly: true - type: array - meta: - $ref: '#/components/schemas/IncidentResponseMeta' - required: - - data - type: object - IncidentTeamResponseData: - description: Incident Team data from a response. - properties: - attributes: - $ref: '#/components/schemas/IncidentTeamResponseAttributes' - id: - description: The incident team's ID. - example: 00000000-7ea3-0000-000a-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentTeamRelationships' - type: - $ref: '#/components/schemas/IncidentTeamType' - type: object - IncidentTeamIncludedItems: - description: An object related to an incident team which is present in the included payload. - oneOf: - - $ref: '#/components/schemas/User' - IncidentTeamResponseAttributes: - description: The incident team's attributes from a response. - properties: - created: - description: Timestamp of when the incident team was created. - format: date-time - readOnly: true - type: string - modified: - description: Timestamp of when the incident team was modified. - format: date-time - readOnly: true - type: string - name: - description: Name of the incident team. - example: team name - type: string - type: object - IncidentTeamRelationships: - description: The incident team's relationships. - properties: - created_by: - $ref: '#/components/schemas/RelationshipToUser' - last_modified_by: - $ref: '#/components/schemas/RelationshipToUser' - readOnly: true - type: object - IncidentTeamType: - default: teams - description: Incident Team resource type. - enum: - - teams - example: teams - type: string - x-enum-varnames: - - TEAMS - IncidentTeamCreateRequest: - description: Create request with an incident team payload. - properties: - data: - $ref: '#/components/schemas/IncidentTeamCreateData' - required: - - data - type: object - IncidentTeamResponse: - description: Response with an incident team payload. - properties: - data: - $ref: '#/components/schemas/IncidentTeamResponseData' - included: - description: Included objects from relationships. - items: - $ref: '#/components/schemas/IncidentTeamIncludedItems' - readOnly: true - type: array - required: - - data - type: object - IncidentTeamCreateData: - description: Incident Team data for a create request. - properties: - attributes: - $ref: '#/components/schemas/IncidentTeamCreateAttributes' - relationships: - $ref: '#/components/schemas/IncidentTeamRelationships' - type: - $ref: '#/components/schemas/IncidentTeamType' - required: - - type - type: object - IncidentTeamCreateAttributes: - description: The incident team's attributes for a create request. - properties: - name: - description: Name of the incident team. - example: team name - type: string - required: - - name - type: object - IncidentTeamUpdateRequest: - description: Update request with an incident team payload. - properties: - data: - $ref: '#/components/schemas/IncidentTeamUpdateData' - required: - - data - type: object - IncidentTeamUpdateData: - description: Incident Team data for an update request. - properties: - attributes: - $ref: '#/components/schemas/IncidentTeamUpdateAttributes' - id: - description: The incident team's ID. - example: 00000000-7ea3-0000-0001-000000000000 - type: string - relationships: - $ref: '#/components/schemas/IncidentTeamRelationships' - type: - $ref: '#/components/schemas/IncidentTeamType' - required: - - type - type: object - IncidentTeamUpdateAttributes: - description: The incident team's attributes for an update request. - properties: - name: - description: Name of the incident team. - example: team name - type: string - required: - - name - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - UnauthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unauthorized - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - incidents: - id: datadog.incidents.incidents - name: incidents - title: Incidents - methods: - list_incidents: - operation: - $ref: '#/paths/~1api~1v2~1incidents/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_incidents: - operation: - $ref: '#/paths/~1api~1v2~1incidents/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_incident: - operation: - $ref: '#/paths/~1api~1v2~1incidents/post' - response: - mediaType: application/json - openAPIDocKey: '201' - search_incidents: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1search/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _search_incidents: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1search/get' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_incident: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_incident: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_incident: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_incident: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/incidents/methods/get_incident' - - $ref: '#/components/x-stackQL-resources/incidents/methods/list_incidents' - - $ref: '#/components/x-stackQL-resources/incidents/methods/search_incidents' - insert: - - $ref: '#/components/x-stackQL-resources/incidents/methods/create_incident' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/incidents/methods/delete_incident' - incident_attachments: - id: datadog.incidents.incident_attachments - name: incident_attachments - title: Incident Attachments - methods: - list_incident_attachments: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1attachments/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_incident_attachments: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1attachments/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_incident_attachments: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1attachments/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/incident_attachments/methods/list_incident_attachments' - insert: [] - update: [] - delete: [] - incident_integrations: - id: datadog.incidents.incident_integrations - name: incident_integrations - title: Incident Integrations - methods: - list_incident_integrations: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_incident_integrations: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_incident_integration: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_incident_integration: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations~1{integration_metadata_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_incident_integration: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations~1{integration_metadata_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_incident_integration: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations~1{integration_metadata_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_incident_integration: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations~1{integration_metadata_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/incident_integrations/methods/get_incident_integration' - - $ref: '#/components/x-stackQL-resources/incident_integrations/methods/list_incident_integrations' - insert: - - $ref: '#/components/x-stackQL-resources/incident_integrations/methods/create_incident_integration' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/incident_integrations/methods/delete_incident_integration' - incident_todos: - id: datadog.incidents.incident_todos - name: incident_todos - title: Incident Todos - methods: - list_incident_todos: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_incident_todos: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_incident_todo: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_incident_todo: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos~1{todo_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_incident_todo: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos~1{todo_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_incident_todo: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos~1{todo_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_incident_todo: - operation: - $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos~1{todo_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/incident_todos/methods/get_incident_todo' - - $ref: '#/components/x-stackQL-resources/incident_todos/methods/list_incident_todos' - insert: - - $ref: '#/components/x-stackQL-resources/incident_todos/methods/create_incident_todo' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/incident_todos/methods/delete_incident_todo' - incident_services: - id: datadog.incidents.incident_services - name: incident_services - title: Incident Services - methods: - list_incident_services: - operation: - $ref: '#/paths/~1api~1v2~1services/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_incident_services: - operation: - $ref: '#/paths/~1api~1v2~1services/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_incident_service: - operation: - $ref: '#/paths/~1api~1v2~1services/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_incident_service: - operation: - $ref: '#/paths/~1api~1v2~1services~1{service_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_incident_service: - operation: - $ref: '#/paths/~1api~1v2~1services~1{service_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_incident_service: - operation: - $ref: '#/paths/~1api~1v2~1services~1{service_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_incident_service: - operation: - $ref: '#/paths/~1api~1v2~1services~1{service_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/incident_services/methods/get_incident_service' - - $ref: '#/components/x-stackQL-resources/incident_services/methods/list_incident_services' - insert: - - $ref: '#/components/x-stackQL-resources/incident_services/methods/create_incident_service' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/incident_services/methods/delete_incident_service' - incident_teams: - id: datadog.incidents.incident_teams - name: incident_teams - title: Incident Teams - methods: - list_incident_teams: - operation: - $ref: '#/paths/~1api~1v2~1teams/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_incident_teams: - operation: - $ref: '#/paths/~1api~1v2~1teams/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_incident_team: - operation: - $ref: '#/paths/~1api~1v2~1teams/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_incident_team: - operation: - $ref: '#/paths/~1api~1v2~1teams~1{team_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_incident_team: - operation: - $ref: '#/paths/~1api~1v2~1teams~1{team_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_incident_team: - operation: - $ref: '#/paths/~1api~1v2~1teams~1{team_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_incident_team: - operation: - $ref: '#/paths/~1api~1v2~1teams~1{team_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/incident_teams/methods/get_incident_team' - - $ref: '#/components/x-stackQL-resources/incident_teams/methods/list_incident_teams' - insert: - - $ref: '#/components/x-stackQL-resources/incident_teams/methods/create_incident_team' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/incident_teams/methods/delete_incident_team' -paths: - /api/v2/incidents: - get: - description: Get all incidents for the user's organization. - operationId: ListIncidents - parameters: - - $ref: '#/components/parameters/IncidentIncludeQueryParameter' - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageOffset' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get a list of incidents - tags: - - Incidents - x-pagination: - limitParam: 'page[size]' - pageOffsetParam: 'page[offset]' - resultsPath: data - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - post: - description: Create an incident. - operationId: CreateIncident - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentCreateRequest' - description: Incident payload. - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Create an incident - tags: - - Incidents - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/incidents/search: - get: - description: Search for incidents matching a certain query. - operationId: SearchIncidents - parameters: - - $ref: '#/components/parameters/IncidentSearchIncludeQueryParameter' - - $ref: '#/components/parameters/IncidentSearchQueryQueryParameter' - - $ref: '#/components/parameters/IncidentSearchSortQueryParameter' - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageOffset' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentSearchResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Search for incidents - tags: - - Incidents - x-pagination: - limitParam: 'page[size]' - pageOffsetParam: 'page[offset]' - resultsPath: data.attributes.incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/incidents/{incident_id}': - delete: - description: Deletes an existing incident from the users organization. - operationId: DeleteIncident - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Delete an existing incident - tags: - - Incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - get: - description: Get the details of an incident by `incident_id`. - operationId: GetIncident - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentIncludeQueryParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get the details of an incident - tags: - - Incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - patch: - description: Updates an incident. Provide only the attributes that should be updated as this request is a partial update. - operationId: UpdateIncident - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentIncludeQueryParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentUpdateRequest' - description: Incident Payload. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Update an existing incident - tags: - - Incidents - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/incidents/{incident_id}/attachments': - get: - description: Get all attachments for a given incident. - operationId: ListIncidentAttachments - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentAttachmentIncludeQueryParameter' - - $ref: '#/components/parameters/IncidentAttachmentFilterQueryParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentAttachmentsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get a list of attachments - tags: - - Incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - patch: - description: 'The bulk update endpoint for creating, updating, and deleting attachments for a given incident.' - operationId: UpdateIncidentAttachments - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentAttachmentIncludeQueryParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentAttachmentUpdateRequest' - description: Incident Attachment Payload. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentAttachmentUpdateResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: 'Create, update, and delete incident attachments' - tags: - - Incidents - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/incidents/{incident_id}/relationships/integrations': - get: - description: Get all integration metadata for an incident. - operationId: ListIncidentIntegrations - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentIntegrationMetadataListResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get a list of an incident's integration metadata - tags: - - Incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - post: - description: Create an incident integration metadata. - operationId: CreateIncidentIntegration - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentIntegrationMetadataCreateRequest' - description: Incident integration metadata payload. - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentIntegrationMetadataResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Create an incident integration metadata - tags: - - Incidents - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/incidents/{incident_id}/relationships/integrations/{integration_metadata_id}': - delete: - description: Delete an incident integration metadata. - operationId: DeleteIncidentIntegration - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentIntegrationMetadataIDPathParameter' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Delete an incident integration metadata - tags: - - Incidents - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - get: - description: Get incident integration metadata details. - operationId: GetIncidentIntegration - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentIntegrationMetadataIDPathParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentIntegrationMetadataResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get incident integration metadata details - tags: - - Incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - patch: - description: Update an existing incident integration metadata. - operationId: UpdateIncidentIntegration - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentIntegrationMetadataIDPathParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentIntegrationMetadataPatchRequest' - description: Incident integration metadata payload. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentIntegrationMetadataResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Update an existing incident integration metadata - tags: - - Incidents - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/incidents/{incident_id}/relationships/todos': - get: - description: Get all todos for an incident. - operationId: ListIncidentTodos - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTodoListResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get a list of an incident's todos - tags: - - Incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - post: - description: Create an incident todo. - operationId: CreateIncidentTodo - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTodoCreateRequest' - description: Incident todo payload. - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTodoResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Create an incident todo - tags: - - Incidents - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/incidents/{incident_id}/relationships/todos/{todo_id}': - delete: - description: Delete an incident todo. - operationId: DeleteIncidentTodo - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentTodoIDPathParameter' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Delete an incident todo - tags: - - Incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - get: - description: Get incident todo details. - operationId: GetIncidentTodo - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentTodoIDPathParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTodoResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get incident todo details - tags: - - Incidents - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - patch: - description: Update an incident todo. - operationId: UpdateIncidentTodo - parameters: - - $ref: '#/components/parameters/IncidentIDPathParameter' - - $ref: '#/components/parameters/IncidentTodoIDPathParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTodoPatchRequest' - description: Incident todo payload. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTodoResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_write - summary: Update an incident todo - tags: - - Incidents - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/services: - get: - description: 'Get all incident services uploaded for the requesting user''s organization. If the `include[users]` query parameter is provided, the included attribute will contain the users related to these incident services.' - operationId: ListIncidentServices - parameters: - - $ref: '#/components/parameters/IncidentServiceIncludeQueryParameter' - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageOffset' - - $ref: '#/components/parameters/IncidentServiceSearchQueryParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentServicesResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get a list of all incident services - tags: - - Incident Services - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - post: - description: Creates a new incident service. - operationId: CreateIncidentService - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentServiceCreateRequest' - description: Incident Service Payload. - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentServiceResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_settings_write - summary: Create a new incident service - tags: - - Incident Services - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/services/{service_id}': - delete: - description: Deletes an existing incident service. - operationId: DeleteIncidentService - parameters: - - $ref: '#/components/parameters/IncidentServiceIDPathParameter' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_settings_write - summary: Delete an existing incident service - tags: - - Incident Services - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - get: - description: |- - Get details of an incident service. If the `include[users]` query parameter is provided, - the included attribute will contain the users related to these incident services. - operationId: GetIncidentService - parameters: - - $ref: '#/components/parameters/IncidentServiceIDPathParameter' - - $ref: '#/components/parameters/IncidentServiceIncludeQueryParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentServiceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get details of an incident service - tags: - - Incident Services - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - patch: - description: Updates an existing incident service. Only provide the attributes which should be updated as this request is a partial update. - operationId: UpdateIncidentService - parameters: - - $ref: '#/components/parameters/IncidentServiceIDPathParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentServiceUpdateRequest' - description: Incident Service Payload. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentServiceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_settings_write - summary: Update an existing incident service - tags: - - Incident Services - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/teams: - get: - deprecated: true - description: 'Get all incident teams for the requesting user''s organization. If the `include[users]` query parameter is provided, the included attribute will contain the users related to these incident teams.' - operationId: ListIncidentTeams - parameters: - - $ref: '#/components/parameters/IncidentTeamIncludeQueryParameter' - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageOffset' - - $ref: '#/components/parameters/IncidentTeamSearchQueryParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTeamsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get a list of all incident teams - tags: - - Incident Teams - x-unstable: '**Note**: This endpoint is deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).' - post: - deprecated: true - description: Creates a new incident team. - operationId: CreateIncidentTeam - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTeamCreateRequest' - description: Incident Team Payload. - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTeamResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_settings_write - summary: Create a new incident team - tags: - - Incident Teams - x-codegen-request-body-name: body - x-unstable: '**Note**: This endpoint is deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).' - '/api/v2/teams/{team_id}': - delete: - deprecated: true - description: Deletes an existing incident team. - operationId: DeleteIncidentTeam - parameters: - - $ref: '#/components/parameters/IncidentTeamIDPathParameter' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_settings_write - summary: Delete an existing incident team - tags: - - Incident Teams - x-unstable: '**Note**: This endpoint is deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).' - get: - deprecated: true - description: |- - Get details of an incident team. If the `include[users]` query parameter is provided, - the included attribute will contain the users related to these incident teams. - operationId: GetIncidentTeam - parameters: - - $ref: '#/components/parameters/IncidentTeamIDPathParameter' - - $ref: '#/components/parameters/IncidentTeamIncludeQueryParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTeamResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_read - summary: Get details of an incident team - tags: - - Incident Teams - x-unstable: '**Note**: This endpoint is deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).' - patch: - deprecated: true - description: Updates an existing incident team. Only provide the attributes which should be updated as this request is a partial update. - operationId: UpdateIncidentTeam - parameters: - - $ref: '#/components/parameters/IncidentTeamIDPathParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTeamUpdateRequest' - description: Incident Team Payload. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IncidentTeamResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - incident_settings_write - summary: Update an existing incident team - tags: - - Incident Teams - x-codegen-request-body-name: body - x-unstable: '**Note**: This endpoint is deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/).' diff --git a/providers/src/datadog/v00.00.00000/services/infrastructure.yaml b/providers/src/datadog/v00.00.00000/services/infrastructure.yaml new file mode 100644 index 00000000..15cd6bd6 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/infrastructure.yaml @@ -0,0 +1,4124 @@ +openapi: 3.0.0 +info: + title: infrastructure API + description: datadog infrastructure API + version: '1.0' +paths: + /api/v2/app-builder/apps: + delete: + description: >- + Delete multiple apps in a single request from a list of app IDs. This + API requires a [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: DeleteApps + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteAppsRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteAppsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Multiple Apps + tags: + - App Builder + x-permission: + operator: OR + permissions: + - apps_write + get: + description: >- + List all apps, with optional filters and sorting. This endpoint is + paginated. Only basic app information such as the app ID, name, and + description is returned by this endpoint. This API requires a + [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: ListApps + parameters: + - description: The number of apps to return per page. + in: query + name: limit + required: false + schema: + format: int64 + type: integer + - description: The page number to return. + in: query + name: page + required: false + schema: + format: int64 + type: integer + - description: Filter apps by the app creator. Usually the user's email. + in: query + name: filter[user_name] + required: false + schema: + type: string + - description: Filter apps by the app creator's UUID. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: query + name: filter[user_uuid] + required: false + schema: + format: uuid + type: string + - description: Filter by app name. + in: query + name: filter[name] + required: false + schema: + type: string + - description: Filter apps by the app name or the app creator. + in: query + name: filter[query] + required: false + schema: + type: string + - description: Filter apps by whether they are published. + in: query + name: filter[deployed] + required: false + schema: + type: boolean + - description: Filter apps by tags. + in: query + name: filter[tags] + required: false + schema: + type: string + - description: Filter apps by whether you have added them to your favorites. + in: query + name: filter[favorite] + required: false + schema: + type: boolean + - description: Filter apps by whether they are enabled for self-service. + in: query + name: filter[self_service] + required: false + schema: + type: boolean + - description: The fields and direction to sort apps by. + explode: false + in: query + name: sort + required: false + schema: + items: + $ref: '#/components/schemas/AppsSortField' + type: array + style: form + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListAppsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Apps + tags: + - App Builder + x-permission: + operator: OR + permissions: + - apps_run + post: + description: >- + Create a new app, returning the app ID. This API requires a [registered + application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: CreateApp + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateAppRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/CreateAppResponse' + description: Created + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create App + tags: + - App Builder + x-permission: + operator: AND + permissions: + - apps_write + - connections_resolve + - workflows_run + /api/v2/app-builder/apps/{app_id}: + delete: + description: >- + Delete a single app. This API requires a [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: DeleteApp + parameters: + - description: The ID of the app to delete. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteAppResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '410': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Gone + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete App + tags: + - App Builder + x-permission: + operator: OR + permissions: + - apps_write + get: + description: >- + Get the full definition of an app. This API requires a [registered + application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: GetApp + parameters: + - description: The ID of the app to retrieve. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + - description: >- + The version number of the app to retrieve. If not specified, the + latest version is returned. Version numbers start at 1 and increment + with each update. The special values `latest` and `deployed` can be + used to retrieve the latest version or the published version, + respectively. + in: query + name: version + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetAppResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '410': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Gone + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get App + tags: + - App Builder + x-permission: + operator: AND + permissions: + - apps_run + - connections_read + patch: + description: >- + Update an existing app. This creates a new version of the app. This API + requires a [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: UpdateApp + parameters: + - description: The ID of the app to update. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateAppRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateAppResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update App + tags: + - App Builder + x-permission: + operator: AND + permissions: + - apps_write + - connections_resolve + - workflows_run + /api/v2/app-builder/apps/{app_id}/deployment: + delete: + description: >- + Unpublish an app, removing the live version of the app. Unpublishing + creates a new instance of a `deployment` object on the app, with a nil + `app_version_id` (`00000000-0000-0000-0000-000000000000`). The app can + still be updated and published again in the future. This API requires a + [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: UnpublishApp + parameters: + - description: The ID of the app to unpublish. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UnpublishAppResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Unpublish App + tags: + - App Builder + x-permission: + operator: OR + permissions: + - apps_write + post: + description: >- + Publish an app for use by other users. To ensure the app is accessible + to the correct users, you also need to set a [Restriction + Policy](https://docs.datadoghq.com/api/latest/restriction-policies/) on + the app if a policy does not yet exist. This API requires a [registered + application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: PublishApp + parameters: + - description: The ID of the app to publish. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + in: path + name: app_id + required: true + schema: + format: uuid + type: string + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/PublishAppResponse' + description: Created + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Publish App + tags: + - App Builder + x-permission: + operator: OR + permissions: + - apps_write + /api/v2/container_images: + get: + description: Get all Container Images for your organization. + operationId: ListContainerImages + parameters: + - description: Comma-separated list of tags to filter Container Images by. + example: short_image:redis,status:running + in: query + name: filter[tags] + required: false + schema: + type: string + - description: Comma-separated list of tags to group Container Images by. + example: registry,image_tags + in: query + name: group_by + required: false + schema: + type: string + - description: Attribute to sort Container Images by. + example: container_count + in: query + name: sort + required: false + schema: + type: string + - description: Maximum number of results returned. + in: query + name: page[size] + required: false + schema: + default: 1000 + format: int32 + maximum: 10000 + minimum: 1 + type: integer + - description: >- + String to query the next page of results. + + This key is provided with each valid response from the API in + `meta.pagination.next_cursor`. + in: query + name: page[cursor] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ContainerImagesResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get all Container Images + tags: + - Container Images + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.pagination.next_cursor + limitParam: page[size] + resultsPath: data + x-permission: + operator: OPEN + permissions: [] + /api/v2/containers: + get: + description: Get all containers for your organization. + operationId: ListContainers + parameters: + - description: Comma-separated list of tags to filter containers by. + example: env:prod,short_image:cassandra + in: query + name: filter[tags] + required: false + schema: + type: string + - description: Comma-separated list of tags to group containers by. + example: datacenter,cluster + in: query + name: group_by + required: false + schema: + type: string + - description: Attribute to sort containers by. + example: started_at + in: query + name: sort + required: false + schema: + type: string + - description: Maximum number of results returned. + in: query + name: page[size] + required: false + schema: + default: 1000 + format: int32 + maximum: 10000 + minimum: 1 + type: integer + - description: >- + String to query the next page of results. + + This key is provided with each valid response from the API in + `meta.pagination.next_cursor`. + in: query + name: page[cursor] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ContainersResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get All Containers + tags: + - Containers + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.pagination.next_cursor + limitParam: page[size] + resultsPath: data + x-permission: + operator: OPEN + permissions: [] + /api/v2/ndm/devices: + get: + description: Get the list of devices. + operationId: ListDevices + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - description: The field to sort the devices by. + example: status + in: query + name: sort + required: false + schema: + type: string + - description: Filter devices by tag. + example: status:ok + in: query + name: filter[tag] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListDevicesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get the list of devices + tags: + - Network Device Monitoring + x-pagination: + limitParam: page[size] + pageParam: page[number] + resultsPath: data + /api/v2/ndm/devices/{device_id}: + get: + description: Get the device details. + operationId: GetDevice + parameters: + - description: The id of the device to fetch. + example: example:1.2.3.4 + in: path + name: device_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetDeviceResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get the device details + tags: + - Network Device Monitoring + /api/v2/ndm/interfaces: + get: + description: Get the list of interfaces of the device. + operationId: GetInterfaces + parameters: + - description: The ID of the device to get interfaces from. + example: example:1.2.3.4 + in: query + name: device_id + required: true + schema: + type: string + - description: Whether to get the IP addresses of the interfaces. + example: true + in: query + name: get_ip_addresses + required: false + schema: + type: boolean + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetInterfacesResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get the list of interfaces of the device + tags: + - Network Device Monitoring + /api/v2/ndm/tags/devices/{device_id}: + get: + description: Get the list of tags for a device. + operationId: ListDeviceUserTags + parameters: + - description: The id of the device to fetch tags for. + example: example:1.2.3.4 + in: path + name: device_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListTagsResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get the list of tags for a device + tags: + - Network Device Monitoring + patch: + description: Update the tags for a device. + operationId: UpdateDeviceUserTags + parameters: + - description: The id of the device to update tags for. + example: example:1.2.3.4 + in: path + name: device_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ListTagsResponse' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListTagsResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update the tags for a device + tags: + - Network Device Monitoring + /api/v2/network/connections/aggregate: + get: + description: Get all aggregated connections. + operationId: GetAggregatedConnections + parameters: + - description: >- + Unix timestamp (number of seconds since epoch) of the start of the + query window. If not provided, the start of the query window is 15 + minutes before the `to` timestamp. If neither `from` nor `to` are + provided, the query window is `[now - 15m, now]`. + in: query + name: from + schema: + format: int64 + type: integer + - description: >- + Unix timestamp (number of seconds since epoch) of the end of the + query window. If not provided, the end of the query window is the + current time. If neither `from` nor `to` are provided, the query + window is `[now - 15m, now]`. + in: query + name: to + schema: + format: int64 + type: integer + - description: >- + Comma-separated list of fields to group connections by. The maximum + number of group_by(s) is 10. + in: query + name: group_by + schema: + type: string + - description: Comma-separated list of tags to filter connections by. + in: query + name: tags + schema: + type: string + - description: >- + The number of connections to be returned. The maximum value is 7500. + The default is 100. + in: query + name: limit + schema: + default: 100 + format: int32 + maximum: 7500 + minimum: 1 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SingleAggregatedConnectionResponseArray' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all aggregated connections + tags: + - Cloud Network Monitoring + /api/v2/network/dns/aggregate: + get: + description: Get all aggregated DNS traffic. + operationId: GetAggregatedDns + parameters: + - description: >- + Unix timestamp (number of seconds since epoch) of the start of the + query window. If not provided, the start of the query window is 15 + minutes before the `to` timestamp. If neither `from` nor `to` are + provided, the query window is `[now - 15m, now]`. + in: query + name: from + schema: + format: int64 + type: integer + - description: >- + Unix timestamp (number of seconds since epoch) of the end of the + query window. If not provided, the end of the query window is the + current time. If neither `from` nor `to` are provided, the query + window is `[now - 15m, now]`. + in: query + name: to + schema: + format: int64 + type: integer + - description: >- + Comma-separated list of fields to group DNS traffic by. The server + side defaults to `network.dns_query` if unspecified. + `server_ungrouped` may be used if groups are not desired. The + maximum number of group_by(s) is 10. + in: query + name: group_by + schema: + type: string + - description: Comma-separated list of tags to filter DNS traffic by. + in: query + name: tags + schema: + type: string + - description: >- + The number of aggregated DNS entries to be returned. The maximum + value is 7500. The default is 100. + in: query + name: limit + schema: + default: 100 + format: int32 + maximum: 7500 + minimum: 1 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SingleAggregatedDnsResponseArray' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all aggregated DNS traffic + tags: + - Cloud Network Monitoring + /api/v2/processes: + get: + description: Get all processes for your organization. + operationId: ListProcesses + parameters: + - description: String to search processes by. + in: query + name: search + required: false + schema: + type: string + - description: Comma-separated list of tags to filter processes by. + example: account:prod,user:admin + in: query + name: tags + required: false + schema: + type: string + - description: >- + Unix timestamp (number of seconds since epoch) of the start of the + query window. + + If not provided, the start of the query window will be 15 minutes + before the `to` timestamp. If neither + + `from` nor `to` are provided, the query window will be `[now - 15m, + now]`. + in: query + name: from + required: false + schema: + format: int64 + type: integer + - description: >- + Unix timestamp (number of seconds since epoch) of the end of the + query window. + + If not provided, the end of the query window will be 15 minutes + after the `from` timestamp. If neither + + `from` nor `to` are provided, the query window will be `[now - 15m, + now]`. + in: query + name: to + required: false + schema: + format: int64 + type: integer + - description: Maximum number of results returned. + in: query + name: page[limit] + required: false + schema: + default: 1000 + format: int32 + maximum: 10000 + minimum: 1 + type: integer + - description: >- + String to query the next page of results. + + This key is provided with each valid response from the API in + `meta.page.after`. + in: query + name: page[cursor] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ProcessSummariesResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get all processes + tags: + - Processes + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + x-permission: + operator: OPEN + permissions: [] + /api/v2/spa/recommendations/{service}/{shard}: + get: + description: >- + Retrieve resource recommendations for a Spark job. The caller (Spark + Gateway or DJM UI) provides a service name and shard identifier, and SPA + returns structured recommendations for driver and executor resources. + operationId: GetSPARecommendations + parameters: + - description: >- + The shard tag for a spark job, which differentiates jobs within the + same service that have different resource needs + in: path + name: shard + required: true + schema: + type: string + - description: The service name for a spark job + in: path + name: service + required: true + schema: + type: string + responses: + '200': + content: + application/json: + example: + data: + attributes: + driver: + estimation: + cpu: + max: 1500 + p75: 1000 + p95: 1200 + ephemeral_storage: 896 + heap: 6144 + memory: 7168 + overhead: 1024 + executor: + estimation: + cpu: + max: 2000 + p75: 1200 + p95: 1500 + ephemeral_storage: 512 + heap: 3072 + memory: 4096 + overhead: 1024 + id: dedupeactivecontexts:adp_dedupeactivecontexts_org2 + type: recommendation + schema: + $ref: '#/components/schemas/RecommendationDocument' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get SPA Recommendations + tags: + - Spa + x-unstable: >- + **Note**: This endpoint is in public beta and may change in the future. + It is not yet recommended for production use. +components: + schemas: + DeleteAppsRequest: + description: A request object for deleting multiple apps by ID. + example: + data: + - id: aea2ed17-b45f-40d0-ba59-c86b7972c901 + type: appDefinitions + - id: f69bb8be-6168-4fe7-a30d-370256b6504a + type: appDefinitions + - id: ab1ed73e-13ad-4426-b0df-a0ff8876a088 + type: appDefinitions + properties: + data: + description: An array of objects containing the IDs of the apps to delete. + items: + $ref: '#/components/schemas/DeleteAppsRequestDataItems' + type: array + type: object + DeleteAppsResponse: + description: The response object after multiple apps are successfully deleted. + properties: + data: + description: An array of objects containing the IDs of the deleted apps. + items: + $ref: '#/components/schemas/DeleteAppsResponseDataItems' + type: array + type: object + JSONAPIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + items: + $ref: '#/components/schemas/JSONAPIErrorItem' + type: array + required: + - errors + type: object + AppsSortField: + description: The field and direction to sort apps by + enum: + - name + - created_at + - updated_at + - user_name + - '-name' + - '-created_at' + - '-updated_at' + - '-user_name' + example: '-created_at' + type: string + x-enum-varnames: + - NAME + - CREATED_AT + - UPDATED_AT + - USER_NAME + - NAME_DESC + - CREATED_AT_DESC + - UPDATED_AT_DESC + - USER_NAME_DESC + ListAppsResponse: + description: A paginated list of apps matching the specified filters and sorting. + properties: + data: + description: An array of app definitions. + items: + $ref: '#/components/schemas/ListAppsResponseDataItems' + type: array + included: + description: Data on the version of the app that was published. + items: + $ref: '#/components/schemas/Deployment' + type: array + meta: + $ref: '#/components/schemas/ListAppsResponseMeta' + type: object + CreateAppRequest: + description: A request object for creating a new app. + example: + data: + attributes: + components: + - events: [] + name: grid0 + properties: + children: + - events: [] + name: gridCell0 + properties: + children: + - events: [] + name: calloutValue0 + properties: + isDisabled: false + isLoading: false + isVisible: true + label: CPU Usage + size: sm + style: vivid_yellow + unit: kB + value: '42' + type: calloutValue + isVisible: 'true' + layout: + default: + height: 8 + width: 2 + x: 0 + 'y': 0 + type: gridCell + type: grid + description: This is a simple example app + name: Example App + queries: [] + rootInstanceName: grid0 + type: appDefinitions + properties: + data: + $ref: '#/components/schemas/CreateAppRequestData' + type: object + CreateAppResponse: + description: >- + The response object after a new app is successfully created, with the + app ID. + properties: + data: + $ref: '#/components/schemas/CreateAppResponseData' + type: object + DeleteAppResponse: + description: The response object after an app is successfully deleted. + properties: + data: + $ref: '#/components/schemas/DeleteAppResponseData' + type: object + GetAppResponse: + description: The full app definition response object. + properties: + data: + $ref: '#/components/schemas/GetAppResponseData' + included: + description: Data on the version of the app that was published. + items: + $ref: '#/components/schemas/Deployment' + type: array + meta: + $ref: '#/components/schemas/AppMeta' + relationship: + $ref: '#/components/schemas/AppRelationship' + type: object + UpdateAppRequest: + description: A request object for updating an existing app. + example: + data: + attributes: + components: + - events: [] + name: grid0 + properties: + children: + - events: [] + name: gridCell0 + properties: + children: + - events: [] + name: calloutValue0 + properties: + isDisabled: false + isLoading: false + isVisible: true + label: CPU Usage + size: sm + style: vivid_yellow + unit: kB + value: '42' + type: calloutValue + isVisible: 'true' + layout: + default: + height: 8 + width: 2 + x: 0 + 'y': 0 + type: gridCell + type: grid + description: This is a simple example app + name: Example App + queries: [] + rootInstanceName: grid0 + id: 9e20cbaf-68da-45a6-9ccf-54193ac29fa5 + type: appDefinitions + properties: + data: + $ref: '#/components/schemas/UpdateAppRequestData' + type: object + UpdateAppResponse: + description: The response object after an app is successfully updated. + properties: + data: + $ref: '#/components/schemas/UpdateAppResponseData' + included: + description: Data on the version of the app that was published. + items: + $ref: '#/components/schemas/Deployment' + type: array + meta: + $ref: '#/components/schemas/AppMeta' + relationship: + $ref: '#/components/schemas/AppRelationship' + type: object + UnpublishAppResponse: + description: The response object after an app is successfully unpublished. + properties: + data: + $ref: '#/components/schemas/Deployment' + type: object + PublishAppResponse: + description: The response object after an app is successfully published. + properties: + data: + $ref: '#/components/schemas/Deployment' + type: object + ContainerImagesResponse: + description: List of Container Images. + properties: + data: + description: Array of Container Image objects. + items: + $ref: '#/components/schemas/ContainerImageItem' + type: array + links: + $ref: '#/components/schemas/ContainerImagesResponseLinks' + meta: + $ref: '#/components/schemas/ContainerImageMeta' + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + ContainersResponse: + description: List of containers. + properties: + data: + description: Array of Container objects. + items: + $ref: '#/components/schemas/ContainerItem' + type: array + links: + $ref: '#/components/schemas/ContainersResponseLinks' + meta: + $ref: '#/components/schemas/ContainerMeta' + type: object + ListDevicesResponse: + description: List devices response. + properties: + data: + description: The list devices response data. + items: + $ref: '#/components/schemas/DevicesListData' + type: array + meta: + $ref: '#/components/schemas/ListDevicesResponseMetadata' + type: object + GetDeviceResponse: + description: The `GetDevice` operation's response. + properties: + data: + $ref: '#/components/schemas/GetDeviceData' + type: object + GetInterfacesResponse: + description: The `GetInterfaces` operation's response. + properties: + data: + description: Get Interfaces response + items: + $ref: '#/components/schemas/GetInterfacesData' + type: array + type: object + ListTagsResponse: + description: List tags response. + properties: + data: + $ref: '#/components/schemas/ListTagsResponseData' + type: object + SingleAggregatedConnectionResponseArray: + description: List of aggregated connections. + example: + data: + - attributes: + bytes_sent_by_client: 100 + bytes_sent_by_server: 200 + group_bys: + client_team: + - networks + server_service: + - hucklebuck + packets_sent_by_client: 10 + packets_sent_by_server: 20 + rtt_micro_seconds: 800 + tcp_closed_connections: 30 + tcp_established_connections: 40 + tcp_refusals: 7 + tcp_resets: 5 + tcp_retransmits: 30 + tcp_timeouts: 6 + id: client_team:networks, server_service:hucklebuck + type: aggregated_connection + properties: + data: + description: Array of aggregated connection objects. + items: + $ref: '#/components/schemas/SingleAggregatedConnectionResponseData' + type: array + type: object + SingleAggregatedDnsResponseArray: + description: List of aggregated DNS flows. + example: + data: + - attributes: + group_bys: + - key: client_service + value: example-service + - key: network.dns_query + value: example.com + metrics: + - key: dns_total_requests + value: 100 + - key: dns_failures + value: 7 + - key: dns_successful_responses + value: 93 + - key: dns_failed_responses + value: 5 + - key: dns_timeouts + value: 2 + - key: dns_responses.nxdomain + value: 1 + - key: dns_responses.servfail + value: 1 + - key: dns_responses.other + value: 3 + - key: dns_success_latency_percentile + value: 50 + - key: dns_failure_latency_percentile + value: 75 + id: client_service:example-service,network.dns_query:example.com + type: aggregated_dns + properties: + data: + description: Array of aggregated DNS objects. + items: + $ref: '#/components/schemas/SingleAggregatedDnsResponseData' + type: array + type: object + ProcessSummariesResponse: + description: List of process summaries. + properties: + data: + description: Array of process summary objects. + items: + $ref: '#/components/schemas/ProcessSummary' + type: array + meta: + $ref: '#/components/schemas/ProcessSummariesMeta' + type: object + RecommendationDocument: + description: >- + JSON:API document containing a single Recommendation resource. Returned + by SPA when the Spark Gateway requests recommendations. + properties: + data: + $ref: '#/components/schemas/RecommendationData' + required: + - data + type: object + DeleteAppsRequestDataItems: + description: An object containing the ID of an app to delete. + properties: + id: + description: The ID of the app to delete. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - id + - type + type: object + DeleteAppsResponseDataItems: + description: An object containing the ID of a deleted app. + properties: + id: + description: The ID of the deleted app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - id + - type + type: object + JSONAPIErrorItem: + description: API error response body + properties: + detail: + description: >- + A human-readable explanation specific to this occurrence of the + error. + example: Missing required attribute in body + type: string + meta: + additionalProperties: {} + description: Non-standard meta-information about the error + type: object + source: + $ref: '#/components/schemas/JSONAPIErrorItemSource' + status: + description: Status code of the response. + example: '400' + type: string + title: + description: Short human-readable summary of the error. + example: Bad Request + type: string + type: object + ListAppsResponseDataItems: + description: >- + An app definition object. This contains only basic information about the + app such as ID, name, and tags. + properties: + attributes: + $ref: '#/components/schemas/ListAppsResponseDataItemsAttributes' + id: + description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + meta: + $ref: '#/components/schemas/AppMeta' + relationships: + $ref: '#/components/schemas/ListAppsResponseDataItemsRelationships' + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - id + - type + - attributes + type: object + Deployment: + description: The version of the app that was published. + properties: + attributes: + $ref: '#/components/schemas/DeploymentAttributes' + id: + description: The deployment ID. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + meta: + $ref: '#/components/schemas/DeploymentMetadata' + type: + $ref: '#/components/schemas/AppDeploymentType' + type: object + ListAppsResponseMeta: + description: Pagination metadata. + properties: + page: + $ref: '#/components/schemas/ListAppsResponseMetaPage' + type: object + CreateAppRequestData: + description: The data object containing the app definition. + properties: + attributes: + $ref: '#/components/schemas/CreateAppRequestDataAttributes' + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - type + type: object + CreateAppResponseData: + description: The data object containing the app ID. + properties: + id: + description: The ID of the created app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - id + - type + type: object + DeleteAppResponseData: + description: The definition of `DeleteAppResponseData` object. + properties: + id: + description: The ID of the deleted app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - id + - type + type: object + GetAppResponseData: + description: The data object containing the app definition. + properties: + attributes: + $ref: '#/components/schemas/GetAppResponseDataAttributes' + id: + description: The ID of the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - id + - type + - attributes + type: object + AppMeta: + description: Metadata of an app. + properties: + created_at: + description: Timestamp of when the app was created. + format: date-time + type: string + deleted_at: + description: Timestamp of when the app was deleted. + format: date-time + type: string + org_id: + description: The Datadog organization ID that owns the app. + format: int64 + type: integer + updated_at: + description: Timestamp of when the app was last updated. + format: date-time + type: string + updated_since_deployment: + description: >- + Whether the app was updated since it was last published. Published + apps are pinned to a specific version and do not automatically + update when the app is updated. + type: boolean + user_id: + description: The ID of the user who created the app. + format: int64 + type: integer + user_name: + description: The name (or email address) of the user who created the app. + type: string + user_uuid: + description: The UUID of the user who created the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + version: + description: >- + The version number of the app. This starts at 1 and increments with + each update. + format: int64 + type: integer + type: object + AppRelationship: + description: The app's publication relationship and custom connections. + properties: + connections: + description: Array of custom connections used by the app. + items: + $ref: '#/components/schemas/CustomConnection' + type: array + deployment: + $ref: '#/components/schemas/DeploymentRelationship' + type: object + UpdateAppRequestData: + description: >- + The data object containing the new app definition. Any fields not + included in the request remain unchanged. + properties: + attributes: + $ref: '#/components/schemas/UpdateAppRequestDataAttributes' + id: + description: >- + The ID of the app to update. The app ID must match the ID in the URL + path. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - type + type: object + UpdateAppResponseData: + description: The data object containing the updated app definition. + properties: + attributes: + $ref: '#/components/schemas/UpdateAppResponseDataAttributes' + id: + description: The ID of the updated app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/AppDefinitionType' + required: + - id + - type + - attributes + type: object + ContainerImageItem: + description: Possible Container Image models. + oneOf: + - $ref: '#/components/schemas/ContainerImage' + - $ref: '#/components/schemas/ContainerImageGroup' + ContainerImagesResponseLinks: + description: Pagination links. + properties: + first: + description: Link to the first page. + type: string + last: + description: Link to the last page. + nullable: true + type: string + next: + description: Link to the next page. + nullable: true + type: string + prev: + description: Link to previous page. + nullable: true + type: string + self: + description: Link to current page. + type: string + type: object + ContainerImageMeta: + description: Response metadata object. + properties: + pagination: + $ref: '#/components/schemas/ContainerImageMetaPage' + type: object + ContainerItem: + description: Possible Container models. + oneOf: + - $ref: '#/components/schemas/Container' + - $ref: '#/components/schemas/ContainerGroup' + ContainersResponseLinks: + description: Pagination links. + properties: + first: + description: Link to the first page. + type: string + last: + description: Link to the last page. + nullable: true + type: string + next: + description: Link to the next page. + nullable: true + type: string + prev: + description: Link to previous page. + nullable: true + type: string + self: + description: Link to current page. + type: string + type: object + ContainerMeta: + description: Response metadata object. + properties: + pagination: + $ref: '#/components/schemas/ContainerMetaPage' + type: object + DevicesListData: + description: The devices list data + properties: + attributes: + $ref: '#/components/schemas/DeviceAttributes' + id: + description: The device ID + example: example:1.2.3.4 + type: string + type: + description: The type of the resource. The value should always be device. + type: string + type: object + ListDevicesResponseMetadata: + description: Object describing meta attributes of response. + properties: + page: + $ref: '#/components/schemas/ListDevicesResponseMetadataPage' + type: object + GetDeviceData: + description: Get device response data. + properties: + attributes: + $ref: '#/components/schemas/GetDeviceAttributes' + id: + description: The device ID + example: example:1.2.3.4 + type: string + type: + description: The type of the resource. The value should always be device. + type: string + type: object + GetInterfacesData: + description: The interfaces list data + properties: + attributes: + $ref: '#/components/schemas/InterfaceAttributes' + id: + description: The interface ID + example: example:1.2.3.4:99 + type: string + type: + description: The type of the resource. The value should always be interface. + type: string + type: object + ListTagsResponseData: + description: The list tags response data. + properties: + attributes: + $ref: '#/components/schemas/ListTagsResponseDataAttributes' + id: + description: The device ID + example: example:1.2.3.4 + type: string + type: + description: The type of the resource. The value should always be tags. + type: string + type: object + SingleAggregatedConnectionResponseData: + description: Object describing an aggregated connection. + properties: + attributes: + $ref: >- + #/components/schemas/SingleAggregatedConnectionResponseDataAttributes + id: + description: >- + A unique identifier for the aggregated connection based on the group + by values. + type: string + type: + $ref: '#/components/schemas/SingleAggregatedConnectionResponseDataType' + type: object + SingleAggregatedDnsResponseData: + description: Object describing an aggregated DNS flow. + properties: + attributes: + $ref: '#/components/schemas/SingleAggregatedDnsResponseDataAttributes' + id: + description: >- + A unique identifier for the aggregated DNS traffic based on the + group by values. + type: string + type: + $ref: '#/components/schemas/SingleAggregatedDnsResponseDataType' + type: object + ProcessSummary: + description: Process summary object. + properties: + attributes: + $ref: '#/components/schemas/ProcessSummaryAttributes' + id: + description: Process ID. + type: string + type: + $ref: '#/components/schemas/ProcessSummaryType' + type: object + ProcessSummariesMeta: + description: Response metadata object. + properties: + page: + $ref: '#/components/schemas/ProcessSummariesMetaPage' + type: object + RecommendationData: + description: >- + JSON:API resource object for SPA Recommendation. Includes type, optional + ID, and resource attributes with structured recommendations. + properties: + attributes: + $ref: '#/components/schemas/RecommendationAttributes' + id: + description: Resource identifier for the recommendation. Optional in responses. + type: string + type: + $ref: '#/components/schemas/RecommendationType' + required: + - type + - attributes + type: object + AppDefinitionType: + default: appDefinitions + description: The app definition type. + enum: + - appDefinitions + example: appDefinitions + type: string + x-enum-varnames: + - APPDEFINITIONS + JSONAPIErrorItemSource: + description: References to the source of the error. + properties: + header: + description: >- + A string indicating the name of a single request header which caused + the error. + example: Authorization + type: string + parameter: + description: A string indicating which URI query parameter caused the error. + example: limit + type: string + pointer: + description: >- + A JSON pointer to the value in the request document that caused the + error. + example: /data/attributes/title + type: string + type: object + ListAppsResponseDataItemsAttributes: + description: Basic information about the app such as name, description, and tags. + properties: + description: + description: A human-readable description for the app. + type: string + favorite: + description: Whether the app is marked as a favorite by the current user. + type: boolean + name: + description: The name of the app. + type: string + selfService: + description: Whether the app is enabled for use in the Datadog self-service hub. + type: boolean + tags: + description: A list of tags for the app, which can be used to filter apps. + example: + - service:webshop-backend + - team:webshop + items: + description: An individual tag for the app. + type: string + type: array + type: object + ListAppsResponseDataItemsRelationships: + description: The app's publication information. + properties: + deployment: + $ref: '#/components/schemas/DeploymentRelationship' + type: object + DeploymentAttributes: + description: The attributes object containing the version ID of the published app. + properties: + app_version_id: + description: >- + The version ID of the app that was published. For an unpublished + app, this is always the nil UUID + (`00000000-0000-0000-0000-000000000000`). + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: object + DeploymentMetadata: + description: Metadata object containing the publication creation information. + properties: + created_at: + description: Timestamp of when the app was published. + format: date-time + type: string + user_id: + description: The ID of the user who published the app. + format: int64 + type: integer + user_name: + description: The name (or email address) of the user who published the app. + type: string + user_uuid: + description: The UUID of the user who published the app. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: object + AppDeploymentType: + default: deployment + description: The deployment type. + enum: + - deployment + example: deployment + type: string + x-enum-varnames: + - DEPLOYMENT + ListAppsResponseMetaPage: + description: Information on the total number of apps, to be used for pagination. + properties: + totalCount: + description: >- + The total number of apps under the Datadog organization, + disregarding any filters applied. + format: int64 + type: integer + totalFilteredCount: + description: The total number of apps that match the specified filters. + format: int64 + type: integer + type: object + CreateAppRequestDataAttributes: + description: App definition attributes such as name, description, and components. + properties: + components: + description: The UI components that make up the app. + items: + $ref: '#/components/schemas/ComponentGrid' + type: array + description: + description: A human-readable description for the app. + type: string + name: + description: The name of the app. + type: string + queries: + description: >- + An array of queries, such as external actions and state variables, + that the app uses. + items: + $ref: '#/components/schemas/Query' + type: array + rootInstanceName: + description: >- + The name of the root component of the app. This must be a `grid` + component that contains all other components. + type: string + tags: + description: A list of tags for the app, which can be used to filter apps. + example: + - service:webshop-backend + - team:webshop + items: + description: An individual tag for the app. + type: string + type: array + type: object + GetAppResponseDataAttributes: + description: >- + The app definition attributes, such as name, description, and + components. + properties: + components: + description: The UI components that make up the app. + items: + $ref: '#/components/schemas/ComponentGrid' + type: array + description: + description: A human-readable description for the app. + type: string + favorite: + description: Whether the app is marked as a favorite by the current user. + type: boolean + name: + description: The name of the app. + type: string + queries: + description: >- + An array of queries, such as external actions and state variables, + that the app uses. + items: + $ref: '#/components/schemas/Query' + type: array + rootInstanceName: + description: >- + The name of the root component of the app. This must be a `grid` + component that contains all other components. + type: string + tags: + description: A list of tags for the app, which can be used to filter apps. + example: + - service:webshop-backend + - team:webshop + items: + description: An individual tag for the app. + type: string + type: array + type: object + CustomConnection: + description: A custom connection used by an app. + properties: + attributes: + $ref: '#/components/schemas/CustomConnectionAttributes' + id: + description: The ID of the custom connection. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/CustomConnectionType' + type: object + DeploymentRelationship: + description: Information pointing to the app's publication status. + properties: + data: + $ref: '#/components/schemas/DeploymentRelationshipData' + meta: + $ref: '#/components/schemas/DeploymentMetadata' + type: object + UpdateAppRequestDataAttributes: + description: >- + App definition attributes to be updated, such as name, description, and + components. + properties: + components: + description: >- + The new UI components that make up the app. If this field is set, + all existing components are replaced with the new components under + this field. + items: + $ref: '#/components/schemas/ComponentGrid' + type: array + description: + description: The new human-readable description for the app. + type: string + name: + description: The new name of the app. + type: string + queries: + description: >- + The new array of queries, such as external actions and state + variables, that the app uses. If this field is set, all existing + queries are replaced with the new queries under this field. + items: + $ref: '#/components/schemas/Query' + type: array + rootInstanceName: + description: >- + The new name of the root component of the app. This must be a `grid` + component that contains all other components. + type: string + tags: + description: >- + The new list of tags for the app, which can be used to filter apps. + If this field is set, any existing tags not included in the request + are removed. + example: + - service:webshop-backend + - team:webshop + items: + description: An individual tag for the app. + type: string + type: array + type: object + UpdateAppResponseDataAttributes: + description: >- + The updated app definition attributes, such as name, description, and + components. + properties: + components: + description: The UI components that make up the app. + items: + $ref: '#/components/schemas/ComponentGrid' + type: array + description: + description: The human-readable description for the app. + type: string + favorite: + description: Whether the app is marked as a favorite by the current user. + type: boolean + name: + description: The name of the app. + type: string + queries: + description: >- + An array of queries, such as external actions and state variables, + that the app uses. + items: + $ref: '#/components/schemas/Query' + type: array + rootInstanceName: + description: >- + The name of the root component of the app. This must be a `grid` + component that contains all other components. + type: string + tags: + description: A list of tags for the app, which can be used to filter apps. + example: + - service:webshop-backend + - team:webshop + items: + description: An individual tag for the app. + type: string + type: array + type: object + ContainerImage: + description: Container Image object. + properties: + attributes: + $ref: '#/components/schemas/ContainerImageAttributes' + id: + description: Container Image ID. + type: string + type: + $ref: '#/components/schemas/ContainerImageType' + type: object + ContainerImageGroup: + description: Container Image Group object. + properties: + attributes: + $ref: '#/components/schemas/ContainerImageGroupAttributes' + id: + description: Container Image Group ID. + type: string + relationships: + $ref: '#/components/schemas/ContainerImageGroupRelationships' + type: + $ref: '#/components/schemas/ContainerImageGroupType' + type: object + ContainerImageMetaPage: + description: Paging attributes. + properties: + cursor: + description: The cursor used to get the current results, if any. + type: string + limit: + description: Number of results returned + format: int32 + maximum: 10000 + minimum: 0 + type: integer + next_cursor: + description: The cursor used to get the next results, if any. + type: string + prev_cursor: + description: The cursor used to get the previous results, if any. + nullable: true + type: string + total: + description: Total number of records that match the query. + format: int64 + type: integer + type: + $ref: '#/components/schemas/ContainerImageMetaPageType' + type: object + Container: + description: Container object. + properties: + attributes: + $ref: '#/components/schemas/ContainerAttributes' + id: + description: Container ID. + type: string + type: + $ref: '#/components/schemas/ContainerType' + type: object + ContainerGroup: + description: Container group object. + properties: + attributes: + $ref: '#/components/schemas/ContainerGroupAttributes' + id: + description: Container Group ID. + type: string + relationships: + $ref: '#/components/schemas/ContainerGroupRelationships' + type: + $ref: '#/components/schemas/ContainerGroupType' + type: object + ContainerMetaPage: + description: Paging attributes. + properties: + cursor: + description: The cursor used to get the current results, if any. + type: string + limit: + description: Number of results returned + format: int32 + maximum: 10000 + minimum: 0 + type: integer + next_cursor: + description: The cursor used to get the next results, if any. + type: string + prev_cursor: + description: The cursor used to get the previous results, if any. + nullable: true + type: string + total: + description: Total number of records that match the query. + format: int64 + type: integer + type: + $ref: '#/components/schemas/ContainerMetaPageType' + type: object + DeviceAttributes: + description: The device attributes + properties: + description: + description: The device description + example: a device monitored with NDM + type: string + device_type: + description: The device type + example: other + type: string + integration: + description: The device integration + example: snmp + type: string + interface_statuses: + $ref: '#/components/schemas/DeviceAttributesInterfaceStatuses' + ip_address: + description: The device IP address + example: 1.2.3.4 + type: string + location: + description: The device location + example: paris + type: string + model: + description: The device model + example: xx-123 + type: string + name: + description: The device name + example: example device + type: string + os_hostname: + description: The device OS hostname + type: string + os_name: + description: The device OS name + example: example OS + type: string + os_version: + description: The device OS version + example: 1.0.2 + type: string + ping_status: + description: The device ping status + example: unmonitored + type: string + product_name: + description: The device product name + example: example device + type: string + serial_number: + description: The device serial number + example: X12345 + type: string + status: + description: The device SNMP status + example: ok + type: string + subnet: + description: The device subnet + example: 1.2.3.4/24 + type: string + sys_object_id: + description: The device `sys_object_id` + example: 1.3.6.1.4.1.99999 + type: string + tags: + description: The list of device tags + example: + - device_ip:1.2.3.4 + - device_id:example:1.2.3.4 + items: + type: string + type: array + vendor: + description: The device vendor + example: example vendor + type: string + version: + description: The device version + example: 1.2.3 + type: string + type: object + ListDevicesResponseMetadataPage: + description: Pagination object. + properties: + total_filtered_count: + description: Total count of devices matched by the filter. + example: 1 + format: int64 + type: integer + type: object + GetDeviceAttributes: + description: The device attributes + properties: + description: + description: A description of the device. + example: a device monitored with NDM + type: string + device_type: + description: The type of the device. + example: other + type: string + integration: + description: The integration of the device. + example: snmp + type: string + ip_address: + description: The IP address of the device. + example: 1.2.3.4 + type: string + location: + description: The location of the device. + example: paris + type: string + model: + description: The model of the device. + example: xx-123 + type: string + name: + description: The name of the device. + example: example device + type: string + os_hostname: + description: The operating system hostname of the device. + example: 1.0.2 + type: string + os_name: + description: The operating system name of the device. + example: example OS + type: string + os_version: + description: The operating system version of the device. + example: 1.0.2 + type: string + ping_status: + description: The ping status of the device. + example: unmonitored + type: string + product_name: + description: The product name of the device. + example: example device + type: string + serial_number: + description: The serial number of the device. + example: X12345 + type: string + status: + description: The status of the device. + example: ok + type: string + subnet: + description: The subnet of the device. + example: 1.2.3.4/24 + type: string + sys_object_id: + description: The device `sys_object_id`. + example: 1.3.6.1.4.1.99999 + type: string + tags: + description: A list of tags associated with the device. + example: + - device_ip:1.2.3.4 + - device_id:example:1.2.3.4 + items: + type: string + type: array + vendor: + description: The vendor of the device. + example: example vendor + type: string + version: + description: The version of the device. + example: 1.2.3 + type: string + type: object + InterfaceAttributes: + description: The interface attributes + properties: + alias: + description: The interface alias + example: interface_0 + type: string + description: + description: The interface description + example: a network interface + type: string + index: + description: The interface index + example: 0 + format: int64 + type: integer + ip_addresses: + description: The interface IP addresses + example: + - 1.1.1.1 + - 1.1.1.2 + items: + type: string + type: array + mac_address: + description: The interface MAC address + example: '00:00:00:00:00:00' + type: string + name: + description: The interface name + example: if0 + type: string + status: + $ref: '#/components/schemas/InterfaceAttributesStatus' + type: object + ListTagsResponseDataAttributes: + description: The definition of ListTagsResponseDataAttributes object. + properties: + tags: + description: The list of tags + example: + - tag:test + - tag:testbis + items: + type: string + type: array + type: object + SingleAggregatedConnectionResponseDataAttributes: + description: Attributes for an aggregated connection. + properties: + bytes_sent_by_client: + description: The total number of bytes sent by the client over the given period. + format: int64 + type: integer + bytes_sent_by_server: + description: The total number of bytes sent by the server over the given period. + format: int64 + type: integer + group_bys: + additionalProperties: + description: The values for each group by. + items: + type: string + type: array + description: The key, value pairs for each group by. + type: object + packets_sent_by_client: + description: >- + The total number of packets sent by the client over the given + period. + format: int64 + type: integer + packets_sent_by_server: + description: >- + The total number of packets sent by the server over the given + period. + format: int64 + type: integer + rtt_micro_seconds: + description: >- + Measured as TCP smoothed round trip time in microseconds (the time + between a TCP frame being sent and acknowledged). + format: int64 + type: integer + tcp_closed_connections: + description: >- + The number of TCP connections in a closed state. Measured in + connections per second from the client. + format: int64 + type: integer + tcp_established_connections: + description: >- + The number of TCP connections in an established state. Measured in + connections per second from the client. + format: int64 + type: integer + tcp_refusals: + description: >- + The number of TCP connections that were refused by the server. + Typically this indicates an attempt to connect to an IP/port that is + not receiving connections, or a firewall/security misconfiguration. + format: int64 + type: integer + tcp_resets: + description: The number of TCP connections that were reset by the server. + format: int64 + type: integer + tcp_retransmits: + description: >- + TCP Retransmits represent detected failures that are retransmitted + to ensure delivery. Measured in count of retransmits from the + client. + format: int64 + type: integer + tcp_timeouts: + description: >- + The number of TCP connections that timed out from the perspective of + the operating system. This can indicate general connectivity and + latency issues. + format: int64 + type: integer + type: object + SingleAggregatedConnectionResponseDataType: + default: aggregated_connection + description: Aggregated connection resource type. + enum: + - aggregated_connection + type: string + x-enum-varnames: + - AGGREGATED_CONNECTION + SingleAggregatedDnsResponseDataAttributes: + description: Attributes for an aggregated DNS flow. + properties: + group_bys: + description: The key, value pairs for each group by. + items: + $ref: >- + #/components/schemas/SingleAggregatedDnsResponseDataAttributesGroupByItems + type: array + metrics: + description: Metrics associated with an aggregated DNS flow. + items: + $ref: >- + #/components/schemas/SingleAggregatedDnsResponseDataAttributesMetricsItems + type: array + type: object + SingleAggregatedDnsResponseDataType: + default: aggregated_dns + description: Aggregated DNS resource type. + enum: + - aggregated_dns + type: string + x-enum-varnames: + - AGGREGATED_DNS + ProcessSummaryAttributes: + description: Attributes for a process summary. + properties: + cmdline: + description: Process command line. + type: string + host: + description: Host running the process. + type: string + pid: + description: Process ID. + format: int64 + type: integer + ppid: + description: Parent process ID. + format: int64 + type: integer + start: + description: Time the process was started. + type: string + tags: + description: List of tags associated with the process. + items: + description: A tag associated with the process. + type: string + type: array + timestamp: + description: Time the process was seen. + type: string + user: + description: Process owner. + type: string + type: object + ProcessSummaryType: + default: process + description: Type of process summary. + enum: + - process + example: process + type: string + x-enum-varnames: + - PROCESS + ProcessSummariesMetaPage: + description: Paging attributes. + properties: + after: + description: >- + The cursor used to get the next results, if any. To make the next + request, use the same + + parameters with the addition of the `page[cursor]`. + example: 911abf1204838d9cdfcb9a96d0b6a1bd03e1b514074f1ce1737c4cbd + type: string + size: + description: Number of results returned. + format: int32 + maximum: 10000 + minimum: 0 + type: integer + type: object + RecommendationAttributes: + description: >- + Attributes of the SPA Recommendation resource. Contains recommendations + for both driver and executor components. + properties: + driver: + $ref: '#/components/schemas/ComponentRecommendation' + executor: + $ref: '#/components/schemas/ComponentRecommendation' + required: + - driver + - executor + type: object + RecommendationType: + default: recommendation + description: >- + JSON:API resource type for Spark Pod Autosizing recommendations. + Identifies the Recommendation resource returned by SPA. + enum: + - recommendation + example: recommendation + type: string + x-enum-varnames: + - RECOMMENDATION + ComponentGrid: + description: >- + A grid component. The grid component is the root canvas for an app and + contains all other components. + properties: + events: + description: Events to listen for on the grid component. + items: + $ref: '#/components/schemas/AppBuilderEvent' + type: array + id: + description: >- + The ID of the grid component. This property is deprecated; use + `name` to identify individual components instead. + type: string + name: + description: >- + A unique identifier for this grid component. This name is also + visible in the app editor. + example: '' + type: string + properties: + $ref: '#/components/schemas/ComponentGridProperties' + type: + $ref: '#/components/schemas/ComponentGridType' + required: + - name + - type + - properties + type: object + Query: + description: >- + A data query used by an app. This can take the form of an external + action, a data transformation, or a state variable. + oneOf: + - $ref: '#/components/schemas/ActionQuery' + - $ref: '#/components/schemas/DataTransform' + - $ref: '#/components/schemas/StateVariable' + CustomConnectionAttributes: + description: The custom connection attributes. + properties: + name: + description: The name of the custom connection. + type: string + onPremRunner: + $ref: '#/components/schemas/CustomConnectionAttributesOnPremRunner' + type: object + CustomConnectionType: + default: custom_connections + description: The custom connection type. + enum: + - custom_connections + example: custom_connections + type: string + x-enum-varnames: + - CUSTOM_CONNECTIONS + DeploymentRelationshipData: + description: Data object containing the deployment ID. + properties: + id: + description: The deployment ID. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + type: + $ref: '#/components/schemas/AppDeploymentType' + type: object + ContainerImageAttributes: + description: Attributes for a Container Image. + properties: + container_count: + description: Number of containers running the image. + format: int64 + type: integer + image_flavors: + description: |- + List of platform-specific images associated with the image record. + The list contains more than 1 entry for multi-architecture images. + items: + $ref: '#/components/schemas/ContainerImageFlavor' + type: array + image_tags: + description: List of image tags associated with the Container Image. + items: + description: An image tag associated with the Container Image. + type: string + type: array + images_built_at: + description: |- + List of build times associated with the Container Image. + The list contains more than 1 entry for multi-architecture images. + items: + description: Time the platform-specific Container Image was built. + type: string + type: array + name: + description: Name of the Container Image. + type: string + os_architectures: + description: >- + List of Operating System architectures supported by the Container + Image. + items: + description: Operating System architecture supported by the Container Image. + example: amd64 + type: string + type: array + os_names: + description: List of Operating System names supported by the Container Image. + items: + description: Operating System supported by the Container Image. + example: linux + type: string + type: array + os_versions: + description: List of Operating System versions supported by the Container Image. + items: + description: Operating System version supported by the Container Image. + type: string + type: array + published_at: + description: Time the image was pushed to the container registry. + type: string + registry: + description: Registry the Container Image was pushed to. + type: string + repo_digest: + description: Digest of the compressed image manifest. + type: string + repository: + description: Repository where the Container Image is stored in. + type: string + short_image: + description: Short version of the Container Image name. + type: string + sizes: + description: >- + List of size for each platform-specific image associated with the + image record. + + The list contains more than 1 entry for multi-architecture images. + items: + description: Size of the platform-specific Container Image. + format: int64 + type: integer + type: array + sources: + description: List of sources where the Container Image was collected from. + items: + description: Source where the Container Image was collected from. + type: string + type: array + tags: + description: List of tags associated with the Container Image. + items: + description: A tag associated with the Container Image. + type: string + type: array + vulnerability_count: + $ref: '#/components/schemas/ContainerImageVulnerabilities' + type: object + ContainerImageType: + default: container_image + description: Type of Container Image. + enum: + - container_image + example: container_image + type: string + x-enum-varnames: + - CONTAINER_IMAGE + ContainerImageGroupAttributes: + description: Attributes for a Container Image Group. + properties: + count: + description: Number of Container Images in the group. + format: int64 + type: integer + name: + description: Name of the Container Image group. + type: string + tags: + description: Tags from the group name parsed in key/value format. + type: object + type: object + ContainerImageGroupRelationships: + description: Relationships inside a Container Image Group. + properties: + container_images: + $ref: '#/components/schemas/ContainerImageGroupImagesRelationshipsLink' + type: object + ContainerImageGroupType: + default: container_image_group + description: Type of Container Image Group. + enum: + - container_image_group + example: container_image_group + type: string + x-enum-varnames: + - CONTAINER_IMAGE_GROUP + ContainerImageMetaPageType: + default: cursor_limit + description: Type of Container Image pagination. + enum: + - cursor_limit + example: cursor_limit + type: string + x-enum-varnames: + - CURSOR_LIMIT + ContainerAttributes: + description: Attributes for a container. + properties: + container_id: + description: The ID of the container. + type: string + created_at: + description: Time the container was created. + type: string + host: + description: Hostname of the host running the container. + type: string + image_digest: + description: Digest of the compressed image manifest. + nullable: true + type: string + image_name: + description: Name of the associated container image. + type: string + image_tags: + description: List of image tags associated with the container image. + items: + type: string + nullable: true + type: array + name: + description: Name of the container. + type: string + started_at: + description: Time the container was started. + type: string + state: + description: State of the container. This depends on the container runtime. + type: string + tags: + description: List of tags associated with the container. + items: + type: string + type: array + type: object + ContainerType: + default: container + description: Type of container. + enum: + - container + example: container + type: string + x-enum-varnames: + - CONTAINER + ContainerGroupAttributes: + description: Attributes for a container group. + properties: + count: + description: Number of containers in the group. + format: int64 + type: integer + tags: + description: Tags from the group name parsed in key/value format. + type: object + type: object + ContainerGroupRelationships: + description: Relationships to containers inside a container group. + properties: + containers: + $ref: '#/components/schemas/ContainerGroupRelationshipsLink' + type: object + ContainerGroupType: + default: container_group + description: Type of container group. + enum: + - container_group + example: container_group + type: string + x-enum-varnames: + - CONTAINER_GROUP + ContainerMetaPageType: + default: cursor_limit + description: Type of Container pagination. + enum: + - cursor_limit + example: cursor_limit + type: string + x-enum-varnames: + - CURSOR_LIMIT + DeviceAttributesInterfaceStatuses: + description: Count of the device interfaces by status + example: + down: 1 + 'off': 2 + up: 12 + warning: 5 + properties: + down: + description: The number of interfaces that are down + format: int64 + type: integer + 'off': + description: The number of interfaces that are off + format: int64 + type: integer + up: + description: The number of interfaces that are up + format: int64 + type: integer + warning: + description: The number of interfaces that are in a warning state + format: int64 + type: integer + type: object + InterfaceAttributesStatus: + description: The interface status + enum: + - up + - down + - warning + - 'off' + example: up + type: string + x-enum-varnames: + - UP + - DOWN + - WARNING + - 'OFF' + SingleAggregatedDnsResponseDataAttributesGroupByItems: + description: Attributes associated with a group by + properties: + key: + description: The group by key. + type: string + value: + description: The group by value. + type: string + type: object + SingleAggregatedDnsResponseDataAttributesMetricsItems: + description: Metrics associated with an aggregated DNS flow. + properties: + key: + $ref: '#/components/schemas/DnsMetricKey' + value: + description: The metric value. + format: int64 + type: integer + type: object + ComponentRecommendation: + description: >- + Resource recommendation for a single Spark component (driver or + executor). Contains estimation data used to patch Spark job specs. + properties: + estimation: + $ref: '#/components/schemas/Estimation' + required: + - estimation + type: object + AppBuilderEvent: + additionalProperties: {} + description: An event on a UI component that triggers a response or action in an app. + properties: + name: + $ref: '#/components/schemas/AppBuilderEventName' + type: + $ref: '#/components/schemas/AppBuilderEventType' + type: object + ComponentGridProperties: + description: Properties of a grid component. + properties: + backgroundColor: + default: default + description: The background color of the grid. + type: string + children: + description: The child components of the grid. + items: + $ref: '#/components/schemas/Component' + type: array + isVisible: + $ref: '#/components/schemas/ComponentGridPropertiesIsVisible' + type: object + ComponentGridType: + default: grid + description: The grid component type. + enum: + - grid + example: grid + type: string + x-enum-varnames: + - GRID + ActionQuery: + description: >- + An action query. This query type is used to trigger an action, such as + sending a HTTP request. + properties: + events: + description: Events to listen for downstream of the action query. + items: + $ref: '#/components/schemas/AppBuilderEvent' + type: array + id: + description: The ID of the action query. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + name: + description: >- + A unique identifier for this action query. This name is also used to + access the query's result throughout the app. + example: fetchPendingOrders + type: string + properties: + $ref: '#/components/schemas/ActionQueryProperties' + type: + $ref: '#/components/schemas/ActionQueryType' + required: + - id + - name + - type + - properties + type: object + DataTransform: + description: >- + A data transformer, which is custom JavaScript code that executes and + transforms data when its inputs change. + properties: + id: + description: The ID of the data transformer. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + name: + description: >- + A unique identifier for this data transformer. This name is also + used to access the transformer's result throughout the app. + example: combineTwoOrders + type: string + properties: + $ref: '#/components/schemas/DataTransformProperties' + type: + $ref: '#/components/schemas/DataTransformType' + required: + - id + - name + - type + - properties + type: object + StateVariable: + description: A variable, which can be set and read by other components in the app. + properties: + id: + description: The ID of the state variable. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + name: + description: >- + A unique identifier for this state variable. This name is also used + to access the variable's value throughout the app. + example: ordersToSubmit + type: string + properties: + $ref: '#/components/schemas/StateVariableProperties' + type: + $ref: '#/components/schemas/StateVariableType' + required: + - id + - name + - type + - properties + type: object + CustomConnectionAttributesOnPremRunner: + description: >- + Information about the Private Action Runner used by the custom + connection, if the custom connection is associated with a Private Action + Runner. + properties: + id: + description: The Private Action Runner ID. + type: string + url: + description: The URL of the Private Action Runner. + type: string + type: object + ContainerImageFlavor: + description: Container Image breakdown by supported platform. + properties: + built_at: + description: Time the platform-specific Container Image was built. + type: string + os_architecture: + description: Operating System architecture supported by the Container Image. + type: string + os_name: + description: Operating System name supported by the Container Image. + type: string + os_version: + description: Operating System version supported by the Container Image. + type: string + size: + description: Size of the platform-specific Container Image. + format: int64 + type: integer + type: object + ContainerImageVulnerabilities: + description: Vulnerability counts associated with the Container Image. + properties: + asset_id: + description: ID of the Container Image. + type: string + critical: + description: Number of vulnerabilities with CVSS Critical severity. + format: int64 + type: integer + high: + description: Number of vulnerabilities with CVSS High severity. + format: int64 + type: integer + low: + description: Number of vulnerabilities with CVSS Low severity. + format: int64 + type: integer + medium: + description: Number of vulnerabilities with CVSS Medium severity. + format: int64 + type: integer + none: + description: Number of vulnerabilities with CVSS None severity. + format: int64 + type: integer + unknown: + description: Number of vulnerabilities with an unknown CVSS severity. + format: int64 + type: integer + type: object + ContainerImageGroupImagesRelationshipsLink: + description: Relationships to Container Images inside a Container Image Group. + properties: + data: + $ref: '#/components/schemas/ContainerImageGroupRelationshipsData' + links: + $ref: '#/components/schemas/ContainerImageGroupRelationshipsLinks' + type: object + ContainerGroupRelationshipsLink: + description: Relationships to Containers inside a Container Group. + properties: + data: + $ref: '#/components/schemas/ContainerGroupRelationshipsData' + links: + $ref: '#/components/schemas/ContainerGroupRelationshipsLinks' + type: object + DnsMetricKey: + description: The metric key for DNS metrics. + enum: + - dns_total_requests + - dns_failures + - dns_successful_responses + - dns_failed_responses + - dns_timeouts + - dns_responses.nxdomain + - dns_responses.servfail + - dns_responses.other + - dns_success_latency_percentile + - dns_failure_latency_percentile + type: string + x-enum-descriptions: + - The total number of DNS requests made by the client. + - The total number of timeouts and errors in DNS requests. + - The total number of successful DNS responses. + - The total number of failed DNS responses. + - The total number of DNS timeouts. + - The total number of DNS responses with the NXDOMAIN error code. + - The total number of DNS responses with the SERVFAIL error code. + - The total number of DNS responses with other error codes. + - The latency percentile for successful DNS responses. + - The latency percentile for failed DNS responses. + x-enum-varnames: + - DNS_TOTAL_REQUESTS + - DNS_FAILURES + - DNS_SUCCESSFUL_RESPONSES + - DNS_FAILED_RESPONSES + - DNS_TIMEOUTS + - DNS_RESPONSES_NXDOMAIN + - DNS_RESPONSES_SERVFAIL + - DNS_RESPONSES_OTHER + - DNS_SUCCESS_LATENCY_PERCENTILE + - DNS_FAILURE_LATENCY_PERCENTILE + Estimation: + description: >- + Recommended resource values for a Spark driver or executor, derived from + recent real usage metrics. Used by SPA to propose more efficient pod + sizing. + properties: + cpu: + $ref: '#/components/schemas/Cpu' + ephemeral_storage: + description: >- + Recommended ephemeral storage allocation (in MiB). Derived from job + temporary storage patterns. + format: int64 + type: integer + heap: + description: Recommended JVM heap size (in MiB). + format: int64 + type: integer + memory: + description: >- + Recommended total memory allocation (in MiB). Includes both heap and + overhead. + format: int64 + type: integer + overhead: + description: Recommended JVM overhead (in MiB). Computed as total memory - heap. + format: int64 + type: integer + type: object + AppBuilderEventName: + description: The triggering action for the event. + enum: + - pageChange + - tableRowClick + - _tableRowButtonClick + - change + - submit + - click + - toggleOpen + - close + - open + - executionFinished + example: click + type: string + x-enum-varnames: + - PAGECHANGE + - TABLEROWCLICK + - TABLEROWBUTTONCLICK + - CHANGE + - SUBMIT + - CLICK + - TOGGLEOPEN + - CLOSE + - OPEN + - EXECUTIONFINISHED + AppBuilderEventType: + description: The response to the event. + enum: + - custom + - setComponentState + - triggerQuery + - openModal + - closeModal + - openUrl + - downloadFile + - setStateVariableValue + example: triggerQuery + type: string + x-enum-varnames: + - CUSTOM + - SETCOMPONENTSTATE + - TRIGGERQUERY + - OPENMODAL + - CLOSEMODAL + - OPENURL + - DOWNLOADFILE + - SETSTATEVARIABLEVALUE + Component: + description: >- + [Definition of a UI component in the + app](https://docs.datadoghq.com/service_management/app_builder/components/) + properties: + events: + description: Events to listen for on the UI component. + items: + $ref: '#/components/schemas/AppBuilderEvent' + type: array + id: + description: >- + The ID of the UI component. This property is deprecated; use `name` + to identify individual components instead. + nullable: true + type: string + name: + description: >- + A unique identifier for this UI component. This name is also visible + in the app editor. + example: '' + type: string + properties: + $ref: '#/components/schemas/ComponentProperties' + type: + $ref: '#/components/schemas/ComponentType' + required: + - name + - type + - properties + type: object + ComponentGridPropertiesIsVisible: + description: >- + Whether the grid component and its children are visible. If a string, it + must be a valid JavaScript expression that evaluates to a boolean. + oneOf: + - type: string + - default: true + type: boolean + ActionQueryProperties: + description: The properties of the action query. + properties: + condition: + $ref: '#/components/schemas/ActionQueryCondition' + debounceInMs: + $ref: '#/components/schemas/ActionQueryDebounceInMs' + mockedOutputs: + $ref: '#/components/schemas/ActionQueryMockedOutputs' + onlyTriggerManually: + $ref: '#/components/schemas/ActionQueryOnlyTriggerManually' + outputs: + description: >- + The post-query transformation function, which is a JavaScript + function that changes the query's `.outputs` property after the + query's execution. + example: ${((outputs) => {return outputs.body.data})(self.rawOutputs)} + type: string + pollingIntervalInMs: + $ref: '#/components/schemas/ActionQueryPollingIntervalInMs' + requiresConfirmation: + $ref: '#/components/schemas/ActionQueryRequiresConfirmation' + showToastOnError: + $ref: '#/components/schemas/ActionQueryShowToastOnError' + spec: + $ref: '#/components/schemas/ActionQuerySpec' + required: + - spec + type: object + ActionQueryType: + default: action + description: The action query type. + enum: + - action + example: action + type: string + x-enum-varnames: + - ACTION + DataTransformProperties: + description: The properties of the data transformer. + properties: + outputs: + description: A JavaScript function that returns the transformed data. + example: |- + ${(() => {return { + allItems: [...fetchOrder1.outputs.items, ...fetchOrder2.outputs.items], + }})()} + type: string + type: object + DataTransformType: + default: dataTransform + description: The data transform type. + enum: + - dataTransform + example: dataTransform + type: string + x-enum-varnames: + - DATATRANSFORM + StateVariableProperties: + description: The properties of the state variable. + properties: + defaultValue: + description: The default value of the state variable. + example: ${['order_3145', 'order_4920']} + type: object + StateVariableType: + default: stateVariable + description: The state variable type. + enum: + - stateVariable + example: stateVariable + type: string + x-enum-varnames: + - STATEVARIABLE + ContainerImageGroupRelationshipsData: + description: Links data. + items: + description: A link data. + type: string + type: array + ContainerImageGroupRelationshipsLinks: + description: Links attributes. + properties: + related: + description: Link to related Container Images. + type: string + type: object + ContainerGroupRelationshipsData: + description: Links data. + items: + description: A link data. + type: string + type: array + ContainerGroupRelationshipsLinks: + description: Links attributes. + properties: + related: + description: Link to related containers. + type: string + type: object + Cpu: + description: >- + CPU usage statistics derived from historical Spark job metrics. Provides + multiple estimates so users can choose between conservative and + cost-saving risk profiles. + properties: + max: + description: >- + Maximum CPU usage observed for the job, expressed in millicores. + This represents the upper bound of usage. + format: int64 + type: integer + p75: + description: >- + 75th percentile of CPU usage (millicores). Represents a cost-saving + configuration while covering most workloads. + format: int64 + type: integer + p95: + description: >- + 95th percentile of CPU usage (millicores). Balances performance and + cost, providing a safer margin than p75. + format: int64 + type: integer + type: object + x-model-simple-name: SpaCpu + ComponentProperties: + additionalProperties: {} + description: >- + Properties of a UI component. Different component types can have their + own additional unique properties. See the [components + documentation](https://docs.datadoghq.com/service_management/app_builder/components/) + for more detail on each component type and its properties. + properties: + children: + description: The child components of the UI component. + items: + $ref: '#/components/schemas/Component' + type: array + isVisible: + $ref: '#/components/schemas/ComponentPropertiesIsVisible' + type: object + ComponentType: + description: The UI component type. + enum: + - table + - textInput + - textArea + - button + - text + - select + - modal + - schemaForm + - checkbox + - tabs + - vegaChart + - radioButtons + - numberInput + - fileInput + - jsonInput + - gridCell + - dateRangePicker + - search + - container + - calloutValue + example: text + type: string + x-enum-varnames: + - TABLE + - TEXTINPUT + - TEXTAREA + - BUTTON + - TEXT + - SELECT + - MODAL + - SCHEMAFORM + - CHECKBOX + - TABS + - VEGACHART + - RADIOBUTTONS + - NUMBERINPUT + - FILEINPUT + - JSONINPUT + - GRIDCELL + - DATERANGEPICKER + - SEARCH + - CONTAINER + - CALLOUTVALUE + ActionQueryCondition: + description: >- + Whether to run this query. If specified, the query will only run if this + condition evaluates to `true` in JavaScript and all other conditions are + also met. + oneOf: + - type: boolean + - example: ${true} + type: string + ActionQueryDebounceInMs: + description: >- + The minimum time in milliseconds that must pass before the query can be + triggered again. This is useful for preventing accidental double-clicks + from triggering the query multiple times. + oneOf: + - example: 310.5 + format: double + type: number + - description: >- + If this is a string, it must be a valid JavaScript expression that + evaluates to a number. + example: ${1000} + type: string + ActionQueryMockedOutputs: + description: >- + The mocked outputs of the action query. This is useful for testing the + app without actually running the action. + oneOf: + - type: string + - $ref: '#/components/schemas/ActionQueryMockedOutputsObject' + ActionQueryOnlyTriggerManually: + description: >- + Determines when this query is executed. If set to `false`, the query + will run when the app loads and whenever any query arguments change. If + set to `true`, the query will only run when manually triggered from + elsewhere in the app. + oneOf: + - type: boolean + - description: >- + If this is a string, it must be a valid JavaScript expression that + evaluates to a boolean. + example: ${true} + type: string + ActionQueryPollingIntervalInMs: + description: >- + If specified, the app will poll the query at the specified interval in + milliseconds. The minimum polling interval is 15 seconds. The query will + only poll when the app's browser tab is active. + oneOf: + - example: 30000 + format: double + minimum: 15000 + type: number + - description: >- + If this is a string, it must be a valid JavaScript expression that + evaluates to a number. + example: ${15000} + type: string + ActionQueryRequiresConfirmation: + description: Whether to prompt the user to confirm this query before it runs. + oneOf: + - type: boolean + - description: >- + If this is a string, it must be a valid JavaScript expression that + evaluates to a boolean. + example: ${true} + type: string + ActionQueryShowToastOnError: + description: Whether to display a toast to the user when the query returns an error. + oneOf: + - type: boolean + - description: >- + If this is a string, it must be a valid JavaScript expression that + evaluates to a boolean. + example: ${true} + type: string + ActionQuerySpec: + description: The definition of the action query. + oneOf: + - type: string + - $ref: '#/components/schemas/ActionQuerySpecObject' + ComponentPropertiesIsVisible: + description: >- + Whether the UI component is visible. If this is a string, it must be a + valid JavaScript expression that evaluates to a boolean. + oneOf: + - type: boolean + - description: >- + If this is a string, it must be a valid JavaScript expression that + evaluates to a boolean. + example: ${true} + type: string + ActionQueryMockedOutputsObject: + description: The mocked outputs of the action query. + properties: + enabled: + $ref: '#/components/schemas/ActionQueryMockedOutputsEnabled' + outputs: + description: The mocked outputs of the action query, serialized as JSON. + example: '{"status": "success"}' + type: string + required: + - enabled + type: object + ActionQuerySpecObject: + description: The action query spec object. + properties: + connectionGroup: + $ref: '#/components/schemas/ActionQuerySpecConnectionGroup' + connectionId: + description: The ID of the custom connection to use for this action query. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + type: string + fqn: + description: The fully qualified name of the action type. + example: com.datadoghq.http.request + type: string + inputs: + $ref: '#/components/schemas/ActionQuerySpecInputs' + required: + - fqn + type: object + ActionQueryMockedOutputsEnabled: + description: Whether to enable the mocked outputs for testing. + oneOf: + - type: boolean + - description: >- + If this is a string, it must be a valid JavaScript expression that + evaluates to a boolean. + example: ${true} + type: string + ActionQuerySpecConnectionGroup: + description: The connection group to use for an action query. + properties: + id: + description: The ID of the connection group. + example: 65bb1f25-52e1-4510-9f8d-22d1516ed693 + format: uuid + type: string + tags: + description: The tags of the connection group. + items: + type: string + type: array + type: object + ActionQuerySpecInputs: + description: >- + The inputs to the action query. These are the values that are passed to + the action when it is triggered. + oneOf: + - type: string + - $ref: '#/components/schemas/ActionQuerySpecInput' + ActionQuerySpecInput: + additionalProperties: {} + description: >- + The inputs to the action query. See the [Actions + Catalog](https://docs.datadoghq.com/actions/actions_catalog/) for more + detail on each action and its inputs. + type: object + responses: + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + parameters: + PageSize: + description: Size for a given page. The maximum allowed value is 100. + in: query + name: page[size] + required: false + schema: + default: 10 + example: 10 + format: int64 + type: integer + PageNumber: + description: Specific page number to return. + in: query + name: page[number] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + x-stackQL-resources: + apps: + id: datadog.infrastructure.apps + name: apps + title: Apps + methods: + delete_apps: + operation: + $ref: '#/paths/~1api~1v2~1app-builder~1apps/delete' + response: + mediaType: application/json + openAPIDocKey: '200' + list_apps: + operation: + $ref: '#/paths/~1api~1v2~1app-builder~1apps/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_app: + operation: + $ref: '#/paths/~1api~1v2~1app-builder~1apps/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_app: + operation: + $ref: '#/paths/~1api~1v2~1app-builder~1apps~1{app_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '200' + get_app: + operation: + $ref: '#/paths/~1api~1v2~1app-builder~1apps~1{app_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_app: + operation: + $ref: '#/paths/~1api~1v2~1app-builder~1apps~1{app_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + unpublish_app: + operation: + $ref: '#/paths/~1api~1v2~1app-builder~1apps~1{app_id}~1deployment/delete' + response: + mediaType: application/json + openAPIDocKey: '200' + publish_app: + operation: + $ref: '#/paths/~1api~1v2~1app-builder~1apps~1{app_id}~1deployment/post' + response: + mediaType: application/json + openAPIDocKey: '201' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/apps/methods/get_app' + - $ref: '#/components/x-stackQL-resources/apps/methods/list_apps' + insert: + - $ref: '#/components/x-stackQL-resources/apps/methods/create_app' + update: + - $ref: '#/components/x-stackQL-resources/apps/methods/update_app' + delete: + - $ref: '#/components/x-stackQL-resources/apps/methods/delete_app' + - $ref: '#/components/x-stackQL-resources/apps/methods/delete_apps' + replace: [] + container_images: + id: datadog.infrastructure.container_images + name: container_images + title: Container Images + methods: + list_container_images: + operation: + $ref: '#/paths/~1api~1v2~1container_images/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/container_images/methods/list_container_images + insert: [] + update: [] + delete: [] + replace: [] + containers: + id: datadog.infrastructure.containers + name: containers + title: Containers + methods: + list_containers: + operation: + $ref: '#/paths/~1api~1v2~1containers/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/containers/methods/list_containers + insert: [] + update: [] + delete: [] + replace: [] + devices: + id: datadog.infrastructure.devices + name: devices + title: Devices + methods: + list_devices: + operation: + $ref: '#/paths/~1api~1v2~1ndm~1devices/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + get_device: + operation: + $ref: '#/paths/~1api~1v2~1ndm~1devices~1{device_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/devices/methods/get_device' + - $ref: '#/components/x-stackQL-resources/devices/methods/list_devices' + insert: [] + update: [] + delete: [] + replace: [] + device_interfaces: + id: datadog.infrastructure.device_interfaces + name: device_interfaces + title: Device Interfaces + methods: + get_interfaces: + operation: + $ref: '#/paths/~1api~1v2~1ndm~1interfaces/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/device_interfaces/methods/get_interfaces + insert: [] + update: [] + delete: [] + replace: [] + device_user_tags: + id: datadog.infrastructure.device_user_tags + name: device_user_tags + title: Device User Tags + methods: + list_device_user_tags: + operation: + $ref: '#/paths/~1api~1v2~1ndm~1tags~1devices~1{device_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_device_user_tags: + operation: + $ref: '#/paths/~1api~1v2~1ndm~1tags~1devices~1{device_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/device_user_tags/methods/list_device_user_tags + insert: [] + update: + - $ref: >- + #/components/x-stackQL-resources/device_user_tags/methods/update_device_user_tags + delete: [] + replace: [] + aggregated_connections: + id: datadog.infrastructure.aggregated_connections + name: aggregated_connections + title: Aggregated Connections + methods: + get_aggregated_connections: + operation: + $ref: '#/paths/~1api~1v2~1network~1connections~1aggregate/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aggregated_connections/methods/get_aggregated_connections + insert: [] + update: [] + delete: [] + replace: [] + aggregated_dns: + id: datadog.infrastructure.aggregated_dns + name: aggregated_dns + title: Aggregated Dns + methods: + get_aggregated_dns: + operation: + $ref: '#/paths/~1api~1v2~1network~1dns~1aggregate/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aggregated_dns/methods/get_aggregated_dns + insert: [] + update: [] + delete: [] + replace: [] + processes: + id: datadog.infrastructure.processes + name: processes + title: Processes + methods: + list_processes: + operation: + $ref: '#/paths/~1api~1v2~1processes/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/processes/methods/list_processes' + insert: [] + update: [] + delete: [] + replace: [] + spa_recommendations: + id: datadog.infrastructure.spa_recommendations + name: spa_recommendations + title: Spa Recommendations + methods: + get_sparecommendations: + operation: + $ref: '#/paths/~1api~1v2~1spa~1recommendations~1{service}~1{shard}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/spa_recommendations/methods/get_sparecommendations + insert: [] + update: [] + delete: [] + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/integrations.yaml b/providers/src/datadog/v00.00.00000/services/integrations.yaml new file mode 100644 index 00000000..0559a172 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/integrations.yaml @@ -0,0 +1,5112 @@ +openapi: 3.0.0 +info: + title: integrations API + description: datadog integrations API + version: '1.0' +paths: + /api/v2/integration/aws/accounts: + get: + description: Get a list of AWS Account Integration Configs. + operationId: ListAWSAccounts + parameters: + - description: >- + Optional query parameter to filter accounts by AWS Account ID. If + not provided, all accounts are returned. + example: '123456789012' + in: query + name: aws_account_id + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AWSAccountsResponse' + description: AWS Accounts List object + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List all AWS integrations + tags: + - AWS Integration + x-permission: + operator: OR + permissions: + - aws_configuration_read + post: + description: Create a new AWS Account Integration Config. + operationId: CreateAWSAccount + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AWSAccountCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AWSAccountResponse' + description: AWS Account object + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create an AWS integration + tags: + - AWS Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - aws_configurations_manage + /api/v2/integration/aws/accounts/{aws_account_config_id}: + delete: + description: Delete an AWS Account Integration Config by config ID. + operationId: DeleteAWSAccount + parameters: + - $ref: '#/components/parameters/AWSAccountConfigIDPathParameter' + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete an AWS integration + tags: + - AWS Integration + x-permission: + operator: OR + permissions: + - aws_configurations_manage + get: + description: Get an AWS Account Integration Config by config ID. + operationId: GetAWSAccount + parameters: + - $ref: '#/components/parameters/AWSAccountConfigIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AWSAccountResponse' + description: AWS Account object + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get an AWS integration by config ID + tags: + - AWS Integration + x-permission: + operator: OR + permissions: + - aws_configuration_read + patch: + description: Update an AWS Account Integration Config by config ID. + operationId: UpdateAWSAccount + parameters: + - $ref: '#/components/parameters/AWSAccountConfigIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AWSAccountUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AWSAccountResponse' + description: AWS Account object + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update an AWS integration + tags: + - AWS Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - aws_configuration_edit + /api/v2/integration/aws/available_namespaces: + get: + description: >- + Get a list of available AWS CloudWatch namespaces that can send metrics + to Datadog. + operationId: ListAWSNamespaces + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AWSNamespacesResponse' + description: AWS Namespaces List object + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List available namespaces + tags: + - AWS Integration + x-permission: + operator: OR + permissions: + - aws_configuration_read + /api/v2/integration/aws/generate_new_external_id: + post: + description: Generate a new external ID for AWS role-based authentication. + operationId: CreateNewAWSExternalID + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AWSNewExternalIDResponse' + description: AWS External ID object + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Generate a new external ID + tags: + - AWS Integration + x-permission: + operator: OR + permissions: + - aws_configuration_edit + /api/v2/integration/aws/iam_permissions: + get: + description: Get all AWS IAM permissions required for the AWS integration. + operationId: GetAWSIntegrationIAMPermissions + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AWSIntegrationIamPermissionsResponse' + description: AWS IAM Permissions object + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get AWS integration IAM permissions + tags: + - AWS Integration + /api/v2/integration/aws/logs/services: + get: + description: Get a list of AWS services that can send logs to Datadog. + operationId: ListAWSLogsServices + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AWSLogsServicesResponse' + description: AWS Logs Services List object + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get list of AWS log ready services + tags: + - AWS Logs Integration + x-permission: + operator: OR + permissions: + - aws_configuration_read + /api/v2/integration/gcp/accounts: + get: + description: >- + List all GCP STS-enabled service accounts configured in your Datadog + account. + operationId: ListGCPSTSAccounts + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GCPSTSServiceAccountsResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List all GCP STS-enabled service accounts + tags: + - GCP Integration + x-permission: + operator: OR + permissions: + - gcp_configuration_read + post: + description: Create a new entry within Datadog for your STS enabled service account. + operationId: CreateGCPSTSAccount + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GCPSTSServiceAccountCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/GCPSTSServiceAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a new entry for your service account + tags: + - GCP Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - gcp_configurations_manage + /api/v2/integration/gcp/accounts/{account_id}: + delete: + description: Delete an STS enabled GCP account from within Datadog. + operationId: DeleteGCPSTSAccount + parameters: + - $ref: '#/components/parameters/GCPSTSServiceAccountID' + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete an STS enabled GCP Account + tags: + - GCP Integration + x-permission: + operator: OR + permissions: + - gcp_configurations_manage + patch: + description: Update an STS enabled service account. + operationId: UpdateGCPSTSAccount + parameters: + - $ref: '#/components/parameters/GCPSTSServiceAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/GCPSTSServiceAccountUpdateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/GCPSTSServiceAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update STS Service Account + tags: + - GCP Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - gcp_configuration_edit + /api/v2/integration/gcp/sts_delegate: + get: + description: >- + List your Datadog-GCP STS delegate account configured in your Datadog + account. + operationId: GetGCPSTSDelegate + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GCPSTSDelegateAccountResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List delegate account + tags: + - GCP Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - gcp_configuration_read + post: + description: Create a Datadog GCP principal. + operationId: MakeGCPSTSDelegate + requestBody: + content: + application/json: + schema: + example: {} + type: object + description: Create a delegate service account within Datadog. + required: false + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GCPSTSDelegateAccountResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a Datadog GCP principal + tags: + - GCP Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - gcp_configuration_edit + /api/v2/integration/ms-teams/configuration/channel/{tenant_name}/{team_name}/{channel_name}: + get: + description: >- + Get the tenant, team, and channel ID of a channel in the Datadog + Microsoft Teams integration. + operationId: GetChannelByName + parameters: + - $ref: '#/components/parameters/MicrosoftTeamsTenantNamePathParameter' + - $ref: '#/components/parameters/MicrosoftTeamsTeamNamePathParameter' + - $ref: '#/components/parameters/MicrosoftTeamsChannelNamePathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MicrosoftTeamsGetChannelByNameResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get channel information by name + tags: + - Microsoft Teams Integration + /api/v2/integration/ms-teams/configuration/tenant-based-handles: + get: + description: >- + Get a list of all tenant-based handles from the Datadog Microsoft Teams + integration. + operationId: ListTenantBasedHandles + parameters: + - $ref: '#/components/parameters/MicrosoftTeamsTenantIDQueryParameter' + - $ref: '#/components/parameters/MicrosoftTeamsHandleNameQueryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandlesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all tenant-based handles + tags: + - Microsoft Teams Integration + post: + description: Create a tenant-based handle in the Datadog Microsoft Teams integration. + operationId: CreateTenantBasedHandle + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/MicrosoftTeamsCreateTenantBasedHandleRequest + description: Tenant-based handle payload. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create tenant-based handle + tags: + - Microsoft Teams Integration + x-codegen-request-body-name: body + /api/v2/integration/ms-teams/configuration/tenant-based-handles/{handle_id}: + delete: + description: >- + Delete a tenant-based handle from the Datadog Microsoft Teams + integration. + operationId: DeleteTenantBasedHandle + parameters: + - $ref: >- + #/components/parameters/MicrosoftTeamsTenantBasedHandleIDPathParameter + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete tenant-based handle + tags: + - Microsoft Teams Integration + get: + description: >- + Get the tenant, team, and channel information of a tenant-based handle + from the Datadog Microsoft Teams integration. + operationId: GetTenantBasedHandle + parameters: + - $ref: >- + #/components/parameters/MicrosoftTeamsTenantBasedHandleIDPathParameter + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get tenant-based handle information + tags: + - Microsoft Teams Integration + patch: + description: >- + Update a tenant-based handle from the Datadog Microsoft Teams + integration. + operationId: UpdateTenantBasedHandle + parameters: + - $ref: >- + #/components/parameters/MicrosoftTeamsTenantBasedHandleIDPathParameter + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/MicrosoftTeamsUpdateTenantBasedHandleRequest + description: Tenant-based handle payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update tenant-based handle + tags: + - Microsoft Teams Integration + x-codegen-request-body-name: body + /api/v2/integration/ms-teams/configuration/workflows-webhook-handles: + get: + description: >- + Get a list of all Workflows webhook handles from the Datadog Microsoft + Teams integration. + operationId: ListWorkflowsWebhookHandles + parameters: + - $ref: >- + #/components/parameters/MicrosoftTeamsWorkflowsWebhookHandleNameQueryParameter + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/MicrosoftTeamsWorkflowsWebhookHandlesResponse + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all Workflows webhook handles + tags: + - Microsoft Teams Integration + post: + description: >- + Create a Workflows webhook handle in the Datadog Microsoft Teams + integration. + operationId: CreateWorkflowsWebhookHandle + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/MicrosoftTeamsCreateWorkflowsWebhookHandleRequest + description: Workflows Webhook handle payload. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: >- + #/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleResponse + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create Workflows webhook handle + tags: + - Microsoft Teams Integration + x-codegen-request-body-name: body + /api/v2/integration/ms-teams/configuration/workflows-webhook-handles/{handle_id}: + delete: + description: >- + Delete a Workflows webhook handle from the Datadog Microsoft Teams + integration. + operationId: DeleteWorkflowsWebhookHandle + parameters: + - $ref: >- + #/components/parameters/MicrosoftTeamsWorkflowsWebhookHandleIDPathParameter + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Workflows webhook handle + tags: + - Microsoft Teams Integration + get: + description: >- + Get the name of a Workflows webhook handle from the Datadog Microsoft + Teams integration. + operationId: GetWorkflowsWebhookHandle + parameters: + - $ref: >- + #/components/parameters/MicrosoftTeamsWorkflowsWebhookHandleIDPathParameter + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleResponse + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get Workflows webhook handle information + tags: + - Microsoft Teams Integration + patch: + description: >- + Update a Workflows webhook handle from the Datadog Microsoft Teams + integration. + operationId: UpdateWorkflowsWebhookHandle + parameters: + - $ref: >- + #/components/parameters/MicrosoftTeamsWorkflowsWebhookHandleIDPathParameter + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/MicrosoftTeamsUpdateWorkflowsWebhookHandleRequest + description: Workflows Webhook handle payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleResponse + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '412': + $ref: '#/components/responses/PreconditionFailedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update Workflows webhook handle + tags: + - Microsoft Teams Integration + x-codegen-request-body-name: body + /api/v2/integration/opsgenie/services: + get: + description: Get a list of all services from the Datadog Opsgenie integration. + operationId: ListOpsgenieServices + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OpsgenieServicesResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all service objects + tags: + - Opsgenie Integration + x-permission: + operator: OR + permissions: + - integrations_read + post: + description: Create a new service object in the Opsgenie integration. + operationId: CreateOpsgenieService + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OpsgenieServiceCreateRequest' + description: Opsgenie service payload + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/OpsgenieServiceResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a new service object + tags: + - Opsgenie Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integration/opsgenie/services/{integration_service_id}: + delete: + description: Delete a single service object in the Datadog Opsgenie integration. + operationId: DeleteOpsgenieService + parameters: + - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a single service object + tags: + - Opsgenie Integration + x-permission: + operator: OR + permissions: + - manage_integrations + get: + description: Get a single service from the Datadog Opsgenie integration. + operationId: GetOpsgenieService + parameters: + - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OpsgenieServiceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a single service object + tags: + - Opsgenie Integration + x-permission: + operator: OR + permissions: + - integrations_read + patch: + description: Update a single service object in the Datadog Opsgenie integration. + operationId: UpdateOpsgenieService + parameters: + - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OpsgenieServiceUpdateRequest' + description: Opsgenie service payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OpsgenieServiceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a single service object + tags: + - Opsgenie Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/cloudflare/accounts: + get: + description: List Cloudflare accounts. + operationId: ListCloudflareAccounts + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudflareAccountsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Cloudflare accounts + tags: + - Cloudflare Integration + x-permission: + operator: OR + permissions: + - integrations_read + post: + description: Create a Cloudflare account. + operationId: CreateCloudflareAccount + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CloudflareAccountCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudflareAccountResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Add Cloudflare account + tags: + - Cloudflare Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/cloudflare/accounts/{account_id}: + delete: + description: Delete a Cloudflare account. + operationId: DeleteCloudflareAccount + parameters: + - description: None + in: path + name: account_id + required: true + schema: + type: string + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Cloudflare account + tags: + - Cloudflare Integration + x-permission: + operator: OR + permissions: + - manage_integrations + get: + description: Get a Cloudflare account. + operationId: GetCloudflareAccount + parameters: + - description: None + in: path + name: account_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudflareAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get Cloudflare account + tags: + - Cloudflare Integration + x-permission: + operator: OR + permissions: + - integrations_read + patch: + description: Update a Cloudflare account. + operationId: UpdateCloudflareAccount + parameters: + - description: None + in: path + name: account_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CloudflareAccountUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudflareAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update Cloudflare account + tags: + - Cloudflare Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/confluent-cloud/accounts: + get: + description: List Confluent accounts. + operationId: ListConfluentAccount + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentAccountsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Confluent accounts + tags: + - Confluent Cloud + x-permission: + operator: OR + permissions: + - integrations_read + post: + description: Create a Confluent account. + operationId: CreateConfluentAccount + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentAccountCreateRequest' + description: Confluent payload + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Add Confluent account + tags: + - Confluent Cloud + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/confluent-cloud/accounts/{account_id}: + delete: + description: Delete a Confluent account with the provided account ID. + operationId: DeleteConfluentAccount + parameters: + - $ref: '#/components/parameters/ConfluentAccountID' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Confluent account + tags: + - Confluent Cloud + x-permission: + operator: OR + permissions: + - manage_integrations + get: + description: Get the Confluent account with the provided account ID. + operationId: GetConfluentAccount + parameters: + - $ref: '#/components/parameters/ConfluentAccountID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get Confluent account + tags: + - Confluent Cloud + x-permission: + operator: OR + permissions: + - integrations_read + patch: + description: Update the Confluent account with the provided account ID. + operationId: UpdateConfluentAccount + parameters: + - $ref: '#/components/parameters/ConfluentAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentAccountUpdateRequest' + description: Confluent payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update Confluent account + tags: + - Confluent Cloud + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/confluent-cloud/accounts/{account_id}/resources: + get: + description: >- + Get a Confluent resource for the account associated with the provided + ID. + operationId: ListConfluentResource + parameters: + - $ref: '#/components/parameters/ConfluentAccountID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentResourcesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Confluent Account resources + tags: + - Confluent Cloud + x-permission: + operator: OR + permissions: + - integrations_read + post: + description: >- + Create a Confluent resource for the account associated with the provided + ID. + operationId: CreateConfluentResource + parameters: + - $ref: '#/components/parameters/ConfluentAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentResourceRequest' + description: Confluent payload + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentResourceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Add resource to Confluent account + tags: + - Confluent Cloud + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/confluent-cloud/accounts/{account_id}/resources/{resource_id}: + delete: + description: >- + Delete a Confluent resource with the provided resource id for the + account associated with the provided account ID. + operationId: DeleteConfluentResource + parameters: + - $ref: '#/components/parameters/ConfluentAccountID' + - $ref: '#/components/parameters/ConfluentResourceID' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete resource from Confluent account + tags: + - Confluent Cloud + x-permission: + operator: OR + permissions: + - manage_integrations + get: + description: >- + Get a Confluent resource with the provided resource id for the account + associated with the provided account ID. + operationId: GetConfluentResource + parameters: + - $ref: '#/components/parameters/ConfluentAccountID' + - $ref: '#/components/parameters/ConfluentResourceID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentResourceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get resource from Confluent account + tags: + - Confluent Cloud + x-permission: + operator: OR + permissions: + - integrations_read + patch: + description: >- + Update a Confluent resource with the provided resource id for the + account associated with the provided account ID. + operationId: UpdateConfluentResource + parameters: + - $ref: '#/components/parameters/ConfluentAccountID' + - $ref: '#/components/parameters/ConfluentResourceID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentResourceRequest' + description: Confluent payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ConfluentResourceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update resource in Confluent account + tags: + - Confluent Cloud + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/fastly/accounts: + get: + description: List Fastly accounts. + operationId: ListFastlyAccounts + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyAccountsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Fastly accounts + tags: + - Fastly Integration + x-permission: + operator: OR + permissions: + - integrations_read + post: + description: Create a Fastly account. + operationId: CreateFastlyAccount + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyAccountCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyAccountResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Add Fastly account + tags: + - Fastly Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/fastly/accounts/{account_id}: + delete: + description: Delete a Fastly account. + operationId: DeleteFastlyAccount + parameters: + - $ref: '#/components/parameters/FastlyAccountID' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Fastly account + tags: + - Fastly Integration + x-permission: + operator: OR + permissions: + - manage_integrations + get: + description: Get a Fastly account. + operationId: GetFastlyAccount + parameters: + - $ref: '#/components/parameters/FastlyAccountID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get Fastly account + tags: + - Fastly Integration + x-permission: + operator: OR + permissions: + - integrations_read + patch: + description: Update a Fastly account. + operationId: UpdateFastlyAccount + parameters: + - $ref: '#/components/parameters/FastlyAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyAccountUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update Fastly account + tags: + - Fastly Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/fastly/accounts/{account_id}/services: + get: + description: List Fastly services for an account. + operationId: ListFastlyServices + parameters: + - $ref: '#/components/parameters/FastlyAccountID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyServicesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Fastly services + tags: + - Fastly Integration + x-permission: + operator: OR + permissions: + - integrations_read + post: + description: Create a Fastly service for an account. + operationId: CreateFastlyService + parameters: + - $ref: '#/components/parameters/FastlyAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyServiceRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyServiceResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Add Fastly service + tags: + - Fastly Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/fastly/accounts/{account_id}/services/{service_id}: + delete: + description: Delete a Fastly service for an account. + operationId: DeleteFastlyService + parameters: + - $ref: '#/components/parameters/FastlyAccountID' + - $ref: '#/components/parameters/FastlyServiceID' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Fastly service + tags: + - Fastly Integration + x-permission: + operator: OR + permissions: + - manage_integrations + get: + description: Get a Fastly service for an account. + operationId: GetFastlyService + parameters: + - $ref: '#/components/parameters/FastlyAccountID' + - $ref: '#/components/parameters/FastlyServiceID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyServiceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get Fastly service + tags: + - Fastly Integration + x-permission: + operator: OR + permissions: + - integrations_read + patch: + description: Update a Fastly service for an account. + operationId: UpdateFastlyService + parameters: + - $ref: '#/components/parameters/FastlyAccountID' + - $ref: '#/components/parameters/FastlyServiceID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyServiceRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/FastlyServiceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update Fastly service + tags: + - Fastly Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/okta/accounts: + get: + description: List Okta accounts. + operationId: ListOktaAccounts + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OktaAccountsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Okta accounts + tags: + - Okta Integration + x-permission: + operator: OR + permissions: + - integrations_read + post: + description: Create an Okta account. + operationId: CreateOktaAccount + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OktaAccountRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/OktaAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Add Okta account + tags: + - Okta Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations + /api/v2/integrations/okta/accounts/{account_id}: + delete: + description: Delete an Okta account. + operationId: DeleteOktaAccount + parameters: + - description: None + in: path + name: account_id + required: true + schema: + type: string + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Okta account + tags: + - Okta Integration + x-permission: + operator: OR + permissions: + - manage_integrations + get: + description: Get an Okta account. + operationId: GetOktaAccount + parameters: + - description: None + in: path + name: account_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OktaAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get Okta account + tags: + - Okta Integration + x-permission: + operator: OR + permissions: + - integrations_read + patch: + description: Update an Okta account. + operationId: UpdateOktaAccount + parameters: + - description: None + in: path + name: account_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OktaAccountUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OktaAccountResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update Okta account + tags: + - Okta Integration + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - manage_integrations +components: + schemas: + AWSAccountsResponse: + description: AWS Accounts response body. + properties: + data: + description: List of AWS Account Integration Configs. + items: + $ref: '#/components/schemas/AWSAccountResponseData' + type: array + required: + - data + type: object + AWSAccountCreateRequest: + description: AWS Account Create Request body. + properties: + data: + $ref: '#/components/schemas/AWSAccountCreateRequestData' + required: + - data + type: object + AWSAccountResponse: + description: AWS Account response body. + properties: + data: + $ref: '#/components/schemas/AWSAccountResponseData' + required: + - data + type: object + AWSAccountUpdateRequest: + description: AWS Account Update Request body. + properties: + data: + $ref: '#/components/schemas/AWSAccountUpdateRequestData' + required: + - data + type: object + AWSNamespacesResponse: + description: AWS Namespaces response body. + properties: + data: + $ref: '#/components/schemas/AWSNamespacesResponseData' + required: + - data + type: object + AWSNewExternalIDResponse: + description: AWS External ID response body. + properties: + data: + $ref: '#/components/schemas/AWSNewExternalIDResponseData' + required: + - data + type: object + AWSIntegrationIamPermissionsResponse: + description: AWS Integration IAM Permissions response body. + properties: + data: + $ref: '#/components/schemas/AWSIntegrationIamPermissionsResponseData' + required: + - data + type: object + AWSLogsServicesResponse: + description: AWS Logs Services response body + properties: + data: + $ref: '#/components/schemas/AWSLogsServicesResponseData' + required: + - data + type: object + GCPSTSServiceAccountsResponse: + description: Object containing all your STS enabled accounts. + properties: + data: + description: Array of GCP STS enabled service accounts. + items: + $ref: '#/components/schemas/GCPSTSServiceAccount' + type: array + type: object + GCPSTSServiceAccountCreateRequest: + description: Data on your newly generated service account. + properties: + data: + $ref: '#/components/schemas/GCPSTSServiceAccountData' + type: object + GCPSTSServiceAccountResponse: + description: The account creation response. + properties: + data: + $ref: '#/components/schemas/GCPSTSServiceAccount' + type: object + GCPSTSServiceAccountUpdateRequest: + description: Service account info. + properties: + data: + $ref: '#/components/schemas/GCPSTSServiceAccountUpdateRequestData' + type: object + GCPSTSDelegateAccountResponse: + description: Your delegate service account response data. + properties: + data: + $ref: '#/components/schemas/GCPSTSDelegateAccount' + type: object + MicrosoftTeamsGetChannelByNameResponse: + description: Response with channel, team, and tenant ID information. + properties: + data: + $ref: '#/components/schemas/MicrosoftTeamsChannelInfoResponseData' + type: object + MicrosoftTeamsTenantBasedHandlesResponse: + description: Response with a list of tenant-based handles. + properties: + data: + description: An array of tenant-based handles. + example: + - attributes: + channelId: 19:b41k24b14bn1nwffkernfkwrnfneubgkr@thread.tacv2 + channelName: General + name: general-handle + teamId: 00000000-0000-0000-0000-000000000000 + teamName: Example Team + tenantId: 00000000-0000-0000-0000-000000000001 + tenantName: Company, Inc. + id: 596da4af-0563-4097-90ff-07230c3f9db3 + type: ms-teams-tenant-based-handle-info + - attributes: + channelId: 19:b41k24b14bn1nwffkernfkwrnfneubgk1@thread.tacv2 + channelName: General2 + name: general-handle-2 + teamId: 00000000-0000-0000-0000-000000000002 + teamName: Example Team 2 + tenantId: 00000000-0000-0000-0000-000000000003 + tenantName: Company, Inc. + id: 596da4af-0563-4097-90ff-07230c3f9db4 + type: ms-teams-tenant-based-handle-info + items: + $ref: >- + #/components/schemas/MicrosoftTeamsTenantBasedHandleInfoResponseData + type: array + required: + - data + type: object + MicrosoftTeamsCreateTenantBasedHandleRequest: + description: Create tenant-based handle request. + properties: + data: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleRequestData' + required: + - data + type: object + MicrosoftTeamsTenantBasedHandleResponse: + description: Response of a tenant-based handle. + properties: + data: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleResponseData' + required: + - data + type: object + MicrosoftTeamsUpdateTenantBasedHandleRequest: + description: Update tenant-based handle request. + properties: + data: + $ref: >- + #/components/schemas/MicrosoftTeamsUpdateTenantBasedHandleRequestData + required: + - data + type: object + MicrosoftTeamsWorkflowsWebhookHandlesResponse: + description: Response with a list of Workflows webhook handles. + properties: + data: + description: An array of Workflows webhook handles. + example: + - attributes: + name: general-handle + id: 596da4af-0563-4097-90ff-07230c3f9db3 + type: workflows-webhook-handle + - attributes: + name: general-handle-2 + id: 596da4af-0563-4097-90ff-07230c3f9db4 + type: workflows-webhook-handle + items: + $ref: >- + #/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleResponseData + type: array + required: + - data + type: object + MicrosoftTeamsCreateWorkflowsWebhookHandleRequest: + description: Create Workflows webhook handle request. + properties: + data: + $ref: '#/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleRequestData' + required: + - data + type: object + MicrosoftTeamsWorkflowsWebhookHandleResponse: + description: Response of a Workflows webhook handle. + properties: + data: + $ref: >- + #/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleResponseData + required: + - data + type: object + MicrosoftTeamsUpdateWorkflowsWebhookHandleRequest: + description: Update Workflows webhook handle request. + properties: + data: + $ref: >- + #/components/schemas/MicrosoftTeamsUpdateWorkflowsWebhookHandleRequestData + required: + - data + type: object + OpsgenieServicesResponse: + description: Response with a list of Opsgenie services. + properties: + data: + description: An array of Opsgenie services. + example: + - attributes: + custom_url: null + name: fake-opsgenie-service-name + region: us + id: 596da4af-0563-4097-90ff-07230c3f9db3 + type: opsgenie-service + - attributes: + custom_url: null + name: fake-opsgenie-service-name-2 + region: eu + id: 0d2937f1-b561-44fa-914a-99910f848014 + type: opsgenie-service + items: + $ref: '#/components/schemas/OpsgenieServiceResponseData' + type: array + required: + - data + type: object + OpsgenieServiceCreateRequest: + description: Create request for an Opsgenie service. + properties: + data: + $ref: '#/components/schemas/OpsgenieServiceCreateData' + required: + - data + type: object + OpsgenieServiceResponse: + description: Response of an Opsgenie service. + properties: + data: + $ref: '#/components/schemas/OpsgenieServiceResponseData' + required: + - data + type: object + OpsgenieServiceUpdateRequest: + description: Update request for an Opsgenie service. + properties: + data: + $ref: '#/components/schemas/OpsgenieServiceUpdateData' + required: + - data + type: object + CloudflareAccountsResponse: + description: The expected response schema when getting Cloudflare accounts. + properties: + data: + description: The JSON:API data schema. + items: + $ref: '#/components/schemas/CloudflareAccountResponseData' + type: array + type: object + CloudflareAccountCreateRequest: + description: Payload schema when adding a Cloudflare account. + properties: + data: + $ref: '#/components/schemas/CloudflareAccountCreateRequestData' + required: + - data + type: object + CloudflareAccountResponse: + description: The expected response schema when getting a Cloudflare account. + properties: + data: + $ref: '#/components/schemas/CloudflareAccountResponseData' + type: object + CloudflareAccountUpdateRequest: + description: Payload schema when updating a Cloudflare account. + properties: + data: + $ref: '#/components/schemas/CloudflareAccountUpdateRequestData' + required: + - data + type: object + ConfluentAccountsResponse: + description: Confluent account returned by the API. + properties: + data: + description: The Confluent account. + items: + $ref: '#/components/schemas/ConfluentAccountResponseData' + type: array + type: object + ConfluentAccountCreateRequest: + description: Payload schema when adding a Confluent account. + properties: + data: + $ref: '#/components/schemas/ConfluentAccountCreateRequestData' + required: + - data + type: object + ConfluentAccountResponse: + description: The expected response schema when getting a Confluent account. + properties: + data: + $ref: '#/components/schemas/ConfluentAccountResponseData' + type: object + ConfluentAccountUpdateRequest: + description: The JSON:API request for updating a Confluent account. + properties: + data: + $ref: '#/components/schemas/ConfluentAccountUpdateRequestData' + required: + - data + type: object + ConfluentResourcesResponse: + description: Response schema when interacting with a list of Confluent resources. + properties: + data: + description: The JSON:API data attribute. + items: + $ref: '#/components/schemas/ConfluentResourceResponseData' + type: array + type: object + ConfluentResourceRequest: + description: The JSON:API request for updating a Confluent resource. + properties: + data: + $ref: '#/components/schemas/ConfluentResourceRequestData' + required: + - data + type: object + ConfluentResourceResponse: + description: Response schema when interacting with a Confluent resource. + properties: + data: + $ref: '#/components/schemas/ConfluentResourceResponseData' + type: object + FastlyAccountsResponse: + description: The expected response schema when getting Fastly accounts. + properties: + data: + description: The JSON:API data schema. + items: + $ref: '#/components/schemas/FastlyAccountResponseData' + type: array + type: object + FastlyAccountCreateRequest: + description: Payload schema when adding a Fastly account. + properties: + data: + $ref: '#/components/schemas/FastlyAccountCreateRequestData' + required: + - data + type: object + FastlyAccountResponse: + description: The expected response schema when getting a Fastly account. + properties: + data: + $ref: '#/components/schemas/FastlyAccountResponseData' + type: object + FastlyAccountUpdateRequest: + description: Payload schema when updating a Fastly account. + properties: + data: + $ref: '#/components/schemas/FastlyAccountUpdateRequestData' + required: + - data + type: object + FastlyServicesResponse: + description: The expected response schema when getting Fastly services. + properties: + data: + description: The JSON:API data schema. + items: + $ref: '#/components/schemas/FastlyServiceData' + type: array + type: object + FastlyServiceRequest: + description: Payload schema for Fastly service requests. + properties: + data: + $ref: '#/components/schemas/FastlyServiceData' + required: + - data + type: object + FastlyServiceResponse: + description: The expected response schema when getting a Fastly service. + properties: + data: + $ref: '#/components/schemas/FastlyServiceData' + type: object + OktaAccountsResponse: + description: The expected response schema when getting Okta accounts. + properties: + data: + description: List of Okta accounts. + items: + $ref: '#/components/schemas/OktaAccountResponseData' + type: array + type: object + OktaAccountRequest: + description: Request object for an Okta account. + properties: + data: + $ref: '#/components/schemas/OktaAccount' + required: + - data + type: object + OktaAccountResponse: + description: Response object for an Okta account. + properties: + data: + $ref: '#/components/schemas/OktaAccount' + type: object + OktaAccountUpdateRequest: + description: Payload schema when updating an Okta account. + properties: + data: + $ref: '#/components/schemas/OktaAccountUpdateRequestData' + required: + - data + type: object + AWSAccountResponseData: + description: AWS Account response data. + properties: + attributes: + $ref: '#/components/schemas/AWSAccountResponseAttributes' + id: + $ref: '#/components/schemas/AWSAccountConfigID' + type: + $ref: '#/components/schemas/AWSAccountType' + required: + - id + - type + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + AWSAccountCreateRequestData: + description: AWS Account Create Request data. + properties: + attributes: + $ref: '#/components/schemas/AWSAccountCreateRequestAttributes' + type: + $ref: '#/components/schemas/AWSAccountType' + required: + - attributes + - type + type: object + AWSAccountUpdateRequestData: + description: AWS Account Update Request data. + properties: + attributes: + $ref: '#/components/schemas/AWSAccountUpdateRequestAttributes' + id: + $ref: '#/components/schemas/AWSAccountConfigID' + type: + $ref: '#/components/schemas/AWSAccountType' + required: + - attributes + - type + type: object + AWSNamespacesResponseData: + description: AWS Namespaces response data. + properties: + attributes: + $ref: '#/components/schemas/AWSNamespacesResponseAttributes' + id: + default: namespaces + description: The `AWSNamespacesResponseData` `id`. + example: namespaces + type: string + type: + $ref: '#/components/schemas/AWSNamespacesResponseDataType' + required: + - id + - type + type: object + AWSNewExternalIDResponseData: + description: AWS External ID response body. + properties: + attributes: + $ref: '#/components/schemas/AWSNewExternalIDResponseAttributes' + id: + default: external_id + description: The `AWSNewExternalIDResponseData` `id`. + example: external_id + type: string + type: + $ref: '#/components/schemas/AWSNewExternalIDResponseDataType' + required: + - id + - type + type: object + AWSIntegrationIamPermissionsResponseData: + description: AWS Integration IAM Permissions response data. + properties: + attributes: + $ref: '#/components/schemas/AWSIntegrationIamPermissionsResponseAttributes' + id: + default: permissions + description: The `AWSIntegrationIamPermissionsResponseData` `id`. + example: permissions + type: string + type: + $ref: '#/components/schemas/AWSIntegrationIamPermissionsResponseDataType' + type: object + AWSLogsServicesResponseData: + description: AWS Logs Services response body + properties: + attributes: + $ref: '#/components/schemas/AWSLogsServicesResponseAttributes' + id: + default: logs_services + description: The `AWSLogsServicesResponseData` `id`. + example: logs_services + type: string + type: + $ref: '#/components/schemas/AWSLogsServicesResponseDataType' + required: + - id + - type + type: object + GCPSTSServiceAccount: + description: Info on your service account. + properties: + attributes: + $ref: '#/components/schemas/GCPSTSServiceAccountAttributes' + id: + description: Your service account's unique ID. + example: d291291f-12c2-22g4-j290-123456678897 + type: string + meta: + $ref: '#/components/schemas/GCPServiceAccountMeta' + type: + $ref: '#/components/schemas/GCPServiceAccountType' + type: object + GCPSTSServiceAccountData: + description: Additional metadata on your generated service account. + properties: + attributes: + $ref: '#/components/schemas/GCPSTSServiceAccountAttributes' + type: + $ref: '#/components/schemas/GCPServiceAccountType' + type: object + GCPSTSServiceAccountUpdateRequestData: + description: Data on your service account. + properties: + attributes: + $ref: '#/components/schemas/GCPSTSServiceAccountAttributes' + id: + description: Your service account's unique ID. + example: d291291f-12c2-22g4-j290-123456678897 + type: string + type: + $ref: '#/components/schemas/GCPServiceAccountType' + type: object + GCPSTSDelegateAccount: + description: Datadog principal service account info. + properties: + attributes: + $ref: '#/components/schemas/GCPSTSDelegateAccountAttributes' + id: + description: The ID of the delegate service account. + example: >- + ddgci-1a19n28hb1a812221893@datadog-gci-sts-us5-prod.iam.gserviceaccount.com + type: string + type: + $ref: '#/components/schemas/GCPSTSDelegateAccountType' + type: object + MicrosoftTeamsChannelInfoResponseData: + description: Channel data from a response. + properties: + attributes: + $ref: '#/components/schemas/MicrosoftTeamsChannelInfoResponseAttributes' + id: + description: The ID of the channel. + example: 19:b41k24b14bn1nwffkernfkwrnfneubgkr@thread.tacv2 + maxLength: 255 + minLength: 1 + type: string + type: + $ref: '#/components/schemas/MicrosoftTeamsChannelInfoType' + type: object + MicrosoftTeamsTenantBasedHandleInfoResponseData: + description: Tenant-based handle data from a response. + properties: + attributes: + $ref: >- + #/components/schemas/MicrosoftTeamsTenantBasedHandleInfoResponseAttributes + id: + description: The ID of the tenant-based handle. + example: 596da4af-0563-4097-90ff-07230c3f9db3 + maxLength: 100 + minLength: 1 + type: string + type: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleInfoType' + type: object + MicrosoftTeamsTenantBasedHandleRequestData: + description: Tenant-based handle data from a response. + properties: + attributes: + $ref: >- + #/components/schemas/MicrosoftTeamsTenantBasedHandleRequestAttributes + type: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleType' + required: + - type + - attributes + type: object + MicrosoftTeamsTenantBasedHandleResponseData: + description: Tenant-based handle data from a response. + properties: + attributes: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleAttributes' + id: + description: The ID of the tenant-based handle. + example: 596da4af-0563-4097-90ff-07230c3f9db3 + maxLength: 100 + minLength: 1 + type: string + type: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleType' + type: object + MicrosoftTeamsUpdateTenantBasedHandleRequestData: + description: Tenant-based handle data from a response. + properties: + attributes: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleAttributes' + type: + $ref: '#/components/schemas/MicrosoftTeamsTenantBasedHandleType' + required: + - type + - attributes + type: object + MicrosoftTeamsWorkflowsWebhookHandleResponseData: + description: Workflows Webhook handle data from a response. + properties: + attributes: + $ref: >- + #/components/schemas/MicrosoftTeamsWorkflowsWebhookResponseAttributes + id: + description: The ID of the Workflows webhook handle. + example: 596da4af-0563-4097-90ff-07230c3f9db3 + maxLength: 100 + minLength: 1 + type: string + type: + $ref: '#/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleType' + type: object + MicrosoftTeamsWorkflowsWebhookHandleRequestData: + description: Workflows Webhook handle data from a response. + properties: + attributes: + $ref: >- + #/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleRequestAttributes + type: + $ref: '#/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleType' + required: + - type + - attributes + type: object + MicrosoftTeamsUpdateWorkflowsWebhookHandleRequestData: + description: Workflows Webhook handle data from a response. + properties: + attributes: + $ref: '#/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleAttributes' + type: + $ref: '#/components/schemas/MicrosoftTeamsWorkflowsWebhookHandleType' + required: + - type + - attributes + type: object + OpsgenieServiceResponseData: + description: Opsgenie service data from a response. + properties: + attributes: + $ref: '#/components/schemas/OpsgenieServiceResponseAttributes' + id: + description: The ID of the Opsgenie service. + example: 596da4af-0563-4097-90ff-07230c3f9db3 + maxLength: 100 + minLength: 1 + type: string + type: + $ref: '#/components/schemas/OpsgenieServiceType' + required: + - id + - type + - attributes + type: object + OpsgenieServiceCreateData: + description: Opsgenie service data for a create request. + properties: + attributes: + $ref: '#/components/schemas/OpsgenieServiceCreateAttributes' + type: + $ref: '#/components/schemas/OpsgenieServiceType' + required: + - type + - attributes + type: object + OpsgenieServiceUpdateData: + description: Opsgenie service for an update request. + properties: + attributes: + $ref: '#/components/schemas/OpsgenieServiceUpdateAttributes' + id: + description: The ID of the Opsgenie service. + example: 596da4af-0563-4097-90ff-07230c3f9db3 + maxLength: 100 + minLength: 1 + type: string + type: + $ref: '#/components/schemas/OpsgenieServiceType' + required: + - id + - type + - attributes + type: object + CloudflareAccountResponseData: + description: Data object of a Cloudflare account. + properties: + attributes: + $ref: '#/components/schemas/CloudflareAccountResponseAttributes' + id: + description: The ID of the Cloudflare account, a hash of the account name. + example: c1a8e059bfd1e911cf10b626340c9a54 + type: string + type: + $ref: '#/components/schemas/CloudflareAccountType' + required: + - attributes + - id + - type + type: object + CloudflareAccountCreateRequestData: + description: Data object for creating a Cloudflare account. + properties: + attributes: + $ref: '#/components/schemas/CloudflareAccountCreateRequestAttributes' + type: + $ref: '#/components/schemas/CloudflareAccountType' + required: + - attributes + - type + type: object + CloudflareAccountUpdateRequestData: + description: Data object for updating a Cloudflare account. + properties: + attributes: + $ref: '#/components/schemas/CloudflareAccountUpdateRequestAttributes' + type: + $ref: '#/components/schemas/CloudflareAccountType' + type: object + ConfluentAccountResponseData: + description: An API key and API secret pair that represents a Confluent account. + properties: + attributes: + $ref: '#/components/schemas/ConfluentAccountResponseAttributes' + id: + description: A randomly generated ID associated with a Confluent account. + example: account_id_abc123 + type: string + type: + $ref: '#/components/schemas/ConfluentAccountType' + required: + - attributes + - id + - type + type: object + ConfluentAccountCreateRequestData: + description: The data body for adding a Confluent account. + properties: + attributes: + $ref: '#/components/schemas/ConfluentAccountCreateRequestAttributes' + type: + $ref: '#/components/schemas/ConfluentAccountType' + required: + - attributes + - type + type: object + ConfluentAccountUpdateRequestData: + description: Data object for updating a Confluent account. + properties: + attributes: + $ref: '#/components/schemas/ConfluentAccountUpdateRequestAttributes' + type: + $ref: '#/components/schemas/ConfluentAccountType' + required: + - attributes + - type + type: object + ConfluentResourceResponseData: + description: Confluent Cloud resource data. + properties: + attributes: + $ref: '#/components/schemas/ConfluentResourceResponseAttributes' + id: + description: The ID associated with the Confluent resource. + example: resource_id_abc123 + type: string + type: + $ref: '#/components/schemas/ConfluentResourceType' + required: + - attributes + - type + - id + type: object + ConfluentResourceRequestData: + description: JSON:API request for updating a Confluent resource. + properties: + attributes: + $ref: '#/components/schemas/ConfluentResourceRequestAttributes' + id: + description: The ID associated with a Confluent resource. + example: resource-id-123 + type: string + type: + $ref: '#/components/schemas/ConfluentResourceType' + required: + - attributes + - type + - id + type: object + FastlyAccountResponseData: + description: Data object of a Fastly account. + properties: + attributes: + $ref: '#/components/schemas/FastlyAccounResponseAttributes' + id: + description: The ID of the Fastly account, a hash of the account name. + example: abc123 + type: string + type: + $ref: '#/components/schemas/FastlyAccountType' + required: + - attributes + - id + - type + type: object + FastlyAccountCreateRequestData: + description: Data object for creating a Fastly account. + properties: + attributes: + $ref: '#/components/schemas/FastlyAccountCreateRequestAttributes' + type: + $ref: '#/components/schemas/FastlyAccountType' + required: + - attributes + - type + type: object + FastlyAccountUpdateRequestData: + description: Data object for updating a Fastly account. + properties: + attributes: + $ref: '#/components/schemas/FastlyAccountUpdateRequestAttributes' + type: + $ref: '#/components/schemas/FastlyAccountType' + type: object + FastlyServiceData: + description: Data object for Fastly service requests. + properties: + attributes: + $ref: '#/components/schemas/FastlyServiceAttributes' + id: + description: The ID of the Fastly service. + example: abc123 + type: string + type: + $ref: '#/components/schemas/FastlyServiceType' + required: + - id + - type + type: object + OktaAccountResponseData: + description: Data object of an Okta account + properties: + attributes: + $ref: '#/components/schemas/OktaAccountAttributes' + id: + description: The ID of the Okta account, a UUID hash of the account name. + example: f749daaf-682e-4208-a38d-c9b43162c609 + type: string + type: + $ref: '#/components/schemas/OktaAccountType' + required: + - attributes + - id + - type + type: object + OktaAccount: + description: Schema for an Okta account. + properties: + attributes: + $ref: '#/components/schemas/OktaAccountAttributes' + id: + description: The ID of the Okta account, a UUID hash of the account name. + example: f749daaf-682e-4208-a38d-c9b43162c609 + type: string + type: + $ref: '#/components/schemas/OktaAccountType' + required: + - attributes + - type + type: object + OktaAccountUpdateRequestData: + description: Data object for updating an Okta account. + properties: + attributes: + $ref: '#/components/schemas/OktaAccountUpdateRequestAttributes' + type: + $ref: '#/components/schemas/OktaAccountType' + type: object + AWSAccountResponseAttributes: + description: AWS Account response attributes. + properties: + account_tags: + $ref: '#/components/schemas/AWSAccountTags' + auth_config: + $ref: '#/components/schemas/AWSAuthConfig' + aws_account_id: + $ref: '#/components/schemas/AWSAccountID' + aws_partition: + $ref: '#/components/schemas/AWSAccountPartition' + aws_regions: + $ref: '#/components/schemas/AWSRegions' + created_at: + description: Timestamp of when the account integration was created. + format: date-time + readOnly: true + type: string + logs_config: + $ref: '#/components/schemas/AWSLogsConfig' + metrics_config: + $ref: '#/components/schemas/AWSMetricsConfig' + modified_at: + description: Timestamp of when the account integration was updated. + format: date-time + readOnly: true + type: string + resources_config: + $ref: '#/components/schemas/AWSResourcesConfig' + traces_config: + $ref: '#/components/schemas/AWSTracesConfig' + required: + - aws_account_id + type: object + AWSAccountConfigID: + description: >- + Unique Datadog ID of the AWS Account Integration Config. + + To get the config ID for an account, use the [List all AWS + integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations) + + endpoint and query by AWS Account ID. + example: 00000000-abcd-0001-0000-000000000000 + type: string + AWSAccountType: + default: account + description: AWS Account resource type. + enum: + - account + example: account + type: string + x-enum-varnames: + - ACCOUNT + AWSAccountCreateRequestAttributes: + description: The AWS Account Integration Config to be created. + properties: + account_tags: + $ref: '#/components/schemas/AWSAccountTags' + auth_config: + $ref: '#/components/schemas/AWSAuthConfig' + aws_account_id: + $ref: '#/components/schemas/AWSAccountID' + aws_partition: + $ref: '#/components/schemas/AWSAccountPartition' + aws_regions: + $ref: '#/components/schemas/AWSRegions' + logs_config: + $ref: '#/components/schemas/AWSLogsConfig' + metrics_config: + $ref: '#/components/schemas/AWSMetricsConfig' + resources_config: + $ref: '#/components/schemas/AWSResourcesConfig' + traces_config: + $ref: '#/components/schemas/AWSTracesConfig' + required: + - aws_account_id + - aws_partition + - auth_config + type: object + AWSAccountUpdateRequestAttributes: + description: The AWS Account Integration Config to be updated. + properties: + account_tags: + $ref: '#/components/schemas/AWSAccountTags' + auth_config: + $ref: '#/components/schemas/AWSAuthConfig' + aws_account_id: + $ref: '#/components/schemas/AWSAccountID' + aws_partition: + $ref: '#/components/schemas/AWSAccountPartition' + aws_regions: + $ref: '#/components/schemas/AWSRegions' + logs_config: + $ref: '#/components/schemas/AWSLogsConfig' + metrics_config: + $ref: '#/components/schemas/AWSMetricsConfig' + resources_config: + $ref: '#/components/schemas/AWSResourcesConfig' + traces_config: + $ref: '#/components/schemas/AWSTracesConfig' + required: + - aws_account_id + type: object + AWSNamespacesResponseAttributes: + description: AWS Namespaces response attributes. + properties: + namespaces: + description: AWS CloudWatch namespace. + example: + - AWS/ApiGateway + items: + example: AWS/ApiGateway + type: string + type: array + required: + - namespaces + type: object + AWSNamespacesResponseDataType: + default: namespaces + description: The `AWSNamespacesResponseData` `type`. + enum: + - namespaces + example: namespaces + type: string + x-enum-varnames: + - NAMESPACES + AWSNewExternalIDResponseAttributes: + description: AWS External ID response body. + properties: + external_id: + description: AWS IAM External ID for associated role. + example: acb8f6b8a844443dbb726d07dcb1a870 + type: string + required: + - external_id + type: object + AWSNewExternalIDResponseDataType: + default: external_id + description: The `AWSNewExternalIDResponseData` `type`. + enum: + - external_id + example: external_id + type: string + x-enum-varnames: + - EXTERNAL_ID + AWSIntegrationIamPermissionsResponseAttributes: + description: AWS Integration IAM Permissions response attributes. + properties: + permissions: + description: List of AWS IAM permissions required for the integration. + example: + - account:GetContactInformation + - amplify:ListApps + - amplify:ListArtifacts + - amplify:ListBackendEnvironments + - amplify:ListBranches + items: + example: account:GetContactInformation + type: string + type: array + required: + - permissions + type: object + AWSIntegrationIamPermissionsResponseDataType: + default: permissions + description: The `AWSIntegrationIamPermissionsResponseData` `type`. + enum: + - permissions + example: permissions + type: string + x-enum-varnames: + - PERMISSIONS + AWSLogsServicesResponseAttributes: + description: AWS Logs Services response body + properties: + logs_services: + description: List of AWS services that can send logs to Datadog + example: + - s3 + items: + example: s3 + type: string + type: array + required: + - logs_services + type: object + AWSLogsServicesResponseDataType: + default: logs_services + description: The `AWSLogsServicesResponseData` `type`. + enum: + - logs_services + example: logs_services + type: string + x-enum-varnames: + - LOGS_SERVICES + GCPSTSServiceAccountAttributes: + description: Attributes associated with your service account. + properties: + account_tags: + description: >- + Tags to be associated with GCP metrics and service checks from your + account. + items: + description: Account Level Tag + type: string + type: array + automute: + description: Silence monitors for expected GCE instance shutdowns. + type: boolean + client_email: + description: Your service account email address. + example: datadog-service-account@test-project.iam.gserviceaccount.com + type: string + cloud_run_revision_filters: + deprecated: true + description: >- + List of filters to limit the Cloud Run revisions that are pulled + into Datadog by using tags. + + Only Cloud Run revision resources that apply to specified filters + are imported into Datadog. + + **Note:** This field is deprecated. Instead, use + `monitored_resource_configs` with `type=cloud_run_revision` + example: + - $KEY:$VALUE + items: + description: Cloud Run revision filters + type: string + type: array + host_filters: + deprecated: true + description: >- + List of filters to limit the VM instances that are pulled into + Datadog by using tags. + + Only VM instance resources that apply to specified filters are + imported into Datadog. + + **Note:** This field is deprecated. Instead, use + `monitored_resource_configs` with `type=gce_instance` + example: + - $KEY:$VALUE + items: + description: VM instance filters + type: string + type: array + is_cspm_enabled: + description: >- + When enabled, Datadog will activate the Cloud Security Monitoring + product for this service account. Note: This requires + resource_collection_enabled to be set to true. + type: boolean + is_per_project_quota_enabled: + default: false + description: >- + When enabled, Datadog applies the `X-Goog-User-Project` header, + attributing Google Cloud billing and quota usage to the project + being monitored rather than the default service account project. + example: true + type: boolean + is_resource_change_collection_enabled: + default: false + description: >- + When enabled, Datadog scans for all resource change data in your + Google Cloud environment. + example: true + type: boolean + is_security_command_center_enabled: + default: false + description: >- + When enabled, Datadog will attempt to collect Security Command + Center Findings. Note: This requires additional permissions on the + service account. + example: true + type: boolean + metric_namespace_configs: + description: Configurations for GCP metric namespaces. + example: + - disabled: true + id: aiplatform + items: + $ref: '#/components/schemas/GCPMetricNamespaceConfig' + type: array + monitored_resource_configs: + description: Configurations for GCP monitored resources. + example: + - filters: + - $KEY:$VALUE + type: gce_instance + items: + $ref: '#/components/schemas/GCPMonitoredResourceConfig' + type: array + resource_collection_enabled: + description: >- + When enabled, Datadog scans for all resources in your GCP + environment. + type: boolean + type: object + GCPServiceAccountMeta: + description: Additional information related to your service account. + properties: + accessible_projects: + description: The current list of projects accessible from your service account. + items: + description: List of GCP projects. + type: string + type: array + type: object + GCPServiceAccountType: + default: gcp_service_account + description: The type of account. + enum: + - gcp_service_account + example: gcp_service_account + type: string + x-enum-varnames: + - GCP_SERVICE_ACCOUNT + GCPSTSDelegateAccountAttributes: + description: Your delegate account attributes. + properties: + delegate_account_email: + description: Your organization's Datadog principal email address. + example: >- + ddgci-1a19n28hb1a812221893@datadog-gci-sts-us5-prod.iam.gserviceaccount.com + type: string + type: object + GCPSTSDelegateAccountType: + default: gcp_sts_delegate + description: The type of account. + enum: + - gcp_sts_delegate + example: gcp_sts_delegate + type: string + x-enum-varnames: + - GCP_STS_DELEGATE + MicrosoftTeamsChannelInfoResponseAttributes: + description: Channel attributes. + properties: + is_primary: + description: Indicates if this is the primary channel. + example: true + maxLength: 255 + type: boolean + team_id: + description: Team id. + example: 00000000-0000-0000-0000-000000000000 + maxLength: 255 + type: string + tenant_id: + description: Tenant id. + example: 00000000-0000-0000-0000-000000000001 + maxLength: 255 + type: string + type: object + MicrosoftTeamsChannelInfoType: + default: ms-teams-channel-info + description: Channel info resource type. + enum: + - ms-teams-channel-info + example: ms-teams-channel-info + type: string + x-enum-varnames: + - MS_TEAMS_CHANNEL_INFO + MicrosoftTeamsTenantBasedHandleInfoResponseAttributes: + description: Tenant-based handle attributes. + properties: + channel_id: + description: Channel id. + example: fake-channel-id + maxLength: 255 + type: string + channel_name: + description: Channel name. + example: fake-channel-name + maxLength: 255 + type: string + name: + description: Tenant-based handle name. + example: fake-handle-name + maxLength: 255 + type: string + team_id: + description: Team id. + example: 00000000-0000-0000-0000-000000000000 + maxLength: 255 + type: string + team_name: + description: Team name. + example: fake-team-name + maxLength: 255 + type: string + tenant_id: + description: Tenant id. + example: 00000000-0000-0000-0000-000000000001 + maxLength: 255 + type: string + tenant_name: + description: Tenant name. + example: fake-tenant-name + maxLength: 255 + type: string + type: object + MicrosoftTeamsTenantBasedHandleInfoType: + default: ms-teams-tenant-based-handle-info + description: Tenant-based handle resource type. + enum: + - ms-teams-tenant-based-handle-info + example: ms-teams-tenant-based-handle-info + type: string + x-enum-varnames: + - MS_TEAMS_TENANT_BASED_HANDLE_INFO + MicrosoftTeamsTenantBasedHandleRequestAttributes: + description: Tenant-based handle attributes. + properties: + channel_id: + description: Channel id. + example: fake-channel-id + maxLength: 255 + type: string + name: + description: Tenant-based handle name. + example: fake-handle-name + maxLength: 255 + type: string + team_id: + description: Team id. + example: 00000000-0000-0000-0000-000000000000 + maxLength: 255 + type: string + tenant_id: + description: Tenant id. + example: 00000000-0000-0000-0000-000000000001 + maxLength: 255 + type: string + required: + - name + - channel_id + - team_id + - tenant_id + type: object + MicrosoftTeamsTenantBasedHandleType: + default: tenant-based-handle + description: Specifies the tenant-based handle resource type. + enum: + - tenant-based-handle + example: tenant-based-handle + type: string + x-enum-varnames: + - TENANT_BASED_HANDLE + MicrosoftTeamsTenantBasedHandleAttributes: + description: Tenant-based handle attributes. + properties: + channel_id: + description: Channel id. + example: fake-channel-id + maxLength: 255 + type: string + name: + description: Tenant-based handle name. + example: fake-handle-name + maxLength: 255 + type: string + team_id: + description: Team id. + example: 00000000-0000-0000-0000-000000000000 + maxLength: 255 + type: string + tenant_id: + description: Tenant id. + example: 00000000-0000-0000-0000-000000000001 + maxLength: 255 + type: string + type: object + MicrosoftTeamsWorkflowsWebhookResponseAttributes: + description: Workflows Webhook handle attributes. + properties: + name: + description: Workflows Webhook handle name. + example: fake-handle-name + maxLength: 255 + type: string + type: object + MicrosoftTeamsWorkflowsWebhookHandleType: + default: workflows-webhook-handle + description: Specifies the Workflows webhook handle resource type. + enum: + - workflows-webhook-handle + example: workflows-webhook-handle + type: string + x-enum-varnames: + - WORKFLOWS_WEBHOOK_HANDLE + MicrosoftTeamsWorkflowsWebhookHandleRequestAttributes: + description: Workflows Webhook handle attributes. + properties: + name: + description: Workflows Webhook handle name. + example: fake-handle-name + maxLength: 255 + type: string + url: + description: Workflows Webhook URL. + example: https://fake.url.com + maxLength: 255 + type: string + required: + - name + - url + type: object + MicrosoftTeamsWorkflowsWebhookHandleAttributes: + description: Workflows Webhook handle attributes. + properties: + name: + description: Workflows Webhook handle name. + example: fake-handle-name + maxLength: 255 + type: string + url: + description: Workflows Webhook URL. + example: https://fake.url.com + maxLength: 255 + type: string + type: object + OpsgenieServiceResponseAttributes: + description: The attributes from an Opsgenie service response. + properties: + custom_url: + description: The custom URL for a custom region. + example: null + nullable: true + type: string + name: + description: The name for the Opsgenie service. + example: fake-opsgenie-service-name + maxLength: 100 + type: string + region: + $ref: '#/components/schemas/OpsgenieServiceRegionType' + type: object + OpsgenieServiceType: + default: opsgenie-service + description: Opsgenie service resource type. + enum: + - opsgenie-service + example: opsgenie-service + type: string + x-enum-varnames: + - OPSGENIE_SERVICE + OpsgenieServiceCreateAttributes: + description: The Opsgenie service attributes for a create request. + properties: + custom_url: + description: The custom URL for a custom region. + example: https://example.com + type: string + name: + description: The name for the Opsgenie service. + example: fake-opsgenie-service-name + maxLength: 100 + type: string + opsgenie_api_key: + description: The Opsgenie API key for your Opsgenie service. + example: 00000000-0000-0000-0000-000000000000 + type: string + region: + $ref: '#/components/schemas/OpsgenieServiceRegionType' + required: + - name + - opsgenie_api_key + - region + type: object + OpsgenieServiceUpdateAttributes: + description: The Opsgenie service attributes for an update request. + properties: + custom_url: + description: The custom URL for a custom region. + example: https://example.com + nullable: true + type: string + name: + description: The name for the Opsgenie service. + example: fake-opsgenie-service-name + maxLength: 100 + type: string + opsgenie_api_key: + description: The Opsgenie API key for your Opsgenie service. + example: 00000000-0000-0000-0000-000000000000 + type: string + region: + $ref: '#/components/schemas/OpsgenieServiceRegionType' + type: object + CloudflareAccountResponseAttributes: + description: Attributes object of a Cloudflare account. + properties: + email: + description: The email associated with the Cloudflare account. + example: test-email@example.com + type: string + name: + description: The name of the Cloudflare account. + example: test-name + type: string + resources: + description: >- + An allowlist of resources, such as `web`, `dns`, `lb` (load + balancer), `worker`, that restricts pulling metrics from those + resources. + example: + - web + - dns + - lb + - worker + items: + type: string + type: array + zones: + description: An allowlist of zones to restrict pulling metrics for. + example: + - zone_id_1 + - zone_id_2 + items: + type: string + type: array + required: + - name + type: object + CloudflareAccountType: + default: cloudflare-accounts + description: The JSON:API type for this API. Should always be `cloudflare-accounts`. + enum: + - cloudflare-accounts + example: cloudflare-accounts + type: string + x-enum-varnames: + - CLOUDFLARE_ACCOUNTS + CloudflareAccountCreateRequestAttributes: + description: Attributes object for creating a Cloudflare account. + properties: + api_key: + description: The API key (or token) for the Cloudflare account. + example: a94a8fe5ccb19ba61c4c0873d391e987982fbbd3 + type: string + email: + description: >- + The email associated with the Cloudflare account. If an API key is + provided (and not a token), this field is also required. + example: test-email@example.com + type: string + name: + description: The name of the Cloudflare account. + example: test-name + type: string + resources: + description: >- + An allowlist of resources to restrict pulling metrics for including + `'web', 'dns', 'lb' (load balancer), 'worker'`. + example: + - web + - dns + - lb + - worker + items: + type: string + type: array + zones: + description: An allowlist of zones to restrict pulling metrics for. + example: + - zone_id_1 + - zone_id_2 + items: + type: string + type: array + required: + - api_key + - name + type: object + CloudflareAccountUpdateRequestAttributes: + description: Attributes object for updating a Cloudflare account. + properties: + api_key: + description: The API key of the Cloudflare account. + example: a94a8fe5ccb19ba61c4c0873d391e987982fbbd3 + type: string + email: + description: >- + The email associated with the Cloudflare account. If an API key is + provided (and not a token), this field is also required. + example: test-email@example.com + type: string + name: + description: The name of the Cloudflare account. + type: string + resources: + description: >- + An allowlist of resources to restrict pulling metrics for including + `'web', 'dns', 'lb' (load balancer), 'worker'`. + example: + - web + - dns + - lb + - worker + items: + type: string + type: array + zones: + description: An allowlist of zones to restrict pulling metrics for. + example: + - zone_id_1 + - zone_id_2 + items: + type: string + type: array + required: + - api_key + type: object + ConfluentAccountResponseAttributes: + description: The attributes of a Confluent account. + properties: + api_key: + description: The API key associated with your Confluent account. + example: TESTAPIKEY123 + type: string + resources: + description: A list of Confluent resources associated with the Confluent account. + items: + $ref: '#/components/schemas/ConfluentResourceResponseAttributes' + type: array + tags: + description: >- + A list of strings representing tags. Can be a single key, or + key-value pairs separated by a colon. + example: + - myTag + - myTag2:myValue + items: + type: string + type: array + required: + - api_key + type: object + ConfluentAccountType: + default: confluent-cloud-accounts + description: >- + The JSON:API type for this API. Should always be + `confluent-cloud-accounts`. + enum: + - confluent-cloud-accounts + example: confluent-cloud-accounts + type: string + x-enum-varnames: + - CONFLUENT_CLOUD_ACCOUNTS + ConfluentAccountCreateRequestAttributes: + description: Attributes associated with the account creation request. + properties: + api_key: + description: The API key associated with your Confluent account. + example: TESTAPIKEY123 + type: string + api_secret: + description: The API secret associated with your Confluent account. + example: test-api-secret-123 + type: string + resources: + description: A list of Confluent resources associated with the Confluent account. + items: + $ref: '#/components/schemas/ConfluentAccountResourceAttributes' + type: array + tags: + description: >- + A list of strings representing tags. Can be a single key, or + key-value pairs separated by a colon. + example: + - myTag + - myTag2:myValue + items: + type: string + type: array + required: + - api_key + - api_secret + type: object + ConfluentAccountUpdateRequestAttributes: + description: Attributes object for updating a Confluent account. + properties: + api_key: + description: The API key associated with your Confluent account. + example: TESTAPIKEY123 + type: string + api_secret: + description: The API secret associated with your Confluent account. + example: test-api-secret-123 + type: string + tags: + description: >- + A list of strings representing tags. Can be a single key, or + key-value pairs separated by a colon. + example: + - myTag + - myTag2:myValue + items: + type: string + type: array + required: + - api_key + - api_secret + type: object + ConfluentResourceResponseAttributes: + description: Model representation of a Confluent Cloud resource. + properties: + enable_custom_metrics: + default: false + description: >- + Enable the `custom.consumer_lag_offset` metric, which contains extra + metric tags. + example: false + type: boolean + id: + description: The ID associated with the Confluent resource. + example: resource_id_abc123 + type: string + resource_type: + description: >- + The resource type of the Resource. Can be `kafka`, `connector`, + `ksql`, or `schema_registry`. + example: kafka + type: string + tags: + description: >- + A list of strings representing tags. Can be a single key, or + key-value pairs separated by a colon. + example: + - myTag + - myTag2:myValue + items: + type: string + type: array + required: + - resource_type + type: object + ConfluentResourceType: + default: confluent-cloud-resources + description: The JSON:API type for this request. + enum: + - confluent-cloud-resources + example: confluent-cloud-resources + type: string + x-enum-varnames: + - CONFLUENT_CLOUD_RESOURCES + ConfluentResourceRequestAttributes: + description: Attributes object for updating a Confluent resource. + properties: + enable_custom_metrics: + default: false + description: >- + Enable the `custom.consumer_lag_offset` metric, which contains extra + metric tags. + example: false + type: boolean + resource_type: + description: >- + The resource type of the Resource. Can be `kafka`, `connector`, + `ksql`, or `schema_registry`. + example: kafka + type: string + tags: + description: >- + A list of strings representing tags. Can be a single key, or + key-value pairs separated by a colon. + example: + - myTag + - myTag2:myValue + items: + type: string + type: array + required: + - resource_type + type: object + FastlyAccounResponseAttributes: + description: Attributes object of a Fastly account. + properties: + name: + description: The name of the Fastly account. + example: test-name + type: string + services: + description: A list of services belonging to the parent account. + items: + $ref: '#/components/schemas/FastlyService' + type: array + required: + - name + type: object + FastlyAccountType: + default: fastly-accounts + description: The JSON:API type for this API. Should always be `fastly-accounts`. + enum: + - fastly-accounts + example: fastly-accounts + type: string + x-enum-varnames: + - FASTLY_ACCOUNTS + FastlyAccountCreateRequestAttributes: + description: Attributes object for creating a Fastly account. + properties: + api_key: + description: The API key for the Fastly account. + example: ABCDEFG123 + type: string + name: + description: The name of the Fastly account. + example: test-name + type: string + services: + description: A list of services belonging to the parent account. + items: + $ref: '#/components/schemas/FastlyService' + type: array + required: + - api_key + - name + type: object + FastlyAccountUpdateRequestAttributes: + description: Attributes object for updating a Fastly account. + properties: + api_key: + description: The API key of the Fastly account. + example: ABCDEFG123 + type: string + name: + description: The name of the Fastly account. + type: string + type: object + FastlyServiceAttributes: + description: Attributes object for Fastly service requests. + properties: + tags: + description: A list of tags for the Fastly service. + example: + - myTag + - myTag2:myValue + items: + type: string + type: array + type: object + FastlyServiceType: + default: fastly-services + description: The JSON:API type for this API. Should always be `fastly-services`. + enum: + - fastly-services + example: fastly-services + type: string + x-enum-varnames: + - FASTLY_SERVICES + OktaAccountAttributes: + description: Attributes object for an Okta account. + properties: + api_key: + description: The API key of the Okta account. + type: string + writeOnly: true + auth_method: + description: The authorization method for an Okta account. + example: oauth + type: string + client_id: + description: The Client ID of an Okta app integration. + type: string + client_secret: + description: The client secret of an Okta app integration. + type: string + writeOnly: true + domain: + description: The domain of the Okta account. + example: https://example.okta.com/ + type: string + name: + description: The name of the Okta account. + example: Okta-Prod + type: string + required: + - auth_method + - domain + - name + type: object + OktaAccountType: + default: okta-accounts + description: Account type for an Okta account. + enum: + - okta-accounts + example: okta-accounts + type: string + x-enum-varnames: + - OKTA_ACCOUNTS + OktaAccountUpdateRequestAttributes: + description: Attributes object for updating an Okta account. + properties: + api_key: + description: The API key of the Okta account. + type: string + writeOnly: true + auth_method: + description: The authorization method for an Okta account. + example: oauth + type: string + client_id: + description: The Client ID of an Okta app integration. + type: string + client_secret: + description: The client secret of an Okta app integration. + type: string + writeOnly: true + domain: + description: The domain associated with an Okta account. + example: https://dev-test.okta.com/ + type: string + required: + - auth_method + - domain + type: object + AWSAccountTags: + description: >- + Tags to apply to all hosts and metrics reporting for this account. + Defaults to `[]`. + items: + description: Tag in the form `key:value`. + example: env:prod + type: string + nullable: true + type: array + AWSAuthConfig: + description: AWS Authentication config. + oneOf: + - $ref: '#/components/schemas/AWSAuthConfigKeys' + - $ref: '#/components/schemas/AWSAuthConfigRole' + AWSAccountID: + description: AWS Account ID. + example: '123456789012' + type: string + AWSAccountPartition: + description: >- + AWS partition your AWS account is scoped to. Defaults to `aws`. + + See + [Partitions](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html) + in the AWS documentation for more information. + enum: + - aws + - aws-cn + - aws-us-gov + example: aws + type: string + x-enum-varnames: + - AWS + - AWS_CN + - AWS_US_GOV + AWSRegions: + description: AWS Regions to collect data from. Defaults to `include_all`. + oneOf: + - $ref: '#/components/schemas/AWSRegionsIncludeAll' + - $ref: '#/components/schemas/AWSRegionsIncludeOnly' + AWSLogsConfig: + description: AWS Logs Collection config. + properties: + lambda_forwarder: + $ref: '#/components/schemas/AWSLambdaForwarderConfig' + type: object + AWSMetricsConfig: + description: AWS Metrics Collection config. + properties: + automute_enabled: + description: Enable EC2 automute for AWS metrics. Defaults to `true`. + example: true + type: boolean + collect_cloudwatch_alarms: + description: Enable CloudWatch alarms collection. Defaults to `false`. + example: false + type: boolean + collect_custom_metrics: + description: Enable custom metrics collection. Defaults to `false`. + example: false + type: boolean + enabled: + description: Enable AWS metrics collection. Defaults to `true`. + example: true + type: boolean + namespace_filters: + $ref: '#/components/schemas/AWSNamespaceFilters' + tag_filters: + description: AWS Metrics collection tag filters list. Defaults to `[]`. + items: + $ref: '#/components/schemas/AWSNamespaceTagFilter' + type: array + type: object + AWSResourcesConfig: + description: AWS Resources Collection config. + properties: + cloud_security_posture_management_collection: + description: >- + Enable Cloud Security Management to scan AWS resources for + vulnerabilities, misconfigurations, identity risks, and compliance + violations. Defaults to `false`. Requires `extended_collection` to + be set to `true`. + example: false + type: boolean + extended_collection: + description: >- + Whether Datadog collects additional attributes and configuration + information about the resources in your AWS account. Defaults to + `true`. Required for `cloud_security_posture_management_collection`. + example: true + type: boolean + type: object + AWSTracesConfig: + description: AWS Traces Collection config. + properties: + xray_services: + $ref: '#/components/schemas/XRayServicesList' + type: object + GCPMetricNamespaceConfig: + description: Configuration for a GCP metric namespace. + properties: + disabled: + default: false + description: >- + When disabled, Datadog does not collect metrics that are related to + this GCP metric namespace. + example: true + type: boolean + id: + description: The id of the GCP metric namespace. + example: aiplatform + type: string + type: object + GCPMonitoredResourceConfig: + description: Configuration for a GCP monitored resource. + properties: + filters: + description: >- + List of filters to limit the monitored resources that are pulled + into Datadog by using tags. + + Only monitored resources that apply to specified filters are + imported into Datadog. + example: + - $KEY:$VALUE + items: + description: A monitored resource filter + type: string + type: array + type: + $ref: '#/components/schemas/GCPMonitoredResourceConfigType' + type: object + OpsgenieServiceRegionType: + description: The region for the Opsgenie service. + enum: + - us + - eu + - custom + example: us + type: string + x-enum-varnames: + - US + - EU + - CUSTOM + ConfluentAccountResourceAttributes: + description: Attributes object for updating a Confluent resource. + properties: + enable_custom_metrics: + default: false + description: >- + Enable the `custom.consumer_lag_offset` metric, which contains extra + metric tags. + example: false + type: boolean + id: + description: The ID associated with a Confluent resource. + example: resource-id-123 + type: string + resource_type: + description: >- + The resource type of the Resource. Can be `kafka`, `connector`, + `ksql`, or `schema_registry`. + example: kafka + type: string + tags: + description: >- + A list of strings representing tags. Can be a single key, or + key-value pairs separated by a colon. + example: + - myTag + - myTag2:myValue + items: + type: string + type: array + required: + - resource_type + type: object + FastlyService: + description: The schema representation of a Fastly service. + properties: + id: + description: The ID of the Fastly service + example: 6abc7de6893AbcDe9fghIj + type: string + tags: + description: A list of tags for the Fastly service. + example: + - myTag + - myTag2:myValue + items: + type: string + type: array + required: + - id + type: object + AWSAuthConfigKeys: + description: >- + AWS Authentication config to integrate your account using an access key + pair. + properties: + access_key_id: + description: AWS Access Key ID. + example: AKIAIOSFODNN7EXAMPLE + type: string + secret_access_key: + description: AWS Secret Access Key. + example: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY + minLength: 1 + type: string + writeOnly: true + required: + - access_key_id + type: object + AWSAuthConfigRole: + description: AWS Authentication config to integrate your account using an IAM role. + properties: + external_id: + description: AWS IAM External ID for associated role. + type: string + role_name: + description: AWS IAM Role name. + example: DatadogIntegrationRole + maxLength: 576 + minLength: 1 + type: string + required: + - role_name + type: object + AWSRegionsIncludeAll: + description: Include all regions. Defaults to `true`. + properties: + include_all: + description: Include all regions. + example: true + type: boolean + required: + - include_all + type: object + AWSRegionsIncludeOnly: + description: Include only these regions. + properties: + include_only: + description: Include only these regions. + example: + - us-east-1 + items: + example: us-east-1 + type: string + type: array + required: + - include_only + type: object + AWSLambdaForwarderConfig: + description: >- + Log Autosubscription configuration for Datadog Forwarder Lambda + functions. Automatically set up triggers for existing + + and new logs for some services, ensuring no logs from new resources are + missed and saving time spent on manual configuration. + properties: + lambdas: + description: >- + List of Datadog Lambda Log Forwarder ARNs in your AWS account. + Defaults to `[]`. + items: + example: >- + arn:aws:lambda:us-east-1:123456789012:function:DatadogLambdaLogForwarder + type: string + type: array + log_source_config: + $ref: '#/components/schemas/AWSLambdaForwarderConfigLogSourceConfig' + sources: + description: >- + List of service IDs set to enable automatic log collection. Discover + the list of available services with the + + [Get list of AWS log ready + services](https://docs.datadoghq.com/api/latest/aws-logs-integration/#get-list-of-aws-log-ready-services) + endpoint. + items: + example: s3 + type: string + type: array + type: object + AWSNamespaceFilters: + description: AWS Metrics namespace filters. Defaults to `exclude_only`. + oneOf: + - $ref: '#/components/schemas/AWSNamespaceFiltersExcludeOnly' + - $ref: '#/components/schemas/AWSNamespaceFiltersIncludeOnly' + AWSNamespaceTagFilter: + description: >- + AWS Metrics Collection tag filters list. Defaults to `[]`. + + The array of custom AWS resource tags (in the form `key:value`) defines + a filter that Datadog uses when collecting metrics from a specified + service. + + Wildcards, such as `?` (match a single character) and `*` (match + multiple characters), and exclusion using `!` before the tag are + supported. + + For EC2, only hosts that match one of the defined tags will be imported + into Datadog. The rest will be ignored. + + For example, `env:production,instance-type:c?.*,!region:us-east-1`. + properties: + namespace: + description: >- + The AWS service for which the tag filters defined in `tags` will be + applied. + example: AWS/EC2 + type: string + tags: + description: >- + The AWS resource tags to filter on for the service specified by + `namespace`. + items: + description: Tag in the form `key:value`. + example: datadog:true + type: string + nullable: true + type: array + type: object + XRayServicesList: + description: AWS X-Ray services to collect traces from. Defaults to `include_only`. + oneOf: + - $ref: '#/components/schemas/XRayServicesIncludeAll' + - $ref: '#/components/schemas/XRayServicesIncludeOnly' + GCPMonitoredResourceConfigType: + description: >- + The GCP monitored resource type. Only a subset of resource types are + supported. + enum: + - cloud_function + - cloud_run_revision + - gce_instance + example: gce_instance + type: string + x-enum-varnames: + - CLOUD_FUNCTION + - CLOUD_RUN_REVISION + - GCE_INSTANCE + AWSLambdaForwarderConfigLogSourceConfig: + description: Log source configuration. + properties: + tag_filters: + description: List of AWS log source tag filters. Defaults to `[]`. + items: + $ref: '#/components/schemas/AWSLogSourceTagFilter' + type: array + type: object + AWSNamespaceFiltersExcludeOnly: + description: >- + Exclude only these namespaces from metrics collection. Defaults to + `["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"]`. + + `AWS/SQS`, `AWS/ElasticMapReduce`, and `AWS/Usage` are excluded by + default to reduce your AWS CloudWatch costs from `GetMetricData` API + calls. + properties: + exclude_only: + description: >- + Exclude only these namespaces from metrics collection. Defaults to + `["AWS/SQS", "AWS/ElasticMapReduce", "AWS/Usage"]`. + + `AWS/SQS`, `AWS/ElasticMapReduce`, and `AWS/Usage` are excluded by + default to reduce your AWS CloudWatch costs from `GetMetricData` API + calls. + example: + - AWS/SQS + - AWS/ElasticMapReduce + - AWS/Usage + items: + example: AWS/SQS + type: string + type: array + required: + - exclude_only + type: object + AWSNamespaceFiltersIncludeOnly: + description: Include only these namespaces. + properties: + include_only: + description: Include only these namespaces. + example: + - AWS/EC2 + items: + example: AWS/EC2 + type: string + type: array + required: + - include_only + type: object + XRayServicesIncludeAll: + description: Include all services. + properties: + include_all: + description: Include all services. + example: false + type: boolean + required: + - include_all + type: object + XRayServicesIncludeOnly: + description: Include only these services. Defaults to `[]`. + nullable: true + properties: + include_only: + description: Include only these services. + example: + - AWS/AppSync + items: + example: AWS/AppSync + type: string + type: array + required: + - include_only + type: object + AWSLogSourceTagFilter: + description: >- + AWS log source tag filter list. Defaults to `[]`. + + Array of log source to AWS resource tag mappings. Each mapping contains + a log source and its associated AWS resource tags (in `key:value` + format) used to filter logs submitted to Datadog. + + Tag filters are applied for tags on the AWS resource emitting logs; tags + associated with the log storage entity (such as a CloudWatch Log Group + or S3 Bucket) are not considered. + + For more information on resource tag filter syntax, [see AWS resource + exclusion](https://docs.datadoghq.com/account_management/billing/aws/#aws-resource-exclusion) + in the AWS integration billing page. + properties: + source: + description: >- + The AWS log source to which the tag filters defined in `tags` are + applied. + example: s3 + type: string + tags: + description: >- + The AWS resource tags to filter on for the log source specified by + `source`. + items: + description: Tag in the form `key:value`. + example: env:prod + type: string + nullable: true + type: array + type: object + responses: + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + ConflictResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + UnauthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unauthorized + PreconditionFailedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Failed Precondition + parameters: + AWSAccountConfigIDPathParameter: + description: >- + Unique Datadog ID of the AWS Account Integration Config. To get the + config ID for an account, use the + + [List all AWS + integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations) + endpoint and query by AWS Account ID. + in: path + name: aws_account_config_id + required: true + schema: + type: string + GCPSTSServiceAccountID: + description: Your GCP STS enabled service account's unique ID. + in: path + name: account_id + required: true + schema: + type: string + MicrosoftTeamsTenantNamePathParameter: + description: Your tenant name. + in: path + name: tenant_name + required: true + schema: + type: string + MicrosoftTeamsTeamNamePathParameter: + description: Your team name. + in: path + name: team_name + required: true + schema: + type: string + MicrosoftTeamsChannelNamePathParameter: + description: Your channel name. + in: path + name: channel_name + required: true + schema: + type: string + MicrosoftTeamsTenantIDQueryParameter: + description: Your tenant id. + in: query + name: tenant_id + required: false + schema: + type: string + MicrosoftTeamsHandleNameQueryParameter: + description: Your tenant-based handle name. + in: query + name: name + required: false + schema: + type: string + MicrosoftTeamsTenantBasedHandleIDPathParameter: + description: Your tenant-based handle id. + in: path + name: handle_id + required: true + schema: + type: string + MicrosoftTeamsWorkflowsWebhookHandleNameQueryParameter: + description: Your Workflows webhook handle name. + in: query + name: name + required: false + schema: + type: string + MicrosoftTeamsWorkflowsWebhookHandleIDPathParameter: + description: Your Workflows webhook handle id. + in: path + name: handle_id + required: true + schema: + type: string + OpsgenieServiceIDPathParameter: + description: The UUID of the service. + in: path + name: integration_service_id + required: true + schema: + type: string + ConfluentAccountID: + description: Confluent Account ID. + in: path + name: account_id + required: true + schema: + type: string + ConfluentResourceID: + description: Confluent Account Resource ID. + in: path + name: resource_id + required: true + schema: + type: string + FastlyAccountID: + description: Fastly Account id. + in: path + name: account_id + required: true + schema: + type: string + FastlyServiceID: + description: Fastly Service ID. + in: path + name: service_id + required: true + schema: + type: string + x-stackQL-resources: + aws_accounts: + id: datadog.integrations.aws_accounts + name: aws_accounts + title: Aws Accounts + methods: + list_awsaccounts: + operation: + $ref: '#/paths/~1api~1v2~1integration~1aws~1accounts/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_awsaccount: + operation: + $ref: '#/paths/~1api~1v2~1integration~1aws~1accounts/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_awsaccount: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1aws~1accounts~1{aws_account_config_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_awsaccount: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1aws~1accounts~1{aws_account_config_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_awsaccount: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1aws~1accounts~1{aws_account_config_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + create_new_awsexternal_id: + operation: + $ref: '#/paths/~1api~1v2~1integration~1aws~1generate_new_external_id/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aws_accounts/methods/get_awsaccount + - $ref: >- + #/components/x-stackQL-resources/aws_accounts/methods/list_awsaccounts + insert: + - $ref: >- + #/components/x-stackQL-resources/aws_accounts/methods/create_awsaccount + update: + - $ref: >- + #/components/x-stackQL-resources/aws_accounts/methods/update_awsaccount + delete: + - $ref: >- + #/components/x-stackQL-resources/aws_accounts/methods/delete_awsaccount + replace: [] + aws_namespaces: + id: datadog.integrations.aws_namespaces + name: aws_namespaces + title: Aws Namespaces + methods: + list_awsnamespaces: + operation: + $ref: '#/paths/~1api~1v2~1integration~1aws~1available_namespaces/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aws_namespaces/methods/list_awsnamespaces + insert: [] + update: [] + delete: [] + replace: [] + aws_iam_permissions: + id: datadog.integrations.aws_iam_permissions + name: aws_iam_permissions + title: Aws Iam Permissions + methods: + get_awsintegration_iampermissions: + operation: + $ref: '#/paths/~1api~1v2~1integration~1aws~1iam_permissions/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aws_iam_permissions/methods/get_awsintegration_iampermissions + insert: [] + update: [] + delete: [] + replace: [] + aws_logs_services: + id: datadog.integrations.aws_logs_services + name: aws_logs_services + title: Aws Logs Services + methods: + list_awslogs_services: + operation: + $ref: '#/paths/~1api~1v2~1integration~1aws~1logs~1services/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aws_logs_services/methods/list_awslogs_services + insert: [] + update: [] + delete: [] + replace: [] + gcp_accounts: + id: datadog.integrations.gcp_accounts + name: gcp_accounts + title: Gcp Accounts + methods: + list_gcpstsaccounts: + operation: + $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_gcpstsaccount: + operation: + $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_gcpstsaccount: + operation: + $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts~1{account_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + update_gcpstsaccount: + operation: + $ref: '#/paths/~1api~1v2~1integration~1gcp~1accounts~1{account_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '201' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/gcp_accounts/methods/list_gcpstsaccounts + insert: + - $ref: >- + #/components/x-stackQL-resources/gcp_accounts/methods/create_gcpstsaccount + update: + - $ref: >- + #/components/x-stackQL-resources/gcp_accounts/methods/update_gcpstsaccount + delete: + - $ref: >- + #/components/x-stackQL-resources/gcp_accounts/methods/delete_gcpstsaccount + replace: [] + gcp_sts_delegate: + id: datadog.integrations.gcp_sts_delegate + name: gcp_sts_delegate + title: Gcp Sts Delegate + methods: + get_gcpstsdelegate: + operation: + $ref: '#/paths/~1api~1v2~1integration~1gcp~1sts_delegate/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + make_gcpstsdelegate: + operation: + $ref: '#/paths/~1api~1v2~1integration~1gcp~1sts_delegate/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/gcp_sts_delegate/methods/get_gcpstsdelegate + insert: [] + update: [] + delete: [] + replace: [] + ms_teams_channels: + id: datadog.integrations.ms_teams_channels + name: ms_teams_channels + title: Ms Teams Channels + methods: + get_channel_by_name: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1channel~1{tenant_name}~1{team_name}~1{channel_name}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_channels/methods/get_channel_by_name + insert: [] + update: [] + delete: [] + replace: [] + ms_teams_tenant_based_handles: + id: datadog.integrations.ms_teams_tenant_based_handles + name: ms_teams_tenant_based_handles + title: Ms Teams Tenant Based Handles + methods: + list_tenant_based_handles: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1tenant-based-handles/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_tenant_based_handle: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1tenant-based-handles/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_tenant_based_handle: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1tenant-based-handles~1{handle_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_tenant_based_handle: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1tenant-based-handles~1{handle_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_tenant_based_handle: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1tenant-based-handles~1{handle_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_tenant_based_handles/methods/get_tenant_based_handle + - $ref: >- + #/components/x-stackQL-resources/ms_teams_tenant_based_handles/methods/list_tenant_based_handles + insert: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_tenant_based_handles/methods/create_tenant_based_handle + update: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_tenant_based_handles/methods/update_tenant_based_handle + delete: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_tenant_based_handles/methods/delete_tenant_based_handle + replace: [] + ms_teams_workflows_webhook_handles: + id: datadog.integrations.ms_teams_workflows_webhook_handles + name: ms_teams_workflows_webhook_handles + title: Ms Teams Workflows Webhook Handles + methods: + list_workflows_webhook_handles: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1workflows-webhook-handles/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_workflows_webhook_handle: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1workflows-webhook-handles/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_workflows_webhook_handle: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1workflows-webhook-handles~1{handle_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_workflows_webhook_handle: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1workflows-webhook-handles~1{handle_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_workflows_webhook_handle: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1ms-teams~1configuration~1workflows-webhook-handles~1{handle_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_workflows_webhook_handles/methods/get_workflows_webhook_handle + - $ref: >- + #/components/x-stackQL-resources/ms_teams_workflows_webhook_handles/methods/list_workflows_webhook_handles + insert: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_workflows_webhook_handles/methods/create_workflows_webhook_handle + update: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_workflows_webhook_handles/methods/update_workflows_webhook_handle + delete: + - $ref: >- + #/components/x-stackQL-resources/ms_teams_workflows_webhook_handles/methods/delete_workflows_webhook_handle + replace: [] + opsgenie_services: + id: datadog.integrations.opsgenie_services + name: opsgenie_services + title: Opsgenie Services + methods: + list_opsgenie_services: + operation: + $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_opsgenie_service: + operation: + $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_opsgenie_service: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1opsgenie~1services~1{integration_service_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_opsgenie_service: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1opsgenie~1services~1{integration_service_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_opsgenie_service: + operation: + $ref: >- + #/paths/~1api~1v2~1integration~1opsgenie~1services~1{integration_service_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/opsgenie_services/methods/get_opsgenie_service + - $ref: >- + #/components/x-stackQL-resources/opsgenie_services/methods/list_opsgenie_services + insert: + - $ref: >- + #/components/x-stackQL-resources/opsgenie_services/methods/create_opsgenie_service + update: + - $ref: >- + #/components/x-stackQL-resources/opsgenie_services/methods/update_opsgenie_service + delete: + - $ref: >- + #/components/x-stackQL-resources/opsgenie_services/methods/delete_opsgenie_service + replace: [] + cloudflare_accounts: + id: datadog.integrations.cloudflare_accounts + name: cloudflare_accounts + title: Cloudflare Accounts + methods: + list_cloudflare_accounts: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_cloudflare_account: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1cloudflare~1accounts/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_cloudflare_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1cloudflare~1accounts~1{account_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_cloudflare_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1cloudflare~1accounts~1{account_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_cloudflare_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1cloudflare~1accounts~1{account_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/cloudflare_accounts/methods/get_cloudflare_account + - $ref: >- + #/components/x-stackQL-resources/cloudflare_accounts/methods/list_cloudflare_accounts + insert: + - $ref: >- + #/components/x-stackQL-resources/cloudflare_accounts/methods/create_cloudflare_account + update: + - $ref: >- + #/components/x-stackQL-resources/cloudflare_accounts/methods/update_cloudflare_account + delete: + - $ref: >- + #/components/x-stackQL-resources/cloudflare_accounts/methods/delete_cloudflare_account + replace: [] + confluent_accounts: + id: datadog.integrations.confluent_accounts + name: confluent_accounts + title: Confluent Accounts + methods: + list_confluent_account: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_confluent_account: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_confluent_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_confluent_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_confluent_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/confluent_accounts/methods/get_confluent_account + - $ref: >- + #/components/x-stackQL-resources/confluent_accounts/methods/list_confluent_account + insert: + - $ref: >- + #/components/x-stackQL-resources/confluent_accounts/methods/create_confluent_account + update: + - $ref: >- + #/components/x-stackQL-resources/confluent_accounts/methods/update_confluent_account + delete: + - $ref: >- + #/components/x-stackQL-resources/confluent_accounts/methods/delete_confluent_account + replace: [] + confluent_resources: + id: datadog.integrations.confluent_resources + name: confluent_resources + title: Confluent Resources + methods: + list_confluent_resource: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_confluent_resource: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_confluent_resource: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources~1{resource_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_confluent_resource: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources~1{resource_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_confluent_resource: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1confluent-cloud~1accounts~1{account_id}~1resources~1{resource_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/confluent_resources/methods/get_confluent_resource + - $ref: >- + #/components/x-stackQL-resources/confluent_resources/methods/list_confluent_resource + insert: + - $ref: >- + #/components/x-stackQL-resources/confluent_resources/methods/create_confluent_resource + update: + - $ref: >- + #/components/x-stackQL-resources/confluent_resources/methods/update_confluent_resource + delete: + - $ref: >- + #/components/x-stackQL-resources/confluent_resources/methods/delete_confluent_resource + replace: [] + fastly_accounts: + id: datadog.integrations.fastly_accounts + name: fastly_accounts + title: Fastly Accounts + methods: + list_fastly_accounts: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_fastly_account: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1fastly~1accounts/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_fastly_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_fastly_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_fastly_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/fastly_accounts/methods/get_fastly_account + - $ref: >- + #/components/x-stackQL-resources/fastly_accounts/methods/list_fastly_accounts + insert: + - $ref: >- + #/components/x-stackQL-resources/fastly_accounts/methods/create_fastly_account + update: + - $ref: >- + #/components/x-stackQL-resources/fastly_accounts/methods/update_fastly_account + delete: + - $ref: >- + #/components/x-stackQL-resources/fastly_accounts/methods/delete_fastly_account + replace: [] + fastly_services: + id: datadog.integrations.fastly_services + name: fastly_services + title: Fastly Services + methods: + list_fastly_services: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_fastly_service: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_fastly_service: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services~1{service_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_fastly_service: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services~1{service_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_fastly_service: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1fastly~1accounts~1{account_id}~1services~1{service_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/fastly_services/methods/get_fastly_service + - $ref: >- + #/components/x-stackQL-resources/fastly_services/methods/list_fastly_services + insert: + - $ref: >- + #/components/x-stackQL-resources/fastly_services/methods/create_fastly_service + update: + - $ref: >- + #/components/x-stackQL-resources/fastly_services/methods/update_fastly_service + delete: + - $ref: >- + #/components/x-stackQL-resources/fastly_services/methods/delete_fastly_service + replace: [] + okta_accounts: + id: datadog.integrations.okta_accounts + name: okta_accounts + title: Okta Accounts + methods: + list_okta_accounts: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_okta_account: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_okta_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1okta~1accounts~1{account_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_okta_account: + operation: + $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts~1{account_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_okta_account: + operation: + $ref: >- + #/paths/~1api~1v2~1integrations~1okta~1accounts~1{account_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/okta_accounts/methods/get_okta_account + - $ref: >- + #/components/x-stackQL-resources/okta_accounts/methods/list_okta_accounts + insert: + - $ref: >- + #/components/x-stackQL-resources/okta_accounts/methods/create_okta_account + update: + - $ref: >- + #/components/x-stackQL-resources/okta_accounts/methods/update_okta_account + delete: + - $ref: >- + #/components/x-stackQL-resources/okta_accounts/methods/delete_okta_account + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/ip_allowlist.yaml b/providers/src/datadog/v00.00.00000/services/ip_allowlist.yaml deleted file mode 100644 index 741b97ba..00000000 --- a/providers/src/datadog/v00.00.00000/services/ip_allowlist.yaml +++ /dev/null @@ -1,1067 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - ip_allowlist - description: IP_Allowlist -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - IPAllowlistResponse: - description: Response containing information about the IP allowlist. - properties: - data: - $ref: '#/components/schemas/IPAllowlistData' - type: object - IPAllowlistData: - description: IP allowlist data. - properties: - attributes: - $ref: '#/components/schemas/IPAllowlistAttributes' - id: - description: The unique identifier of the org. - type: string - type: - $ref: '#/components/schemas/IPAllowlistType' - required: - - type - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - IPAllowlistAttributes: - description: Attributes of the IP allowlist. - properties: - enabled: - description: Whether the IP allowlist logic is enabled or not. - type: boolean - entries: - description: Array of entries in the IP allowlist. - items: - $ref: '#/components/schemas/IPAllowlistEntry' - type: array - type: object - IPAllowlistType: - default: ip_allowlist - description: IP allowlist type. - enum: - - ip_allowlist - example: ip_allowlist - type: string - x-enum-varnames: - - IP_ALLOWLIST - IPAllowlistEntry: - description: IP allowlist entry object. - properties: - data: - $ref: '#/components/schemas/IPAllowlistEntryData' - required: - - data - type: object - IPAllowlistEntryData: - description: Data of the IP allowlist entry object. - properties: - attributes: - $ref: '#/components/schemas/IPAllowlistEntryAttributes' - id: - description: The unique identifier of the IP allowlist entry. - type: string - type: - $ref: '#/components/schemas/IPAllowlistEntryType' - required: - - type - type: object - IPAllowlistEntryAttributes: - description: Attributes of the IP allowlist entry. - properties: - cidr_block: - description: The CIDR block describing the IP range of the entry. - type: string - created_at: - description: Creation time of the entry. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last entry modification. - format: date-time - readOnly: true - type: string - note: - description: A note describing the IP allowlist entry. - type: string - type: object - IPAllowlistEntryType: - default: ip_allowlist_entry - description: IP allowlist Entry type. - enum: - - ip_allowlist_entry - example: ip_allowlist_entry - type: string - x-enum-varnames: - - IP_ALLOWLIST_ENTRY - IPAllowlistUpdateRequest: - description: Update the IP allowlist. - properties: - data: - $ref: '#/components/schemas/IPAllowlistData' - required: - - data - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - ip_allowlists: - id: datadog.ip_allowlist.ip_allowlists - name: ip_allowlists - title: Ip Allowlists - methods: - get_ip_allowlist: - operation: - $ref: '#/paths/~1api~1v2~1ip_allowlist/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_ip_allowlist: - operation: - $ref: '#/paths/~1api~1v2~1ip_allowlist/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_ip_allowlist: - operation: - $ref: '#/paths/~1api~1v2~1ip_allowlist/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/ip_allowlists/methods/get_ip_allowlist' - insert: [] - update: [] - delete: [] -paths: - /api/v2/ip_allowlist: - get: - description: Returns the IP allowlist and its enabled or disabled state. - operationId: GetIPAllowlist - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IPAllowlistResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get IP Allowlist - tags: - - IP Allowlist - patch: - description: 'Edit the entries in the IP allowlist, and enable or disable it.' - operationId: UpdateIPAllowlist - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/IPAllowlistUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/IPAllowlistResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update IP Allowlist - tags: - - IP Allowlist - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/key_management.yaml b/providers/src/datadog/v00.00.00000/services/key_management.yaml deleted file mode 100644 index afe6d67d..00000000 --- a/providers/src/datadog/v00.00.00000/services/key_management.yaml +++ /dev/null @@ -1,2241 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - key_management - description: Key_Management -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - APIKeysResponse: - description: Response for a list of API keys. - properties: - data: - description: Array of API keys. - items: - $ref: '#/components/schemas/PartialAPIKey' - type: array - included: - description: Array of objects related to the API key. - items: - $ref: '#/components/schemas/APIKeyResponseIncludedItem' - type: array - meta: - $ref: '#/components/schemas/APIKeysResponseMeta' - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - PartialAPIKey: - description: Partial Datadog API key. - properties: - attributes: - $ref: '#/components/schemas/PartialAPIKeyAttributes' - id: - description: ID of the API key. - type: string - relationships: - $ref: '#/components/schemas/APIKeyRelationships' - type: - $ref: '#/components/schemas/APIKeysType' - type: object - APIKeyResponseIncludedItem: - description: An object related to an API key. - oneOf: - - $ref: '#/components/schemas/User' - APIKeysResponseMeta: - description: Additional information related to api keys response. - properties: - max_allowed: - description: Max allowed number of API keys. - format: int64 - type: integer - page: - $ref: '#/components/schemas/APIKeysResponseMetaPage' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - PartialAPIKeyAttributes: - description: Attributes of a partial API key. - properties: - category: - description: The category of the API key. - type: string - created_at: - description: Creation date of the API key. - example: '2020-11-23T10:00:00.000Z' - readOnly: true - type: string - last4: - description: The last four characters of the API key. - example: abcd - maxLength: 4 - minLength: 4 - readOnly: true - type: string - modified_at: - description: Date the API key was last modified. - example: '2020-11-23T10:00:00.000Z' - readOnly: true - type: string - name: - description: Name of the API key. - example: API Key for submitting metrics - type: string - remote_config_read_enabled: - description: The remote config read enabled status. - type: boolean - type: object - APIKeyRelationships: - description: Resources related to the API key. - properties: - created_by: - $ref: '#/components/schemas/RelationshipToUser' - modified_by: - $ref: '#/components/schemas/RelationshipToUser' - type: object - APIKeysType: - default: api_keys - description: API Keys resource type. - enum: - - api_keys - example: api_keys - type: string - x-enum-varnames: - - API_KEYS - User: - description: User object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserAttributes' - id: - description: ID of the user. - type: string - relationships: - $ref: '#/components/schemas/UserResponseRelationships' - type: - $ref: '#/components/schemas/UsersType' - type: object - APIKeysResponseMetaPage: - description: Additional information related to the API keys response. - properties: - total_filtered_count: - description: Total filtered application key count. - format: int64 - type: integer - type: object - RelationshipToUser: - description: Relationship to user. - properties: - data: - $ref: '#/components/schemas/RelationshipToUserData' - required: - - data - type: object - UserAttributes: - description: Attributes of user object returned by the API. - properties: - created_at: - description: Creation time of the user. - format: date-time - type: string - disabled: - description: Whether the user is disabled. - type: boolean - email: - description: Email of the user. - type: string - handle: - description: Handle of the user. - type: string - icon: - description: URL of the user's icon. - type: string - modified_at: - description: Time that the user was last modified. - format: date-time - type: string - name: - description: Name of the user. - nullable: true - type: string - service_account: - description: Whether the user is a service account. - type: boolean - status: - description: Status of the user. - type: string - title: - description: Title of the user. - nullable: true - type: string - verified: - description: Whether the user is verified. - type: boolean - type: object - UserResponseRelationships: - description: Relationships of the user object returned by the API. - properties: - org: - $ref: '#/components/schemas/RelationshipToOrganization' - other_orgs: - $ref: '#/components/schemas/RelationshipToOrganizations' - other_users: - $ref: '#/components/schemas/RelationshipToUsers' - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - UsersType: - default: users - description: Users resource type. - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - RelationshipToUserData: - description: Relationship to user object. - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - RelationshipToOrganization: - description: Relationship to an organization. - properties: - data: - $ref: '#/components/schemas/RelationshipToOrganizationData' - required: - - data - type: object - RelationshipToOrganizations: - description: Relationship to organizations. - properties: - data: - description: Relationships to organization objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToOrganizationData' - type: array - required: - - data - type: object - RelationshipToUsers: - description: Relationship to users. - properties: - data: - description: Relationships to user objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToUserData' - type: array - required: - - data - type: object - RelationshipToRoles: - description: Relationship to roles. - properties: - data: - description: An array containing type and the unique identifier of a role. - items: - $ref: '#/components/schemas/RelationshipToRoleData' - type: array - type: object - RelationshipToOrganizationData: - description: Relationship to organization object. - properties: - id: - description: ID of the organization. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - id - - type - type: object - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - OrganizationsType: - default: orgs - description: Organizations resource type. - enum: - - orgs - example: orgs - type: string - x-enum-varnames: - - ORGS - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - APIKeyCreateRequest: - description: Request used to create an API key. - properties: - data: - $ref: '#/components/schemas/APIKeyCreateData' - required: - - data - type: object - APIKeyResponse: - description: Response for retrieving an API key. - properties: - data: - $ref: '#/components/schemas/FullAPIKey' - included: - description: Array of objects related to the API key. - items: - $ref: '#/components/schemas/APIKeyResponseIncludedItem' - type: array - type: object - APIKeyCreateData: - description: Object used to create an API key. - properties: - attributes: - $ref: '#/components/schemas/APIKeyCreateAttributes' - type: - $ref: '#/components/schemas/APIKeysType' - required: - - attributes - - type - type: object - FullAPIKey: - description: Datadog API key. - properties: - attributes: - $ref: '#/components/schemas/FullAPIKeyAttributes' - id: - description: ID of the API key. - type: string - relationships: - $ref: '#/components/schemas/APIKeyRelationships' - type: - $ref: '#/components/schemas/APIKeysType' - type: object - APIKeyCreateAttributes: - description: Attributes used to create an API Key. - properties: - name: - description: Name of the API key. - example: API Key for submitting metrics - type: string - required: - - name - type: object - FullAPIKeyAttributes: - description: Attributes of a full API key. - properties: - category: - description: The category of the API key. - type: string - created_at: - description: Creation date of the API key. - example: '2020-11-23T10:00:00.000Z' - readOnly: true - type: string - key: - description: The API key. - readOnly: true - type: string - last4: - description: The last four characters of the API key. - example: abcd - maxLength: 4 - minLength: 4 - readOnly: true - type: string - modified_at: - description: Date the API key was last modified. - example: '2020-11-23T10:00:00.000Z' - readOnly: true - type: string - name: - description: Name of the API key. - example: API Key for submitting metrics - type: string - remote_config_read_enabled: - description: The remote config read enabled status. - type: boolean - type: object - APIKeyUpdateRequest: - description: Request used to update an API key. - properties: - data: - $ref: '#/components/schemas/APIKeyUpdateData' - required: - - data - type: object - APIKeyUpdateData: - description: Object used to update an API key. - properties: - attributes: - $ref: '#/components/schemas/APIKeyUpdateAttributes' - id: - description: ID of the API key. - example: 00112233-4455-6677-8899-aabbccddeeff - type: string - type: - $ref: '#/components/schemas/APIKeysType' - required: - - attributes - - id - - type - type: object - APIKeyUpdateAttributes: - description: Attributes used to update an API Key. - properties: - name: - description: Name of the API key. - example: API Key for submitting metrics - type: string - required: - - name - type: object - ListApplicationKeysResponse: - description: Response for a list of application keys. - properties: - data: - description: Array of application keys. - items: - $ref: '#/components/schemas/PartialApplicationKey' - type: array - included: - description: Array of objects related to the application key. - items: - $ref: '#/components/schemas/ApplicationKeyResponseIncludedItem' - type: array - meta: - $ref: '#/components/schemas/ApplicationKeyResponseMeta' - type: object - PartialApplicationKey: - description: Partial Datadog application key. - properties: - attributes: - $ref: '#/components/schemas/PartialApplicationKeyAttributes' - id: - description: ID of the application key. - type: string - relationships: - $ref: '#/components/schemas/ApplicationKeyRelationships' - type: - $ref: '#/components/schemas/ApplicationKeysType' - type: object - ApplicationKeyResponseIncludedItem: - description: An object related to an application key. - oneOf: - - $ref: '#/components/schemas/User' - - $ref: '#/components/schemas/Role' - ApplicationKeyResponseMeta: - description: Additional information related to the application key response. - properties: - max_allowed_per_user: - description: Max allowed number of application keys per user. - format: int64 - type: integer - page: - $ref: '#/components/schemas/ApplicationKeyResponseMetaPage' - type: object - PartialApplicationKeyAttributes: - description: Attributes of a partial application key. - properties: - created_at: - description: Creation date of the application key. - example: '2020-11-23T10:00:00.000Z' - readOnly: true - type: string - last4: - description: The last four characters of the application key. - example: abcd - maxLength: 4 - minLength: 4 - readOnly: true - type: string - name: - description: Name of the application key. - example: Application Key for managing dashboards - type: string - scopes: - description: Array of scopes to grant the application key. - example: - - dashboards_read - - dashboards_write - - dashboards_public_share - items: - description: Name of scope. - type: string - nullable: true - type: array - type: object - ApplicationKeyRelationships: - description: Resources related to the application key. - properties: - owned_by: - $ref: '#/components/schemas/RelationshipToUser' - type: object - ApplicationKeysType: - default: application_keys - description: Application Keys resource type. - enum: - - application_keys - example: application_keys - type: string - x-enum-varnames: - - APPLICATION_KEYS - Role: - description: Role object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/RoleAttributes' - id: - description: The unique identifier of the role. - type: string - relationships: - $ref: '#/components/schemas/RoleResponseRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - type: object - ApplicationKeyResponseMetaPage: - description: Additional information related to the application key response. - properties: - total_filtered_count: - description: Total filtered application key count. - format: int64 - type: integer - type: object - RoleAttributes: - description: Attributes of the role. - properties: - created_at: - description: Creation time of the role. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last role modification. - format: date-time - readOnly: true - type: string - name: - description: The name of the role. The name is neither unique nor a stable identifier of the role. - type: string - user_count: - description: Number of users with that role. - format: int64 - readOnly: true - type: integer - type: object - RoleResponseRelationships: - description: Relationships of the role object returned by the API. - properties: - permissions: - $ref: '#/components/schemas/RelationshipToPermissions' - type: object - RelationshipToPermissions: - description: Relationship to multiple permissions objects. - properties: - data: - description: Relationships to permission objects. - items: - $ref: '#/components/schemas/RelationshipToPermissionData' - type: array - type: object - RelationshipToPermissionData: - description: Relationship to permission object. - properties: - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - type: object - PermissionsType: - default: permissions - description: Permissions resource type. - enum: - - permissions - example: permissions - type: string - x-enum-varnames: - - PERMISSIONS - ApplicationKeyResponse: - description: Response for retrieving an application key. - properties: - data: - $ref: '#/components/schemas/FullApplicationKey' - included: - description: Array of objects related to the application key. - items: - $ref: '#/components/schemas/ApplicationKeyResponseIncludedItem' - type: array - type: object - FullApplicationKey: - description: Datadog application key. - properties: - attributes: - $ref: '#/components/schemas/FullApplicationKeyAttributes' - id: - description: ID of the application key. - type: string - relationships: - $ref: '#/components/schemas/ApplicationKeyRelationships' - type: - $ref: '#/components/schemas/ApplicationKeysType' - type: object - FullApplicationKeyAttributes: - description: Attributes of a full application key. - properties: - created_at: - description: Creation date of the application key. - example: '2020-11-23T10:00:00.000Z' - readOnly: true - type: string - key: - description: The application key. - readOnly: true - type: string - last4: - description: The last four characters of the application key. - example: abcd - maxLength: 4 - minLength: 4 - readOnly: true - type: string - name: - description: Name of the application key. - example: Application Key for managing dashboards - type: string - scopes: - description: Array of scopes to grant the application key. - example: - - dashboards_read - - dashboards_write - - dashboards_public_share - items: - description: Name of scope. - type: string - nullable: true - type: array - type: object - ApplicationKeyUpdateRequest: - description: Request used to update an application key. - properties: - data: - $ref: '#/components/schemas/ApplicationKeyUpdateData' - required: - - data - type: object - ApplicationKeyUpdateData: - description: Object used to update an application key. - properties: - attributes: - $ref: '#/components/schemas/ApplicationKeyUpdateAttributes' - id: - description: ID of the application key. - example: 00112233-4455-6677-8899-aabbccddeeff - type: string - type: - $ref: '#/components/schemas/ApplicationKeysType' - required: - - attributes - - id - - type - type: object - ApplicationKeyUpdateAttributes: - description: Attributes used to update an application Key. - properties: - name: - description: Name of the application key. - example: Application Key for managing dashboards - type: string - scopes: - description: Array of scopes to grant the application key. - example: - - dashboards_read - - dashboards_write - - dashboards_public_share - items: - description: Name of scope. - type: string - nullable: true - type: array - type: object - ApplicationKeyCreateRequest: - description: Request used to create an application key. - properties: - data: - $ref: '#/components/schemas/ApplicationKeyCreateData' - required: - - data - type: object - ApplicationKeyCreateData: - description: Object used to create an application key. - properties: - attributes: - $ref: '#/components/schemas/ApplicationKeyCreateAttributes' - type: - $ref: '#/components/schemas/ApplicationKeysType' - required: - - attributes - - type - type: object - ApplicationKeyCreateAttributes: - description: Attributes used to create an application Key. - properties: - name: - description: Name of the application key. - example: Application Key for managing dashboards - type: string - scopes: - description: Array of scopes to grant the application key. - example: - - dashboards_read - - dashboards_write - - dashboards_public_share - items: - description: Name of scope. - type: string - nullable: true - type: array - required: - - name - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - api_keys: - id: datadog.key_management.api_keys - name: api_keys - title: Api Keys - methods: - list_api_keys: - operation: - $ref: '#/paths/~1api~1v2~1api_keys/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_api_keys: - operation: - $ref: '#/paths/~1api~1v2~1api_keys/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_api_key: - operation: - $ref: '#/paths/~1api~1v2~1api_keys/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_api_key: - operation: - $ref: '#/paths/~1api~1v2~1api_keys~1{api_key_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_api_key: - operation: - $ref: '#/paths/~1api~1v2~1api_keys~1{api_key_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_api_key: - operation: - $ref: '#/paths/~1api~1v2~1api_keys~1{api_key_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_api_key: - operation: - $ref: '#/paths/~1api~1v2~1api_keys~1{api_key_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/api_keys/methods/get_api_key' - - $ref: '#/components/x-stackQL-resources/api_keys/methods/list_api_keys' - insert: - - $ref: '#/components/x-stackQL-resources/api_keys/methods/create_api_key' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/api_keys/methods/delete_api_key' - application_keys: - id: datadog.key_management.application_keys - name: application_keys - title: Application Keys - methods: - list_application_keys: - operation: - $ref: '#/paths/~1api~1v2~1application_keys/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_application_keys: - operation: - $ref: '#/paths/~1api~1v2~1application_keys/get' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_application_key: - operation: - $ref: '#/paths/~1api~1v2~1application_keys~1{app_key_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_application_key: - operation: - $ref: '#/paths/~1api~1v2~1application_keys~1{app_key_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_application_key: - operation: - $ref: '#/paths/~1api~1v2~1application_keys~1{app_key_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_application_key: - operation: - $ref: '#/paths/~1api~1v2~1application_keys~1{app_key_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/application_keys/methods/get_application_key' - - $ref: '#/components/x-stackQL-resources/application_keys/methods/list_application_keys' - insert: [] - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/application_keys/methods/delete_application_key' - current_user_application_keys: - id: datadog.key_management.current_user_application_keys - name: current_user_application_keys - title: Current User Application Keys - methods: - list_current_user_application_keys: - operation: - $ref: '#/paths/~1api~1v2~1current_user~1application_keys/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_current_user_application_keys: - operation: - $ref: '#/paths/~1api~1v2~1current_user~1application_keys/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_current_user_application_key: - operation: - $ref: '#/paths/~1api~1v2~1current_user~1application_keys/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_current_user_application_key: - operation: - $ref: '#/paths/~1api~1v2~1current_user~1application_keys~1{app_key_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_current_user_application_key: - operation: - $ref: '#/paths/~1api~1v2~1current_user~1application_keys~1{app_key_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_current_user_application_key: - operation: - $ref: '#/paths/~1api~1v2~1current_user~1application_keys~1{app_key_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_current_user_application_key: - operation: - $ref: '#/paths/~1api~1v2~1current_user~1application_keys~1{app_key_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/current_user_application_keys/methods/get_current_user_application_key' - - $ref: '#/components/x-stackQL-resources/current_user_application_keys/methods/list_current_user_application_keys' - insert: - - $ref: '#/components/x-stackQL-resources/current_user_application_keys/methods/create_current_user_application_key' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/current_user_application_keys/methods/delete_current_user_application_key' -paths: - /api/v2/api_keys: - get: - description: List all API keys available for your account. - operationId: ListAPIKeys - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - $ref: '#/components/parameters/APIKeysSortParameter' - - $ref: '#/components/parameters/APIKeyFilterParameter' - - $ref: '#/components/parameters/APIKeyFilterCreatedAtStartParameter' - - $ref: '#/components/parameters/APIKeyFilterCreatedAtEndParameter' - - $ref: '#/components/parameters/APIKeyFilterModifiedAtStartParameter' - - $ref: '#/components/parameters/APIKeyFilterModifiedAtEndParameter' - - $ref: '#/components/parameters/APIKeyIncludeParameter' - - $ref: '#/components/parameters/APIKeyReadConfigReadEnabledParameter' - - $ref: '#/components/parameters/APIKeyCategoryParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/APIKeysResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get all API keys - tags: - - Key Management - post: - description: Create an API key. - operationId: CreateAPIKey - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/APIKeyCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/APIKeyResponse' - description: Created - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create an API key - tags: - - Key Management - x-codegen-request-body-name: body - '/api/v2/api_keys/{api_key_id}': - delete: - description: Delete an API key. - operationId: DeleteAPIKey - parameters: - - $ref: '#/components/parameters/APIKeyId' - responses: - '204': - description: No Content - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete an API key - tags: - - Key Management - get: - description: Get an API key. - operationId: GetAPIKey - parameters: - - $ref: '#/components/parameters/APIKeyId' - - $ref: '#/components/parameters/APIKeyIncludeParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/APIKeyResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get API key - tags: - - Key Management - patch: - description: Update an API key. - operationId: UpdateAPIKey - parameters: - - $ref: '#/components/parameters/APIKeyId' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/APIKeyUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/APIKeyResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Edit an API key - tags: - - Key Management - x-codegen-request-body-name: body - /api/v2/application_keys: - get: - description: List all application keys available for your org - operationId: ListApplicationKeys - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - $ref: '#/components/parameters/ApplicationKeysSortParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtStartParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtEndParameter' - - $ref: '#/components/parameters/ApplicationKeyIncludeParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ListApplicationKeysResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get all application keys - tags: - - Key Management - '/api/v2/application_keys/{app_key_id}': - delete: - description: Delete an application key - operationId: DeleteApplicationKey - parameters: - - $ref: '#/components/parameters/ApplicationKeyID' - responses: - '204': - description: No Content - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete an application key - tags: - - Key Management - x-codegen-request-body-name: body - get: - description: Get an application key for your org. - operationId: GetApplicationKey - parameters: - - $ref: '#/components/parameters/ApplicationKeyID' - - $ref: '#/components/parameters/ApplicationKeyIncludeParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get an application key - tags: - - Key Management - patch: - description: Edit an application key - operationId: UpdateApplicationKey - parameters: - - $ref: '#/components/parameters/ApplicationKeyID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Edit an application key - tags: - - Key Management - x-codegen-request-body-name: body - /api/v2/current_user/application_keys: - get: - description: List all application keys available for current user - operationId: ListCurrentUserApplicationKeys - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - $ref: '#/components/parameters/ApplicationKeysSortParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtStartParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtEndParameter' - - $ref: '#/components/parameters/ApplicationKeyIncludeParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ListApplicationKeysResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get all application keys owned by current user - tags: - - Key Management - post: - description: Create an application key for current user - operationId: CreateCurrentUserApplicationKey - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyResponse' - description: Created - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create an application key for current user - tags: - - Key Management - x-codegen-request-body-name: body - '/api/v2/current_user/application_keys/{app_key_id}': - delete: - description: Delete an application key owned by current user - operationId: DeleteCurrentUserApplicationKey - parameters: - - $ref: '#/components/parameters/ApplicationKeyID' - responses: - '204': - description: No Content - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete an application key owned by current user - tags: - - Key Management - get: - description: Get an application key owned by current user - operationId: GetCurrentUserApplicationKey - parameters: - - $ref: '#/components/parameters/ApplicationKeyID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get one application key owned by current user - tags: - - Key Management - patch: - description: Edit an application key owned by current user - operationId: UpdateCurrentUserApplicationKey - parameters: - - $ref: '#/components/parameters/ApplicationKeyID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Edit an application key owned by current user - tags: - - Key Management - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/log_archives.yaml b/providers/src/datadog/v00.00.00000/services/log_archives.yaml deleted file mode 100644 index da2f29bf..00000000 --- a/providers/src/datadog/v00.00.00000/services/log_archives.yaml +++ /dev/null @@ -1,1840 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - log_archives - description: Logs_Archives -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - LogsArchiveOrder: - description: A ordered list of archive IDs. - properties: - data: - $ref: '#/components/schemas/LogsArchiveOrderDefinition' - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - LogsArchiveOrderDefinition: - description: The definition of an archive order. - properties: - attributes: - $ref: '#/components/schemas/LogsArchiveOrderAttributes' - type: - $ref: '#/components/schemas/LogsArchiveOrderDefinitionType' - required: - - type - - attributes - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - LogsArchiveOrderAttributes: - description: The attributes associated with the archive order. - properties: - archive_ids: - description: |- - An ordered array of `` strings, the order of archive IDs in the array - define the overall archives order for Datadog. - example: - - a2zcMylnM4OCHpYusxIi1g - - a2zcMylnM4OCHpYusxIi2g - - a2zcMylnM4OCHpYusxIi3g - items: - description: A given archive ID. - type: string - type: array - required: - - archive_ids - type: object - LogsArchiveOrderDefinitionType: - default: archive_order - description: Type of the archive order definition. - enum: - - archive_order - example: archive_order - type: string - x-enum-varnames: - - ARCHIVE_ORDER - LogsArchives: - description: The available archives. - properties: - data: - description: A list of archives. - items: - $ref: '#/components/schemas/LogsArchiveDefinition' - type: array - type: object - LogsArchiveDefinition: - description: The definition of an archive. - properties: - attributes: - $ref: '#/components/schemas/LogsArchiveAttributes' - id: - description: The archive ID. - example: a2zcMylnM4OCHpYusxIi3g - readOnly: true - type: string - type: - default: archives - description: The type of the resource. The value should always be archives. - example: archives - readOnly: true - type: string - required: - - type - type: object - LogsArchiveAttributes: - description: The attributes associated with the archive. - properties: - destination: - $ref: '#/components/schemas/LogsArchiveDestination' - include_tags: - default: false - description: |- - To store the tags in the archive, set the value "true". - If it is set to "false", the tags will be deleted when the logs are sent to the archive. - example: false - type: boolean - name: - description: The archive name. - example: Nginx Archive - type: string - query: - description: The archive query/filter. Logs matching this query are included in the archive. - example: 'source:nginx' - type: string - rehydration_max_scan_size_in_gb: - description: Maximum scan size for rehydration from this archive. - example: 100 - format: int64 - nullable: true - type: integer - rehydration_tags: - description: An array of tags to add to rehydrated logs from an archive. - example: - - 'team:intake' - - 'team:app' - items: - description: 'A given tag in the `:` format.' - type: string - type: array - state: - $ref: '#/components/schemas/LogsArchiveState' - required: - - name - - query - - destination - type: object - LogsArchiveDestination: - description: An archive's destination. - nullable: true - oneOf: - - $ref: '#/components/schemas/LogsArchiveDestinationAzure' - - $ref: '#/components/schemas/LogsArchiveDestinationGCS' - - $ref: '#/components/schemas/LogsArchiveDestinationS3' - required: - - type - - integration - LogsArchiveState: - description: The state of the archive. - enum: - - UNKNOWN - - WORKING - - FAILING - - WORKING_AUTH_LEGACY - example: WORKING - type: string - x-enum-varnames: - - UNKNOWN - - WORKING - - FAILING - - WORKING_AUTH_LEGACY - LogsArchiveDestinationAzure: - description: The Azure archive destination. - properties: - container: - description: The container where the archive will be stored. - example: container-name - type: string - integration: - $ref: '#/components/schemas/LogsArchiveIntegrationAzure' - path: - description: The archive path. - type: string - region: - description: The region where the archive will be stored. - type: string - storage_account: - description: The associated storage account. - example: account-name - type: string - type: - $ref: '#/components/schemas/LogsArchiveDestinationAzureType' - required: - - storage_account - - container - - integration - - type - type: object - LogsArchiveDestinationGCS: - description: The GCS archive destination. - properties: - bucket: - description: The bucket where the archive will be stored. - example: bucket-name - type: string - integration: - $ref: '#/components/schemas/LogsArchiveIntegrationGCS' - path: - description: The archive path. - type: string - type: - $ref: '#/components/schemas/LogsArchiveDestinationGCSType' - required: - - bucket - - integration - - type - type: object - LogsArchiveDestinationS3: - description: The S3 archive destination. - properties: - bucket: - description: The bucket where the archive will be stored. - example: bucket-name - type: string - integration: - $ref: '#/components/schemas/LogsArchiveIntegrationS3' - path: - description: The archive path. - type: string - type: - $ref: '#/components/schemas/LogsArchiveDestinationS3Type' - required: - - bucket - - integration - - type - type: object - LogsArchiveIntegrationAzure: - description: The Azure archive's integration destination. - properties: - client_id: - description: A client ID. - example: aaaaaaaa-1a1a-1a1a-1a1a-aaaaaaaaaaaa - type: string - tenant_id: - description: A tenant ID. - example: aaaaaaaa-1a1a-1a1a-1a1a-aaaaaaaaaaaa - type: string - required: - - tenant_id - - client_id - type: object - LogsArchiveDestinationAzureType: - default: azure - description: Type of the Azure archive destination. - enum: - - azure - example: azure - type: string - x-enum-varnames: - - AZURE - LogsArchiveIntegrationGCS: - description: The GCS archive's integration destination. - properties: - client_email: - description: A client email. - example: youremail@example.com - type: string - project_id: - description: A project ID. - example: project-id - type: string - required: - - project_id - - client_email - type: object - LogsArchiveDestinationGCSType: - default: gcs - description: Type of the GCS archive destination. - enum: - - gcs - example: gcs - type: string - x-enum-varnames: - - GCS - LogsArchiveIntegrationS3: - description: The S3 Archive's integration destination. - properties: - account_id: - description: The account ID for the integration. - example: '123456789012' - type: string - role_name: - description: The path of the integration. - example: role-name - type: string - required: - - role_name - - account_id - type: object - LogsArchiveDestinationS3Type: - default: s3 - description: Type of the S3 archive destination. - enum: - - s3 - example: s3 - type: string - x-enum-varnames: - - S3 - LogsArchiveCreateRequest: - description: The logs archive. - properties: - data: - $ref: '#/components/schemas/LogsArchiveCreateRequestDefinition' - type: object - LogsArchive: - description: The logs archive. - properties: - data: - $ref: '#/components/schemas/LogsArchiveDefinition' - type: object - LogsArchiveCreateRequestDefinition: - description: The definition of an archive. - properties: - attributes: - $ref: '#/components/schemas/LogsArchiveCreateRequestAttributes' - type: - default: archives - description: The type of the resource. The value should always be archives. - example: archives - type: string - required: - - type - type: object - LogsArchiveCreateRequestAttributes: - description: The attributes associated with the archive. - properties: - destination: - $ref: '#/components/schemas/LogsArchiveCreateRequestDestination' - include_tags: - default: false - description: |- - To store the tags in the archive, set the value "true". - If it is set to "false", the tags will be deleted when the logs are sent to the archive. - example: false - type: boolean - name: - description: The archive name. - example: Nginx Archive - type: string - query: - description: The archive query/filter. Logs matching this query are included in the archive. - example: 'source:nginx' - type: string - rehydration_max_scan_size_in_gb: - description: Maximum scan size for rehydration from this archive. - example: 100 - format: int64 - nullable: true - type: integer - rehydration_tags: - description: An array of tags to add to rehydrated logs from an archive. - example: - - 'team:intake' - - 'team:app' - items: - description: 'A given tag in the `:` format.' - type: string - type: array - required: - - name - - query - - destination - type: object - LogsArchiveCreateRequestDestination: - description: An archive's destination. - oneOf: - - $ref: '#/components/schemas/LogsArchiveDestinationAzure' - - $ref: '#/components/schemas/LogsArchiveDestinationGCS' - - $ref: '#/components/schemas/LogsArchiveDestinationS3' - required: - - type - - integration - RelationshipToRole: - description: Relationship to role. - properties: - data: - $ref: '#/components/schemas/RelationshipToRoleData' - type: object - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - RolesResponse: - description: Response containing information about multiple roles. - properties: - data: - description: Array of returned roles. - items: - $ref: '#/components/schemas/Role' - type: array - meta: - $ref: '#/components/schemas/ResponseMetaAttributes' - type: object - Role: - description: Role object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/RoleAttributes' - id: - description: The unique identifier of the role. - type: string - relationships: - $ref: '#/components/schemas/RoleResponseRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - type: object - ResponseMetaAttributes: - description: Object describing meta attributes of response. - properties: - page: - $ref: '#/components/schemas/Pagination' - type: object - RoleAttributes: - description: Attributes of the role. - properties: - created_at: - description: Creation time of the role. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last role modification. - format: date-time - readOnly: true - type: string - name: - description: The name of the role. The name is neither unique nor a stable identifier of the role. - type: string - user_count: - description: Number of users with that role. - format: int64 - readOnly: true - type: integer - type: object - RoleResponseRelationships: - description: Relationships of the role object returned by the API. - properties: - permissions: - $ref: '#/components/schemas/RelationshipToPermissions' - type: object - Pagination: - description: Pagination object. - properties: - total_count: - description: Total count. - format: int64 - type: integer - total_filtered_count: - description: Total count of elements matched by the filter. - format: int64 - type: integer - type: object - RelationshipToPermissions: - description: Relationship to multiple permissions objects. - properties: - data: - description: Relationships to permission objects. - items: - $ref: '#/components/schemas/RelationshipToPermissionData' - type: array - type: object - RelationshipToPermissionData: - description: Relationship to permission object. - properties: - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - type: object - PermissionsType: - default: permissions - description: Permissions resource type. - enum: - - permissions - example: permissions - type: string - x-enum-varnames: - - PERMISSIONS - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - log_archive_orders: - id: datadog.log_archives.log_archive_orders - name: log_archive_orders - title: Log Archive Orders - methods: - get_logs_archive_order: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archive-order/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_logs_archive_order: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archive-order/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_logs_archive_order: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archive-order/put' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/log_archive_orders/methods/get_logs_archive_order' - insert: [] - update: [] - delete: [] - log_archives: - id: datadog.log_archives.log_archives - name: log_archives - title: Log Archives - methods: - list_logs_archives: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_logs_archives: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_logs_archive: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_logs_archive: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_logs_archive: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_logs_archive: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_logs_archive: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}/put' - response: - mediaType: application/json - openAPIDocKey: '200' - remove_role_from_archive: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}~1readers/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - add_read_role_to_archive: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}~1readers/post' - response: - mediaType: application/json - openAPIDocKey: '204' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/log_archives/methods/get_logs_archive' - - $ref: '#/components/x-stackQL-resources/log_archives/methods/list_logs_archives' - insert: - - $ref: '#/components/x-stackQL-resources/log_archives/methods/create_logs_archive' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/log_archives/methods/delete_logs_archive' - archive_read_roles: - id: datadog.log_archives.archive_read_roles - name: archive_read_roles - title: Archive Read Roles - methods: - list_archive_read_roles: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}~1readers/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_archive_read_roles: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}~1readers/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/archive_read_roles/methods/list_archive_read_roles' - insert: [] - update: [] - delete: [] -paths: - /api/v2/logs/config/archive-order: - get: - description: |- - Get the current order of your archives. - This endpoint takes no JSON arguments. - operationId: GetLogsArchiveOrder - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchiveOrder' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get archive order - tags: - - Logs Archives - put: - description: |- - Update the order of your archives. Since logs are processed sequentially, reordering an archive may change - the structure and content of the data processed by other archives. - - **Note**: Using the `PUT` method updates your archive's order by replacing the current order - with the new one. - operationId: UpdateLogsArchiveOrder - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchiveOrder' - description: An object containing the new ordered list of archive IDs. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchiveOrder' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unprocessable Entity - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update archive order - tags: - - Logs Archives - x-codegen-request-body-name: body - /api/v2/logs/config/archives: - get: - description: Get the list of configured logs archives with their definitions. - operationId: ListLogsArchives - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchives' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get all archives - tags: - - Logs Archives - post: - description: Create an archive in your organization. - operationId: CreateLogsArchive - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchiveCreateRequest' - description: The definition of the new archive. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchive' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create an archive - tags: - - Logs Archives - x-codegen-request-body-name: body - '/api/v2/logs/config/archives/{archive_id}': - delete: - description: Delete a given archive from your organization. - operationId: DeleteLogsArchive - parameters: - - $ref: '#/components/parameters/ArchiveID' - responses: - '204': - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete an archive - tags: - - Logs Archives - get: - description: Get a specific archive from your organization. - operationId: GetLogsArchive - parameters: - - $ref: '#/components/parameters/ArchiveID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchive' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get an archive - tags: - - Logs Archives - put: - description: |- - Update a given archive configuration. - - **Note**: Using this method updates your archive configuration by **replacing** - your current configuration with the new one sent to your Datadog organization. - operationId: UpdateLogsArchive - parameters: - - $ref: '#/components/parameters/ArchiveID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchiveCreateRequest' - description: New definition of the archive. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsArchive' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update an archive - tags: - - Logs Archives - x-codegen-request-body-name: body - '/api/v2/logs/config/archives/{archive_id}/readers': - delete: - description: 'Removes a role from an archive. ([Roles API](https://docs.datadoghq.com/api/v2/roles/))' - operationId: RemoveRoleFromArchive - parameters: - - $ref: '#/components/parameters/ArchiveID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RelationshipToRole' - required: true - responses: - '204': - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Revoke role from an archive - tags: - - Logs Archives - x-codegen-request-body-name: body - get: - description: Returns all read roles a given archive is restricted to. - operationId: ListArchiveReadRoles - parameters: - - $ref: '#/components/parameters/ArchiveID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RolesResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: List read roles for an archive - tags: - - Logs Archives - x-codegen-request-body-name: body - post: - description: 'Adds a read role to an archive. ([Roles API](https://docs.datadoghq.com/api/v2/roles/))' - operationId: AddReadRoleToArchive - parameters: - - $ref: '#/components/parameters/ArchiveID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RelationshipToRole' - required: true - responses: - '204': - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Grant role to an archive - tags: - - Logs Archives - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/log_metrics.yaml b/providers/src/datadog/v00.00.00000/services/log_metrics.yaml deleted file mode 100644 index 659ffd32..00000000 --- a/providers/src/datadog/v00.00.00000/services/log_metrics.yaml +++ /dev/null @@ -1,1305 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - log_metrics - description: Logs_Metrics -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - LogsMetricsResponse: - description: All the available log-based metric objects. - properties: - data: - description: A list of log-based metric objects. - items: - $ref: '#/components/schemas/LogsMetricResponseData' - type: array - type: object - LogsMetricResponseData: - description: The log-based metric properties. - properties: - attributes: - $ref: '#/components/schemas/LogsMetricResponseAttributes' - id: - $ref: '#/components/schemas/LogsMetricID' - type: - $ref: '#/components/schemas/LogsMetricType' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - LogsMetricResponseAttributes: - description: The object describing a Datadog log-based metric. - properties: - compute: - $ref: '#/components/schemas/LogsMetricResponseCompute' - filter: - $ref: '#/components/schemas/LogsMetricResponseFilter' - group_by: - description: The rules for the group by. - items: - $ref: '#/components/schemas/LogsMetricResponseGroupBy' - type: array - type: object - LogsMetricID: - description: The name of the log-based metric. - example: logs.page.load.count - type: string - LogsMetricType: - default: logs_metrics - description: The type of the resource. The value should always be logs_metrics. - enum: - - logs_metrics - example: logs_metrics - type: string - x-enum-varnames: - - LOGS_METRICS - LogsMetricResponseCompute: - description: The compute rule to compute the log-based metric. - properties: - aggregation_type: - $ref: '#/components/schemas/LogsMetricResponseComputeAggregationType' - include_percentiles: - $ref: '#/components/schemas/LogsMetricComputeIncludePercentiles' - path: - description: The path to the value the log-based metric will aggregate on (only used if the aggregation type is a "distribution"). - example: '@duration' - type: string - type: object - LogsMetricResponseFilter: - description: The log-based metric filter. Logs matching this filter will be aggregated in this metric. - properties: - query: - description: The search query - following the log search syntax. - example: 'service:web* AND @http.status_code:[200 TO 299]' - type: string - type: object - LogsMetricResponseGroupBy: - description: A group by rule. - properties: - path: - description: The path to the value the log-based metric will be aggregated over. - example: '@http.status_code' - type: string - tag_name: - description: 'Eventual name of the tag that gets created. By default, the path attribute is used as the tag name.' - example: status_code - type: string - type: object - LogsMetricResponseComputeAggregationType: - description: The type of aggregation to use. - enum: - - count - - distribution - example: distribution - type: string - x-enum-varnames: - - COUNT - - DISTRIBUTION - LogsMetricComputeIncludePercentiles: - description: |- - Toggle to include or exclude percentile aggregations for distribution metrics. - Only present when the `aggregation_type` is `distribution`. - example: true - type: boolean - LogsMetricCreateRequest: - description: The new log-based metric body. - properties: - data: - $ref: '#/components/schemas/LogsMetricCreateData' - required: - - data - type: object - LogsMetricResponse: - description: The log-based metric object. - properties: - data: - $ref: '#/components/schemas/LogsMetricResponseData' - type: object - LogsMetricCreateData: - description: The new log-based metric properties. - properties: - attributes: - $ref: '#/components/schemas/LogsMetricCreateAttributes' - id: - $ref: '#/components/schemas/LogsMetricID' - type: - $ref: '#/components/schemas/LogsMetricType' - required: - - id - - type - - attributes - type: object - LogsMetricCreateAttributes: - description: The object describing the Datadog log-based metric to create. - properties: - compute: - $ref: '#/components/schemas/LogsMetricCompute' - filter: - $ref: '#/components/schemas/LogsMetricFilter' - group_by: - description: The rules for the group by. - items: - $ref: '#/components/schemas/LogsMetricGroupBy' - type: array - required: - - compute - type: object - LogsMetricCompute: - description: The compute rule to compute the log-based metric. - properties: - aggregation_type: - $ref: '#/components/schemas/LogsMetricComputeAggregationType' - include_percentiles: - $ref: '#/components/schemas/LogsMetricComputeIncludePercentiles' - path: - description: The path to the value the log-based metric will aggregate on (only used if the aggregation type is a "distribution"). - example: '@duration' - type: string - required: - - aggregation_type - type: object - LogsMetricFilter: - description: The log-based metric filter. Logs matching this filter will be aggregated in this metric. - properties: - query: - default: '*' - description: The search query - following the log search syntax. - example: 'service:web* AND @http.status_code:[200 TO 299]' - type: string - type: object - LogsMetricGroupBy: - description: A group by rule. - properties: - path: - description: The path to the value the log-based metric will be aggregated over. - example: '@http.status_code' - type: string - tag_name: - description: 'Eventual name of the tag that gets created. By default, the path attribute is used as the tag name.' - example: status_code - type: string - required: - - path - type: object - LogsMetricComputeAggregationType: - description: The type of aggregation to use. - enum: - - count - - distribution - example: distribution - type: string - x-enum-varnames: - - COUNT - - DISTRIBUTION - LogsMetricUpdateRequest: - description: The new log-based metric body. - properties: - data: - $ref: '#/components/schemas/LogsMetricUpdateData' - required: - - data - type: object - LogsMetricUpdateData: - description: The new log-based metric properties. - properties: - attributes: - $ref: '#/components/schemas/LogsMetricUpdateAttributes' - type: - $ref: '#/components/schemas/LogsMetricType' - required: - - type - - attributes - type: object - LogsMetricUpdateAttributes: - description: The log-based metric properties that will be updated. - properties: - compute: - $ref: '#/components/schemas/LogsMetricUpdateCompute' - filter: - $ref: '#/components/schemas/LogsMetricFilter' - group_by: - description: The rules for the group by. - items: - $ref: '#/components/schemas/LogsMetricGroupBy' - type: array - type: object - LogsMetricUpdateCompute: - description: The compute rule to compute the log-based metric. - properties: - include_percentiles: - $ref: '#/components/schemas/LogsMetricComputeIncludePercentiles' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ConflictResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - log_metrics: - id: datadog.log_metrics.log_metrics - name: log_metrics - title: Log Metrics - methods: - list_logs_metrics: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1metrics/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_logs_metrics: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1metrics/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_logs_metric: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1metrics/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_logs_metric: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1metrics~1{metric_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_logs_metric: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1metrics~1{metric_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_logs_metric: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1metrics~1{metric_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_logs_metric: - operation: - $ref: '#/paths/~1api~1v2~1logs~1config~1metrics~1{metric_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/log_metrics/methods/get_logs_metric' - - $ref: '#/components/x-stackQL-resources/log_metrics/methods/list_logs_metrics' - insert: - - $ref: '#/components/x-stackQL-resources/log_metrics/methods/create_logs_metric' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/log_metrics/methods/delete_logs_metric' -paths: - /api/v2/logs/config/metrics: - get: - description: Get the list of configured log-based metrics with their definitions. - operationId: ListLogsMetrics - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsMetricsResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get all log-based metrics - tags: - - Logs Metrics - post: - description: |- - Create a metric based on your ingested logs in your organization. - Returns the log-based metric object from the request body when the request is successful. - operationId: CreateLogsMetric - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LogsMetricCreateRequest' - description: The definition of the new log-based metric. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsMetricResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a log-based metric - tags: - - Logs Metrics - x-codegen-request-body-name: body - '/api/v2/logs/config/metrics/{metric_id}': - delete: - description: Delete a specific log-based metric from your organization. - operationId: DeleteLogsMetric - parameters: - - $ref: '#/components/parameters/MetricID' - responses: - '204': - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete a log-based metric - tags: - - Logs Metrics - get: - description: Get a specific log-based metric from your organization. - operationId: GetLogsMetric - parameters: - - $ref: '#/components/parameters/MetricID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsMetricResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get a log-based metric - tags: - - Logs Metrics - patch: - description: |- - Update a specific log-based metric from your organization. - Returns the log-based metric object from the request body when the request is successful. - operationId: UpdateLogsMetric - parameters: - - $ref: '#/components/parameters/MetricID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LogsMetricUpdateRequest' - description: New definition of the log-based metric. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsMetricResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update a log-based metric - tags: - - Logs Metrics - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/logs.yaml b/providers/src/datadog/v00.00.00000/services/logs.yaml index ef5bfa0a..50f440dd 100644 --- a/providers/src/datadog/v00.00.00000/services/logs.yaml +++ b/providers/src/datadog/v00.00.00000/services/logs.yaml @@ -1,573 +1,1225 @@ openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' + title: logs API + description: datadog logs API version: '1.0' - title: Datadog API V2 Collection - logs - description: Search your logs and send them to your Datadog platform over HTTP. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ContentEncoding: - description: HTTP header used to compress the media-type. - enum: - - identity - - gzip - - deflate - type: string - x-enum-varnames: - - IDENTITY - - GZIP - - DEFLATE - HTTPLog: - description: Structured log message. - items: - $ref: '#/components/schemas/HTTPLogItem' - type: array - HTTPLogErrors: - description: Invalid query performed. - properties: - errors: - description: Structured errors. - items: - $ref: '#/components/schemas/HTTPLogError' - type: array - type: object - HTTPLogItem: - additionalProperties: - description: Additional log attributes. - type: string - description: Logs that are sent over HTTP. - properties: - ddsource: - description: |- - The integration name associated with your log: the technology from which the log originated. - When it matches an integration name, Datadog automatically installs the corresponding parsers and facets. - See [reserved attributes](https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention/#reserved-attributes). - example: nginx - type: string - ddtags: - description: Tags associated with your logs. - example: 'env:staging,version:5.1' - type: string - hostname: - description: The name of the originating host of the log. - example: i-012345678 - type: string - message: - description: |- - The message [reserved attribute](https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention/#reserved-attributes) - of your log. By default, Datadog ingests the value of the message attribute as the body of the log entry. - That value is then highlighted and displayed in the Logstream, where it is indexed for full text search. - example: '2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World' - type: string - service: - description: |- - The name of the application or service generating the log events. - It is used to switch from Logs to APM, so make sure you define the same value when you use both products. - See [reserved attributes](https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention/#reserved-attributes). - example: payment - type: string - required: - - message - type: object - HTTPLogError: - description: List of errors. - properties: - detail: - description: Error message. - example: Malformed payload - type: string - status: - description: Error code. - example: '400' - type: string - title: - description: Error title. - example: Bad Request - type: string - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - LogsAggregateRequest: - description: The object sent with the request to retrieve a list of logs from your organization. - properties: - compute: - description: The list of metrics or timeseries to compute for the retrieved buckets. - items: - $ref: '#/components/schemas/LogsCompute' - type: array - filter: - $ref: '#/components/schemas/LogsQueryFilter' - group_by: - description: The rules for the group by - items: - $ref: '#/components/schemas/LogsGroupBy' - type: array - options: - $ref: '#/components/schemas/LogsQueryOptions' - page: - $ref: '#/components/schemas/LogsAggregateRequestPage' - type: object - LogsAggregateResponse: - description: The response object for the logs aggregate API endpoint - properties: - data: - $ref: '#/components/schemas/LogsAggregateResponseData' - meta: - $ref: '#/components/schemas/LogsResponseMetadata' - type: object - LogsCompute: - description: A compute rule to compute metrics or timeseries - properties: - aggregation: - $ref: '#/components/schemas/LogsAggregationFunction' - interval: - description: |- - The time buckets' size (only used for type=timeseries) - Defaults to a resolution of 150 points - example: 5m - type: string - metric: - description: The metric to use - example: '@duration' - type: string - type: - $ref: '#/components/schemas/LogsComputeType' - required: - - aggregation - type: object - LogsQueryFilter: - description: The search and filter query settings - properties: - from: - default: now-15m - description: 'The minimum time for the requested logs, supports date math and regular timestamps (milliseconds).' - example: now-15m - type: string - indexes: - default: - - '*' - description: 'For customers with multiple indexes, the indexes to search. Defaults to [''*''] which means all indexes.' - example: - - main - - web - items: - description: The name of a log index. +paths: + /api/v2/logs: + post: + description: >- + Send your logs to your Datadog platform over HTTP. Limits per HTTP + request are: + + + - Maximum content size per payload (uncompressed): 5MB + + - Maximum size for a single log: 1MB + + - Maximum array size if sending multiple logs in an array: 1000 entries + + + Any log exceeding 1MB is accepted and truncated by Datadog: + + - For a single log request, the API truncates the log at 1MB and returns + a 2xx. + + - For a multi-logs request, the API processes all logs, truncates only + logs larger than 1MB, and returns a 2xx. + + + Datadog recommends sending your logs compressed. + + Add the `Content-Encoding: gzip` header to the request when sending + compressed logs. + + Log events can be submitted with a timestamp that is up to 18 hours in + the past. + + + The status codes answered by the HTTP API are: + + - 202: Accepted: the request has been accepted for processing + + - 400: Bad request (likely an issue in the payload formatting) + + - 401: Unauthorized (likely a missing API Key) + + - 403: Permission issue (likely using an invalid API Key) + + - 408: Request Timeout, request should be retried after some time + + - 413: Payload too large (batch is above 5MB uncompressed) + + - 429: Too Many Requests, request should be retried after some time + + - 500: Internal Server Error, the server encountered an unexpected + condition that prevented it from fulfilling the request, request should + be retried after some time + + - 503: Service Unavailable, the server is not ready to handle the + request probably because it is overloaded, request should be retried + after some time + operationId: SubmitLog + parameters: + - description: HTTP header used to compress the media-type. + in: header + name: Content-Encoding + required: false + schema: + $ref: '#/components/schemas/ContentEncoding' + - description: >- + Log tags can be passed as query parameters with `text/plain` content + type. + example: env:prod,user:my-user + in: query + name: ddtags + required: false + schema: type: string - type: array - query: - default: '*' - description: The search query - following the log search syntax. - example: 'service:web* AND @http.status_code:[200 TO 299]' - type: string - storage_tier: - $ref: '#/components/schemas/LogsStorageTier' - to: - default: now - description: 'The maximum time for the requested logs, supports date math and regular timestamps (milliseconds).' - example: now - type: string - type: object - LogsGroupBy: - description: A group by rule - properties: - facet: - description: The name of the facet to use (required) - example: host - type: string - histogram: - $ref: '#/components/schemas/LogsGroupByHistogram' - limit: - default: 10 - description: |- - The maximum buckets to return for this group by. Note: at most 10000 buckets are allowed. - If grouping by multiple facets, the product of limits must not exceed 10000. - format: int64 - type: integer - missing: - $ref: '#/components/schemas/LogsGroupByMissing' - sort: - $ref: '#/components/schemas/LogsAggregateSort' - total: - $ref: '#/components/schemas/LogsGroupByTotal' - required: - - facet - type: object - LogsQueryOptions: - description: |- - Global query options that are used during the query. - Note: you should supply either timezone or time offset, but not both. Otherwise, the query will fail. - properties: - timeOffset: - description: The time offset (in seconds) to apply to the query. - format: int64 - type: integer - timezone: - default: UTC - description: 'The timezone can be specified as GMT, UTC, an offset from UTC (like UTC+1), or as a Timezone Database identifier (like America/New_York).' - example: GMT - type: string - type: object - LogsAggregateRequestPage: - description: Paging settings - properties: - cursor: - description: 'The returned paging point to use to get the next results. Note: at most 1000 results can be paged.' - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - type: object - LogsAggregateResponseData: - description: The query results + requestBody: + content: + application/json: + examples: + multi-json-messages: + description: Pass multiple log objects at once. + summary: Multi JSON Messages + value: + - ddsource: nginx + ddtags: env:staging,version:5.1 + hostname: i-012345678 + message: 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello + service: payment + - ddsource: nginx + ddtags: env:staging,version:5.1 + hostname: i-012345679 + message: 2019-11-19T14:37:58,995 INFO [process.name][20081] World + service: payment + simple-json-message: + description: >- + Log attributes can be passed as `key:value` pairs in valid + JSON messages. + summary: Simple JSON Message + value: + ddsource: nginx + ddtags: env:staging,version:5.1 + hostname: i-012345678 + message: >- + 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello + World + service: payment + schema: + $ref: '#/components/schemas/HTTPLog' + application/logplex-1: + examples: + multi-raw-message: + description: Submit log messages. + summary: Multi Logplex Messages + value: |- + 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello + 2019-11-19T14:37:58,995 INFO [process.name][20081] World + simple-logplex-message: + description: Submit log string. + summary: Simple Logplex Message + value: 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World + schema: + type: string + text/plain: + examples: + multi-raw-message: + description: Submit log string. + summary: Multi Raw Messages + value: | + 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello + 2019-11-19T14:37:58,995 INFO [process.name][20081] World + simple-raw-message: + description: >- + Submit log string. Log attributes can be passed as query + parameters in the URL. This enables the addition of tags or + the source by using the `ddtags` and `ddsource` parameters: + `?host=my-hostname&service=my-service&ddsource=my-source&ddtags=env:prod,user:my-user`. + summary: Simple Raw Message + value: 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World + schema: + type: string + description: Log to send (JSON format). + required: true + responses: + '202': + content: + application/json: + schema: + type: object + description: Request accepted for processing (always 202 empty JSON). + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPLogErrors' + description: Bad Request + '401': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPLogErrors' + description: Unauthorized + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPLogErrors' + description: Forbidden + '408': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPLogErrors' + description: Request Timeout + '413': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPLogErrors' + description: Payload Too Large + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPLogErrors' + description: Too Many Requests + '500': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPLogErrors' + description: Internal Server Error + '503': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPLogErrors' + description: Service Unavailable + security: + - apiKeyAuth: [] + servers: + - url: https://{subdomain}.{site} + variables: + site: + default: datadoghq.com + description: The regional site for customers. + enum: + - datadoghq.com + - us3.datadoghq.com + - us5.datadoghq.com + - ap1.datadoghq.com + - ap2.datadoghq.com + - datadoghq.eu + - ddog-gov.com + subdomain: + default: http-intake.logs + description: The subdomain where the API is deployed. + - url: '{protocol}://{name}' + variables: + name: + default: http-intake.logs.datadoghq.com + description: Full site DNS name. + protocol: + default: https + description: The protocol for accessing the API. + - url: https://{subdomain}.{site} + variables: + site: + default: datadoghq.com + description: Any Datadog deployment. + subdomain: + default: http-intake.logs + description: The subdomain where the API is deployed. + summary: Send logs + tags: + - Logs + x-codegen-request-body-name: body + /api/v2/logs/analytics/aggregate: + post: + description: >- + The API endpoint to aggregate events into buckets and compute metrics + and timeseries. + operationId: AggregateLogs + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/LogsAggregateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsAggregateResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Aggregate events + tags: + - Logs + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_read_data + /api/v2/logs/config/archive-order: + get: + description: |- + Get the current order of your archives. + This endpoint takes no JSON arguments. + operationId: GetLogsArchiveOrder + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchiveOrder' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get archive order + tags: + - Logs Archives + x-permission: + operator: OR + permissions: + - logs_read_config + put: + description: >- + Update the order of your archives. Since logs are processed + sequentially, reordering an archive may change + + the structure and content of the data processed by other archives. + + + **Note**: Using the `PUT` method updates your archive's order by + replacing the current order + + with the new one. + operationId: UpdateLogsArchiveOrder + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchiveOrder' + description: An object containing the new ordered list of archive IDs. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchiveOrder' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unprocessable Entity + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update archive order + tags: + - Logs Archives + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_write_archives + /api/v2/logs/config/archives: + get: + description: Get the list of configured logs archives with their definitions. + operationId: ListLogsArchives + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchives' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all archives + tags: + - Logs Archives + x-permission: + operator: OR + permissions: + - logs_read_archives + post: + description: Create an archive in your organization. + operationId: CreateLogsArchive + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchiveCreateRequest' + description: The definition of the new archive. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchive' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create an archive + tags: + - Logs Archives + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_write_archives + /api/v2/logs/config/archives/{archive_id}: + delete: + description: Delete a given archive from your organization. + operationId: DeleteLogsArchive + parameters: + - $ref: '#/components/parameters/ArchiveID' + responses: + '204': + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete an archive + tags: + - Logs Archives + x-permission: + operator: OR + permissions: + - logs_write_archives + get: + description: Get a specific archive from your organization. + operationId: GetLogsArchive + parameters: + - $ref: '#/components/parameters/ArchiveID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchive' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get an archive + tags: + - Logs Archives + x-permission: + operator: OR + permissions: + - logs_read_archives + put: + description: >- + Update a given archive configuration. + + + **Note**: Using this method updates your archive configuration by + **replacing** + + your current configuration with the new one sent to your Datadog + organization. + operationId: UpdateLogsArchive + parameters: + - $ref: '#/components/parameters/ArchiveID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchiveCreateRequest' + description: New definition of the archive. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsArchive' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update an archive + tags: + - Logs Archives + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_write_archives + /api/v2/logs/config/archives/{archive_id}/readers: + delete: + description: >- + Removes a role from an archive. ([Roles + API](https://docs.datadoghq.com/api/v2/roles/)) + operationId: RemoveRoleFromArchive + parameters: + - $ref: '#/components/parameters/ArchiveID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RelationshipToRole' + required: true + responses: + '204': + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Revoke role from an archive + tags: + - Logs Archives + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_write_archives + get: + description: Returns all read roles a given archive is restricted to. + operationId: ListArchiveReadRoles + parameters: + - $ref: '#/components/parameters/ArchiveID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RolesResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List read roles for an archive + tags: + - Logs Archives + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_read_config + post: + description: >- + Adds a read role to an archive. ([Roles + API](https://docs.datadoghq.com/api/v2/roles/)) + operationId: AddReadRoleToArchive + parameters: + - $ref: '#/components/parameters/ArchiveID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RelationshipToRole' + required: true + responses: + '204': + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Grant role to an archive + tags: + - Logs Archives + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_write_archives + /api/v2/logs/config/custom-destinations: + get: + description: >- + Get the list of configured custom destinations in your organization with + their definitions. + operationId: ListLogsCustomDestinations + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CustomDestinationsResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all custom destinations + tags: + - Logs Custom Destinations + x-permission: + operator: OR + permissions: + - logs_read_config + - logs_read_data + post: + description: Create a custom destination in your organization. + operationId: CreateLogsCustomDestination + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CustomDestinationCreateRequest' + description: The definition of the new custom destination. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CustomDestinationResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a custom destination + tags: + - Logs Custom Destinations + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_write_forwarding_rules + /api/v2/logs/config/custom-destinations/{custom_destination_id}: + delete: + description: Delete a specific custom destination in your organization. + operationId: DeleteLogsCustomDestination + parameters: + - $ref: '#/components/parameters/CustomDestinationId' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a custom destination + tags: + - Logs Custom Destinations + x-permission: + operator: OR + permissions: + - logs_write_forwarding_rules + get: + description: Get a specific custom destination in your organization. + operationId: GetLogsCustomDestination + parameters: + - $ref: '#/components/parameters/CustomDestinationId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CustomDestinationResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a custom destination + tags: + - Logs Custom Destinations + x-permission: + operator: OR + permissions: + - logs_read_config + - logs_read_data + patch: + description: >- + Update the given fields of a specific custom destination in your + organization. + operationId: UpdateLogsCustomDestination + parameters: + - $ref: '#/components/parameters/CustomDestinationId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CustomDestinationUpdateRequest' + description: New definition of the custom destination's fields. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CustomDestinationResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a custom destination + tags: + - Logs Custom Destinations + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_write_forwarding_rules + /api/v2/logs/config/metrics: + get: + description: Get the list of configured log-based metrics with their definitions. + operationId: ListLogsMetrics + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsMetricsResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all log-based metrics + tags: + - Logs Metrics + x-permission: + operator: OR + permissions: + - logs_read_config + post: + description: >- + Create a metric based on your ingested logs in your organization. + + Returns the log-based metric object from the request body when the + request is successful. + operationId: CreateLogsMetric + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/LogsMetricCreateRequest' + description: The definition of the new log-based metric. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsMetricResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a log-based metric + tags: + - Logs Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_generate_metrics + /api/v2/logs/config/metrics/{metric_id}: + delete: + description: Delete a specific log-based metric from your organization. + operationId: DeleteLogsMetric + parameters: + - $ref: '#/components/parameters/MetricID' + responses: + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a log-based metric + tags: + - Logs Metrics + x-permission: + operator: OR + permissions: + - logs_generate_metrics + get: + description: Get a specific log-based metric from your organization. + operationId: GetLogsMetric + parameters: + - $ref: '#/components/parameters/MetricID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsMetricResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a log-based metric + tags: + - Logs Metrics + x-permission: + operator: OR + permissions: + - logs_read_config + patch: + description: >- + Update a specific log-based metric from your organization. + + Returns the log-based metric object from the request body when the + request is successful. + operationId: UpdateLogsMetric + parameters: + - $ref: '#/components/parameters/MetricID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/LogsMetricUpdateRequest' + description: New definition of the log-based metric. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsMetricResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a log-based metric + tags: + - Logs Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - logs_generate_metrics + /api/v2/logs/events: + get: + description: >- + List endpoint returns logs that match a log search query. + + [Results are paginated][1]. + + + Use this endpoint to search and filter your logs. + + + **If you are considering archiving logs for your organization, + + consider use of the Datadog archive capabilities instead of the log list + API. + + See [Datadog Logs Archive documentation][2].** + + + [1]: /logs/guide/collect-multiple-logs-with-pagination + + [2]: https://docs.datadoghq.com/logs/archives + operationId: ListLogsGet + parameters: + - description: Search query following logs syntax. + example: '@datacenter:us @role:db' + in: query + name: filter[query] + required: false + schema: + type: string + - description: |- + For customers with multiple indexes, the indexes to search. + Defaults to '*' which means all indexes + example: + - main + - web + explode: false + in: query + name: filter[indexes] + required: false + schema: + items: + description: The name of a log index. + type: string + type: array + - description: Minimum timestamp for requested logs. + example: '2019-01-02T09:42:36.320Z' + in: query + name: filter[from] + required: false + schema: + format: date-time + type: string + - description: Maximum timestamp for requested logs. + example: '2019-01-03T09:42:36.320Z' + in: query + name: filter[to] + required: false + schema: + format: date-time + type: string + - description: Specifies the storage type to be used + example: indexes + in: query + name: filter[storage_tier] + required: false + schema: + $ref: '#/components/schemas/LogsStorageTier' + - description: Order of logs in results. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/LogsSort' + - description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + in: query + name: page[cursor] + required: false + schema: + type: string + - description: Maximum number of logs in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 10 + format: int32 + maximum: 1000 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Search logs (GET) + tags: + - Logs + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + x-permission: + operator: OR + permissions: + - logs_read_data + /api/v2/logs/events/search: + post: + description: >- + List endpoint returns logs that match a log search query. + + [Results are paginated][1]. + + + Use this endpoint to search and filter your logs. + + + **If you are considering archiving logs for your organization, + + consider use of the Datadog archive capabilities instead of the log list + API. + + See [Datadog Logs Archive documentation][2].** + + + [1]: /logs/guide/collect-multiple-logs-with-pagination + + [2]: https://docs.datadoghq.com/logs/archives + operationId: ListLogs + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/LogsListRequest' + required: false + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/LogsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Search logs (POST) + tags: + - Logs + x-codegen-request-body-name: body + x-pagination: + cursorParam: body.page.cursor + cursorPath: meta.page.after + limitParam: body.page.limit + resultsPath: data + x-permission: + operator: OR + permissions: + - logs_read_data +components: + schemas: + ContentEncoding: + description: HTTP header used to compress the media-type. + enum: + - identity + - gzip + - deflate + type: string + x-enum-varnames: + - IDENTITY + - GZIP + - DEFLATE + HTTPLog: + description: Structured log message. + items: + $ref: '#/components/schemas/HTTPLogItem' + type: array + HTTPLogErrors: + description: Invalid query performed. properties: - buckets: - description: 'The list of matching buckets, one item per bucket' + errors: + description: Structured errors. items: - $ref: '#/components/schemas/LogsAggregateBucket' + $ref: '#/components/schemas/HTTPLogError' type: array type: object - LogsResponseMetadata: - description: The metadata associated with a request + LogsAggregateRequest: + description: >- + The object sent with the request to retrieve a list of logs from your + organization. properties: - elapsed: - description: The time elapsed in milliseconds - example: 132 - format: int64 - type: integer - page: - $ref: '#/components/schemas/LogsResponseMetadataPage' - request_id: - description: The identifier of the request - example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR - type: string - status: - $ref: '#/components/schemas/LogsAggregateResponseStatus' - warnings: - description: |- - A list of warnings (non fatal errors) encountered, partial results might be returned if - warnings are present in the response. + compute: + description: >- + The list of metrics or timeseries to compute for the retrieved + buckets. items: - $ref: '#/components/schemas/LogsWarning' + $ref: '#/components/schemas/LogsCompute' + type: array + filter: + $ref: '#/components/schemas/LogsQueryFilter' + group_by: + description: The rules for the group by + items: + $ref: '#/components/schemas/LogsGroupBy' type: array + options: + $ref: '#/components/schemas/LogsQueryOptions' + page: + $ref: '#/components/schemas/LogsAggregateRequestPage' + type: object + LogsAggregateResponse: + description: The response object for the logs aggregate API endpoint + properties: + data: + $ref: '#/components/schemas/LogsAggregateResponseData' + meta: + $ref: '#/components/schemas/LogsResponseMetadata' + type: object + LogsArchiveOrder: + description: A ordered list of archive IDs. + properties: + data: + $ref: '#/components/schemas/LogsArchiveOrderDefinition' type: object APIErrorResponse: description: API error response. properties: errors: description: A list of errors. + example: + - Bad Request items: description: A list of items. example: Bad Request @@ -576,237 +1228,115 @@ components: required: - errors type: object - LogsAggregationFunction: - description: An aggregation function - enum: - - count - - cardinality - - pc75 - - pc90 - - pc95 - - pc98 - - pc99 - - sum - - min - - max - - avg - - median - example: pc90 - type: string - x-enum-varnames: - - COUNT - - CARDINALITY - - PERCENTILE_75 - - PERCENTILE_90 - - PERCENTILE_95 - - PERCENTILE_98 - - PERCENTILE_99 - - SUM - - MIN - - MAX - - AVG - - MEDIAN - LogsComputeType: - default: total - description: The type of compute - enum: - - timeseries - - total - type: string - x-enum-varnames: - - TIMESERIES - - TOTAL - LogsStorageTier: - default: indexes - description: Specifies storage type as indexes or online-archives - enum: - - indexes - - online-archives - example: indexes - type: string - x-enum-varnames: - - INDEXES - - ONLINE_ARCHIVES - LogsGroupByHistogram: - description: |- - Used to perform a histogram computation (only for measure facets). - Note: at most 100 buckets are allowed, the number of buckets is (max - min)/interval. + LogsArchives: + description: The available archives. properties: - interval: - description: The bin size of the histogram buckets - example: 10 - format: double - type: number - max: - description: |- - The maximum value for the measure used in the histogram - (values greater than this one are filtered out) - example: 100 - format: double - type: number - min: - description: |- - The minimum value for the measure used in the histogram - (values smaller than this one are filtered out) - example: 50 - format: double - type: number - required: - - interval - - min - - max + data: + description: A list of archives. + items: + $ref: '#/components/schemas/LogsArchiveDefinition' + type: array type: object - LogsGroupByMissing: - description: The value to use for logs that don't have the facet used to group by - oneOf: - - $ref: '#/components/schemas/LogsGroupByMissingString' - - $ref: '#/components/schemas/LogsGroupByMissingNumber' - LogsAggregateSort: - description: A sort rule - example: - aggregation: count - order: asc + LogsArchiveCreateRequest: + description: The logs archive. properties: - aggregation: - $ref: '#/components/schemas/LogsAggregationFunction' - metric: - description: The metric to sort by (only used for `type=measure`) - example: '@duration' - type: string - order: - $ref: '#/components/schemas/LogsSortOrder' - type: - $ref: '#/components/schemas/LogsAggregateSortType' + data: + $ref: '#/components/schemas/LogsArchiveCreateRequestDefinition' type: object - LogsGroupByTotal: - default: false - description: A resulting object to put the given computes in over all the matching records. - oneOf: - - $ref: '#/components/schemas/LogsGroupByTotalBoolean' - - $ref: '#/components/schemas/LogsGroupByTotalString' - - $ref: '#/components/schemas/LogsGroupByTotalNumber' - LogsAggregateBucket: - description: A bucket values + LogsArchive: + description: The logs archive. properties: - by: - additionalProperties: - description: The values for each group by - description: 'The key, value pairs for each group by' - example: - '@state': success - '@version': abc - type: object - computes: - additionalProperties: - $ref: '#/components/schemas/LogsAggregateBucketValue' - description: A map of the metric name -> value for regular compute or list of values for a timeseries - type: object + data: + $ref: '#/components/schemas/LogsArchiveDefinition' type: object - LogsResponseMetadataPage: - description: Paging attributes. + RelationshipToRole: + description: Relationship to role. properties: - after: - description: |- - The cursor to use to get the next results, if any. To make the next request, use the same - parameters with the addition of the `page[cursor]`. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string + data: + $ref: '#/components/schemas/RelationshipToRoleData' type: object - LogsAggregateResponseStatus: - description: The status of the response - enum: - - done - - timeout - example: done - type: string - x-enum-varnames: - - DONE - - TIMEOUT - LogsWarning: - description: A warning message indicating something that went wrong with the query + RolesResponse: + description: Response containing information about multiple roles. properties: - code: - description: A unique code for this type of warning - example: unknown_index - type: string - detail: - description: A detailed explanation of this specific warning - example: 'indexes: foo, bar' - type: string - title: - description: A short human-readable summary of the warning - example: 'One or several indexes are missing or invalid, results hold data from the other indexes' - type: string + data: + description: Array of returned roles. + items: + $ref: '#/components/schemas/Role' + type: array + meta: + $ref: '#/components/schemas/ResponseMetaAttributes' type: object - LogsGroupByMissingString: - description: The missing value to use if there is string valued facet. - type: string - LogsGroupByMissingNumber: - description: The missing value to use if there is a number valued facet. - format: double - type: number - LogsSortOrder: - description: 'The order to use, ascending or descending' - enum: - - asc - - desc - example: asc - type: string - x-enum-varnames: - - ASCENDING - - DESCENDING - LogsAggregateSortType: - default: alphabetical - description: The type of sorting algorithm + CustomDestinationsResponse: + description: The available custom destinations. + properties: + data: + description: A list of custom destinations. + items: + $ref: '#/components/schemas/CustomDestinationResponseDefinition' + type: array + type: object + CustomDestinationCreateRequest: + description: The custom destination. + properties: + data: + $ref: '#/components/schemas/CustomDestinationCreateRequestDefinition' + type: object + CustomDestinationResponse: + description: The custom destination. + properties: + data: + $ref: '#/components/schemas/CustomDestinationResponseDefinition' + type: object + CustomDestinationUpdateRequest: + description: The custom destination. + properties: + data: + $ref: '#/components/schemas/CustomDestinationUpdateRequestDefinition' + type: object + LogsMetricsResponse: + description: All the available log-based metric objects. + properties: + data: + description: A list of log-based metric objects. + items: + $ref: '#/components/schemas/LogsMetricResponseData' + type: array + type: object + LogsMetricCreateRequest: + description: The new log-based metric body. + properties: + data: + $ref: '#/components/schemas/LogsMetricCreateData' + required: + - data + type: object + LogsMetricResponse: + description: The log-based metric object. + properties: + data: + $ref: '#/components/schemas/LogsMetricResponseData' + type: object + LogsMetricUpdateRequest: + description: The new log-based metric body. + properties: + data: + $ref: '#/components/schemas/LogsMetricUpdateData' + required: + - data + type: object + LogsStorageTier: + default: indexes + description: Specifies storage type as indexes, online-archives or flex enum: - - alphabetical - - measure + - indexes + - online-archives + - flex + example: indexes type: string x-enum-varnames: - - ALPHABETICAL - - MEASURE - LogsGroupByTotalBoolean: - description: 'If set to true, creates an additional bucket labeled "$facet_total"' - type: boolean - LogsGroupByTotalString: - description: A string to use as the key value for the total bucket - type: string - LogsGroupByTotalNumber: - description: A number to use as the key value for the total bucket - format: double - type: number - LogsAggregateBucketValue: - description: 'A bucket value, can be either a timeseries or a single value' - oneOf: - - $ref: '#/components/schemas/LogsAggregateBucketValueSingleString' - - $ref: '#/components/schemas/LogsAggregateBucketValueSingleNumber' - - $ref: '#/components/schemas/LogsAggregateBucketValueTimeseries' - LogsAggregateBucketValueSingleString: - description: A single string value - type: string - LogsAggregateBucketValueSingleNumber: - description: A single number value - format: double - type: number - LogsAggregateBucketValueTimeseries: - description: A timeseries array - items: - $ref: '#/components/schemas/LogsAggregateBucketValueTimeseriesPoint' - type: array - x-generate-alias-as-model: true - LogsAggregateBucketValueTimeseriesPoint: - description: A timeseries point - properties: - time: - description: The time value for this point - example: '2020-06-08T11:55:00Z' - type: string - value: - description: The value for this point - example: 19 - format: double - type: number - type: object + - INDEXES + - ONLINE_ARCHIVES + - FLEX LogsSort: description: Sort parameters when querying logs. enum: @@ -817,7 +1347,9 @@ components: - TIMESTAMP_ASCENDING - TIMESTAMP_DESCENDING LogsListResponse: - description: Response object with all logs matching the request and pagination information. + description: >- + Response object with all logs matching the request and pagination + information. properties: data: description: Array of logs matching the request. @@ -829,1076 +1361,2322 @@ components: meta: $ref: '#/components/schemas/LogsResponseMetadata' type: object - Log: - description: Object description of a log after being processed and stored by Datadog. + LogsListRequest: + description: The request for a logs list. properties: - attributes: - $ref: '#/components/schemas/LogAttributes' - id: - description: Unique ID of the Log. - example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA - type: string - type: - $ref: '#/components/schemas/LogType' + filter: + $ref: '#/components/schemas/LogsQueryFilter' + options: + $ref: '#/components/schemas/LogsQueryOptions' + page: + $ref: '#/components/schemas/LogsListRequestPage' + sort: + $ref: '#/components/schemas/LogsSort' type: object - LogsListResponseLinks: - description: Links attributes. + HTTPLogItem: + additionalProperties: + description: Additional log attributes. + description: Logs that are sent over HTTP. properties: - next: - description: |- - Link for the next set of results. Note that the request can also be made using the - POST endpoint. - example: 'https://app.datadoghq.com/api/v2/logs/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==' + ddsource: + description: >- + The integration name associated with your log: the technology from + which the log originated. + + When it matches an integration name, Datadog automatically installs + the corresponding parsers and facets. + + See [reserved + attributes](https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention/#reserved-attributes). + example: nginx type: string - type: object - LogAttributes: - description: JSON object containing all log attributes and their associated values. - properties: - attributes: - additionalProperties: {} - description: JSON object of attributes from your log. - example: - customAttribute: 123 - duration: 2345 - type: object - host: - description: Name of the machine from where the logs are being sent. - example: i-0123 + ddtags: + description: Tags associated with your logs. + example: env:staging,version:5.1 + type: string + hostname: + description: The name of the originating host of the log. + example: i-012345678 type: string message: - description: |- - The message [reserved attribute](https://docs.datadoghq.com/logs/log_collection/#reserved-attributes) - of your log. By default, Datadog ingests the value of the message attribute as the body of the log entry. - That value is then highlighted and displayed in the Logstream, where it is indexed for full text search. - example: Host connected to remote + description: >- + The message [reserved + attribute](https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention/#reserved-attributes) + + of your log. By default, Datadog ingests the value of the message + attribute as the body of the log entry. + + That value is then highlighted and displayed in the Logstream, where + it is indexed for full text search. + example: 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World type: string service: - description: |- + description: >- The name of the application or service generating the log events. - It is used to switch from Logs to APM, so make sure you define the same - value when you use both products. - example: agent + + It is used to switch from Logs to APM, so make sure you define the + same value when you use both products. + + See [reserved + attributes](https://docs.datadoghq.com/logs/log_configuration/attributes_naming_convention/#reserved-attributes). + example: payment + type: string + required: + - message + type: object + HTTPLogError: + description: List of errors. + properties: + detail: + description: Error message. + example: Malformed payload type: string status: - description: Status of the message associated with your log. - example: INFO + description: Error code. + example: '400' type: string - tags: - description: Array of tags associated with your log. + title: + description: Error title. + example: Bad Request + type: string + type: object + LogsCompute: + description: A compute rule to compute metrics or timeseries + properties: + aggregation: + $ref: '#/components/schemas/LogsAggregationFunction' + interval: + description: |- + The time buckets' size (only used for type=timeseries) + Defaults to a resolution of 150 points + example: 5m + type: string + metric: + description: The metric to use + example: '@duration' + type: string + type: + $ref: '#/components/schemas/LogsComputeType' + required: + - aggregation + type: object + LogsQueryFilter: + description: The search and filter query settings + properties: + from: + default: now-15m + description: >- + The minimum time for the requested logs, supports date math and + regular timestamps (milliseconds). + example: now-15m + type: string + indexes: + default: + - '*' + description: >- + For customers with multiple indexes, the indexes to search. Defaults + to ['*'] which means all indexes. example: - - 'team:A' + - main + - web items: - description: Tag associated with your log. + description: The name of a log index. type: string type: array - timestamp: - description: Timestamp of your log. - example: '2019-01-02T09:42:36.320Z' - format: date-time + query: + default: '*' + description: The search query - following the log search syntax. + example: service:web* AND @http.status_code:[200 TO 299] + type: string + storage_tier: + $ref: '#/components/schemas/LogsStorageTier' + to: + default: now + description: >- + The maximum time for the requested logs, supports date math and + regular timestamps (milliseconds). + example: now type: string type: object - LogType: - default: log - description: Type of the event. - enum: - - log - example: log - type: string - x-enum-varnames: - - LOG - LogsListRequest: - description: The request for a logs list. - properties: - filter: - $ref: '#/components/schemas/LogsQueryFilter' - options: - $ref: '#/components/schemas/LogsQueryOptions' - page: - $ref: '#/components/schemas/LogsListRequestPage' - sort: - $ref: '#/components/schemas/LogsSort' - type: object - LogsListRequestPage: - description: Paging attributes for listing logs. + LogsGroupBy: + description: A group by rule properties: - cursor: - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + facet: + description: The name of the facet to use (required) + example: host type: string + histogram: + $ref: '#/components/schemas/LogsGroupByHistogram' limit: default: 10 - description: Maximum number of logs in the response. - example: 25 - format: int32 - maximum: 1000 + description: >- + The maximum buckets to return for this group by. Note: at most 10000 + buckets are allowed. + + If grouping by multiple facets, the product of limits must not + exceed 10000. + format: int64 + type: integer + missing: + $ref: '#/components/schemas/LogsGroupByMissing' + sort: + $ref: '#/components/schemas/LogsAggregateSort' + total: + $ref: '#/components/schemas/LogsGroupByTotal' + required: + - facet + type: object + LogsQueryOptions: + deprecated: true + description: >- + Global query options that are used during the query. + + Note: These fields are currently deprecated and do not affect the query + results. + properties: + timeOffset: + description: The time offset (in seconds) to apply to the query. + format: int64 type: integer + timezone: + default: UTC + description: >- + The timezone can be specified as GMT, UTC, an offset from UTC (like + UTC+1), or as a Timezone Database identifier (like + America/New_York). + example: GMT + type: string + type: object + LogsAggregateRequestPage: + description: Paging settings + properties: + cursor: + description: >- + The returned paging point to use to get the next results. Note: at + most 1000 results can be paged. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - logs: - id: datadog.logs.logs - name: logs - title: Logs - methods: - submit_log: - operation: - $ref: '#/paths/~1api~1v2~1logs/post' - response: - mediaType: application/json - openAPIDocKey: '202' - aggregate_logs: - operation: - $ref: '#/paths/~1api~1v2~1logs~1analytics~1aggregate/post' - response: - mediaType: application/json - openAPIDocKey: '200' - list_logs: - operation: - $ref: '#/paths/~1api~1v2~1logs~1events~1search/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/logs/methods/list_logs' - insert: [] - update: [] - delete: [] - log_search: - id: datadog.logs.log_search - name: log_search - title: Log Search - methods: - list_logs_get: - operation: - $ref: '#/paths/~1api~1v2~1logs~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_logs_get: - operation: - $ref: '#/paths/~1api~1v2~1logs~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/log_search/methods/list_logs_get' - insert: [] - update: [] - delete: [] -paths: - /api/v2/logs: - post: - description: |- - Send your logs to your Datadog platform over HTTP. Limits per HTTP request are: + LogsAggregateResponseData: + description: The query results + properties: + buckets: + description: The list of matching buckets, one item per bucket + items: + $ref: '#/components/schemas/LogsAggregateBucket' + type: array + type: object + LogsResponseMetadata: + description: The metadata associated with a request + properties: + elapsed: + description: The time elapsed in milliseconds + example: 132 + format: int64 + type: integer + page: + $ref: '#/components/schemas/LogsResponseMetadataPage' + request_id: + description: The identifier of the request + example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR + type: string + status: + $ref: '#/components/schemas/LogsAggregateResponseStatus' + warnings: + description: >- + A list of warnings (non fatal errors) encountered, partial results + might be returned if - - Maximum content size per payload (uncompressed): 5MB - - Maximum size for a single log: 1MB - - Maximum array size if sending multiple logs in an array: 1000 entries + warnings are present in the response. + items: + $ref: '#/components/schemas/LogsWarning' + type: array + type: object + LogsArchiveOrderDefinition: + description: The definition of an archive order. + properties: + attributes: + $ref: '#/components/schemas/LogsArchiveOrderAttributes' + type: + $ref: '#/components/schemas/LogsArchiveOrderDefinitionType' + required: + - type + - attributes + type: object + LogsArchiveDefinition: + description: The definition of an archive. + properties: + attributes: + $ref: '#/components/schemas/LogsArchiveAttributes' + id: + description: The archive ID. + example: a2zcMylnM4OCHpYusxIi3g + readOnly: true + type: string + type: + default: archives + description: The type of the resource. The value should always be archives. + example: archives + readOnly: true + type: string + required: + - type + type: object + LogsArchiveCreateRequestDefinition: + description: The definition of an archive. + properties: + attributes: + $ref: '#/components/schemas/LogsArchiveCreateRequestAttributes' + type: + default: archives + description: The type of the resource. The value should always be archives. + example: archives + type: string + required: + - type + type: object + RelationshipToRoleData: + description: Relationship to role object. + properties: + id: + description: The unique identifier of the role. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + type: + $ref: '#/components/schemas/RolesType' + type: object + Role: + description: Role object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/RoleAttributes' + id: + description: The unique identifier of the role. + type: string + relationships: + $ref: '#/components/schemas/RoleResponseRelationships' + type: + $ref: '#/components/schemas/RolesType' + required: + - type + type: object + ResponseMetaAttributes: + description: Object describing meta attributes of response. + properties: + page: + $ref: '#/components/schemas/Pagination' + type: object + CustomDestinationResponseDefinition: + description: The definition of a custom destination. + properties: + attributes: + $ref: '#/components/schemas/CustomDestinationResponseAttributes' + id: + description: The custom destination ID. + example: be5d7a69-d0c8-4d4d-8ee8-bba292d98139 + readOnly: true + type: string + type: + $ref: '#/components/schemas/CustomDestinationType' + type: object + CustomDestinationCreateRequestDefinition: + description: The definition of a custom destination. + properties: + attributes: + $ref: '#/components/schemas/CustomDestinationCreateRequestAttributes' + type: + $ref: '#/components/schemas/CustomDestinationType' + required: + - type + - attributes + type: object + CustomDestinationUpdateRequestDefinition: + description: The definition of a custom destination. + properties: + attributes: + $ref: '#/components/schemas/CustomDestinationUpdateRequestAttributes' + id: + description: The custom destination ID. + example: be5d7a69-d0c8-4d4d-8ee8-bba292d98139 + type: string + type: + $ref: '#/components/schemas/CustomDestinationType' + required: + - type + - id + type: object + LogsMetricResponseData: + description: The log-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/LogsMetricResponseAttributes' + id: + $ref: '#/components/schemas/LogsMetricID' + type: + $ref: '#/components/schemas/LogsMetricType' + type: object + LogsMetricCreateData: + description: The new log-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/LogsMetricCreateAttributes' + id: + $ref: '#/components/schemas/LogsMetricID' + type: + $ref: '#/components/schemas/LogsMetricType' + required: + - id + - type + - attributes + type: object + LogsMetricUpdateData: + description: The new log-based metric properties. + properties: + attributes: + $ref: '#/components/schemas/LogsMetricUpdateAttributes' + type: + $ref: '#/components/schemas/LogsMetricType' + required: + - type + - attributes + type: object + Log: + description: Object description of a log after being processed and stored by Datadog. + properties: + attributes: + $ref: '#/components/schemas/LogAttributes' + id: + description: Unique ID of the Log. + example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA + type: string + type: + $ref: '#/components/schemas/LogType' + type: object + LogsListResponseLinks: + description: Links attributes. + properties: + next: + description: >- + Link for the next set of results. Note that the request can also be + made using the + + POST endpoint. + example: >- + https://app.datadoghq.com/api/v2/logs/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + LogsListRequestPage: + description: Paging attributes for listing logs. + properties: + cursor: + description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + limit: + default: 10 + description: Maximum number of logs in the response. + example: 25 + format: int32 + maximum: 1000 + type: integer + type: object + LogsAggregationFunction: + description: An aggregation function + enum: + - count + - cardinality + - pc75 + - pc90 + - pc95 + - pc98 + - pc99 + - sum + - min + - max + - avg + - median + example: pc90 + type: string + x-enum-varnames: + - COUNT + - CARDINALITY + - PERCENTILE_75 + - PERCENTILE_90 + - PERCENTILE_95 + - PERCENTILE_98 + - PERCENTILE_99 + - SUM + - MIN + - MAX + - AVG + - MEDIAN + LogsComputeType: + default: total + description: The type of compute + enum: + - timeseries + - total + type: string + x-enum-varnames: + - TIMESERIES + - TOTAL + LogsGroupByHistogram: + description: >- + Used to perform a histogram computation (only for measure facets). + + Note: at most 100 buckets are allowed, the number of buckets is (max - + min)/interval. + properties: + interval: + description: The bin size of the histogram buckets + example: 10 + format: double + type: number + max: + description: |- + The maximum value for the measure used in the histogram + (values greater than this one are filtered out) + example: 100 + format: double + type: number + min: + description: |- + The minimum value for the measure used in the histogram + (values smaller than this one are filtered out) + example: 50 + format: double + type: number + required: + - interval + - min + - max + type: object + LogsGroupByMissing: + description: The value to use for logs that don't have the facet used to group by + oneOf: + - $ref: '#/components/schemas/LogsGroupByMissingString' + - $ref: '#/components/schemas/LogsGroupByMissingNumber' + LogsAggregateSort: + description: A sort rule + example: + aggregation: count + order: asc + properties: + aggregation: + $ref: '#/components/schemas/LogsAggregationFunction' + metric: + description: The metric to sort by (only used for `type=measure`) + example: '@duration' + type: string + order: + $ref: '#/components/schemas/LogsSortOrder' + type: + $ref: '#/components/schemas/LogsAggregateSortType' + type: object + LogsGroupByTotal: + default: false + description: >- + A resulting object to put the given computes in over all the matching + records. + oneOf: + - $ref: '#/components/schemas/LogsGroupByTotalBoolean' + - $ref: '#/components/schemas/LogsGroupByTotalString' + - $ref: '#/components/schemas/LogsGroupByTotalNumber' + LogsAggregateBucket: + description: A bucket values + properties: + by: + additionalProperties: + description: The values for each group by + description: The key, value pairs for each group by + example: + '@state': success + '@version': abc + type: object + computes: + additionalProperties: + $ref: '#/components/schemas/LogsAggregateBucketValue' + description: >- + A map of the metric name -> value for regular compute or list of + values for a timeseries + type: object + type: object + LogsResponseMetadataPage: + description: Paging attributes. + properties: + after: + description: >- + The cursor to use to get the next results, if any. To make the next + request, use the same + + parameters with the addition of the `page[cursor]`. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + LogsAggregateResponseStatus: + description: The status of the response + enum: + - done + - timeout + example: done + type: string + x-enum-varnames: + - DONE + - TIMEOUT + LogsWarning: + description: A warning message indicating something that went wrong with the query + properties: + code: + description: A unique code for this type of warning + example: unknown_index + type: string + detail: + description: A detailed explanation of this specific warning + example: 'indexes: foo, bar' + type: string + title: + description: A short human-readable summary of the warning + example: >- + One or several indexes are missing or invalid, results hold data + from the other indexes + type: string + type: object + LogsArchiveOrderAttributes: + description: The attributes associated with the archive order. + properties: + archive_ids: + description: >- + An ordered array of `` strings, the order of archive IDs + in the array - Any log exceeding 1MB is accepted and truncated by Datadog: - - For a single log request, the API truncates the log at 1MB and returns a 2xx. - - For a multi-logs request, the API processes all logs, truncates only logs larger than 1MB, and returns a 2xx. + define the overall archives order for Datadog. + example: + - a2zcMylnM4OCHpYusxIi1g + - a2zcMylnM4OCHpYusxIi2g + - a2zcMylnM4OCHpYusxIi3g + items: + description: A given archive ID. + type: string + type: array + required: + - archive_ids + type: object + LogsArchiveOrderDefinitionType: + default: archive_order + description: Type of the archive order definition. + enum: + - archive_order + example: archive_order + type: string + x-enum-varnames: + - ARCHIVE_ORDER + LogsArchiveAttributes: + description: The attributes associated with the archive. + properties: + destination: + $ref: '#/components/schemas/LogsArchiveDestination' + include_tags: + default: false + description: >- + To store the tags in the archive, set the value "true". - Datadog recommends sending your logs compressed. - Add the `Content-Encoding: gzip` header to the request when sending compressed logs. - Log events can be submitted with a timestamp that is up to 18 hours in the past. + If it is set to "false", the tags will be deleted when the logs are + sent to the archive. + example: false + type: boolean + name: + description: The archive name. + example: Nginx Archive + type: string + query: + description: >- + The archive query/filter. Logs matching this query are included in + the archive. + example: source:nginx + type: string + rehydration_max_scan_size_in_gb: + description: Maximum scan size for rehydration from this archive. + example: 100 + format: int64 + nullable: true + type: integer + rehydration_tags: + description: An array of tags to add to rehydrated logs from an archive. + example: + - team:intake + - team:app + items: + description: A given tag in the `:` format. + type: string + type: array + state: + $ref: '#/components/schemas/LogsArchiveState' + required: + - name + - query + - destination + type: object + LogsArchiveCreateRequestAttributes: + description: The attributes associated with the archive. + properties: + destination: + $ref: '#/components/schemas/LogsArchiveCreateRequestDestination' + include_tags: + default: false + description: >- + To store the tags in the archive, set the value "true". - The status codes answered by the HTTP API are: - - 202: Accepted: the request has been accepted for processing - - 400: Bad request (likely an issue in the payload formatting) - - 401: Unauthorized (likely a missing API Key) - - 403: Permission issue (likely using an invalid API Key) - - 408: Request Timeout, request should be retried after some time - - 413: Payload too large (batch is above 5MB uncompressed) - - 429: Too Many Requests, request should be retried after some time - - 500: Internal Server Error, the server encountered an unexpected condition that prevented it from fulfilling the request, request should be retried after some time - - 503: Service Unavailable, the server is not ready to handle the request probably because it is overloaded, request should be retried after some time - operationId: SubmitLog - parameters: - - description: HTTP header used to compress the media-type. - in: header - name: Content-Encoding - required: false - schema: - $ref: '#/components/schemas/ContentEncoding' - - description: Log tags can be passed as query parameters with `text/plain` content type. - example: 'env:prod,user:my-user' - in: query - name: ddtags - required: false - schema: + If it is set to "false", the tags will be deleted when the logs are + sent to the archive. + example: false + type: boolean + name: + description: The archive name. + example: Nginx Archive + type: string + query: + description: >- + The archive query/filter. Logs matching this query are included in + the archive. + example: source:nginx + type: string + rehydration_max_scan_size_in_gb: + description: Maximum scan size for rehydration from this archive. + example: 100 + format: int64 + nullable: true + type: integer + rehydration_tags: + description: An array of tags to add to rehydrated logs from an archive. + example: + - team:intake + - team:app + items: + description: A given tag in the `:` format. type: string - requestBody: - content: - application/json: - examples: - multi-json-messages: - description: Pass multiple log objects at once. - summary: Multi JSON Messages - value: - - ddsource: nginx - ddtags: 'env:staging,version:5.1' - hostname: i-012345678 - message: '2019-11-19T14:37:58,995 INFO [process.name][20081] Hello' - service: payment - - ddsource: nginx - ddtags: 'env:staging,version:5.1' - hostname: i-012345679 - message: '2019-11-19T14:37:58,995 INFO [process.name][20081] World' - service: payment - simple-json-message: - description: 'Log attributes can be passed as `key:value` pairs in valid JSON messages.' - summary: Simple JSON Message - value: - ddsource: nginx - ddtags: 'env:staging,version:5.1' - hostname: i-012345678 - message: '2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World' - service: payment - schema: - $ref: '#/components/schemas/HTTPLog' - application/logplex-1: - examples: - multi-raw-message: - description: Submit log messages. - summary: Multi Logplex Messages - value: |- - 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello - 2019-11-19T14:37:58,995 INFO [process.name][20081] World - simple-logplex-message: - description: Submit log string. - summary: Simple Logplex Message - value: '2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World' - schema: - type: string - text/plain: - examples: - multi-raw-message: - description: Submit log string. - summary: Multi Raw Messages - value: | - 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello - 2019-11-19T14:37:58,995 INFO [process.name][20081] World - simple-raw-message: - description: 'Submit log string. Log attributes can be passed as query parameters in the URL. This enables the addition of tags or the source by using the `ddtags` and `ddsource` parameters: `?host=my-hostname&service=my-service&ddsource=my-source&ddtags=env:prod,user:my-user`.' - summary: Simple Raw Message - value: '2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World' - schema: - type: string - description: Log to send (JSON format). - required: true - responses: - '202': - content: - application/json: - schema: - type: object - description: Request accepted for processing (always 202 empty JSON). - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPLogErrors' - description: Bad Request - '401': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPLogErrors' - description: Unauthorized - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPLogErrors' - description: Forbidden - '408': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPLogErrors' - description: Request Timeout - '413': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPLogErrors' - description: Payload Too Large - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPLogErrors' - description: Too Many Requests - '500': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPLogErrors' - description: Internal Server Error - '503': - content: - application/json: - schema: - $ref: '#/components/schemas/HTTPLogErrors' - description: Service Unavailable - security: - - apiKeyAuth: [] - servers: - - url: 'https://{subdomain}.{site}' - variables: - site: - default: datadoghq.com - description: The regional site for customers. - enum: - - datadoghq.com - - us3.datadoghq.com - - us5.datadoghq.com - - ap1.datadoghq.com - - datadoghq.eu - - ddog-gov.com - subdomain: - default: http-intake.logs - description: The subdomain where the API is deployed. - - url: '{protocol}://{name}' - variables: - name: - default: http-intake.logs.datadoghq.com - description: Full site DNS name. - protocol: - default: https - description: The protocol for accessing the API. - - url: 'https://{subdomain}.{site}' - variables: - site: - default: datadoghq.com - description: Any Datadog deployment. - subdomain: - default: http-intake.logs - description: The subdomain where the API is deployed. - summary: Send logs - tags: - - Logs - x-codegen-request-body-name: body - /api/v2/logs/analytics/aggregate: - post: - description: The API endpoint to aggregate events into buckets and compute metrics and timeseries. - operationId: AggregateLogs - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LogsAggregateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsAggregateResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Aggregate events - tags: - - Logs - x-codegen-request-body-name: body - /api/v2/logs/events: - get: - description: |- - List endpoint returns logs that match a log search query. - [Results are paginated][1]. + type: array + required: + - name + - query + - destination + type: object + RolesType: + default: roles + description: Roles type. + enum: + - roles + example: roles + type: string + x-enum-varnames: + - ROLES + RoleAttributes: + description: Attributes of the role. + properties: + created_at: + description: Creation time of the role. + format: date-time + readOnly: true + type: string + modified_at: + description: Time of last role modification. + format: date-time + readOnly: true + type: string + name: + description: >- + The name of the role. The name is neither unique nor a stable + identifier of the role. + type: string + user_count: + description: Number of users with that role. + format: int64 + readOnly: true + type: integer + type: object + RoleResponseRelationships: + description: Relationships of the role object returned by the API. + properties: + permissions: + $ref: '#/components/schemas/RelationshipToPermissions' + type: object + Pagination: + description: Pagination object. + properties: + total_count: + description: Total count. + format: int64 + type: integer + total_filtered_count: + description: Total count of elements matched by the filter. + format: int64 + type: integer + type: object + CustomDestinationResponseAttributes: + description: The attributes associated with the custom destination. + properties: + enabled: + default: true + description: >- + Whether logs matching this custom destination should be forwarded or + not. + example: true + type: boolean + forward_tags: + default: true + description: Whether tags from the forwarded logs should be forwarded or not. + example: true + type: boolean + forward_tags_restriction_list: + default: [] + description: >- + List of [keys of + tags](https://docs.datadoghq.com/getting_started/tagging/#define-tags) + to be filtered. + + + An empty list represents no restriction is in place and either all + or no tags will be + + forwarded depending on `forward_tags_restriction_list_type` + parameter. + example: + - datacenter + - host + items: + description: >- + The [key part of a + tag](https://docs.datadoghq.com/getting_started/tagging/#define-tags). + type: string + maxItems: 10 + minItems: 0 + type: array + forward_tags_restriction_list_type: + $ref: >- + #/components/schemas/CustomDestinationAttributeTagsRestrictionListType + forwarder_destination: + $ref: '#/components/schemas/CustomDestinationResponseForwardDestination' + name: + description: The custom destination name. + example: Nginx logs + type: string + query: + default: '' + description: >- + The custom destination query filter. Logs matching this query are + forwarded to the destination. + example: source:nginx + type: string + type: object + CustomDestinationType: + default: custom_destination + description: >- + The type of the resource. The value should always be + `custom_destination`. + enum: + - custom_destination + example: custom_destination + type: string + x-enum-varnames: + - CUSTOM_DESTINATION + CustomDestinationCreateRequestAttributes: + description: The attributes associated with the custom destination. + properties: + enabled: + default: true + description: >- + Whether logs matching this custom destination should be forwarded or + not. + example: true + type: boolean + forward_tags: + default: true + description: Whether tags from the forwarded logs should be forwarded or not. + example: true + type: boolean + forward_tags_restriction_list: + default: [] + description: >- + List of [keys of + tags](https://docs.datadoghq.com/getting_started/tagging/#define-tags) + to be filtered. + + + An empty list represents no restriction is in place and either all + or no tags will be + + forwarded depending on `forward_tags_restriction_list_type` + parameter. + example: + - datacenter + - host + items: + description: >- + The [key part of a + tag](https://docs.datadoghq.com/getting_started/tagging/#define-tags). + type: string + maxItems: 10 + minItems: 0 + type: array + forward_tags_restriction_list_type: + $ref: >- + #/components/schemas/CustomDestinationAttributeTagsRestrictionListType + forwarder_destination: + $ref: '#/components/schemas/CustomDestinationForwardDestination' + name: + description: The custom destination name. + example: Nginx logs + type: string + query: + default: '' + description: >- + The custom destination query and filter. Logs matching this query + are forwarded to the destination. + example: source:nginx + type: string + required: + - name + - forwarder_destination + type: object + CustomDestinationUpdateRequestAttributes: + description: The attributes associated with the custom destination. + properties: + enabled: + default: true + description: >- + Whether logs matching this custom destination should be forwarded or + not. + example: true + type: boolean + forward_tags: + default: true + description: Whether tags from the forwarded logs should be forwarded or not. + example: true + type: boolean + forward_tags_restriction_list: + default: [] + description: >- + List of [keys of + tags](https://docs.datadoghq.com/getting_started/tagging/#define-tags) + to be restricted from being forwarded. + + An empty list represents no restriction is in place and either all + or no tags will be forwarded depending on + `forward_tags_restriction_list_type` parameter. + example: + - datacenter + - host + items: + description: >- + The [key part of a + tag](https://docs.datadoghq.com/getting_started/tagging/#define-tags). + type: string + maxItems: 10 + minItems: 0 + type: array + forward_tags_restriction_list_type: + $ref: >- + #/components/schemas/CustomDestinationAttributeTagsRestrictionListType + forwarder_destination: + $ref: '#/components/schemas/CustomDestinationForwardDestination' + name: + description: The custom destination name. + example: Nginx logs + type: string + query: + default: '' + description: >- + The custom destination query and filter. Logs matching this query + are forwarded to the destination. + example: source:nginx + type: string + type: object + LogsMetricResponseAttributes: + description: The object describing a Datadog log-based metric. + properties: + compute: + $ref: '#/components/schemas/LogsMetricResponseCompute' + filter: + $ref: '#/components/schemas/LogsMetricResponseFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/LogsMetricResponseGroupBy' + type: array + type: object + LogsMetricID: + description: The name of the log-based metric. + example: logs.page.load.count + type: string + LogsMetricType: + default: logs_metrics + description: The type of the resource. The value should always be logs_metrics. + enum: + - logs_metrics + example: logs_metrics + type: string + x-enum-varnames: + - LOGS_METRICS + LogsMetricCreateAttributes: + description: The object describing the Datadog log-based metric to create. + properties: + compute: + $ref: '#/components/schemas/LogsMetricCompute' + filter: + $ref: '#/components/schemas/LogsMetricFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/LogsMetricGroupBy' + type: array + required: + - compute + type: object + LogsMetricUpdateAttributes: + description: The log-based metric properties that will be updated. + properties: + compute: + $ref: '#/components/schemas/LogsMetricUpdateCompute' + filter: + $ref: '#/components/schemas/LogsMetricFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/LogsMetricGroupBy' + type: array + type: object + LogAttributes: + description: JSON object containing all log attributes and their associated values. + properties: + attributes: + additionalProperties: {} + description: JSON object of attributes from your log. + example: + customAttribute: 123 + duration: 2345 + type: object + host: + description: Name of the machine from where the logs are being sent. + example: i-0123 + type: string + message: + description: >- + The message [reserved + attribute](https://docs.datadoghq.com/logs/log_collection/#reserved-attributes) + + of your log. By default, Datadog ingests the value of the message + attribute as the body of the log entry. + + That value is then highlighted and displayed in the Logstream, where + it is indexed for full text search. + example: Host connected to remote + type: string + service: + description: >- + The name of the application or service generating the log events. + + It is used to switch from Logs to APM, so make sure you define the + same + + value when you use both products. + example: agent + type: string + status: + description: Status of the message associated with your log. + example: INFO + type: string + tags: + description: Array of tags associated with your log. + example: + - team:A + items: + description: Tag associated with your log. + type: string + type: array + timestamp: + description: Timestamp of your log. + example: '2019-01-02T09:42:36.320Z' + format: date-time + type: string + type: object + LogType: + default: log + description: Type of the event. + enum: + - log + example: log + type: string + x-enum-varnames: + - LOG + LogsGroupByMissingString: + description: The missing value to use if there is string valued facet. + type: string + LogsGroupByMissingNumber: + description: The missing value to use if there is a number valued facet. + format: double + type: number + LogsSortOrder: + description: The order to use, ascending or descending + enum: + - asc + - desc + example: asc + type: string + x-enum-varnames: + - ASCENDING + - DESCENDING + LogsAggregateSortType: + default: alphabetical + description: The type of sorting algorithm + enum: + - alphabetical + - measure + type: string + x-enum-varnames: + - ALPHABETICAL + - MEASURE + LogsGroupByTotalBoolean: + description: If set to true, creates an additional bucket labeled "$facet_total" + type: boolean + LogsGroupByTotalString: + description: A string to use as the key value for the total bucket + type: string + LogsGroupByTotalNumber: + description: A number to use as the key value for the total bucket + format: double + type: number + LogsAggregateBucketValue: + description: A bucket value, can be either a timeseries or a single value + oneOf: + - $ref: '#/components/schemas/LogsAggregateBucketValueSingleString' + - $ref: '#/components/schemas/LogsAggregateBucketValueSingleNumber' + - $ref: '#/components/schemas/LogsAggregateBucketValueTimeseries' + LogsArchiveDestination: + description: An archive's destination. + nullable: true + oneOf: + - $ref: '#/components/schemas/LogsArchiveDestinationAzure' + - $ref: '#/components/schemas/LogsArchiveDestinationGCS' + - $ref: '#/components/schemas/LogsArchiveDestinationS3' + type: object + LogsArchiveState: + description: The state of the archive. + enum: + - UNKNOWN + - WORKING + - FAILING + - WORKING_AUTH_LEGACY + example: WORKING + type: string + x-enum-varnames: + - UNKNOWN + - WORKING + - FAILING + - WORKING_AUTH_LEGACY + LogsArchiveCreateRequestDestination: + description: An archive's destination. + oneOf: + - $ref: '#/components/schemas/LogsArchiveDestinationAzure' + - $ref: '#/components/schemas/LogsArchiveDestinationGCS' + - $ref: '#/components/schemas/LogsArchiveDestinationS3' + RelationshipToPermissions: + description: Relationship to multiple permissions objects. + properties: + data: + description: Relationships to permission objects. + items: + $ref: '#/components/schemas/RelationshipToPermissionData' + type: array + type: object + CustomDestinationAttributeTagsRestrictionListType: + default: ALLOW_LIST + description: >- + How `forward_tags_restriction_list` parameter should be interpreted. + + If `ALLOW_LIST`, then only tags whose keys on the forwarded logs match + the ones on the restriction list + + are forwarded. + + + `BLOCK_LIST` works the opposite way. It does not forward the tags + matching the ones on the list. + enum: + - ALLOW_LIST + - BLOCK_LIST + example: ALLOW_LIST + type: string + x-enum-varnames: + - ALLOW_LIST + - BLOCK_LIST + CustomDestinationResponseForwardDestination: + description: A custom destination's location to forward logs. + oneOf: + - $ref: '#/components/schemas/CustomDestinationResponseForwardDestinationHttp' + - $ref: >- + #/components/schemas/CustomDestinationResponseForwardDestinationSplunk + - $ref: >- + #/components/schemas/CustomDestinationResponseForwardDestinationElasticsearch + - $ref: >- + #/components/schemas/CustomDestinationResponseForwardDestinationMicrosoftSentinel + CustomDestinationForwardDestination: + description: A custom destination's location to forward logs. + oneOf: + - $ref: '#/components/schemas/CustomDestinationForwardDestinationHttp' + - $ref: '#/components/schemas/CustomDestinationForwardDestinationSplunk' + - $ref: >- + #/components/schemas/CustomDestinationForwardDestinationElasticsearch + - $ref: >- + #/components/schemas/CustomDestinationForwardDestinationMicrosoftSentinel + LogsMetricResponseCompute: + description: The compute rule to compute the log-based metric. + properties: + aggregation_type: + $ref: '#/components/schemas/LogsMetricResponseComputeAggregationType' + include_percentiles: + $ref: '#/components/schemas/LogsMetricComputeIncludePercentiles' + path: + description: >- + The path to the value the log-based metric will aggregate on (only + used if the aggregation type is a "distribution"). + example: '@duration' + type: string + type: object + LogsMetricResponseFilter: + description: >- + The log-based metric filter. Logs matching this filter will be + aggregated in this metric. + properties: + query: + description: The search query - following the log search syntax. + example: service:web* AND @http.status_code:[200 TO 299] + type: string + type: object + LogsMetricResponseGroupBy: + description: A group by rule. + properties: + path: + description: The path to the value the log-based metric will be aggregated over. + example: '@http.status_code' + type: string + tag_name: + description: >- + Eventual name of the tag that gets created. By default, the path + attribute is used as the tag name. + example: status_code + type: string + type: object + LogsMetricCompute: + description: The compute rule to compute the log-based metric. + properties: + aggregation_type: + $ref: '#/components/schemas/LogsMetricComputeAggregationType' + include_percentiles: + $ref: '#/components/schemas/LogsMetricComputeIncludePercentiles' + path: + description: >- + The path to the value the log-based metric will aggregate on (only + used if the aggregation type is a "distribution"). + example: '@duration' + type: string + required: + - aggregation_type + type: object + LogsMetricFilter: + description: >- + The log-based metric filter. Logs matching this filter will be + aggregated in this metric. + properties: + query: + default: '*' + description: The search query - following the log search syntax. + example: service:web* AND @http.status_code:[200 TO 299] + type: string + type: object + LogsMetricGroupBy: + description: A group by rule. + properties: + path: + description: The path to the value the log-based metric will be aggregated over. + example: '@http.status_code' + type: string + tag_name: + description: >- + Eventual name of the tag that gets created. By default, the path + attribute is used as the tag name. + example: status_code + type: string + required: + - path + type: object + LogsMetricUpdateCompute: + description: The compute rule to compute the log-based metric. + properties: + include_percentiles: + $ref: '#/components/schemas/LogsMetricComputeIncludePercentiles' + type: object + LogsAggregateBucketValueSingleString: + description: A single string value + type: string + LogsAggregateBucketValueSingleNumber: + description: A single number value + format: double + type: number + LogsAggregateBucketValueTimeseries: + description: A timeseries array + items: + $ref: '#/components/schemas/LogsAggregateBucketValueTimeseriesPoint' + type: array + x-generate-alias-as-model: true + LogsArchiveDestinationAzure: + description: The Azure archive destination. + properties: + container: + description: The container where the archive will be stored. + example: container-name + type: string + integration: + $ref: '#/components/schemas/LogsArchiveIntegrationAzure' + path: + description: The archive path. + type: string + region: + description: The region where the archive will be stored. + type: string + storage_account: + description: The associated storage account. + example: account-name + type: string + type: + $ref: '#/components/schemas/LogsArchiveDestinationAzureType' + required: + - storage_account + - container + - integration + - type + type: object + LogsArchiveDestinationGCS: + description: The GCS archive destination. + properties: + bucket: + description: The bucket where the archive will be stored. + example: bucket-name + type: string + integration: + $ref: '#/components/schemas/LogsArchiveIntegrationGCS' + path: + description: The archive path. + type: string + type: + $ref: '#/components/schemas/LogsArchiveDestinationGCSType' + required: + - bucket + - integration + - type + type: object + LogsArchiveDestinationS3: + description: The S3 archive destination. + properties: + bucket: + description: The bucket where the archive will be stored. + example: bucket-name + type: string + encryption: + $ref: '#/components/schemas/LogsArchiveEncryptionS3' + integration: + $ref: '#/components/schemas/LogsArchiveIntegrationS3' + path: + description: The archive path. + type: string + storage_class: + $ref: '#/components/schemas/LogsArchiveStorageClassS3Type' + type: + $ref: '#/components/schemas/LogsArchiveDestinationS3Type' + required: + - bucket + - integration + - type + type: object + RelationshipToPermissionData: + description: Relationship to permission object. + properties: + id: + description: ID of the permission. + type: string + type: + $ref: '#/components/schemas/PermissionsType' + type: object + CustomDestinationResponseForwardDestinationHttp: + description: The HTTP destination. + properties: + auth: + $ref: '#/components/schemas/CustomDestinationResponseHttpDestinationAuth' + endpoint: + description: >- + The destination for which logs will be forwarded to. - Use this endpoint to see your latest logs. + Must have HTTPS scheme and forwarding back to Datadog is not + allowed. + example: https://example.com + type: string + type: + $ref: >- + #/components/schemas/CustomDestinationResponseForwardDestinationHttpType + required: + - type + - endpoint + - auth + type: object + CustomDestinationResponseForwardDestinationSplunk: + description: The Splunk HTTP Event Collector (HEC) destination. + properties: + endpoint: + description: >- + The destination for which logs will be forwarded to. - **If you are considering archiving logs for your organization, - consider use of the Datadog archive capabilities instead of the log list API. - See [Datadog Logs Archive documentation][2].** + Must have HTTPS scheme and forwarding back to Datadog is not + allowed. + example: https://example.com + type: string + type: + $ref: >- + #/components/schemas/CustomDestinationResponseForwardDestinationSplunkType + required: + - type + - endpoint + type: object + CustomDestinationResponseForwardDestinationElasticsearch: + description: The Elasticsearch destination. + properties: + auth: + $ref: >- + #/components/schemas/CustomDestinationResponseElasticsearchDestinationAuth + endpoint: + description: >- + The destination for which logs will be forwarded to. - [1]: /logs/guide/collect-multiple-logs-with-pagination - [2]: https://docs.datadoghq.com/logs/archives - operationId: ListLogsGet - parameters: - - description: Search query following logs syntax. - example: '@datacenter:us @role:db' - in: query - name: 'filter[query]' - required: false - schema: - type: string - - description: |- - For customers with multiple indexes, the indexes to search. - Defaults to '*' which means all indexes - example: - - main - - web - explode: false - in: query - name: 'filter[indexes]' - required: false - schema: - items: - description: The name of a log index. - type: string - type: array - - description: Minimum timestamp for requested logs. - example: '2019-01-02T09:42:36.320Z' - in: query - name: 'filter[from]' - required: false - schema: - format: date-time - type: string - - description: Maximum timestamp for requested logs. - example: '2019-01-03T09:42:36.320Z' - in: query - name: 'filter[to]' - required: false + Must have HTTPS scheme and forwarding back to Datadog is not + allowed. + example: https://example.com + type: string + index_name: + description: >- + Name of the Elasticsearch index (must follow [Elasticsearch's + criteria](https://www.elastic.co/guide/en/elasticsearch/reference/8.11/indices-create-index.html#indices-create-api-path-params)). + example: nginx-logs + type: string + index_rotation: + description: >- + Date pattern with US locale and UTC timezone to be appended to the + index name after adding `-` + + (that is, `${index_name}-${indexPattern}`). + + You can customize the index rotation naming pattern by choosing one + of these options: + + - Hourly: `yyyy-MM-dd-HH` (as an example, it would render: + `2022-10-19-09`) + + - Daily: `yyyy-MM-dd` (as an example, it would render: `2022-10-19`) + + - Weekly: `yyyy-'W'ww` (as an example, it would render: `2022-W42`) + + - Monthly: `yyyy-MM` (as an example, it would render: `2022-10`) + + + If this field is missing or is blank, it means that the index name + will always be the same + + (that is, no rotation). + example: yyyy-MM-dd + type: string + type: + $ref: >- + #/components/schemas/CustomDestinationResponseForwardDestinationElasticsearchType + required: + - type + - endpoint + - auth + - index_name + type: object + CustomDestinationResponseForwardDestinationMicrosoftSentinel: + description: The Microsoft Sentinel destination. + properties: + client_id: + description: Client ID from the Datadog Azure integration. + example: 9a2f4d83-2b5e-429e-a35a-2b3c4182db71 + type: string + data_collection_endpoint: + description: Azure data collection endpoint. + example: https://my-dce-5kyl.eastus-1.ingest.monitor.azure.com + type: string + data_collection_rule_id: + description: Azure data collection rule ID. + example: dcr-000a00a000a00000a000000aa000a0aa + type: string + stream_name: + description: Azure stream name. + example: Custom-MyTable + type: string + writeOnly: true + tenant_id: + description: Tenant ID from the Datadog Azure integration. + example: f3c9a8a1-4c2e-4d2e-b911-9f3c28c3c8b2 + type: string + type: + $ref: >- + #/components/schemas/CustomDestinationResponseForwardDestinationMicrosoftSentinelType + required: + - type + - tenant_id + - client_id + - data_collection_endpoint + - data_collection_rule_id + - stream_name + type: object + CustomDestinationForwardDestinationHttp: + description: The HTTP destination. + properties: + auth: + $ref: '#/components/schemas/CustomDestinationHttpDestinationAuth' + endpoint: + description: >- + The destination for which logs will be forwarded to. + + Must have HTTPS scheme and forwarding back to Datadog is not + allowed. + example: https://example.com + type: string + type: + $ref: '#/components/schemas/CustomDestinationForwardDestinationHttpType' + required: + - type + - endpoint + - auth + type: object + CustomDestinationForwardDestinationSplunk: + description: The Splunk HTTP Event Collector (HEC) destination. + properties: + access_token: + description: >- + Access token of the Splunk HTTP Event Collector. This field is not + returned by the API. + example: splunk_access_token + type: string + writeOnly: true + endpoint: + description: >- + The destination for which logs will be forwarded to. + + Must have HTTPS scheme and forwarding back to Datadog is not + allowed. + example: https://example.com + type: string + type: + $ref: '#/components/schemas/CustomDestinationForwardDestinationSplunkType' + required: + - type + - endpoint + - access_token + type: object + CustomDestinationForwardDestinationElasticsearch: + description: The Elasticsearch destination. + properties: + auth: + $ref: '#/components/schemas/CustomDestinationElasticsearchDestinationAuth' + endpoint: + description: >- + The destination for which logs will be forwarded to. + + Must have HTTPS scheme and forwarding back to Datadog is not + allowed. + example: https://example.com + type: string + index_name: + description: >- + Name of the Elasticsearch index (must follow [Elasticsearch's + criteria](https://www.elastic.co/guide/en/elasticsearch/reference/8.11/indices-create-index.html#indices-create-api-path-params)). + example: nginx-logs + type: string + index_rotation: + description: >- + Date pattern with US locale and UTC timezone to be appended to the + index name after adding `-` + + (that is, `${index_name}-${indexPattern}`). + + You can customize the index rotation naming pattern by choosing one + of these options: + + - Hourly: `yyyy-MM-dd-HH` (as an example, it would render: + `2022-10-19-09`) + + - Daily: `yyyy-MM-dd` (as an example, it would render: `2022-10-19`) + + - Weekly: `yyyy-'W'ww` (as an example, it would render: `2022-W42`) + + - Monthly: `yyyy-MM` (as an example, it would render: `2022-10`) + + + If this field is missing or is blank, it means that the index name + will always be the same + + (that is, no rotation). + example: yyyy-MM-dd + type: string + type: + $ref: >- + #/components/schemas/CustomDestinationForwardDestinationElasticsearchType + required: + - type + - endpoint + - auth + - index_name + type: object + CustomDestinationForwardDestinationMicrosoftSentinel: + description: The Microsoft Sentinel destination. + properties: + client_id: + description: Client ID from the Datadog Azure integration. + example: 9a2f4d83-2b5e-429e-a35a-2b3c4182db71 + type: string + data_collection_endpoint: + description: Azure data collection endpoint. + example: https://my-dce-5kyl.eastus-1.ingest.monitor.azure.com + type: string + data_collection_rule_id: + description: Azure data collection rule ID. + example: dcr-000a00a000a00000a000000aa000a0aa + type: string + stream_name: + description: Azure stream name. + example: Custom-MyTable + type: string + writeOnly: true + tenant_id: + description: Tenant ID from the Datadog Azure integration. + example: f3c9a8a1-4c2e-4d2e-b911-9f3c28c3c8b2 + type: string + type: + $ref: >- + #/components/schemas/CustomDestinationForwardDestinationMicrosoftSentinelType + required: + - type + - tenant_id + - client_id + - data_collection_endpoint + - data_collection_rule_id + - stream_name + type: object + LogsMetricResponseComputeAggregationType: + description: The type of aggregation to use. + enum: + - count + - distribution + example: distribution + type: string + x-enum-varnames: + - COUNT + - DISTRIBUTION + LogsMetricComputeIncludePercentiles: + description: >- + Toggle to include or exclude percentile aggregations for distribution + metrics. + + Only present when the `aggregation_type` is `distribution`. + example: true + type: boolean + LogsMetricComputeAggregationType: + description: The type of aggregation to use. + enum: + - count + - distribution + example: distribution + type: string + x-enum-varnames: + - COUNT + - DISTRIBUTION + LogsAggregateBucketValueTimeseriesPoint: + description: A timeseries point + properties: + time: + description: The time value for this point + example: '2020-06-08T11:55:00Z' + type: string + value: + description: The value for this point + example: 19 + format: double + type: number + type: object + LogsArchiveIntegrationAzure: + description: The Azure archive's integration destination. + properties: + client_id: + description: A client ID. + example: aaaaaaaa-1a1a-1a1a-1a1a-aaaaaaaaaaaa + type: string + tenant_id: + description: A tenant ID. + example: aaaaaaaa-1a1a-1a1a-1a1a-aaaaaaaaaaaa + type: string + required: + - tenant_id + - client_id + type: object + LogsArchiveDestinationAzureType: + default: azure + description: Type of the Azure archive destination. + enum: + - azure + example: azure + type: string + x-enum-varnames: + - AZURE + LogsArchiveIntegrationGCS: + description: The GCS archive's integration destination. + properties: + client_email: + description: A client email. + example: youremail@example.com + type: string + project_id: + description: A project ID. + example: project-id + type: string + required: + - client_email + type: object + LogsArchiveDestinationGCSType: + default: gcs + description: Type of the GCS archive destination. + enum: + - gcs + example: gcs + type: string + x-enum-varnames: + - GCS + LogsArchiveEncryptionS3: + description: The S3 encryption settings. + properties: + key: + description: An Amazon Resource Name (ARN) used to identify an AWS KMS key. + example: arn:aws:kms:us-east-1:012345678901:key/DatadogIntegrationRoleKms + type: string + type: + $ref: '#/components/schemas/LogsArchiveEncryptionS3Type' + required: + - type + type: object + LogsArchiveIntegrationS3: + description: The S3 Archive's integration destination. + properties: + account_id: + description: The account ID for the integration. + example: '123456789012' + type: string + role_name: + description: The path of the integration. + example: role-name + type: string + required: + - role_name + - account_id + type: object + LogsArchiveStorageClassS3Type: + default: STANDARD + description: The storage class where the archive will be stored. + enum: + - STANDARD + - STANDARD_IA + - ONEZONE_IA + - INTELLIGENT_TIERING + - GLACIER_IR + example: STANDARD + type: string + x-enum-varnames: + - STANDARD + - STANDARD_IA + - ONEZONE_IA + - INTELLIGENT_TIERING + - GLACIER_IR + LogsArchiveDestinationS3Type: + default: s3 + description: Type of the S3 archive destination. + enum: + - s3 + example: s3 + type: string + x-enum-varnames: + - S3 + PermissionsType: + default: permissions + description: Permissions resource type. + enum: + - permissions + example: permissions + type: string + x-enum-varnames: + - PERMISSIONS + CustomDestinationResponseHttpDestinationAuth: + description: Authentication method of the HTTP requests. + oneOf: + - $ref: >- + #/components/schemas/CustomDestinationResponseHttpDestinationAuthBasic + - $ref: >- + #/components/schemas/CustomDestinationResponseHttpDestinationAuthCustomHeader + CustomDestinationResponseForwardDestinationHttpType: + default: http + description: Type of the HTTP destination. + enum: + - http + example: http + type: string + x-enum-varnames: + - HTTP + CustomDestinationResponseForwardDestinationSplunkType: + default: splunk_hec + description: Type of the Splunk HTTP Event Collector (HEC) destination. + enum: + - splunk_hec + example: splunk_hec + type: string + x-enum-varnames: + - SPLUNK_HEC + CustomDestinationResponseElasticsearchDestinationAuth: + additionalProperties: + description: Basic access authentication. + description: Basic access authentication. + type: object + CustomDestinationResponseForwardDestinationElasticsearchType: + default: elasticsearch + description: Type of the Elasticsearch destination. + enum: + - elasticsearch + example: elasticsearch + type: string + x-enum-varnames: + - ELASTICSEARCH + CustomDestinationResponseForwardDestinationMicrosoftSentinelType: + default: microsoft_sentinel + description: Type of the Microsoft Sentinel destination. + enum: + - microsoft_sentinel + example: microsoft_sentinel + type: string + x-enum-varnames: + - MICROSOFT_SENTINEL + CustomDestinationHttpDestinationAuth: + description: Authentication method of the HTTP requests. + oneOf: + - $ref: '#/components/schemas/CustomDestinationHttpDestinationAuthBasic' + - $ref: >- + #/components/schemas/CustomDestinationHttpDestinationAuthCustomHeader + CustomDestinationForwardDestinationHttpType: + default: http + description: Type of the HTTP destination. + enum: + - http + example: http + type: string + x-enum-varnames: + - HTTP + CustomDestinationForwardDestinationSplunkType: + default: splunk_hec + description: Type of the Splunk HTTP Event Collector (HEC) destination. + enum: + - splunk_hec + example: splunk_hec + type: string + x-enum-varnames: + - SPLUNK_HEC + CustomDestinationElasticsearchDestinationAuth: + description: Basic access authentication. + properties: + password: + description: >- + The password of the authentication. This field is not returned by + the API. + example: datadog-custom-destination-password + type: string + writeOnly: true + username: + description: >- + The username of the authentication. This field is not returned by + the API. + example: datadog-custom-destination-username + type: string + writeOnly: true + required: + - username + - password + type: object + CustomDestinationForwardDestinationElasticsearchType: + default: elasticsearch + description: Type of the Elasticsearch destination. + enum: + - elasticsearch + example: elasticsearch + type: string + x-enum-varnames: + - ELASTICSEARCH + CustomDestinationForwardDestinationMicrosoftSentinelType: + default: microsoft_sentinel + description: Type of the Microsoft Sentinel destination. + enum: + - microsoft_sentinel + example: microsoft_sentinel + type: string + x-enum-varnames: + - MICROSOFT_SENTINEL + LogsArchiveEncryptionS3Type: + description: Type of S3 encryption for a destination. + enum: + - NO_OVERRIDE + - SSE_S3 + - SSE_KMS + example: SSE_S3 + type: string + x-enum-varnames: + - NO_OVERRIDE + - SSE_S3 + - SSE_KMS + CustomDestinationResponseHttpDestinationAuthBasic: + description: Basic access authentication. + properties: + type: + $ref: >- + #/components/schemas/CustomDestinationResponseHttpDestinationAuthBasicType + required: + - type + type: object + CustomDestinationResponseHttpDestinationAuthCustomHeader: + description: Custom header access authentication. + properties: + header_name: + description: The header name of the authentication. + example: CUSTOM-HEADER-NAME + type: string + type: + $ref: >- + #/components/schemas/CustomDestinationResponseHttpDestinationAuthCustomHeaderType + required: + - type + - header_name + type: object + CustomDestinationHttpDestinationAuthBasic: + description: Basic access authentication. + properties: + password: + description: >- + The password of the authentication. This field is not returned by + the API. + example: datadog-custom-destination-password + type: string + writeOnly: true + type: + $ref: '#/components/schemas/CustomDestinationHttpDestinationAuthBasicType' + username: + description: >- + The username of the authentication. This field is not returned by + the API. + example: datadog-custom-destination-username + type: string + writeOnly: true + required: + - type + - username + - password + type: object + CustomDestinationHttpDestinationAuthCustomHeader: + description: Custom header access authentication. + properties: + header_name: + description: The header name of the authentication. + example: CUSTOM-HEADER-NAME + type: string + header_value: + description: >- + The header value of the authentication. This field is not returned + by the API. + example: CUSTOM-HEADER-AUTHENTICATION-VALUE + type: string + writeOnly: true + type: + $ref: >- + #/components/schemas/CustomDestinationHttpDestinationAuthCustomHeaderType + required: + - type + - header_name + - header_value + type: object + CustomDestinationResponseHttpDestinationAuthBasicType: + default: basic + description: Type of the basic access authentication. + enum: + - basic + example: basic + type: string + x-enum-varnames: + - BASIC + CustomDestinationResponseHttpDestinationAuthCustomHeaderType: + default: custom_header + description: Type of the custom header access authentication. + enum: + - custom_header + example: custom_header + type: string + x-enum-varnames: + - CUSTOM_HEADER + CustomDestinationHttpDestinationAuthBasicType: + default: basic + description: Type of the basic access authentication. + enum: + - basic + example: basic + type: string + x-enum-varnames: + - BASIC + CustomDestinationHttpDestinationAuthCustomHeaderType: + default: custom_header + description: Type of the custom header access authentication. + enum: + - custom_header + example: custom_header + type: string + x-enum-varnames: + - CUSTOM_HEADER + responses: + BadRequestResponse: + content: + application/json: schema: - format: date-time - type: string - - description: Specifies the storage type to be used - example: indexes - in: query - name: 'filter[storage_tier]' - required: false + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + NotAuthorizedResponse: + content: + application/json: schema: - $ref: '#/components/schemas/LogsStorageTier' - - description: Order of logs in results. - in: query - name: sort - required: false + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + TooManyRequestsResponse: + content: + application/json: schema: - $ref: '#/components/schemas/LogsSort' - - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - in: query - name: 'page[cursor]' - required: false + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + ForbiddenResponse: + content: + application/json: schema: - type: string - - description: Maximum number of logs in the response. - example: 25 - in: query - name: 'page[limit]' - required: false + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + ConflictResponse: + content: + application/json: schema: - default: 10 - format: int32 - maximum: 1000 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsListResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get a list of logs - tags: - - Logs - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data - /api/v2/logs/events/search: - post: - description: |- - List endpoint returns logs that match a log search query. - [Results are paginated][1]. - - Use this endpoint to build complex logs filtering and search. - - **If you are considering archiving logs for your organization, - consider use of the Datadog archive capabilities instead of the log list API. - See [Datadog Logs Archive documentation][2].** - - [1]: /logs/guide/collect-multiple-logs-with-pagination - [2]: https://docs.datadoghq.com/logs/archives - operationId: ListLogs - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/LogsListRequest' - required: false - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/LogsListResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Search logs - tags: - - Logs - x-codegen-request-body-name: body - x-pagination: - cursorParam: body.page.cursor - cursorPath: meta.page.after - limitParam: body.page.limit - resultsPath: data + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + parameters: + ArchiveID: + description: The ID of the archive. + in: path + name: archive_id + required: true + schema: + type: string + CustomDestinationId: + description: The ID of the custom destination. + in: path + name: custom_destination_id + required: true + schema: + type: string + MetricID: + description: The name of the log-based metric. + in: path + name: metric_id + required: true + schema: + type: string + x-stackQL-resources: + logs: + id: datadog.logs.logs + name: logs + title: Logs + methods: + submit_log: + operation: + $ref: '#/paths/~1api~1v2~1logs/post' + response: + mediaType: application/json + openAPIDocKey: '202' + aggregate_logs: + operation: + $ref: '#/paths/~1api~1v2~1logs~1analytics~1aggregate/post' + response: + mediaType: application/json + openAPIDocKey: '200' + list_logs_get: + operation: + $ref: '#/paths/~1api~1v2~1logs~1events/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + list_logs: + operation: + $ref: '#/paths/~1api~1v2~1logs~1events~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/logs/methods/list_logs_get' + insert: + - $ref: '#/components/x-stackQL-resources/logs/methods/submit_log' + - $ref: '#/components/x-stackQL-resources/logs/methods/list_logs' + update: [] + delete: [] + replace: [] + archive_order: + id: datadog.logs.archive_order + name: archive_order + title: Archive Order + methods: + get_logs_archive_order: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1archive-order/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_logs_archive_order: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1archive-order/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/archive_order/methods/get_logs_archive_order + insert: [] + update: [] + delete: [] + replace: + - $ref: >- + #/components/x-stackQL-resources/archive_order/methods/update_logs_archive_order + archives: + id: datadog.logs.archives + name: archives + title: Archives + methods: + list_logs_archives: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1archives/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_logs_archive: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1archives/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_logs_archive: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_logs_archive: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_logs_archive: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/archives/methods/get_logs_archive' + - $ref: >- + #/components/x-stackQL-resources/archives/methods/list_logs_archives + insert: + - $ref: >- + #/components/x-stackQL-resources/archives/methods/create_logs_archive + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/archives/methods/delete_logs_archive + replace: + - $ref: >- + #/components/x-stackQL-resources/archives/methods/update_logs_archive + archive_read_roles: + id: datadog.logs.archive_read_roles + name: archive_read_roles + title: Archive Read Roles + methods: + remove_role_from_archive: + operation: + $ref: >- + #/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}~1readers/delete + response: + mediaType: application/json + openAPIDocKey: '204' + list_archive_read_roles: + operation: + $ref: >- + #/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}~1readers/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + add_read_role_to_archive: + operation: + $ref: >- + #/paths/~1api~1v2~1logs~1config~1archives~1{archive_id}~1readers/post + response: + mediaType: application/json + openAPIDocKey: '204' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/archive_read_roles/methods/list_archive_read_roles + insert: + - $ref: >- + #/components/x-stackQL-resources/archive_read_roles/methods/add_read_role_to_archive + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/archive_read_roles/methods/remove_role_from_archive + replace: [] + custom_destinations: + id: datadog.logs.custom_destinations + name: custom_destinations + title: Custom Destinations + methods: + list_logs_custom_destinations: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1custom-destinations/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_logs_custom_destination: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1custom-destinations/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_logs_custom_destination: + operation: + $ref: >- + #/paths/~1api~1v2~1logs~1config~1custom-destinations~1{custom_destination_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_logs_custom_destination: + operation: + $ref: >- + #/paths/~1api~1v2~1logs~1config~1custom-destinations~1{custom_destination_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_logs_custom_destination: + operation: + $ref: >- + #/paths/~1api~1v2~1logs~1config~1custom-destinations~1{custom_destination_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/custom_destinations/methods/get_logs_custom_destination + - $ref: >- + #/components/x-stackQL-resources/custom_destinations/methods/list_logs_custom_destinations + insert: + - $ref: >- + #/components/x-stackQL-resources/custom_destinations/methods/create_logs_custom_destination + update: + - $ref: >- + #/components/x-stackQL-resources/custom_destinations/methods/update_logs_custom_destination + delete: + - $ref: >- + #/components/x-stackQL-resources/custom_destinations/methods/delete_logs_custom_destination + replace: [] + metrics: + id: datadog.logs.metrics + name: metrics + title: Metrics + methods: + list_logs_metrics: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1metrics/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_logs_metric: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1metrics/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_logs_metric: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1metrics~1{metric_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_logs_metric: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1metrics~1{metric_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_logs_metric: + operation: + $ref: '#/paths/~1api~1v2~1logs~1config~1metrics~1{metric_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/metrics/methods/get_logs_metric' + - $ref: '#/components/x-stackQL-resources/metrics/methods/list_logs_metrics' + insert: + - $ref: >- + #/components/x-stackQL-resources/metrics/methods/create_logs_metric + update: + - $ref: >- + #/components/x-stackQL-resources/metrics/methods/update_logs_metric + delete: + - $ref: >- + #/components/x-stackQL-resources/metrics/methods/delete_logs_metric + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/metrics.yaml b/providers/src/datadog/v00.00.00000/services/metrics.yaml index 724cdad4..090b21f7 100644 --- a/providers/src/datadog/v00.00.00000/services/metrics.yaml +++ b/providers/src/datadog/v00.00.00000/services/metrics.yaml @@ -1,3380 +1,4678 @@ openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' + title: metrics API + description: datadog metrics API version: '1.0' - title: Datadog API V2 Collection - metrics - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - MetricTagConfigurationMetricTypes: - default: gauge - description: The metric's type. - enum: - - gauge - - count - - rate - - distribution - example: count - type: string - x-enum-varnames: - - GAUGE - - COUNT - - RATE - - DISTRIBUTION - MetricsAndMetricTagConfigurationsResponse: - description: Response object that includes metrics and metric tag configurations. - properties: - data: - description: Array of metrics and metric tag configurations. - items: - $ref: '#/components/schemas/MetricsAndMetricTagConfigurations' - type: array - readOnly: true - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - MetricsAndMetricTagConfigurations: - description: Object for a metrics and metric tag configurations. - oneOf: - - $ref: '#/components/schemas/Metric' - - $ref: '#/components/schemas/MetricTagConfiguration' - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - Metric: - description: Object for a single metric tag configuration. - example: - id: metric.foo.bar - type: metrics - properties: - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricType' - type: object - MetricTagConfiguration: - description: Object for a single metric tag configuration. - example: - attributes: - aggregations: - - space: avg - time: avg - created_at: '2020-03-25T09:48:37.463835Z' - metric_type: gauge - modified_at: '2020-04-25T09:48:37.463835Z' - tags: - - app - - datacenter - id: http.request.latency - type: manage_tags - properties: - attributes: - $ref: '#/components/schemas/MetricTagConfigurationAttributes' - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricTagConfigurationType' - type: object - MetricName: - description: The metric name for this resource. - example: test.metric.latency - type: string - MetricType: - default: metrics - description: The metric resource type. - enum: - - metrics - example: metrics - type: string - x-enum-varnames: - - METRICS - MetricTagConfigurationAttributes: - description: Object containing the definition of a metric tag configuration attributes. - properties: - aggregations: - $ref: '#/components/schemas/MetricCustomAggregations' - created_at: - description: Timestamp when the tag configuration was created. - example: '2020-03-25T09:48:37.463835Z' - format: date-time - type: string - exclude_tags_mode: - description: |- - When set to true, the configuration will exclude the configured tags and include any other submitted tags. - When set to false, the configuration will include the configured tags and exclude any other submitted tags. - Defaults to false. Requires `tags` property. - type: boolean - include_percentiles: - description: |- - Toggle to include or exclude percentile aggregations for distribution metrics. - Only present when the `metric_type` is `distribution`. +paths: + /api/v2/datasets: + get: + description: Get all datasets that have been configured for an organization. + operationId: GetAllDatasets + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DatasetResponseMulti' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: Get all datasets + tags: + - Datasets + x-permission: + operator: OR + permissions: + - user_access_read + x-unstable: |- + **Note: Data Access is in preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/).** + post: + description: Create a dataset with the configurations in the request. + operationId: CreateDataset + requestBody: + content: + application/json: + example: + data: + attributes: + name: Test RUM Dataset + principals: + - role:94172442-be03-11e9-a77a-3b7612558ac1 + product_filters: + - filters: + - '@application.id:application_123' + product: rum + type: dataset + schema: + $ref: '#/components/schemas/DatasetCreateRequest' + description: Dataset payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DatasetResponseSingle' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Create a dataset + tags: + - Datasets + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + x-unstable: |- + **Note: Data Access is in preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/).** + /api/v2/datasets/{dataset_id}: + delete: + description: Deletes the dataset associated with the ID. + operationId: DeleteDataset + parameters: + - $ref: '#/components/parameters/DatasetID' + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Delete a dataset + tags: + - Datasets + x-permission: + operator: OR + permissions: + - user_access_manage + x-unstable: |- + **Note: Data Access is in preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/).** + get: + description: Retrieves the dataset associated with the ID. + operationId: GetDataset + parameters: + - $ref: '#/components/parameters/DatasetID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DatasetResponseSingle' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: Get a single dataset by ID + tags: + - Datasets + x-permission: + operator: OPEN + permissions: [] + x-unstable: |- + **Note: Data Access is in preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/).** + put: + description: Edits the dataset associated with the ID. + operationId: UpdateDataset + parameters: + - $ref: '#/components/parameters/DatasetID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DatasetUpdateRequest' + description: Dataset payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DatasetResponseSingle' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Edit a dataset + tags: + - Datasets + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + x-unstable: |- + **Note: Data Access is in preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/).** + /api/v2/metrics: + get: + description: >- + Returns all metrics that can be configured in the Metrics Summary page + or with Metrics without Limits™ (matching additional filters if + specified). + + Optionally, paginate by using the `page[cursor]` and/or `page[size]` + query parameters. + + To fetch the first page, pass in a query parameter with either a valid + `page[size]` or an empty cursor like `page[cursor]=`. To fetch the next + page, pass in the `next_cursor` value from the response as the new + `page[cursor]` value. + + Once the `meta.pagination.next_cursor` value is null, all pages have + been retrieved. + operationId: ListTagConfigurations + parameters: + - description: Filter custom metrics that have configured tags. example: true - type: boolean - metric_type: - $ref: '#/components/schemas/MetricTagConfigurationMetricTypes' - modified_at: - description: Timestamp when the tag configuration was last modified. - example: '2020-03-25T09:48:37.463835Z' - format: date-time - type: string - tags: - description: List of tag keys on which to group. - example: - - app - - datacenter - items: - description: Tag keys to group by. - type: string - type: array - type: object - MetricTagConfigurationType: - default: manage_tags - description: The metric tag configuration resource type. - enum: - - manage_tags - example: manage_tags - type: string - x-enum-varnames: - - MANAGE_TAGS - MetricCustomAggregations: - description: |- - A list of queryable aggregation combinations for a count, rate, or gauge metric. - By default, count and rate metrics require the (time: sum, space: sum) aggregation and - Gauge metrics require the (time: avg, space: avg) aggregation. - Additional time & space combinations are also available: - - - time: avg, space: avg - - time: avg, space: max - - time: avg, space: min - - time: avg, space: sum - - time: count, space: sum - - time: max, space: max - - time: min, space: min - - time: sum, space: avg - - time: sum, space: sum - - Can only be applied to metrics that have a `metric_type` of `count`, `rate`, or `gauge`. - example: - - space: sum - time: sum - - space: sum - time: count - items: - $ref: '#/components/schemas/MetricCustomAggregation' - type: array - MetricCustomAggregation: - description: A time and space aggregation combination for use in query. - example: - space: sum - time: sum - properties: - space: - $ref: '#/components/schemas/MetricCustomSpaceAggregation' - time: - $ref: '#/components/schemas/MetricCustomTimeAggregation' - required: - - time - - space - type: object - MetricCustomSpaceAggregation: - description: A space aggregation for use in query. - enum: - - avg - - max - - min - - sum - example: sum - type: string - x-enum-varnames: - - AVG - - MAX - - MIN - - SUM - MetricCustomTimeAggregation: - description: A time aggregation for use in query. - enum: - - avg - - count - - max - - min - - sum - example: sum - type: string - x-enum-varnames: - - AVG - - COUNT - - MAX - - MIN - - SUM - MetricBulkTagConfigDeleteRequest: - description: Wrapper object for a single bulk tag deletion request. - properties: - data: - $ref: '#/components/schemas/MetricBulkTagConfigDelete' - required: - - data - type: object - MetricBulkTagConfigResponse: - description: Wrapper for a single bulk tag configuration status response. - properties: - data: - $ref: '#/components/schemas/MetricBulkTagConfigStatus' - type: object - MetricBulkTagConfigDelete: - description: Request object to bulk delete all tag configurations for metrics matching the given prefix. - properties: - attributes: - $ref: '#/components/schemas/MetricBulkTagConfigDeleteAttributes' - id: - $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix' - type: - $ref: '#/components/schemas/MetricBulkConfigureTagsType' - required: - - id - - type - type: object - MetricBulkTagConfigStatus: - description: |- - The status of a request to bulk configure metric tags. - It contains the fields from the original request for reference. - properties: - attributes: - $ref: '#/components/schemas/MetricBulkTagConfigStatusAttributes' - id: - $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix' - type: - $ref: '#/components/schemas/MetricBulkConfigureTagsType' - required: - - id - - type - type: object - MetricBulkTagConfigDeleteAttributes: - description: Optional parameters for bulk deleting metric tag configurations. - properties: - emails: - $ref: '#/components/schemas/MetricBulkTagConfigEmailList' - type: object - MetricBulkTagConfigNamePrefix: - description: A text prefix to match against metric names. - example: kafka.lag - type: string - MetricBulkConfigureTagsType: - default: metric_bulk_configure_tags - description: The metric bulk configure tags resource. - enum: - - metric_bulk_configure_tags - example: metric_bulk_configure_tags - type: string - x-enum-varnames: - - BULK_MANAGE_TAGS - MetricBulkTagConfigStatusAttributes: - description: Optional attributes for the status of a bulk tag configuration request. - properties: - emails: - $ref: '#/components/schemas/MetricBulkTagConfigEmailList' - exclude_tags_mode: - description: |- - When set to true, the configuration will exclude the configured tags and include any other submitted tags. - When set to false, the configuration will include the configured tags and exclude any other submitted tags. - type: boolean - status: - description: The status of the request. - example: Accepted - type: string - tags: - $ref: '#/components/schemas/MetricBulkTagConfigTagNameList' - type: object - MetricBulkTagConfigEmailList: - description: A list of account emails to notify when the configuration is applied. - example: - - sue@example.com - - bob@example.com - items: - description: An email address. - format: email - type: string - type: array - MetricBulkTagConfigTagNameList: - description: A list of tag names to apply to the configuration. - example: - - host - - pod_name - - is_shadow - items: - description: A metric tag name. - maxLength: 200 - pattern: '^[A-Za-z][A-Za-z0-9\.\-\_:\/]*$' - type: string - type: array - MetricBulkTagConfigCreateRequest: - description: Wrapper object for a single bulk tag configuration request. - properties: - data: - $ref: '#/components/schemas/MetricBulkTagConfigCreate' - required: - - data - type: object - MetricBulkTagConfigCreate: - description: Request object to bulk configure tags for metrics matching the given prefix. - properties: - attributes: - $ref: '#/components/schemas/MetricBulkTagConfigCreateAttributes' - id: - $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix' - type: - $ref: '#/components/schemas/MetricBulkConfigureTagsType' - required: - - id - - type - type: object - MetricBulkTagConfigCreateAttributes: - description: Optional parameters for bulk creating metric tag configurations. - properties: - emails: - $ref: '#/components/schemas/MetricBulkTagConfigEmailList' - exclude_tags_mode: - description: |- - When set to true, the configuration will exclude the configured tags and include any other submitted tags. - When set to false, the configuration will include the configured tags and exclude any other submitted tags. - Defaults to false. - type: boolean - tags: - $ref: '#/components/schemas/MetricBulkTagConfigTagNameList' - type: object - MetricSuggestedTagsAndAggregationsResponse: - description: Response object that includes a single metric's actively queried tags and aggregations. - properties: - data: - $ref: '#/components/schemas/MetricSuggestedTagsAndAggregations' - readOnly: true - type: object - MetricSuggestedTagsAndAggregations: - description: Object for a single metric's actively queried tags and aggregations. - properties: - attributes: - $ref: '#/components/schemas/MetricSuggestedTagsAttributes' - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricActiveConfigurationType' - type: object - MetricSuggestedTagsAttributes: - description: Object containing the definition of a metric's actively queried tags and aggregations. - properties: - active_aggregations: - $ref: '#/components/schemas/MetricSuggestedAggregations' - active_tags: - description: List of tag keys that have been actively queried. - example: - - app - - datacenter - items: - description: Actively queried tag keys. + in: query + name: filter[configured] + required: false + schema: + type: boolean + - description: Filter tag configurations by configured tags. + example: app + in: query + name: filter[tags_configured] + required: false + schema: + description: Tag keys to filter by. type: string - type: array - type: object - MetricActiveConfigurationType: - default: actively_queried_configurations - description: The metric actively queried configuration resource type. - enum: - - actively_queried_configurations - example: actively_queried_configurations - type: string - x-enum-varnames: - - ACTIVELY_QUERIED_CONFIGURATIONS - MetricSuggestedAggregations: - description: List of aggregation combinations that have been actively queried. - example: - - space: sum - time: sum - - space: sum - time: count - items: - $ref: '#/components/schemas/MetricCustomAggregation' - type: array - MetricAllTagsResponse: - description: Response object that includes a single metric's indexed tags. - properties: - data: - $ref: '#/components/schemas/MetricAllTags' - readOnly: true - type: object - MetricAllTags: - description: Object for a single metric's indexed tags. - properties: - attributes: - $ref: '#/components/schemas/MetricAllTagsAttributes' - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricType' - type: object - MetricAllTagsAttributes: - description: Object containing the definition of a metric's tags. - properties: - tags: - description: List of indexed tag value pairs. - example: - - 'sport:golf' - - 'sport:football' - - 'animal:dog' - items: - description: Tag key-value pairs. - type: string - type: array - type: object - MetricEstimateResponse: - description: Response object that includes metric cardinality estimates. - properties: - data: - $ref: '#/components/schemas/MetricEstimate' - type: object - MetricEstimate: - description: Object for a metric cardinality estimate. - properties: - attributes: - $ref: '#/components/schemas/MetricEstimateAttributes' - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricEstimateResourceType' - type: object - MetricEstimateAttributes: - description: Object containing the definition of a metric estimate attribute. - properties: - estimate_type: - $ref: '#/components/schemas/MetricEstimateType' - estimated_at: - description: Timestamp when the cardinality estimate was requested. - example: '2022-04-27T09:48:37.463835Z' - format: date-time - type: string - estimated_output_series: - description: Estimated cardinality of the metric based on the queried configuration. - example: 50 - format: int64 - type: integer - type: object - MetricEstimateResourceType: - default: metric_cardinality_estimate - description: The metric estimate resource type. - enum: - - metric_cardinality_estimate - example: metric_cardinality_estimate - type: string - x-enum-varnames: - - METRIC_CARDINALITY_ESTIMATE - MetricEstimateType: - default: count_or_gauge - description: 'Estimate type based on the queried configuration. By default, `count_or_gauge` is returned. `distribution` is returned for distribution metrics without percentiles enabled. Lastly, `percentile` is returned if `filter[pct]=true` is queried with a distribution metric.' - enum: - - count_or_gauge - - distribution - - percentile - example: distribution - type: string - x-enum-varnames: - - COUNT_OR_GAUGE - - DISTRIBUTION - - PERCENTILE - MetricTagConfigurationResponse: - description: Response object which includes a single metric's tag configuration. - properties: - data: - $ref: '#/components/schemas/MetricTagConfiguration' - readOnly: true - type: object - MetricTagConfigurationUpdateRequest: - description: Request object that includes the metric that you would like to edit the tag configuration on. - properties: - data: - $ref: '#/components/schemas/MetricTagConfigurationUpdateData' - required: - - data - type: object - MetricTagConfigurationUpdateData: - description: Object for a single tag configuration to be edited. - example: - attributes: - group_by: - - app - - datacenter - include_percentiles: false - id: http.endpoint.request - type: manage_tags - properties: - attributes: - $ref: '#/components/schemas/MetricTagConfigurationUpdateAttributes' - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricTagConfigurationType' - required: - - id - - type - type: object - MetricTagConfigurationUpdateAttributes: - description: Object containing the definition of a metric tag configuration to be updated. - properties: - aggregations: - $ref: '#/components/schemas/MetricCustomAggregations' - exclude_tags_mode: - description: |- - When set to true, the configuration will exclude the configured tags and include any other submitted tags. - When set to false, the configuration will include the configured tags and exclude any other submitted tags. - Defaults to false. Requires `tags` property. - type: boolean - include_percentiles: - description: |- - Toggle to include/exclude percentiles for a distribution metric. - Defaults to false. Can only be applied to metrics that have a `metric_type` of `distribution`. + - description: Filter metrics by metric type. + in: query + name: filter[metric_type] + required: false + schema: + $ref: '#/components/schemas/MetricTagConfigurationMetricTypeCategory' + - description: |- + Filter distributions with additional percentile + aggregations enabled or disabled. example: true - type: boolean - tags: - default: [] - description: A list of tag keys that will be queryable for your metric. - example: - - app - - datacenter - items: - description: Tag keys to group by. + in: query + name: filter[include_percentiles] + required: false + schema: + type: boolean + - description: >- + (Preview) Filter custom metrics that have or have not been queried + in the specified window[seconds]. + + If no window is provided or the window is less than 2 hours, a + default of 2 hours will be applied. + example: true + in: query + name: filter[queried] + required: false + schema: + type: boolean + - description: >- + Filter metrics that have been submitted with the given tags. + Supports boolean and wildcard expressions. + + Can only be combined with the filter[queried] filter. + example: env IN (staging,test) AND service:web + in: query + name: filter[tags] + required: false + schema: type: string - type: array - type: object - MetricTagConfigurationCreateRequest: - description: Request object that includes the metric that you would like to configure tags for. - properties: - data: - $ref: '#/components/schemas/MetricTagConfigurationCreateData' - required: - - data - type: object - MetricTagConfigurationCreateData: - description: Object for a single metric to be configure tags on. - example: - attributes: - include_percentiles: false - metric_type: distribution - tags: - - app - - datacenter - id: http.endpoint.request - type: manage_tags - properties: - attributes: - $ref: '#/components/schemas/MetricTagConfigurationCreateAttributes' - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricTagConfigurationType' - required: - - id - - type - type: object - MetricTagConfigurationCreateAttributes: - description: Object containing the definition of a metric tag configuration to be created. - properties: - aggregations: - $ref: '#/components/schemas/MetricCustomAggregations' - exclude_tags_mode: - description: |- - When set to true, the configuration will exclude the configured tags and include any other submitted tags. - When set to false, the configuration will include the configured tags and exclude any other submitted tags. - Defaults to false. Requires `tags` property. - type: boolean - include_percentiles: - description: |- - Toggle to include/exclude percentiles for a distribution metric. - Defaults to false. Can only be applied to metrics that have a `metric_type` of `distribution`. + - description: >- + (Preview) Filter metrics that are used in dashboards, monitors, + notebooks, SLOs. example: true - type: boolean - metric_type: - $ref: '#/components/schemas/MetricTagConfigurationMetricTypes' - tags: - default: [] - description: A list of tag keys that will be queryable for your metric. - example: - - app - - datacenter - items: - description: Tag keys to group by. + in: query + name: filter[related_assets] + required: false + schema: + type: boolean + - description: >- + The number of seconds of look back (from now) to apply to a + filter[tag] or filter[queried] query. + + Default value is 3600 (1 hour), maximum value is 2,592,000 (30 + days). + example: 3600 + in: query + name: window[seconds] + required: false + schema: + format: int64 + type: integer + - description: Maximum number of results returned. + in: query + name: page[size] + required: false + schema: + default: 10000 + format: int32 + maximum: 10000 + minimum: 1 + type: integer + - description: >- + String to query the next page of results. + + This key is provided with each valid response from the API in + `meta.pagination.next_cursor`. + + Once the `meta.pagination.next_cursor` key is null, all pages have + been retrieved. + in: query + name: page[cursor] + required: false + schema: type: string - type: array - required: - - tags - - metric_type - type: object - MetricVolumesResponse: - description: Response object which includes a single metric's volume. - properties: - data: - $ref: '#/components/schemas/MetricVolumes' - readOnly: true - type: object - MetricVolumes: - description: Possible response objects for a metric's volume. - oneOf: - - $ref: '#/components/schemas/MetricDistinctVolume' - - $ref: '#/components/schemas/MetricIngestedIndexedVolume' - MetricDistinctVolume: - description: Object for a single metric's distinct volume. - properties: - attributes: - $ref: '#/components/schemas/MetricDistinctVolumeAttributes' - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricDistinctVolumeType' - type: object - MetricIngestedIndexedVolume: - description: Object for a single metric's ingested and indexed volume. - properties: - attributes: - $ref: '#/components/schemas/MetricIngestedIndexedVolumeAttributes' - id: - $ref: '#/components/schemas/MetricName' - type: - $ref: '#/components/schemas/MetricIngestedIndexedVolumeType' - type: object - MetricDistinctVolumeAttributes: - description: Object containing the definition of a metric's distinct volume. - properties: - distinct_volume: - description: Distinct volume for the given metric. - example: 10 - format: int64 - type: integer - type: object - MetricDistinctVolumeType: - default: distinct_metric_volumes - description: The metric distinct volume type. - enum: - - distinct_metric_volumes - example: distinct_metric_volumes - type: string - x-enum-varnames: - - DISTINCT_METRIC_VOLUMES - MetricIngestedIndexedVolumeAttributes: - description: Object containing the definition of a metric's ingested and indexed volume. - properties: - indexed_volume: - description: Indexed volume for the given metric. - example: 10 - format: int64 - type: integer - ingested_volume: - description: Ingested volume for the given metric. - example: 20 - format: int64 - type: integer - type: object - MetricIngestedIndexedVolumeType: - default: metric_volumes - description: The metric ingested and indexed volume type. - enum: - - metric_volumes - example: metric_volumes - type: string - x-enum-varnames: - - METRIC_VOLUMES - ScalarFormulaQueryRequest: - description: A wrapper request around one scalar query to be executed. - properties: - data: - $ref: '#/components/schemas/ScalarFormulaRequest' - required: - - data - type: object - ScalarFormulaQueryResponse: - description: A message containing one or more responses to scalar queries. - properties: - data: - $ref: '#/components/schemas/ScalarResponse' - errors: - description: An error generated when processing a request. - type: string - type: object - ScalarFormulaRequest: - description: A single scalar query to be executed. - properties: - attributes: - $ref: '#/components/schemas/ScalarFormulaRequestAttributes' - type: - $ref: '#/components/schemas/ScalarFormulaRequestType' - required: - - type - - attributes - type: object - ScalarResponse: - description: A message containing the response to a scalar query. - properties: - attributes: - $ref: '#/components/schemas/ScalarFormulaResponseAtrributes' - type: - $ref: '#/components/schemas/ScalarFormulaResponseType' - type: object - ScalarFormulaRequestAttributes: - description: The object describing a scalar formula request. - properties: - formulas: - description: List of formulas to be calculated and returned as responses. - items: - $ref: '#/components/schemas/QueryFormula' - type: array - from: - description: Start date (inclusive) of the query in milliseconds since the Unix epoch. - example: 1568899800000 - format: int64 - type: integer - queries: - $ref: '#/components/schemas/ScalarFormulaRequestQueries' - to: - description: End date (exclusive) of the query in milliseconds since the Unix epoch. - example: 1568923200000 - format: int64 - type: integer - required: - - to - - from - - queries - type: object - ScalarFormulaRequestType: - default: scalar_request - description: The type of the resource. The value should always be scalar_request. - enum: - - scalar_request - example: scalar_request - type: string - x-enum-varnames: - - SCALAR_REQUEST - ScalarFormulaResponseAtrributes: - description: The object describing a scalar response. - properties: - columns: - description: 'List of response columns, each corresponding to an individual formula or query in the request and with values in parallel arrays matching the series list.' - items: - $ref: '#/components/schemas/ScalarColumn' - type: array - type: object - ScalarFormulaResponseType: - default: scalar_response - description: The type of the resource. The value should always be scalar_response. - enum: - - scalar_response - example: scalar_response - type: string - x-enum-varnames: - - SCALAR_RESPONSE - QueryFormula: - description: A formula for calculation based on one or more queries. - properties: - formula: - description: 'Formula string, referencing one or more queries with their name property.' - example: a+b - type: string - limit: - $ref: '#/components/schemas/FormulaLimit' - required: - - formula - type: object - ScalarFormulaRequestQueries: - description: List of queries to be run and used as inputs to the formulas. - items: - $ref: '#/components/schemas/ScalarQuery' - type: array - ScalarColumn: - description: A single column in a scalar query response. - oneOf: - - $ref: '#/components/schemas/GroupScalarColumn' - - $ref: '#/components/schemas/DataScalarColumn' - FormulaLimit: - description: |- - Message for specifying limits to the number of values returned by a query. - This limit is only for scalar queries and has no effect on timeseries queries. - properties: - count: - description: The number of results to which to limit. - example: 10 - format: int32 - maximum: 2147483647 - type: integer - order: - $ref: '#/components/schemas/QuerySortOrder' - type: object - ScalarQuery: - description: An individual scalar query to one of the basic Datadog data sources. - example: - aggregator: avg - data_source: metrics - query: 'avg:system.cpu.user{*} by {env}' - oneOf: - - $ref: '#/components/schemas/MetricsScalarQuery' - - $ref: '#/components/schemas/EventsScalarQuery' - GroupScalarColumn: - description: A column containing the tag keys and values in a group. - properties: - name: - description: The name of the tag key or group. - example: env - type: string - type: - $ref: '#/components/schemas/ScalarColumnTypeGroup' - values: - description: The array of tag values for each group found for the results of the formulas or queries. - example: - - - production - - - staging - items: - description: An individual tag value for a given group column. - items: - description: One tag value within a values array. - example: production - type: string - type: array - type: array - type: object - DataScalarColumn: - description: A column containing the numerical results for a formula or query. - properties: - meta: - $ref: '#/components/schemas/ScalarMeta' - name: - description: The name referencing the formula or query for this column. - example: a - type: string - type: - $ref: '#/components/schemas/ScalarColumnTypeNumber' - values: - description: The array of numerical values for one formula or query. - example: - - 0.5 - items: - description: An individual value for a given column and group-by. - example: 0.5 - format: double - nullable: true - type: number - type: array - type: object - QuerySortOrder: - default: desc - description: Direction of sort. - enum: - - asc - - desc - type: string - x-enum-varnames: - - ASC - - DESC - MetricsScalarQuery: - description: An individual scalar metrics query. - properties: - aggregator: - $ref: '#/components/schemas/MetricsAggregator' - data_source: - $ref: '#/components/schemas/MetricsDataSource' - name: - description: The variable name for use in formulas. - type: string - query: - description: A classic metrics query string. - example: 'avg:system.cpu.user{*} by {env}' - type: string - required: - - data_source - - query - - aggregator - type: object - EventsScalarQuery: - description: An individual scalar events query. - properties: - compute: - $ref: '#/components/schemas/EventsCompute' - data_source: - $ref: '#/components/schemas/EventsDataSource' - group_by: - $ref: '#/components/schemas/EventsQueryGroupBys' - indexes: - description: The indexes in which to search. - example: - - main - items: - description: The unique index name. - example: main - type: string - type: array - name: - description: The variable name for use in formulas. - type: string - search: - $ref: '#/components/schemas/EventsSearch' - required: - - data_source - - compute - type: object - ScalarColumnTypeGroup: - default: group - description: The type of column present for groups. - enum: - - group - example: group - type: string - x-enum-varnames: - - GROUP - ScalarMeta: - description: Metadata for the resulting numerical values. - properties: - unit: - description: |- - Detailed information about the unit. - First element describes the "primary unit" (for example, `bytes` in `bytes per second`). - The second element describes the "per unit" (for example, `second` in `bytes per second`). - If the second element is not present, the API returns null. - items: - $ref: '#/components/schemas/Unit' - nullable: true - type: array - type: object - ScalarColumnTypeNumber: - default: number - description: The type of column present for numbers. - enum: - - number - example: number - type: string - x-enum-varnames: - - NUMBER - MetricsAggregator: - default: avg - description: The type of aggregation that can be performed on metrics-based queries. - enum: - - avg - - min - - max - - sum - - last - - percentile - - mean - - l2norm - - area - example: avg - type: string - x-enum-varnames: - - AVG - - MIN - - MAX - - SUM - - LAST - - PERCENTILE - - MEAN - - L2NORM - - AREA - MetricsDataSource: - default: metrics - description: A data source that is powered by the Metrics platform. - enum: - - metrics - - cloud_cost - example: metrics - type: string - x-enum-varnames: - - METRICS - - CLOUD_COST - EventsCompute: - description: The instructions for what to compute for this query. - properties: - aggregation: - $ref: '#/components/schemas/EventsAggregation' - interval: - description: Interval for compute in milliseconds. - example: 60000 - format: int64 - type: integer - metric: - description: The "measure" attribute on which to perform the computation. - type: string - required: - - aggregation - type: object - EventsDataSource: - default: logs - description: A data source that is powered by the Events Platform. - enum: - - logs - - rum - example: logs - type: string - x-enum-varnames: - - LOGS - - RUM - EventsQueryGroupBys: - description: The list of facets on which to split results. - items: - $ref: '#/components/schemas/EventsGroupBy' - type: array - EventsSearch: - description: Configuration of the search/filter for an events query. - properties: - query: - description: The search/filter string for an events query. - example: 'status:warn service:foo' - type: string - type: object - Unit: - description: 'Object containing the metric unit family, scale factor, name, and short name.' - nullable: true - properties: - family: - description: 'Unit family, allows for conversion between units of the same family, for scaling.' - example: time - type: string - name: - description: Unit name - example: minute - type: string - plural: - description: Plural form of the unit name. - example: minutes - type: string - scale_factor: - description: Factor for scaling between units of the same family. - example: 60 - format: double - type: number - short_name: - description: Abbreviation of the unit. - example: min - type: string - type: object - EventsAggregation: - default: count - description: The type of aggregation that can be performed on events-based queries. - enum: - - count - - cardinality - - pc75 - - pc90 - - pc95 - - pc98 - - pc99 - - sum - - min - - max - - avg - example: count - type: string - x-enum-varnames: - - COUNT - - CARDINALITY - - PC75 - - PC90 - - PC95 - - PC98 - - PC99 - - SUM - - MIN - - MAX - - AVG - EventsGroupBy: - description: A dimension on which to split a query's results. - properties: - facet: - description: The facet by which to split groups. - example: '@error.type' - type: string - limit: - description: The maximum number of groups to return. - example: 10 - format: int32 - maximum: 2147483647 - type: integer - sort: - $ref: '#/components/schemas/EventsGroupBySort' - required: - - facet - type: object - EventsGroupBySort: - description: The dimension by which to sort a query's results. - properties: - aggregation: - $ref: '#/components/schemas/EventsAggregation' - metric: - description: The metric's calculated value which should be used to define the sort order of a query's results. - example: '@duration' - type: string - order: - $ref: '#/components/schemas/QuerySortOrder' - type: - $ref: '#/components/schemas/EventsSortType' - required: - - aggregation - type: object - EventsSortType: - description: The type of sort to use on the calculated value. - enum: - - alphabetical - - measure - type: string - x-enum-varnames: - - ALPHABETICAL - - MEASURE - TimeseriesFormulaQueryRequest: - description: A request wrapper around a single timeseries query to be executed. - properties: - data: - $ref: '#/components/schemas/TimeseriesFormulaRequest' - required: - - data - type: object - TimeseriesFormulaQueryResponse: - description: A message containing one response to a timeseries query made with timeseries formula query request. - properties: - data: - $ref: '#/components/schemas/TimeseriesResponse' - errors: - description: The error generated by the request. - type: string - type: object - TimeseriesFormulaRequest: - description: A single timeseries query to be executed. - properties: - attributes: - $ref: '#/components/schemas/TimeseriesFormulaRequestAttributes' - type: - $ref: '#/components/schemas/TimeseriesFormulaRequestType' - required: - - type - - attributes - type: object - TimeseriesResponse: - description: A message containing the response to a timeseries query. - properties: - attributes: - $ref: '#/components/schemas/TimeseriesResponseAttributes' - type: - $ref: '#/components/schemas/TimeseriesFormulaResponseType' - type: object - TimeseriesFormulaRequestAttributes: - description: The object describing a timeseries formula request. - properties: - formulas: - description: List of formulas to be calculated and returned as responses. - items: - $ref: '#/components/schemas/QueryFormula' - type: array - from: - description: Start date (inclusive) of the query in milliseconds since the Unix epoch. - example: 1568899800000 - format: int64 - type: integer - interval: - description: |- - A time interval in milliseconds. - May be overridden by a larger interval if the query would result in - too many points for the specified timeframe. - Defaults to a reasonable interval for the given timeframe. - example: 5000 - format: int64 - type: integer - queries: - $ref: '#/components/schemas/TimeseriesFormulaRequestQueries' - to: - description: End date (exclusive) of the query in milliseconds since the Unix epoch. - example: 1568923200000 - format: int64 - type: integer - required: - - to - - from - - queries - type: object - TimeseriesFormulaRequestType: - default: timeseries_request - description: The type of the resource. The value should always be timeseries_request. - enum: - - timeseries_request - example: timeseries_request - type: string - x-enum-varnames: - - TIMESERIES_REQUEST - TimeseriesResponseAttributes: - description: The object describing a timeseries response. - properties: - series: - $ref: '#/components/schemas/TimeseriesResponseSeriesList' - times: - $ref: '#/components/schemas/TimeseriesResponseTimes' - values: - $ref: '#/components/schemas/TimeseriesResponseValuesList' - type: object - TimeseriesFormulaResponseType: - default: timeseries_response - description: The type of the resource. The value should always be timeseries_response. - enum: - - timeseries_response - example: timeseries_response - type: string - x-enum-varnames: - - TIMESERIES_RESPONSE - TimeseriesFormulaRequestQueries: - description: List of queries to be run and used as inputs to the formulas. - items: - $ref: '#/components/schemas/TimeseriesQuery' - type: array - TimeseriesResponseSeriesList: - description: Array of response series. The index here corresponds to the index in the `formulas` or `queries` array from the request. - items: - $ref: '#/components/schemas/TimeseriesResponseSeries' - type: array - TimeseriesResponseTimes: - description: 'Array of times, 1-1 match with individual values arrays.' - items: - description: Start date (inclusive) of the query in seconds since the Unix epoch. - example: 1568899800000 - format: int64 - type: integer - type: array - TimeseriesResponseValuesList: - description: Array of value-arrays. The index here corresponds to the index in the `formulas` or `queries` array from the request. - items: - $ref: '#/components/schemas/TimeseriesResponseValues' - type: array - TimeseriesQuery: - description: An individual timeseries query to one of the basic Datadog data sources. - example: - data_source: metrics - query: 'avg:system.cpu.user{*} by {env}' - oneOf: - - $ref: '#/components/schemas/MetricsTimeseriesQuery' - - $ref: '#/components/schemas/EventsTimeseriesQuery' - TimeseriesResponseSeries: - description: '' - properties: - group_tags: - $ref: '#/components/schemas/GroupTags' - query_index: - description: The index of the query in the "formulas" array (or "queries" array if no "formulas" was specified). - example: 0 - format: int32 - maximum: 2147483647 - type: integer - unit: - description: |- - Detailed information about the unit. - The first element describes the "primary unit" (for example, `bytes` in `bytes per second`). - The second element describes the "per unit" (for example, `second` in `bytes per second`). - If the second element is not present, the API returns null. - items: - $ref: '#/components/schemas/Unit' - type: array - type: object - TimeseriesResponseValues: - description: Array of values for an individual formula or query. - example: - - 1575317847 - - 0.5 - items: - description: An individual value for a given time. - format: double - nullable: true - type: number - type: array - MetricsTimeseriesQuery: - description: An individual timeseries metrics query. - properties: - data_source: - $ref: '#/components/schemas/MetricsDataSource' - name: - description: The variable name for use in formulas. - type: string - query: - description: A classic metrics query string. - example: 'avg:system.cpu.user{*} by {env}' - type: string - required: - - data_source - - query - type: object - EventsTimeseriesQuery: - description: An individual timeseries events query. - properties: - compute: - $ref: '#/components/schemas/EventsCompute' - data_source: - $ref: '#/components/schemas/EventsDataSource' - group_by: - $ref: '#/components/schemas/EventsQueryGroupBys' - indexes: - description: The indexes in which to search. - example: - - main - items: - description: The unique index name. - example: main - type: string - type: array - name: - description: The variable name for use in formulas. - type: string - search: - $ref: '#/components/schemas/EventsSearch' - required: - - data_source - - compute - type: object - GroupTags: - description: List of tags that apply to a single response value. - items: - description: A single tag that applies to a single response value. - example: 'env:production' - type: string - type: array - MetricContentEncoding: - default: deflate - description: HTTP header used to compress the media-type. - enum: - - deflate - - zstd1 - - gzip - example: deflate - type: string - x-enum-varnames: - - DEFLATE - - ZSTD1 - - GZIP - MetricPayload: - description: The metrics' payload. - properties: - series: - description: A list of time series to submit to Datadog. - example: - - metric: system.load.1 - points: - - timestamp: 1475317847 - value: 0.7 - resources: - - name: dummyhost - type: host - items: - $ref: '#/components/schemas/MetricSeries' - type: array - required: - - series - type: object - IntakePayloadAccepted: - description: The payload accepted for intake. - properties: - errors: - description: A list of errors. - items: - description: An empty error list. - type: string - type: array - type: object - MetricSeries: - description: |- - A metric to submit to Datadog. - See [Datadog metrics](https://docs.datadoghq.com/developers/metrics/#custom-metrics-properties). - properties: - interval: - description: 'If the type of the metric is rate or count, define the corresponding interval.' - example: 20 - format: int64 - type: integer - metadata: - $ref: '#/components/schemas/MetricMetadata' - metric: - description: The name of the timeseries. - example: system.load.1 - type: string - points: - description: 'Points relating to a metric. All points must be objects with timestamp and a scalar value (cannot be a string). Timestamps should be in POSIX time in seconds, and cannot be more than ten minutes in the future or more than one hour in the past.' - items: - $ref: '#/components/schemas/MetricPoint' - type: array - resources: - description: A list of resources to associate with this metric. - items: - $ref: '#/components/schemas/MetricResource' - type: array - source_type_name: - description: The source type name. - example: datadog - type: string - tags: - description: A list of tags associated with the metric. - example: - - 'environment:test' - items: - description: Individual tags. - type: string - type: array - type: - $ref: '#/components/schemas/MetricIntakeType' - unit: - description: The unit of point value. - example: second - type: string - required: - - metric - - points - type: object - MetricMetadata: - description: Metadata for the metric. - properties: - origin: - $ref: '#/components/schemas/MetricOrigin' - type: object - MetricPoint: - description: 'A point object is of the form `{POSIX_timestamp, numeric_value}`.' - example: - timestamp: 1575317847 - value: 0.5 - properties: - timestamp: - description: |- - The timestamp should be in seconds and current. - Current is defined as not more than 10 minutes in the future or more than 1 hour in the past. - format: int64 - type: integer - value: - description: The numeric value format should be a 64bit float gauge-type value. - format: double - type: number - type: object - MetricResource: - description: Metric resource. - example: - name: dummyhost - type: host - properties: - name: - description: The name of the resource. - type: string - type: - description: The type of the resource. - type: string - type: object - MetricIntakeType: - description: 'The type of metric. The available types are `0` (unspecified), `1` (count), `2` (rate), and `3` (gauge).' - enum: - - 0 - - 1 - - 2 - - 3 - format: int32 - type: integer - x-enum-varnames: - - UNSPECIFIED - - COUNT - - RATE - - GAUGE - MetricOrigin: - description: Metric origin information. - properties: - metric_type: - default: 0 - description: The origin metric type code - format: int32 - maximum: 1000 - type: integer - product: - default: 0 - description: The origin product code - format: int32 - maximum: 1000 - type: integer - service: - default: 0 - description: The origin service code - format: int32 - maximum: 1000 - type: integer - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - UnauthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unauthorized - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - tag_configurations: - id: datadog.metrics.tag_configurations - name: tag_configurations - title: Tag Configurations - methods: - list_tag_configurations: - operation: - $ref: '#/paths/~1api~1v2~1metrics/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_tag_configurations: - operation: - $ref: '#/paths/~1api~1v2~1metrics/get' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_tag_configuration: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - update_tag_configuration: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - create_tag_configuration: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/post' - response: - mediaType: application/json - openAPIDocKey: '201' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/tag_configurations/methods/list_tag_configurations' - insert: - - $ref: '#/components/x-stackQL-resources/tag_configurations/methods/create_tag_configuration' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/tag_configurations/methods/delete_tag_configuration' - active_metric_configurations: - id: datadog.metrics.active_metric_configurations - name: active_metric_configurations - title: Active Metric Configurations - methods: - delete_bulk_tags_metrics_configuration: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1config~1bulk-tags/delete' - response: - mediaType: application/json - openAPIDocKey: '202' - create_bulk_tags_metrics_configuration: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1config~1bulk-tags/post' - response: - mediaType: application/json - openAPIDocKey: '202' - list_active_metric_configurations: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1active-configurations/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_active_metric_configurations: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1active-configurations/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/active_metric_configurations/methods/list_active_metric_configurations' - insert: - - $ref: '#/components/x-stackQL-resources/active_metric_configurations/methods/create_bulk_tags_metrics_configuration' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/active_metric_configurations/methods/delete_bulk_tags_metrics_configuration' - tags_by_metric_names: - id: datadog.metrics.tags_by_metric_names - name: tags_by_metric_names - title: Tags By Metric Names - methods: - list_tags_by_metric_name: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1all-tags/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_tags_by_metric_name: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1all-tags/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/tags_by_metric_names/methods/list_tags_by_metric_name' - insert: [] - update: [] - delete: [] - metrics_output_series: - id: datadog.metrics.metrics_output_series - name: metrics_output_series - title: Metrics Output Series - methods: - estimate_metrics_output_series: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1estimate/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _estimate_metrics_output_series: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1estimate/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: [] - insert: [] - update: [] - delete: [] - tag_configuration_by_name: - id: datadog.metrics.tag_configuration_by_name - name: tag_configuration_by_name - title: Tag Configuration By Name - methods: - list_tag_configuration_by_name: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_tag_configuration_by_name: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/tag_configuration_by_name/methods/list_tag_configuration_by_name' - insert: [] - update: [] - delete: [] - volumes_by_metric_name: - id: datadog.metrics.volumes_by_metric_name - name: volumes_by_metric_name - title: Volumes By Metric Name - methods: - list_volumes_by_metric_name: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1volumes/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_volumes_by_metric_name: - operation: - $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1volumes/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/volumes_by_metric_name/methods/list_volumes_by_metric_name' - insert: [] - update: [] - delete: [] - scalar_data: - id: datadog.metrics.scalar_data - name: scalar_data - title: Scalar Data - methods: - query_scalar_data: - operation: - $ref: '#/paths/~1api~1v2~1query~1scalar/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/scalar_data/methods/query_scalar_data' - insert: [] - update: [] - delete: [] - timeseries_data: - id: datadog.metrics.timeseries_data - name: timeseries_data - title: Timeseries Data - methods: - query_timeseries_data: - operation: - $ref: '#/paths/~1api~1v2~1query~1timeseries/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/timeseries_data/methods/query_timeseries_data' - insert: [] - update: [] - delete: [] - metrics: - id: datadog.metrics.metrics - name: metrics - title: Metrics - methods: - submit_metrics: - operation: - $ref: '#/paths/~1api~1v2~1series/post' - response: - mediaType: application/json - openAPIDocKey: '202' - sqlVerbs: - select: [] - insert: [] - update: [] - delete: [] -paths: - /api/v2/metrics: + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricsAndMetricTagConfigurationsResponse' + description: Success + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - metrics_read + summary: Get a list of metrics + tags: + - Metrics + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.pagination.next_cursor + limitParam: page[size] + resultsPath: data + x-permission: + operator: OR + permissions: + - metrics_read + /api/v2/metrics/config/bulk-tags: + delete: + description: >- + Delete all custom lists of queryable tag keys for a set of existing + count, gauge, rate, and distribution metrics. + + Metrics are selected by passing a metric name prefix. + + Results can be sent to a set of account email addresses, just like the + same operation in the Datadog web app. + + Can only be used with application keys of users with the `Manage Tags + for Metrics` permission. + operationId: DeleteBulkTagsMetricsConfiguration + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MetricBulkTagConfigDeleteRequest' + required: true + responses: + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricBulkTagConfigResponse' + description: Accepted + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + summary: Delete tags for multiple metrics + tags: + - Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - metric_tags_write + post: + description: >- + Create and define a list of queryable tag keys for a set of existing + count, gauge, rate, and distribution metrics. + + Metrics are selected by passing a metric name prefix. Use the Delete + method of this API path to remove tag configurations. + + Results can be sent to a set of account email addresses, just like the + same operation in the Datadog web app. + + If multiple calls include the same metric, the last configuration + applied (not by submit order) is used, do not + + expect deterministic ordering of concurrent calls. The + `exclude_tags_mode` value will set all metrics that match the prefix to + + the same exclusion state, metric tag configurations do not support mixed + inclusion and exclusion for tags on the same metric. + + Can only be used with application keys of users with the `Manage Tags + for Metrics` permission. + operationId: CreateBulkTagsMetricsConfiguration + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MetricBulkTagConfigCreateRequest' + required: true + responses: + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricBulkTagConfigResponse' + description: Accepted + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + summary: Configure tags for multiple metrics + tags: + - Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - metric_tags_write + /api/v2/metrics/{metric_name}/active-configurations: + get: + description: >- + List tags and aggregations that are actively queried on dashboards, + notebooks, monitors, the Metrics Explorer, and using the API for a given + metric name. + operationId: ListActiveMetricConfigurations + parameters: + - $ref: '#/components/parameters/MetricName' + - description: >- + The number of seconds of look back (from now). + + Default value is 604,800 (1 week), minimum value is 7200 (2 hours), + maximum value is 2,630,000 (1 month). + example: 7200 + in: query + name: window[seconds] + required: false + schema: + format: int64 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/MetricSuggestedTagsAndAggregationsResponse + description: Success + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + summary: List active tags and aggregations + tags: + - Metrics + x-permission: + operator: OR + permissions: + - metrics_read + /api/v2/metrics/{metric_name}/all-tags: + get: + description: >- + View indexed tag key-value pairs for a given metric name over the + previous hour. + operationId: ListTagsByMetricName + parameters: + - $ref: '#/components/parameters/MetricName' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricAllTagsResponse' + description: Success + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - metrics_read + summary: List tags by metric name + tags: + - Metrics + x-permission: + operator: OR + permissions: + - metrics_read + /api/v2/metrics/{metric_name}/assets: + get: + description: >- + Returns dashboards, monitors, notebooks, and SLOs that a metric is + stored in, if any. Updated every 24 hours. + operationId: ListMetricAssets + parameters: + - $ref: '#/components/parameters/MetricName' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricAssetsResponse' + description: Success + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Related Assets to a Metric + tags: + - Metrics + /api/v2/metrics/{metric_name}/estimate: + get: + description: >- + Returns the estimated cardinality for a metric with a given tag, + percentile and number of aggregations configuration using Metrics + without Limits™. + operationId: EstimateMetricsOutputSeries + parameters: + - $ref: '#/components/parameters/MetricName' + - description: Filtered tag keys that the metric is configured to query with. + example: app,host + in: query + name: filter[groups] + required: false + schema: + type: string + - description: >- + The number of hours of look back (from now) to estimate cardinality + with. If unspecified, it defaults to 0 hours. + example: 49 + in: query + name: filter[hours_ago] + required: false + schema: + format: int32 + maximum: 2147483647 + minimum: 49 + type: integer + - description: Deprecated. Number of aggregations has no impact on volume. + example: 1 + in: query + name: filter[num_aggregations] + required: false + schema: + format: int32 + maximum: 9 + type: integer + - description: >- + A boolean, for distribution metrics only, to estimate cardinality if + the metric includes additional percentile aggregators. + example: true + in: query + name: filter[pct] + required: false + schema: + type: boolean + - description: >- + A window, in hours, from the look back to estimate cardinality with. + The minimum and default is 1 hour. + example: 6 + in: query + name: filter[timespan_h] + required: false + schema: + format: int32 + maximum: 2147483647 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricEstimateResponse' + description: Success + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + summary: Tag Configuration Cardinality Estimator + tags: + - Metrics + x-permission: + operator: OPEN + permissions: [] + /api/v2/metrics/{metric_name}/tag-cardinalities: + get: + description: Returns the cardinality details of tags for a specific metric. + operationId: GetMetricTagCardinalityDetails + parameters: + - $ref: '#/components/parameters/MetricName' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricTagCardinalitiesResponse' + description: Success + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too Many Requests + summary: Get tag key cardinality details + tags: + - Metrics + x-permission: + operator: OR + permissions: + - metrics_read + /api/v2/metrics/{metric_name}/tags: + delete: + description: |- + Deletes a metric's tag configuration. Can only be used with application + keys from users with the `Manage Tags for Metrics` permission. + operationId: DeleteTagConfiguration + parameters: + - $ref: '#/components/parameters/MetricName' + responses: + '204': + description: No Content + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + summary: Delete a tag configuration + tags: + - Metrics + x-permission: + operator: OR + permissions: + - metric_tags_write + get: + description: Returns the tag configuration for the given metric name. + operationId: ListTagConfigurationByName + parameters: + - $ref: '#/components/parameters/MetricName' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricTagConfigurationResponse' + description: Success + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - metrics_read + summary: List tag configuration by name + tags: + - Metrics + x-permission: + operator: OR + permissions: + - metrics_read + patch: + description: >- + Update the tag configuration of a metric or percentile aggregations of a + distribution metric or custom aggregations + + of a count, rate, or gauge metric. By setting `exclude_tags_mode` to + true the behavior is changed + + from an allow-list to a deny-list, and tags in the defined list will not + be queryable. + + Can only be used with application keys from users with the `Manage Tags + for Metrics` permission. This endpoint requires + + a tag configuration to be created first. + operationId: UpdateTagConfiguration + parameters: + - $ref: '#/components/parameters/MetricName' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MetricTagConfigurationUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricTagConfigurationResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unprocessable Entity + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + summary: Update a tag configuration + tags: + - Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - metric_tags_write + post: + description: >- + Create and define a list of queryable tag keys for an existing + count/gauge/rate/distribution metric. + + Optionally, include percentile aggregations on any distribution metric. + By setting `exclude_tags_mode` + + to true, the behavior is changed from an allow-list to a deny-list, and + tags in the defined list are + + not queryable. Can only be used with application keys of users with the + `Manage Tags for Metrics` + + permission. + operationId: CreateTagConfiguration + parameters: + - $ref: '#/components/parameters/MetricName' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MetricTagConfigurationCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricTagConfigurationResponse' + description: Created + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '409': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + summary: Create a tag configuration + tags: + - Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - metric_tags_write + /api/v2/metrics/{metric_name}/volumes: + get: + description: >- + View distinct metrics volumes for the given metric name. + + + Custom metrics generated in-app from other products will return `null` + for ingested volumes. + operationId: ListVolumesByMetricName + parameters: + - $ref: '#/components/parameters/MetricName' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MetricVolumesResponse' + description: Success + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too Many Requests + summary: List distinct metric volumes by metric name + tags: + - Metrics + x-permission: + operator: OPEN + permissions: [] + /api/v2/query/scalar: + post: + description: >- + Query scalar values (as seen on Query Value, Table, and Toplist + widgets). + + Multiple data sources are supported with the ability to + + process the data using formulas and functions. + operationId: QueryScalarData + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ScalarFormulaQueryRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ScalarFormulaQueryResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - timeseries_query + summary: Query scalar data across multiple products + tags: + - Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - timeseries_query + /api/v2/query/timeseries: + post: + description: |- + Query timeseries data across various data sources and + process the data by applying formulas and functions. + operationId: QueryTimeseriesData + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/TimeseriesFormulaQueryRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TimeseriesFormulaQueryResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - timeseries_query + summary: Query timeseries data across multiple products + tags: + - Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - timeseries_query + /api/v2/series: + post: + description: >- + The metrics end-point allows you to post time-series data that can be + graphed on Datadog’s dashboards. + + The maximum payload size is 500 kilobytes (512000 bytes). Compressed + payloads must have a decompressed size of less than 5 megabytes (5242880 + bytes). + + + If you’re submitting metrics directly to the Datadog API without using + DogStatsD, expect: + + + - 64 bits for the timestamp + + - 64 bits for the value + + - 20 bytes for the metric names + + - 50 bytes for the timeseries + + - The full payload is approximately 100 bytes. + + + Host name is one of the resources in the Resources field. + operationId: SubmitMetrics + parameters: + - description: HTTP header used to compress the media-type. + in: header + name: Content-Encoding + required: false + schema: + $ref: '#/components/schemas/MetricContentEncoding' + requestBody: + content: + application/json: + examples: + dynamic-points: + description: >- + Post time-series data that can be graphed on Datadog’s + dashboards. + externalValue: examples/metrics/dynamic-points.json.sh + summary: Dynamic Points + x-variables: + NOW: $(date +%s) + schema: + $ref: '#/components/schemas/MetricPayload' + required: true + responses: + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/IntakePayloadAccepted' + description: Payload accepted + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '408': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Request timeout + '413': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Payload too large + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + summary: Submit metrics + tags: + - Metrics + x-codegen-request-body-name: body + /api/v2/spans/analytics/aggregate: + post: + description: >- + The API endpoint to aggregate spans into buckets and compute metrics and + timeseries. + + This endpoint is rate limited to `300` requests per hour. + operationId: AggregateSpans + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SpansAggregateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SpansAggregateResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_read + summary: Aggregate spans + tags: + - Spans + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - apm_read + /api/v2/spans/events: get: - description: Returns all metrics that can be configured in the Metrics Summary page or with Metrics without Limits™ (matching additional filters if specified). - operationId: ListTagConfigurations + description: |- + List endpoint returns spans that match a span search query. + [Results are paginated][1]. + + Use this endpoint to see your latest spans. + This endpoint is rate limited to `300` requests per hour. + + [1]: /logs/guide/collect-multiple-logs-with-pagination?tab=v2api + operationId: ListSpansGet parameters: - - description: Filter custom metrics that have configured tags. - example: true + - description: Search query following spans syntax. + example: '@datacenter:us @role:db' in: query - name: 'filter[configured]' + name: filter[query] required: false schema: - type: boolean - - description: Filter tag configurations by configured tags. - example: app + type: string + - description: >- + Minimum timestamp for requested spans. Supports date-time ISO8601, + date math, and regular timestamps (milliseconds). + example: '2023-01-02T09:42:36.320Z' in: query - name: 'filter[tags_configured]' + name: filter[from] required: false schema: - description: Tag keys to filter by. type: string - - description: Filter metrics by metric type. - in: query - name: 'filter[metric_type]' - required: false - schema: - $ref: '#/components/schemas/MetricTagConfigurationMetricTypes' - - description: |- - Filter distributions with additional percentile - aggregations enabled or disabled. + - description: >- + Maximum timestamp for requested spans. Supports date-time ISO8601, + date math, and regular timestamps (milliseconds). + example: '2023-01-03T09:42:36.320Z' + in: query + name: filter[to] + required: false + schema: + type: string + - description: Order of spans in results. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/SpansSort' + - description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + in: query + name: page[cursor] + required: false + schema: + type: string + - description: Maximum number of spans in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 10 + format: int32 + maximum: 1000 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SpansListResponse' + description: OK + '400': + $ref: '#/components/responses/SpansBadRequestResponse' + '403': + $ref: '#/components/responses/SpansForbiddenResponse' + '422': + $ref: '#/components/responses/SpansUnprocessableEntityResponse' + '429': + $ref: '#/components/responses/SpansTooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_read + summary: Get a list of spans + tags: + - Spans + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + /api/v2/spans/events/search: + post: + description: |- + List endpoint returns spans that match a span search query. + [Results are paginated][1]. + + Use this endpoint to build complex spans filtering and search. + This endpoint is rate limited to `300` requests per hour. + + [1]: /logs/guide/collect-multiple-logs-with-pagination?tab=v2api + operationId: ListSpans + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SpansListRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SpansListResponse' + description: OK + '400': + $ref: '#/components/responses/SpansBadRequestResponse' + '403': + $ref: '#/components/responses/SpansForbiddenResponse' + '422': + $ref: '#/components/responses/SpansUnprocessableEntityResponse' + '429': + $ref: '#/components/responses/SpansTooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_read + summary: Search spans + tags: + - Spans + x-codegen-request-body-name: body + x-pagination: + cursorParam: body.data.attributes.page.cursor + cursorPath: meta.page.after + limitParam: body.data.attributes.page.limit + resultsPath: data +components: + schemas: + DatasetResponseMulti: + description: Response containing a list of datasets. + properties: + data: + description: The list of datasets returned in response. + items: + $ref: '#/components/schemas/DatasetResponse' + type: array + type: object + DatasetCreateRequest: + description: Create request for a dataset. + properties: + data: + $ref: '#/components/schemas/DatasetRequest' + required: + - data + type: object + DatasetResponseSingle: + description: Response containing a single dataset object. + properties: + data: + $ref: '#/components/schemas/DatasetResponse' + type: object + DatasetUpdateRequest: + description: Edit request for a dataset. + properties: + data: + $ref: '#/components/schemas/DatasetRequest' + required: + - data + type: object + MetricTagConfigurationMetricTypeCategory: + default: distribution + description: The metric's type category. + enum: + - non_distribution + - distribution + example: distribution + type: string + x-enum-varnames: + - NON_DISTRIBUTION + - DISTRIBUTION + MetricsAndMetricTagConfigurationsResponse: + description: Response object that includes metrics and metric tag configurations. + properties: + data: + description: Array of metrics and metric tag configurations. + items: + $ref: '#/components/schemas/MetricsAndMetricTagConfigurations' + type: array + links: + $ref: '#/components/schemas/MetricsListResponseLinks' + meta: + $ref: '#/components/schemas/MetricPaginationMeta' + readOnly: true + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + MetricBulkTagConfigDeleteRequest: + description: Wrapper object for a single bulk tag deletion request. + properties: + data: + $ref: '#/components/schemas/MetricBulkTagConfigDelete' + required: + - data + type: object + MetricBulkTagConfigResponse: + description: Wrapper for a single bulk tag configuration status response. + properties: + data: + $ref: '#/components/schemas/MetricBulkTagConfigStatus' + type: object + MetricBulkTagConfigCreateRequest: + description: Wrapper object for a single bulk tag configuration request. + properties: + data: + $ref: '#/components/schemas/MetricBulkTagConfigCreate' + required: + - data + type: object + MetricSuggestedTagsAndAggregationsResponse: + description: >- + Response object that includes a single metric's actively queried tags + and aggregations. + properties: + data: + $ref: '#/components/schemas/MetricSuggestedTagsAndAggregations' + readOnly: true + type: object + MetricAllTagsResponse: + description: Response object that includes a single metric's indexed tags. + properties: + data: + $ref: '#/components/schemas/MetricAllTags' + readOnly: true + type: object + MetricAssetsResponse: + description: >- + Response object that includes related dashboards, monitors, notebooks, + and SLOs. + properties: + data: + $ref: '#/components/schemas/MetricAssetResponseData' + included: + description: Array of objects related to the metric assets. + items: + $ref: '#/components/schemas/MetricAssetResponseIncluded' + type: array + type: object + MetricEstimateResponse: + description: Response object that includes metric cardinality estimates. + properties: + data: + $ref: '#/components/schemas/MetricEstimate' + type: object + MetricTagCardinalitiesResponse: + description: > + Response object that includes an array of objects representing the + cardinality details of a metric's tags. + properties: + data: + $ref: '#/components/schemas/MetricTagCardinalitiesData' + meta: + $ref: '#/components/schemas/MetricTagCardinalitiesMeta' + readOnly: true + type: object + JSONAPIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + items: + $ref: '#/components/schemas/JSONAPIErrorItem' + type: array + required: + - errors + type: object + MetricTagConfigurationResponse: + description: Response object which includes a single metric's tag configuration. + properties: + data: + $ref: '#/components/schemas/MetricTagConfiguration' + readOnly: true + type: object + MetricTagConfigurationUpdateRequest: + description: >- + Request object that includes the metric that you would like to edit the + tag configuration on. + properties: + data: + $ref: '#/components/schemas/MetricTagConfigurationUpdateData' + required: + - data + type: object + MetricTagConfigurationCreateRequest: + description: >- + Request object that includes the metric that you would like to configure + tags for. + properties: + data: + $ref: '#/components/schemas/MetricTagConfigurationCreateData' + required: + - data + type: object + MetricVolumesResponse: + description: Response object which includes a single metric's volume. + properties: + data: + $ref: '#/components/schemas/MetricVolumes' + readOnly: true + type: object + ScalarFormulaQueryRequest: + description: A wrapper request around one scalar query to be executed. + properties: + data: + $ref: '#/components/schemas/ScalarFormulaRequest' + required: + - data + type: object + ScalarFormulaQueryResponse: + description: A message containing one or more responses to scalar queries. + properties: + data: + $ref: '#/components/schemas/ScalarResponse' + errors: + description: An error generated when processing a request. + type: string + type: object + TimeseriesFormulaQueryRequest: + description: A request wrapper around a single timeseries query to be executed. + properties: + data: + $ref: '#/components/schemas/TimeseriesFormulaRequest' + required: + - data + type: object + TimeseriesFormulaQueryResponse: + description: >- + A message containing one response to a timeseries query made with + timeseries formula query request. + properties: + data: + $ref: '#/components/schemas/TimeseriesResponse' + errors: + description: The error generated by the request. + type: string + type: object + MetricContentEncoding: + default: deflate + description: HTTP header used to compress the media-type. + enum: + - deflate + - zstd1 + - gzip + example: deflate + type: string + x-enum-varnames: + - DEFLATE + - ZSTD1 + - GZIP + MetricPayload: + description: The metrics' payload. + properties: + series: + description: A list of timeseries to submit to Datadog. + example: + - metric: system.load.1 + points: + - timestamp: 1475317847 + value: 0.7 + resources: + - name: dummyhost + type: host + items: + $ref: '#/components/schemas/MetricSeries' + type: array + required: + - series + type: object + IntakePayloadAccepted: + description: The payload accepted for intake. + properties: + errors: + description: A list of errors. + items: + description: An empty error list. + type: string + type: array + type: object + SpansAggregateRequest: + description: >- + The object sent with the request to retrieve a list of aggregated spans + from your organization. + properties: + data: + $ref: '#/components/schemas/SpansAggregateData' + type: object + SpansAggregateResponse: + description: The response object for the spans aggregate API endpoint. + properties: + data: + description: The list of matching buckets, one item per bucket. + items: + $ref: '#/components/schemas/SpansAggregateBucket' + type: array + meta: + $ref: '#/components/schemas/SpansAggregateResponseMetadata' + type: object + SpansSort: + description: Sort parameters when querying spans. + enum: + - timestamp + - '-timestamp' + type: string + x-enum-varnames: + - TIMESTAMP_ASCENDING + - TIMESTAMP_DESCENDING + SpansListResponse: + description: >- + Response object with all spans matching the request and pagination + information. + properties: + data: + description: Array of spans matching the request. + items: + $ref: '#/components/schemas/Span' + type: array + links: + $ref: '#/components/schemas/SpansListResponseLinks' + meta: + $ref: '#/components/schemas/SpansListResponseMetadata' + type: object + SpansListRequest: + description: The request for a spans list. + properties: + data: + $ref: '#/components/schemas/SpansListRequestData' + type: object + DatasetResponse: + description: |- + **Datasets Object Constraints** + - **Tag Limit per Dataset**: + - Each restricted dataset supports a maximum of 10 key:value pairs per product. + + - **Tag Key Rules per Telemetry Type**: + - Only one tag key or attribute may be used to define access within a single telemetry type. + - The same or different tag key may be used across different telemetry types. + + - **Tag Value Uniqueness**: + - Tag values must be unique within a single dataset. + - A tag value used in one dataset cannot be reused in another dataset of the same telemetry type. + properties: + attributes: + $ref: '#/components/schemas/DatasetAttributesResponse' + id: + description: Unique identifier for the dataset. + example: 123e4567-e89b-12d3-a456-426614174000 + type: string + type: + $ref: '#/components/schemas/DatasetType' + type: object + DatasetRequest: + description: |- + **Datasets Object Constraints** + - **Tag limit per dataset**: + - Each restricted dataset supports a maximum of 10 key:value pairs per product. + + - **Tag key rules per telemetry type**: + - Only one tag key or attribute may be used to define access within a single telemetry type. + - The same or different tag key may be used across different telemetry types. + + - **Tag value uniqueness**: + - Tag values must be unique within a single dataset. + - A tag value used in one dataset cannot be reused in another dataset of the same telemetry type. + properties: + attributes: + $ref: '#/components/schemas/DatasetAttributesRequest' + type: + $ref: '#/components/schemas/DatasetType' + required: + - type + - attributes + type: object + MetricsAndMetricTagConfigurations: + description: Object for a metrics and metric tag configurations. + oneOf: + - $ref: '#/components/schemas/Metric' + - $ref: '#/components/schemas/MetricTagConfiguration' + MetricsListResponseLinks: + description: >- + Pagination links. Only present if pagination query parameters were + provided. + properties: + first: + description: Link to the first page. + type: string + last: + description: Link to the last page. + nullable: true + type: string + next: + description: Link to the next page. + nullable: true + type: string + prev: + description: Link to previous page. + nullable: true + type: string + self: + description: Link to current page. + type: string + type: object + MetricPaginationMeta: + description: Response metadata object. + properties: + pagination: + $ref: '#/components/schemas/MetricMetaPage' + type: object + MetricBulkTagConfigDelete: + description: >- + Request object to bulk delete all tag configurations for metrics + matching the given prefix. + properties: + attributes: + $ref: '#/components/schemas/MetricBulkTagConfigDeleteAttributes' + id: + $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix' + type: + $ref: '#/components/schemas/MetricBulkConfigureTagsType' + required: + - id + - type + type: object + MetricBulkTagConfigStatus: + description: |- + The status of a request to bulk configure metric tags. + It contains the fields from the original request for reference. + properties: + attributes: + $ref: '#/components/schemas/MetricBulkTagConfigStatusAttributes' + id: + $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix' + type: + $ref: '#/components/schemas/MetricBulkConfigureTagsType' + required: + - id + - type + type: object + MetricBulkTagConfigCreate: + description: >- + Request object to bulk configure tags for metrics matching the given + prefix. + properties: + attributes: + $ref: '#/components/schemas/MetricBulkTagConfigCreateAttributes' + id: + $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix' + type: + $ref: '#/components/schemas/MetricBulkConfigureTagsType' + required: + - id + - type + type: object + MetricSuggestedTagsAndAggregations: + description: Object for a single metric's actively queried tags and aggregations. + properties: + attributes: + $ref: '#/components/schemas/MetricSuggestedTagsAttributes' + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricActiveConfigurationType' + type: object + MetricAllTags: + description: Object for a single metric's indexed tags. + properties: + attributes: + $ref: '#/components/schemas/MetricAllTagsAttributes' + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricType' + type: object + MetricAssetResponseData: + description: Metric assets response data. + properties: + id: + $ref: '#/components/schemas/MetricName' + relationships: + $ref: '#/components/schemas/MetricAssetResponseRelationships' + type: + $ref: '#/components/schemas/MetricType' + required: + - id + - type + type: object + MetricAssetResponseIncluded: + description: List of included assets with full set of attributes. + oneOf: + - $ref: '#/components/schemas/MetricDashboardAsset' + - $ref: '#/components/schemas/MetricMonitorAsset' + - $ref: '#/components/schemas/MetricNotebookAsset' + - $ref: '#/components/schemas/MetricSLOAsset' + MetricEstimate: + description: Object for a metric cardinality estimate. + properties: + attributes: + $ref: '#/components/schemas/MetricEstimateAttributes' + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricEstimateResourceType' + type: object + MetricTagCardinalitiesData: + description: A list of tag cardinalities associated with the given metric. + items: + $ref: '#/components/schemas/MetricTagCardinality' + type: array + MetricTagCardinalitiesMeta: + description: Response metadata object. + properties: + metric_name: + description: | + The name of metric for which the tag cardinalities are returned. + This matches the metric name provided in the request. + type: string + type: object + JSONAPIErrorItem: + description: API error response body + properties: + detail: + description: >- + A human-readable explanation specific to this occurrence of the + error. + example: Missing required attribute in body + type: string + meta: + additionalProperties: {} + description: Non-standard meta-information about the error + type: object + source: + $ref: '#/components/schemas/JSONAPIErrorItemSource' + status: + description: Status code of the response. + example: '400' + type: string + title: + description: Short human-readable summary of the error. + example: Bad Request + type: string + type: object + MetricTagConfiguration: + description: Object for a single metric tag configuration. + example: + attributes: + aggregations: + - space: avg + time: avg + created_at: '2020-03-25T09:48:37.463835Z' + metric_type: gauge + modified_at: '2020-04-25T09:48:37.463835Z' + tags: + - app + - datacenter + id: http.request.latency + type: manage_tags + properties: + attributes: + $ref: '#/components/schemas/MetricTagConfigurationAttributes' + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricTagConfigurationType' + type: object + MetricTagConfigurationUpdateData: + description: Object for a single tag configuration to be edited. + example: + attributes: + group_by: + - app + - datacenter + include_percentiles: false + id: http.endpoint.request + type: manage_tags + properties: + attributes: + $ref: '#/components/schemas/MetricTagConfigurationUpdateAttributes' + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricTagConfigurationType' + required: + - id + - type + type: object + MetricTagConfigurationCreateData: + description: Object for a single metric to be configure tags on. + example: + attributes: + include_percentiles: false + metric_type: distribution + tags: + - app + - datacenter + id: http.endpoint.request + type: manage_tags + properties: + attributes: + $ref: '#/components/schemas/MetricTagConfigurationCreateAttributes' + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricTagConfigurationType' + required: + - id + - type + type: object + MetricVolumes: + description: Possible response objects for a metric's volume. + oneOf: + - $ref: '#/components/schemas/MetricDistinctVolume' + - $ref: '#/components/schemas/MetricIngestedIndexedVolume' + ScalarFormulaRequest: + description: A single scalar query to be executed. + properties: + attributes: + $ref: '#/components/schemas/ScalarFormulaRequestAttributes' + type: + $ref: '#/components/schemas/ScalarFormulaRequestType' + required: + - type + - attributes + type: object + ScalarResponse: + description: A message containing the response to a scalar query. + properties: + attributes: + $ref: '#/components/schemas/ScalarFormulaResponseAtrributes' + type: + $ref: '#/components/schemas/ScalarFormulaResponseType' + type: object + TimeseriesFormulaRequest: + description: A single timeseries query to be executed. + properties: + attributes: + $ref: '#/components/schemas/TimeseriesFormulaRequestAttributes' + type: + $ref: '#/components/schemas/TimeseriesFormulaRequestType' + required: + - type + - attributes + type: object + TimeseriesResponse: + description: A message containing the response to a timeseries query. + properties: + attributes: + $ref: '#/components/schemas/TimeseriesResponseAttributes' + type: + $ref: '#/components/schemas/TimeseriesFormulaResponseType' + type: object + MetricSeries: + description: >- + A metric to submit to Datadog. + + See [Datadog + metrics](https://docs.datadoghq.com/developers/metrics/#custom-metrics-properties). + properties: + interval: + description: >- + If the type of the metric is rate or count, define the corresponding + interval in seconds. + example: 20 + format: int64 + type: integer + metadata: + $ref: '#/components/schemas/MetricMetadata' + metric: + description: The name of the timeseries. + example: system.load.1 + type: string + points: + description: >- + Points relating to a metric. All points must be objects with + timestamp and a scalar value (cannot be a string). Timestamps should + be in POSIX time in seconds, and cannot be more than ten minutes in + the future or more than one hour in the past. + example: + - timestamp: 1575317847 + value: 0.5 + items: + $ref: '#/components/schemas/MetricPoint' + type: array + resources: + description: A list of resources to associate with this metric. + items: + $ref: '#/components/schemas/MetricResource' + type: array + source_type_name: + description: The source type name. + example: datadog + type: string + tags: + description: A list of tags associated with the metric. + example: + - environment:test + items: + description: Individual tags. + type: string + type: array + type: + $ref: '#/components/schemas/MetricIntakeType' + unit: + description: The unit of point value. + example: second + type: string + required: + - metric + - points + type: object + SpansAggregateData: + description: The object containing the query content. + properties: + attributes: + $ref: '#/components/schemas/SpansAggregateRequestAttributes' + type: + $ref: '#/components/schemas/SpansAggregateRequestType' + type: object + SpansAggregateBucket: + description: Spans aggregate. + properties: + attributes: + $ref: '#/components/schemas/SpansAggregateBucketAttributes' + id: + description: ID of the spans aggregate. + type: string + type: + $ref: '#/components/schemas/SpansAggregateBucketType' + type: object + SpansAggregateResponseMetadata: + description: The metadata associated with a request. + properties: + elapsed: + description: The time elapsed in milliseconds. + example: 132 + format: int64 + type: integer + request_id: + description: The identifier of the request. + example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR + type: string + status: + $ref: '#/components/schemas/SpansAggregateResponseStatus' + warnings: + description: >- + A list of warnings (non fatal errors) encountered, partial results + might be returned if + + warnings are present in the response. + items: + $ref: '#/components/schemas/SpansWarning' + type: array + type: object + Span: + description: >- + Object description of a spans after being processed and stored by + Datadog. + properties: + attributes: + $ref: '#/components/schemas/SpansAttributes' + id: + description: Unique ID of the Span. + example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA + type: string + type: + $ref: '#/components/schemas/SpansType' + type: object + SpansListResponseLinks: + description: Links attributes. + properties: + next: + description: >- + Link for the next set of results. Note that the request can also be + made using the + + POST endpoint. + example: >- + https://app.datadoghq.com/api/v2/spans/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + SpansListResponseMetadata: + description: The metadata associated with a request. + properties: + elapsed: + description: The time elapsed in milliseconds. + example: 132 + format: int64 + type: integer + page: + $ref: '#/components/schemas/SpansResponseMetadataPage' + request_id: + description: The identifier of the request. + example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR + type: string + status: + $ref: '#/components/schemas/SpansAggregateResponseStatus' + warnings: + description: >- + A list of warnings (non fatal errors) encountered, partial results + might be returned if + + warnings are present in the response. + items: + $ref: '#/components/schemas/SpansWarning' + type: array + type: object + SpansListRequestData: + description: The object containing the query content. + properties: + attributes: + $ref: '#/components/schemas/SpansListRequestAttributes' + type: + $ref: '#/components/schemas/SpansListRequestType' + type: object + DatasetAttributesResponse: + description: Dataset metadata and configuration(s). + properties: + created_at: + description: Timestamp when the dataset was created. + format: date-time + nullable: true + type: string + created_by: + description: Unique ID of the user who created the dataset. + format: uuid + type: string + name: + description: Name of the dataset. + example: Security Audit Dataset + type: string + principals: + description: >- + List of access principals, formatted as `principal_type:id`. + Principal can be 'team' or 'role'. + example: + - role:86245fce-0a4e-11f0-92bd-da7ad0900002 + items: + example: role:86245fce-0a4e-11f0-92bd-da7ad0900002 + type: string + type: array + product_filters: + description: List of product-specific filters. + items: + $ref: '#/components/schemas/FiltersPerProduct' + type: array + type: object + DatasetType: + default: dataset + description: Resource type, always set to `dataset`. + enum: + - dataset + example: dataset + type: string + x-enum-varnames: + - DATASET + DatasetAttributesRequest: + description: Dataset metadata and configurations. + properties: + name: + description: Name of the dataset. + example: Security Audit Dataset + type: string + principals: + description: >- + List of access principals, formatted as `principal_type:id`. + Principal can be 'team' or 'role'. + example: + - role:94172442-be03-11e9-a77a-3b7612558ac1 + items: + example: role:94172442-be03-11e9-a77a-3b7612558ac1 + type: string + type: array + product_filters: + description: List of product-specific filters. + items: + $ref: '#/components/schemas/FiltersPerProduct' + type: array + required: + - name + - product_filters + - principals + type: object + Metric: + description: Object for a single metric tag configuration. + example: + id: metric.foo.bar + type: metrics + properties: + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricType' + type: object + MetricMetaPage: + description: >- + Paging attributes. Only present if pagination query parameters were + provided. + properties: + cursor: + description: The cursor used to get the current results, if any. + nullable: true + type: string + limit: + description: Number of results returned + format: int32 + maximum: 20000 + minimum: 0 + type: integer + next_cursor: + description: The cursor used to get the next results, if any. + nullable: true + type: string + type: + $ref: '#/components/schemas/MetricMetaPageType' + type: object + MetricBulkTagConfigDeleteAttributes: + description: Optional parameters for bulk deleting metric tag configurations. + properties: + emails: + $ref: '#/components/schemas/MetricBulkTagConfigEmailList' + type: object + MetricBulkTagConfigNamePrefix: + description: A text prefix to match against metric names. + example: kafka.lag + type: string + MetricBulkConfigureTagsType: + default: metric_bulk_configure_tags + description: The metric bulk configure tags resource. + enum: + - metric_bulk_configure_tags + example: metric_bulk_configure_tags + type: string + x-enum-varnames: + - BULK_MANAGE_TAGS + MetricBulkTagConfigStatusAttributes: + description: Optional attributes for the status of a bulk tag configuration request. + properties: + emails: + $ref: '#/components/schemas/MetricBulkTagConfigEmailList' + exclude_tags_mode: + description: >- + When set to true, the configuration will exclude the configured tags + and include any other submitted tags. + + When set to false, the configuration will include the configured + tags and exclude any other submitted tags. + type: boolean + status: + description: The status of the request. + example: Accepted + type: string + tags: + $ref: '#/components/schemas/MetricBulkTagConfigTagNameList' + type: object + MetricBulkTagConfigCreateAttributes: + description: Optional parameters for bulk creating metric tag configurations. + properties: + emails: + $ref: '#/components/schemas/MetricBulkTagConfigEmailList' + exclude_tags_mode: + description: >- + When set to true, the configuration will exclude the configured tags + and include any other submitted tags. + + When set to false, the configuration will include the configured + tags and exclude any other submitted tags. + + Defaults to false. + type: boolean + include_actively_queried_tags_window: + description: |- + When provided, all tags that have been actively queried are + configured (and, therefore, remain queryable) for each metric that + matches the given prefix. Minimum value is 1 second, and maximum + value is 7,776,000 seconds (90 days). + format: double + maximum: 7776000 + minimum: 1 + type: number + override_existing_configurations: + description: |- + When set to true, the configuration overrides any existing + configurations for the given metric with the new set of tags in this + configuration request. If false, old configurations are kept and + are merged with the set of tags in this configuration request. + Defaults to true. + type: boolean + tags: + $ref: '#/components/schemas/MetricBulkTagConfigTagNameList' + type: object + MetricSuggestedTagsAttributes: + description: >- + Object containing the definition of a metric's actively queried tags and + aggregations. + properties: + active_aggregations: + $ref: '#/components/schemas/MetricSuggestedAggregations' + active_tags: + description: List of tag keys that have been actively queried. + example: + - app + - datacenter + items: + description: Actively queried tag keys. + type: string + type: array + type: object + MetricName: + description: The metric name for this resource. + example: test.metric.latency + type: string + MetricActiveConfigurationType: + default: actively_queried_configurations + description: The metric actively queried configuration resource type. + enum: + - actively_queried_configurations + example: actively_queried_configurations + type: string + x-enum-varnames: + - ACTIVELY_QUERIED_CONFIGURATIONS + MetricAllTagsAttributes: + description: Object containing the definition of a metric's tags. + properties: + tags: + description: List of indexed tag value pairs. + example: + - sport:golf + - sport:football + - animal:dog + items: + description: Tag key-value pairs. + type: string + type: array + type: object + MetricType: + default: metrics + description: The metric resource type. + enum: + - metrics + example: metrics + type: string + x-enum-varnames: + - METRICS + MetricAssetResponseRelationships: + description: Relationships to assets related to the metric. + properties: + dashboards: + $ref: '#/components/schemas/MetricAssetDashboardRelationships' + monitors: + $ref: '#/components/schemas/MetricAssetMonitorRelationships' + notebooks: + $ref: '#/components/schemas/MetricAssetNotebookRelationships' + slos: + $ref: '#/components/schemas/MetricAssetSLORelationships' + type: object + MetricDashboardAsset: + description: A dashboard object with title and popularity. + properties: + attributes: + $ref: '#/components/schemas/MetricDashboardAttributes' + id: + $ref: '#/components/schemas/MetricDashboardID' + type: + $ref: '#/components/schemas/MetricDashboardType' + required: + - id + - type + type: object + MetricMonitorAsset: + description: A monitor object with title. + properties: + attributes: + $ref: '#/components/schemas/MetricAssetAttributes' + id: + $ref: '#/components/schemas/MetricMonitorID' + type: + $ref: '#/components/schemas/MetricMonitorType' + required: + - id + - type + type: object + MetricNotebookAsset: + description: A notebook object with title. + properties: + attributes: + $ref: '#/components/schemas/MetricAssetAttributes' + id: + $ref: '#/components/schemas/MetricNotebookID' + type: + $ref: '#/components/schemas/MetricNotebookType' + required: + - id + - type + type: object + MetricSLOAsset: + description: A SLO object with title. + properties: + attributes: + $ref: '#/components/schemas/MetricAssetAttributes' + id: + $ref: '#/components/schemas/MetricSLOID' + type: + $ref: '#/components/schemas/MetricSLOType' + required: + - id + - type + type: object + MetricEstimateAttributes: + description: Object containing the definition of a metric estimate attribute. + properties: + estimate_type: + $ref: '#/components/schemas/MetricEstimateType' + estimated_at: + description: Timestamp when the cardinality estimate was requested. + example: '2022-04-27T09:48:37.463835Z' + format: date-time + type: string + estimated_output_series: + description: >- + Estimated cardinality of the metric based on the queried + configuration. + example: 50 + format: int64 + type: integer + type: object + MetricEstimateResourceType: + default: metric_cardinality_estimate + description: The metric estimate resource type. + enum: + - metric_cardinality_estimate + example: metric_cardinality_estimate + type: string + x-enum-varnames: + - METRIC_CARDINALITY_ESTIMATE + MetricTagCardinality: + description: >- + Object containing metadata and attributes related to a specific tag key + associated with the metric. + example: + attributes: + cardinality_delta: 25 + id: http.request.latency + type: tag_cardinality + properties: + attributes: + $ref: '#/components/schemas/MetricTagCardinalityAttributes' + id: + description: The name of the tag key. + type: string + type: + default: tag_cardinality + description: This describes the endpoint action. + type: string + type: object + JSONAPIErrorItemSource: + description: References to the source of the error. + properties: + header: + description: >- + A string indicating the name of a single request header which caused + the error. + example: Authorization + type: string + parameter: + description: A string indicating which URI query parameter caused the error. + example: limit + type: string + pointer: + description: >- + A JSON pointer to the value in the request document that caused the + error. + example: /data/attributes/title + type: string + type: object + MetricTagConfigurationAttributes: + description: >- + Object containing the definition of a metric tag configuration + attributes. + properties: + aggregations: + $ref: '#/components/schemas/MetricCustomAggregations' + created_at: + description: Timestamp when the tag configuration was created. + example: '2020-03-25T09:48:37.463835Z' + format: date-time + type: string + exclude_tags_mode: + description: >- + When set to true, the configuration will exclude the configured tags + and include any other submitted tags. + + When set to false, the configuration will include the configured + tags and exclude any other submitted tags. + + Defaults to false. Requires `tags` property. + type: boolean + include_percentiles: + description: >- + Toggle to include or exclude percentile aggregations for + distribution metrics. + + Only present when the `metric_type` is `distribution`. example: true - in: query - name: 'filter[include_percentiles]' - required: false - schema: - type: boolean - - description: |- - Filter custom metrics that have or have not been queried in the specified window[seconds]. - If no window is provided or the window is less than 2 hours, a default of 2 hours will be applied. + type: boolean + metric_type: + $ref: '#/components/schemas/MetricTagConfigurationMetricTypes' + modified_at: + description: Timestamp when the tag configuration was last modified. + example: '2020-03-25T09:48:37.463835Z' + format: date-time + type: string + tags: + description: List of tag keys on which to group. + example: + - app + - datacenter + items: + description: Tag keys to group by. + type: string + type: array + type: object + MetricTagConfigurationType: + default: manage_tags + description: The metric tag configuration resource type. + enum: + - manage_tags + example: manage_tags + type: string + x-enum-varnames: + - MANAGE_TAGS + MetricTagConfigurationUpdateAttributes: + description: >- + Object containing the definition of a metric tag configuration to be + updated. + properties: + aggregations: + $ref: '#/components/schemas/MetricCustomAggregations' + exclude_tags_mode: + description: >- + When set to true, the configuration will exclude the configured tags + and include any other submitted tags. + + When set to false, the configuration will include the configured + tags and exclude any other submitted tags. + + Defaults to false. Requires `tags` property. + type: boolean + include_percentiles: + description: >- + Toggle to include/exclude percentiles for a distribution metric. + + Defaults to false. Can only be applied to metrics that have a + `metric_type` of `distribution`. example: true - in: query - name: 'filter[queried]' - required: false - schema: - type: boolean - - description: |- - Filter metrics that have been submitted with the given tags. Supports boolean and wildcard expressions. - Can only be combined with the filter[queried] filter. - example: 'env IN (staging,test) AND service:web' - in: query - name: 'filter[tags]' - required: false - schema: - type: string - - description: |- - The number of seconds of look back (from now) to apply to a filter[tag] or filter[queried] query. - Default value is 3600 (1 hour), maximum value is 2,592,000 (30 days). - example: 3600 - in: query - name: 'window[seconds]' - required: false - schema: - format: int64 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricsAndMetricTagConfigurationsResponse' - description: Success - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - metrics_read - summary: Get a list of metrics - tags: - - Metrics - /api/v2/metrics/config/bulk-tags: - delete: - description: |- - Delete all custom lists of queryable tag keys for a set of existing count, gauge, rate, and distribution metrics. - Metrics are selected by passing a metric name prefix. - Results can be sent to a set of account email addresses, just like the same operation in the Datadog web app. - Can only be used with application keys of users with the `Manage Tags for Metrics` permission. - operationId: DeleteBulkTagsMetricsConfiguration - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/MetricBulkTagConfigDeleteRequest' - required: true - responses: - '202': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricBulkTagConfigResponse' - description: Accepted - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - summary: Delete tags for multiple metrics - tags: - - Metrics - x-codegen-request-body-name: body - post: - description: |- - Create and define a list of queryable tag keys for a set of existing count, gauge, rate, and distribution metrics. - Metrics are selected by passing a metric name prefix. Use the Delete method of this API path to remove tag configurations. - Results can be sent to a set of account email addresses, just like the same operation in the Datadog web app. - If multiple calls include the same metric, the last configuration applied (not by submit order) is used, do not - expect deterministic ordering of concurrent calls. The `exclude_tags_mode` value will set all metrics that match the prefix to - the same exclusion state, metric tag configurations do not support mixed inclusion and exclusion for tags on the same metric. - Can only be used with application keys of users with the `Manage Tags for Metrics` permission. - operationId: CreateBulkTagsMetricsConfiguration - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/MetricBulkTagConfigCreateRequest' - required: true - responses: - '202': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricBulkTagConfigResponse' - description: Accepted - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - summary: Configure tags for multiple metrics - tags: - - Metrics - x-codegen-request-body-name: body - '/api/v2/metrics/{metric_name}/active-configurations': - get: - description: List tags and aggregations that are actively queried on dashboards and monitors for a given metric name. - operationId: ListActiveMetricConfigurations - parameters: - - $ref: '#/components/parameters/MetricName' - - description: |- - The number of seconds of look back (from now). - Default value is 604,800 (1 week), minimum value is 7200 (2 hours), maximum value is 2,630,000 (1 month). - example: 7200 - in: query - name: 'window[seconds]' - required: false - schema: - format: int64 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricSuggestedTagsAndAggregationsResponse' - description: Success - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - metrics_read - summary: List active tags and aggregations - tags: - - Metrics - '/api/v2/metrics/{metric_name}/all-tags': - get: - description: View indexed tag key-value pairs for a given metric name. - operationId: ListTagsByMetricName - parameters: - - $ref: '#/components/parameters/MetricName' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricAllTagsResponse' - description: Success - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - metrics_read - summary: List tags by metric name - tags: - - Metrics - '/api/v2/metrics/{metric_name}/estimate': - get: - description: 'Returns the estimated cardinality for a metric with a given tag, percentile and number of aggregations configuration using Metrics without Limits™.' - operationId: EstimateMetricsOutputSeries - parameters: - - $ref: '#/components/parameters/MetricName' - - description: Filtered tag keys that the metric is configured to query with. - example: 'app,host' - in: query - name: 'filter[groups]' - required: false - schema: + type: boolean + tags: + default: [] + description: A list of tag keys that will be queryable for your metric. + example: + - app + - datacenter + items: + description: Tag keys to group by. type: string - - description: The number of hours of look back (from now) to estimate cardinality with. - example: 49 - in: query - name: 'filter[hours_ago]' - required: false - schema: - format: int32 - maximum: 2147483647 - type: integer - - description: 'The number of aggregations that a `count`, `rate`, or `gauge` metric is configured to use. Max number of aggregation combos is 9.' - example: 1 - in: query - name: 'filter[num_aggregations]' - required: false - schema: - format: int32 - maximum: 9 - type: integer - - description: 'A boolean, for distribution metrics only, to estimate cardinality if the metric includes additional percentile aggregators.' + type: array + type: object + MetricTagConfigurationCreateAttributes: + description: >- + Object containing the definition of a metric tag configuration to be + created. + properties: + aggregations: + $ref: '#/components/schemas/MetricCustomAggregations' + exclude_tags_mode: + description: >- + When set to true, the configuration will exclude the configured tags + and include any other submitted tags. + + When set to false, the configuration will include the configured + tags and exclude any other submitted tags. + + Defaults to false. Requires `tags` property. + type: boolean + include_percentiles: + description: >- + Toggle to include/exclude percentiles for a distribution metric. + + Defaults to false. Can only be applied to metrics that have a + `metric_type` of `distribution`. + example: true + type: boolean + metric_type: + $ref: '#/components/schemas/MetricTagConfigurationMetricTypes' + tags: + default: [] + description: A list of tag keys that will be queryable for your metric. + example: + - app + - datacenter + items: + description: Tag keys to group by. + type: string + type: array + required: + - tags + - metric_type + type: object + MetricDistinctVolume: + description: Object for a single metric's distinct volume. + properties: + attributes: + $ref: '#/components/schemas/MetricDistinctVolumeAttributes' + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricDistinctVolumeType' + type: object + MetricIngestedIndexedVolume: + description: Object for a single metric's ingested and indexed volume. + properties: + attributes: + $ref: '#/components/schemas/MetricIngestedIndexedVolumeAttributes' + id: + $ref: '#/components/schemas/MetricName' + type: + $ref: '#/components/schemas/MetricIngestedIndexedVolumeType' + type: object + ScalarFormulaRequestAttributes: + description: The object describing a scalar formula request. + properties: + formulas: + description: List of formulas to be calculated and returned as responses. + items: + $ref: '#/components/schemas/QueryFormula' + type: array + from: + description: >- + Start date (inclusive) of the query in milliseconds since the Unix + epoch. + example: 1568899800000 + format: int64 + type: integer + queries: + $ref: '#/components/schemas/ScalarFormulaRequestQueries' + to: + description: >- + End date (exclusive) of the query in milliseconds since the Unix + epoch. + example: 1568923200000 + format: int64 + type: integer + required: + - to + - from + - queries + type: object + ScalarFormulaRequestType: + default: scalar_request + description: The type of the resource. The value should always be scalar_request. + enum: + - scalar_request + example: scalar_request + type: string + x-enum-varnames: + - SCALAR_REQUEST + ScalarFormulaResponseAtrributes: + description: The object describing a scalar response. + properties: + columns: + description: >- + List of response columns, each corresponding to an individual + formula or query in the request and with values in parallel arrays + matching the series list. + items: + $ref: '#/components/schemas/ScalarColumn' + type: array + type: object + ScalarFormulaResponseType: + default: scalar_response + description: The type of the resource. The value should always be scalar_response. + enum: + - scalar_response + example: scalar_response + type: string + x-enum-varnames: + - SCALAR_RESPONSE + TimeseriesFormulaRequestAttributes: + description: The object describing a timeseries formula request. + properties: + formulas: + description: List of formulas to be calculated and returned as responses. + items: + $ref: '#/components/schemas/QueryFormula' + type: array + from: + description: >- + Start date (inclusive) of the query in milliseconds since the Unix + epoch. + example: 1568899800000 + format: int64 + type: integer + interval: + description: |- + A time interval in milliseconds. + May be overridden by a larger interval if the query would result in + too many points for the specified timeframe. + Defaults to a reasonable interval for the given timeframe. + example: 5000 + format: int64 + type: integer + queries: + $ref: '#/components/schemas/TimeseriesFormulaRequestQueries' + to: + description: >- + End date (exclusive) of the query in milliseconds since the Unix + epoch. + example: 1568923200000 + format: int64 + type: integer + required: + - to + - from + - queries + type: object + TimeseriesFormulaRequestType: + default: timeseries_request + description: The type of the resource. The value should always be timeseries_request. + enum: + - timeseries_request + example: timeseries_request + type: string + x-enum-varnames: + - TIMESERIES_REQUEST + TimeseriesResponseAttributes: + description: The object describing a timeseries response. + properties: + series: + $ref: '#/components/schemas/TimeseriesResponseSeriesList' + times: + $ref: '#/components/schemas/TimeseriesResponseTimes' + values: + $ref: '#/components/schemas/TimeseriesResponseValuesList' + type: object + TimeseriesFormulaResponseType: + default: timeseries_response + description: >- + The type of the resource. The value should always be + timeseries_response. + enum: + - timeseries_response + example: timeseries_response + type: string + x-enum-varnames: + - TIMESERIES_RESPONSE + MetricMetadata: + description: Metadata for the metric. + properties: + origin: + $ref: '#/components/schemas/MetricOrigin' + type: object + MetricPoint: + description: A point object is of the form `{POSIX_timestamp, numeric_value}`. + example: + timestamp: 1575317847 + value: 0.5 + properties: + timestamp: + description: >- + The timestamp should be in seconds and current. + + Current is defined as not more than 10 minutes in the future or more + than 1 hour in the past. + format: int64 + type: integer + value: + description: The numeric value format should be a 64bit float gauge-type value. + format: double + type: number + type: object + MetricResource: + description: Metric resource. + example: + name: dummyhost + type: host + properties: + name: + description: The name of the resource. + type: string + type: + description: The type of the resource. + type: string + type: object + MetricIntakeType: + description: >- + The type of metric. The available types are `0` (unspecified), `1` + (count), `2` (rate), and `3` (gauge). + enum: + - 0 + - 1 + - 2 + - 3 + format: int32 + type: integer + x-enum-varnames: + - UNSPECIFIED + - COUNT + - RATE + - GAUGE + SpansAggregateRequestAttributes: + description: The object containing all the query parameters. + properties: + compute: + description: >- + The list of metrics or timeseries to compute for the retrieved + buckets. + items: + $ref: '#/components/schemas/SpansCompute' + type: array + filter: + $ref: '#/components/schemas/SpansQueryFilter' + group_by: + description: The rules for the group by. + items: + $ref: '#/components/schemas/SpansGroupBy' + type: array + options: + $ref: '#/components/schemas/SpansQueryOptions' + type: object + SpansAggregateRequestType: + default: aggregate_request + description: The type of resource. The value should always be aggregate_request. + enum: + - aggregate_request + example: aggregate_request + type: string + x-enum-varnames: + - AGGREGATE_REQUEST + SpansAggregateBucketAttributes: + description: A bucket values. + properties: + by: + additionalProperties: + description: The values for each group by. + description: The key, value pairs for each group by. + example: + '@state': success + '@version': abc + type: object + compute: + description: The compute data. + type: object + computes: + additionalProperties: + $ref: '#/components/schemas/SpansAggregateBucketValue' + description: >- + A map of the metric name -> value for regular compute or list of + values for a timeseries. + type: object + type: object + SpansAggregateBucketType: + description: The spans aggregate bucket type. + enum: + - bucket + example: bucket + type: string + x-enum-varnames: + - BUCKET + SpansAggregateResponseStatus: + description: The status of the response. + enum: + - done + - timeout + example: done + type: string + x-enum-varnames: + - DONE + - TIMEOUT + SpansWarning: + description: A warning message indicating something that went wrong with the query. + properties: + code: + description: A unique code for this type of warning. + example: unknown_index + type: string + detail: + description: A detailed explanation of this specific warning. + example: 'indexes: foo, bar' + type: string + title: + description: A short human-readable summary of the warning. + example: >- + One or several indexes are missing or invalid, results hold data + from the other indexes + type: string + type: object + SpansAttributes: + description: JSON object containing all span attributes and their associated values. + properties: + attributes: + additionalProperties: {} + description: JSON object of attributes from your span. + example: + customAttribute: 123 + duration: 2345 + type: object + custom: + additionalProperties: {} + description: JSON object of custom spans data. + type: object + end_timestamp: + description: End timestamp of your span. + example: '2023-01-02T09:42:36.420Z' + format: date-time + type: string + env: + description: Name of the environment from where the spans are being sent. + example: prod + type: string + host: + description: Name of the machine from where the spans are being sent. + example: i-0123 + type: string + ingestion_reason: + description: The reason why the span was ingested. + example: rule + type: string + parent_id: + description: Id of the span that's parent of this span. + example: '0' + type: string + resource_hash: + description: Unique identifier of the resource. + example: a12345678b91c23d + type: string + resource_name: + description: The name of the resource. + example: agent + type: string + retained_by: + description: The reason why the span was indexed. + example: retention_filter + type: string + service: + description: >- + The name of the application or service generating the span events. + + It is used to switch from APM to Logs, so make sure you define the + same + + value when you use both products. + example: agent + type: string + single_span: + description: >- + Whether or not the span was collected as a stand-alone span. Always + associated to "single_span" ingestion_reason if true. example: true - in: query - name: 'filter[pct]' - required: false - schema: - type: boolean - - description: 'A window, in hours, from the look back to estimate cardinality with.' - example: 6 - in: query - name: 'filter[timespan_h]' - required: false - schema: - format: int32 - maximum: 2147483647 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricEstimateResponse' - description: Success - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Tag Configuration Cardinality Estimator - tags: - - Metrics - x-dd-ownership: - notification_configuration: - manual_escalation_policy: '[Points Aggregation] Primary' - prod_high_urgency: '@pagerduty-Points-Aggregation @slack-points-aggr-ops' - prod_low_urgency: '@slack-points-aggr-ops' - slack_support_channel: '#points-aggregation' - staging_high_urgency: '@slack-points-aggr-stg-ops' - staging_low_urgency: '@slack-points-aggr-stg-ops' - team: points-aggregation - team_escalation: '[Points Aggregation] Primary' - x-permission: - operator: OPEN - permissions: [] - '/api/v2/metrics/{metric_name}/tags': - delete: - description: |- - Deletes a metric's tag configuration. Can only be used with application - keys from users with the `Manage Tags for Metrics` permission. - operationId: DeleteTagConfiguration - parameters: - - $ref: '#/components/parameters/MetricName' - responses: - '204': - description: No Content - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - summary: Delete a tag configuration - tags: - - Metrics - get: - description: Returns the tag configuration for the given metric name. - operationId: ListTagConfigurationByName - parameters: - - $ref: '#/components/parameters/MetricName' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricTagConfigurationResponse' - description: Success - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - metrics_read - summary: List tag configuration by name - tags: - - Metrics - patch: - description: |- - Update the tag configuration of a metric or percentile aggregations of a distribution metric or custom aggregations - of a count, rate, or gauge metric. By setting `exclude_tags_mode` to true the behavior is changed - from an allow-list to a deny-list, and tags in the defined list will not be queryable. - Can only be used with application keys from users with the `Manage Tags for Metrics` permission. This endpoint requires - a tag configuration to be created first. - operationId: UpdateTagConfiguration - parameters: - - $ref: '#/components/parameters/MetricName' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/MetricTagConfigurationUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricTagConfigurationResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unprocessable Entity - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - summary: Update a tag configuration - tags: - - Metrics - x-codegen-request-body-name: body - post: - description: |- - Create and define a list of queryable tag keys for an existing count/gauge/rate/distribution metric. - Optionally, include percentile aggregations on any distribution metric or configure custom aggregations - on any count, rate, or gauge metric. By setting `exclude_tags_mode` to true the behavior is changed - from an allow-list to a deny-list, and tags in the defined list will not be queryable. - Can only be used with application keys of users with the `Manage Tags for Metrics` permission. - operationId: CreateTagConfiguration - parameters: - - $ref: '#/components/parameters/MetricName' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/MetricTagConfigurationCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricTagConfigurationResponse' - description: Created - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '409': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - summary: Create a tag configuration - tags: - - Metrics - x-codegen-request-body-name: body - '/api/v2/metrics/{metric_name}/volumes': - get: - description: |- - View distinct metrics volumes for the given metric name. + type: boolean + span_id: + description: Id of the span. + example: '1234567890987654321' + type: string + start_timestamp: + description: Start timestamp of your span. + example: '2023-01-02T09:42:36.320Z' + format: date-time + type: string + tags: + description: Array of tags associated with your span. + example: + - team:A + items: + description: Tag associated with your span. + type: string + type: array + trace_id: + description: Id of the trace to which the span belongs. + example: '1234567890987654321' + type: string + type: + description: The type of the span. + example: web + type: string + type: object + SpansType: + default: spans + description: Type of the span. + enum: + - spans + example: spans + type: string + x-enum-varnames: + - SPANS + SpansResponseMetadataPage: + description: Paging attributes. + properties: + after: + description: >- + The cursor to use to get the next results, if any. To make the next + request, use the same + + parameters with the addition of the `page[cursor]`. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + SpansListRequestAttributes: + description: The object containing all the query parameters. + properties: + filter: + $ref: '#/components/schemas/SpansQueryFilter' + options: + $ref: '#/components/schemas/SpansQueryOptions' + page: + $ref: '#/components/schemas/SpansListRequestPage' + sort: + $ref: '#/components/schemas/SpansSort' + type: object + SpansListRequestType: + default: search_request + description: The type of resource. The value should always be search_request. + enum: + - search_request + example: search_request + type: string + x-enum-varnames: + - SEARCH_REQUEST + FiltersPerProduct: + description: Product-specific filters for the dataset. + properties: + filters: + description: >- + Defines the list of tag-based filters used to restrict access to + telemetry data for a specific product. + + These filters act as access control rules. Each filter must follow + the tag query syntax used by + + Datadog (such as `@tag.key:value`), and only one tag or attribute + may be used to define the access strategy + + per telemetry type. + example: + - '@application.id:ABCD' + items: + example: '@application.id:ABCD' + type: string + type: array + product: + description: >- + Name of the product the dataset is for. Possible values are 'apm', + 'rum', + + 'metrics', 'logs', 'error_tracking', and 'cloud_cost'. + example: logs + type: string + required: + - product + - filters + type: object + MetricMetaPageType: + default: cursor_limit + description: Type of metric pagination. + enum: + - cursor_limit + example: cursor_limit + type: string + x-enum-varnames: + - CURSOR_LIMIT + MetricBulkTagConfigEmailList: + description: A list of account emails to notify when the configuration is applied. + example: + - sue@example.com + - bob@example.com + items: + description: An email address. + type: string + type: array + MetricBulkTagConfigTagNameList: + description: A list of tag names to apply to the configuration. + example: + - host + - pod_name + - is_shadow + items: + description: A metric tag name. + maxLength: 200 + pattern: ^[A-Za-z][A-Za-z0-9\.\-\_:\/]*$ + type: string + type: array + MetricSuggestedAggregations: + description: List of aggregation combinations that have been actively queried. + example: + - space: sum + time: sum + - space: sum + time: count + items: + $ref: '#/components/schemas/MetricCustomAggregation' + type: array + MetricAssetDashboardRelationships: + description: >- + An object containing the list of dashboards that can be referenced in + the `included` data. + properties: + data: + description: A list of dashboards that can be referenced in the `included` data. + items: + $ref: '#/components/schemas/MetricAssetDashboardRelationship' + type: array + type: object + MetricAssetMonitorRelationships: + description: >- + A object containing the list of monitors that can be referenced in the + `included` data. + properties: + data: + description: A list of monitors that can be referenced in the `included` data. + items: + $ref: '#/components/schemas/MetricAssetMonitorRelationship' + type: array + type: object + MetricAssetNotebookRelationships: + description: >- + An object containing the list of notebooks that can be referenced in the + `included` data. + properties: + data: + description: A list of notebooks that can be referenced in the `included` data. + items: + $ref: '#/components/schemas/MetricAssetNotebookRelationship' + type: array + type: object + MetricAssetSLORelationships: + description: >- + An object containing a list of SLOs that can be referenced in the + `included` data. + properties: + data: + description: A list of SLOs that can be referenced in the `included` data. + items: + $ref: '#/components/schemas/MetricAssetSLORelationship' + type: array + type: object + MetricDashboardAttributes: + description: >- + Attributes related to the dashboard, including title, popularity, and + url. + properties: + popularity: + description: Value from 0 to 5 that ranks popularity of the dashboard. + format: double + maximum: 5 + minimum: 0 + type: number + tags: + description: List of tag keys used in the asset. + example: + - env + - service + - host + - datacenter + items: + description: Tag key used in assets. + type: string + type: array + title: + description: Title of the asset. + type: string + url: + description: URL path of the asset. + type: string + type: object + MetricDashboardID: + description: The related dashboard's ID. + example: xxx-yyy-zzz + type: string + MetricDashboardType: + description: Dashboard resource type. + enum: + - dashboards + example: dashboards + type: string + x-enum-varnames: + - DASHBOARDS + MetricAssetAttributes: + description: Assets related to the object, including title, url, and tags. + properties: + tags: + description: List of tag keys used in the asset. + example: + - env + - service + - host + - datacenter + items: + description: Tag key used in assets. + type: string + type: array + title: + description: Title of the asset. + type: string + url: + description: URL path of the asset. + type: string + type: object + MetricMonitorID: + description: The related monitor's ID. + example: '1775073' + type: string + MetricMonitorType: + description: Monitor resource type. + enum: + - monitors + example: monitors + type: string + x-enum-varnames: + - MONITORS + MetricNotebookID: + description: The related notebook's ID. + example: '12345' + type: string + MetricNotebookType: + description: Notebook resource type. + enum: + - notebooks + example: notebooks + type: string + x-enum-varnames: + - NOTEBOOKS + MetricSLOID: + description: The SLO ID. + example: 9ffef113b389520db54391d67d652dfb + type: string + MetricSLOType: + description: SLO resource type. + enum: + - slos + example: slos + type: string + x-enum-varnames: + - SLOS + MetricEstimateType: + default: count_or_gauge + description: >- + Estimate type based on the queried configuration. By default, + `count_or_gauge` is returned. `distribution` is returned for + distribution metrics without percentiles enabled. Lastly, `percentile` + is returned if `filter[pct]=true` is queried with a distribution metric. + enum: + - count_or_gauge + - distribution + - percentile + example: distribution + type: string + x-enum-varnames: + - COUNT_OR_GAUGE + - DISTRIBUTION + - PERCENTILE + MetricTagCardinalityAttributes: + description: An object containing properties related to the tag key + properties: + cardinality_delta: + description: This describes the recent change in the tag keys cardinality + format: int64 + type: integer + type: object + MetricCustomAggregations: + description: >- + Deprecated. You no longer need to configure specific time and space + aggregations for Metrics Without Limits. + example: + - space: sum + time: sum + - space: sum + time: count + items: + $ref: '#/components/schemas/MetricCustomAggregation' + type: array + MetricTagConfigurationMetricTypes: + default: gauge + description: The metric's type. + enum: + - gauge + - count + - rate + - distribution + example: count + type: string + x-enum-varnames: + - GAUGE + - COUNT + - RATE + - DISTRIBUTION + MetricDistinctVolumeAttributes: + description: Object containing the definition of a metric's distinct volume. + properties: + distinct_volume: + description: Distinct volume for the given metric. + example: 10 + format: int64 + type: integer + type: object + MetricDistinctVolumeType: + default: distinct_metric_volumes + description: The metric distinct volume type. + enum: + - distinct_metric_volumes + example: distinct_metric_volumes + type: string + x-enum-varnames: + - DISTINCT_METRIC_VOLUMES + MetricIngestedIndexedVolumeAttributes: + description: >- + Object containing the definition of a metric's ingested and indexed + volume. + properties: + indexed_volume: + description: Indexed volume for the given metric. + example: 10 + format: int64 + type: integer + ingested_volume: + description: Ingested volume for the given metric. + example: 20 + format: int64 + type: integer + type: object + MetricIngestedIndexedVolumeType: + default: metric_volumes + description: The metric ingested and indexed volume type. + enum: + - metric_volumes + example: metric_volumes + type: string + x-enum-varnames: + - METRIC_VOLUMES + QueryFormula: + description: A formula for calculation based on one or more queries. + properties: + formula: + description: >- + Formula string, referencing one or more queries with their name + property. + example: a+b + type: string + limit: + $ref: '#/components/schemas/FormulaLimit' + required: + - formula + type: object + ScalarFormulaRequestQueries: + description: List of queries to be run and used as inputs to the formulas. + example: + - aggregator: avg + data_source: metrics + query: avg:system.cpu.user{*} by {env} + items: + $ref: '#/components/schemas/ScalarQuery' + type: array + ScalarColumn: + description: A single column in a scalar query response. + oneOf: + - $ref: '#/components/schemas/GroupScalarColumn' + - $ref: '#/components/schemas/DataScalarColumn' + TimeseriesFormulaRequestQueries: + description: List of queries to be run and used as inputs to the formulas. + example: + - data_source: metrics + query: avg:system.cpu.user{*} by {env} + items: + $ref: '#/components/schemas/TimeseriesQuery' + type: array + TimeseriesResponseSeriesList: + description: >- + Array of response series. The index here corresponds to the index in the + `formulas` or `queries` array from the request. + items: + $ref: '#/components/schemas/TimeseriesResponseSeries' + type: array + TimeseriesResponseTimes: + description: Array of times, 1-1 match with individual values arrays. + items: + description: Start date (inclusive) of the query in seconds since the Unix epoch. + example: 1568899800000 + format: int64 + type: integer + type: array + TimeseriesResponseValuesList: + description: >- + Array of value-arrays. The index here corresponds to the index in the + `formulas` or `queries` array from the request. + items: + $ref: '#/components/schemas/TimeseriesResponseValues' + type: array + MetricOrigin: + description: Metric origin information. + properties: + metric_type: + default: 0 + description: The origin metric type code + format: int32 + maximum: 1000 + type: integer + product: + default: 0 + description: The origin product code + format: int32 + maximum: 1000 + type: integer + service: + default: 0 + description: The origin service code + format: int32 + maximum: 1000 + type: integer + type: object + SpansCompute: + description: A compute rule to compute metrics or timeseries. + properties: + aggregation: + $ref: '#/components/schemas/SpansAggregationFunction' + interval: + description: |- + The time buckets' size (only used for type=timeseries) + Defaults to a resolution of 150 points. + example: 5m + type: string + metric: + description: The metric to use. + example: '@duration' + type: string + type: + $ref: '#/components/schemas/SpansComputeType' + required: + - aggregation + type: object + SpansQueryFilter: + description: The search and filter query settings. + properties: + from: + default: now-15m + description: >- + The minimum time for the requested spans, supports date-time + ISO8601, date math, and regular timestamps (milliseconds). + example: now-15m + type: string + query: + default: '*' + description: The search query - following the span search syntax. + example: service:web* AND @http.status_code:[200 TO 299] + type: string + to: + default: now + description: >- + The maximum time for the requested spans, supports date-time + ISO8601, date math, and regular timestamps (milliseconds). + example: now + type: string + type: object + SpansGroupBy: + description: A group by rule. + properties: + facet: + description: The name of the facet to use (required). + example: host + type: string + histogram: + $ref: '#/components/schemas/SpansGroupByHistogram' + limit: + default: 10 + description: The maximum buckets to return for this group by. + format: int64 + type: integer + missing: + $ref: '#/components/schemas/SpansGroupByMissing' + sort: + $ref: '#/components/schemas/SpansAggregateSort' + total: + $ref: '#/components/schemas/SpansGroupByTotal' + required: + - facet + type: object + SpansQueryOptions: + description: >- + Global query options that are used during the query. + + Note: You should only supply timezone or time offset but not both + otherwise the query will fail. + properties: + timeOffset: + description: The time offset (in seconds) to apply to the query. + format: int64 + type: integer + timezone: + default: UTC + description: >- + The timezone can be specified as GMT, UTC, an offset from UTC (like + UTC+1), or as a Timezone Database identifier (like + America/New_York). + example: GMT + type: string + type: object + SpansAggregateBucketValue: + description: A bucket value, can be either a timeseries or a single value. + oneOf: + - $ref: '#/components/schemas/SpansAggregateBucketValueSingleString' + - $ref: '#/components/schemas/SpansAggregateBucketValueSingleNumber' + - $ref: '#/components/schemas/SpansAggregateBucketValueTimeseries' + SpansListRequestPage: + description: Paging attributes for listing spans. + properties: + cursor: + description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + limit: + default: 10 + description: Maximum number of spans in the response. + example: 25 + format: int32 + maximum: 1000 + type: integer + type: object + MetricCustomAggregation: + description: A time and space aggregation combination for use in query. + example: + space: sum + time: sum + properties: + space: + $ref: '#/components/schemas/MetricCustomSpaceAggregation' + time: + $ref: '#/components/schemas/MetricCustomTimeAggregation' + required: + - time + - space + type: object + MetricAssetDashboardRelationship: + description: >- + An object of type `dashboard` that can be referenced in the `included` + data. + properties: + id: + $ref: '#/components/schemas/MetricDashboardID' + type: + $ref: '#/components/schemas/MetricDashboardType' + type: object + MetricAssetMonitorRelationship: + description: >- + An object of type `monitor` that can be referenced in the `included` + data. + properties: + id: + $ref: '#/components/schemas/MetricMonitorID' + type: + $ref: '#/components/schemas/MetricMonitorType' + type: object + MetricAssetNotebookRelationship: + description: >- + An object of type `notebook` that can be referenced in the `included` + data. + properties: + id: + $ref: '#/components/schemas/MetricNotebookID' + type: + $ref: '#/components/schemas/MetricNotebookType' + type: object + MetricAssetSLORelationship: + description: An object of type `slos` that can be referenced in the `included` data. + properties: + id: + $ref: '#/components/schemas/MetricSLOID' + type: + $ref: '#/components/schemas/MetricSLOType' + type: object + FormulaLimit: + description: >- + Message for specifying limits to the number of values returned by a + query. + + This limit is only for scalar queries and has no effect on timeseries + queries. + properties: + count: + description: The number of results to which to limit. + example: 10 + format: int32 + maximum: 2147483647 + type: integer + order: + $ref: '#/components/schemas/QuerySortOrder' + type: object + ScalarQuery: + description: An individual scalar query to one of the basic Datadog data sources. + example: + aggregator: avg + data_source: metrics + query: avg:system.cpu.user{*} by {env} + oneOf: + - $ref: '#/components/schemas/MetricsScalarQuery' + - $ref: '#/components/schemas/EventsScalarQuery' + GroupScalarColumn: + description: A column containing the tag keys and values in a group. + properties: + name: + description: The name of the tag key or group. + example: env + type: string + type: + $ref: '#/components/schemas/ScalarColumnTypeGroup' + values: + description: >- + The array of tag values for each group found for the results of the + formulas or queries. + example: + - - production + - - staging + items: + description: An individual tag value for a given group column. + items: + description: One tag value within a values array. + example: production + type: string + type: array + type: array + type: object + DataScalarColumn: + description: A column containing the numerical results for a formula or query. + properties: + meta: + $ref: '#/components/schemas/ScalarMeta' + name: + description: The name referencing the formula or query for this column. + example: a + type: string + type: + $ref: '#/components/schemas/ScalarColumnTypeNumber' + values: + description: The array of numerical values for one formula or query. + example: + - 0.5 + items: + description: An individual value for a given column and group-by. + example: 0.5 + format: double + nullable: true + type: number + type: array + type: object + TimeseriesQuery: + description: An individual timeseries query to one of the basic Datadog data sources. + example: + data_source: metrics + query: avg:system.cpu.user{*} by {env} + oneOf: + - $ref: '#/components/schemas/MetricsTimeseriesQuery' + - $ref: '#/components/schemas/EventsTimeseriesQuery' + TimeseriesResponseSeries: + description: '' + properties: + group_tags: + $ref: '#/components/schemas/GroupTags' + query_index: + description: >- + The index of the query in the "formulas" array (or "queries" array + if no "formulas" was specified). + example: 0 + format: int32 + maximum: 2147483647 + type: integer + unit: + description: >- + Detailed information about the unit. + + The first element describes the "primary unit" (for example, `bytes` + in `bytes per second`). + + The second element describes the "per unit" (for example, `second` + in `bytes per second`). + + If the second element is not present, the API returns null. + items: + $ref: '#/components/schemas/Unit' + nullable: true + type: array + type: object + TimeseriesResponseValues: + description: Array of values for an individual formula or query. + example: + - 1575317847 + - 0.5 + items: + description: An individual value for a given time. + format: double + nullable: true + type: number + type: array + SpansAggregationFunction: + description: An aggregation function. + enum: + - count + - cardinality + - pc75 + - pc90 + - pc95 + - pc98 + - pc99 + - sum + - min + - max + - avg + - median + example: pc90 + type: string + x-enum-varnames: + - COUNT + - CARDINALITY + - PERCENTILE_75 + - PERCENTILE_90 + - PERCENTILE_95 + - PERCENTILE_98 + - PERCENTILE_99 + - SUM + - MIN + - MAX + - AVG + - MEDIAN + SpansComputeType: + default: total + description: The type of compute. + enum: + - timeseries + - total + type: string + x-enum-varnames: + - TIMESERIES + - TOTAL + SpansGroupByHistogram: + description: >- + Used to perform a histogram computation (only for measure facets). + + Note: At most 100 buckets are allowed, the number of buckets is (max - + min)/interval. + properties: + interval: + description: The bin size of the histogram buckets. + example: 10 + format: double + type: number + max: + description: |- + The maximum value for the measure used in the histogram + (values greater than this one are filtered out). + example: 100 + format: double + type: number + min: + description: |- + The minimum value for the measure used in the histogram + (values smaller than this one are filtered out). + example: 50 + format: double + type: number + required: + - interval + - min + - max + type: object + SpansGroupByMissing: + description: The value to use for spans that don't have the facet used to group by. + oneOf: + - $ref: '#/components/schemas/SpansGroupByMissingString' + - $ref: '#/components/schemas/SpansGroupByMissingNumber' + SpansAggregateSort: + description: A sort rule. + example: + aggregation: count + order: asc + properties: + aggregation: + $ref: '#/components/schemas/SpansAggregationFunction' + metric: + description: The metric to sort by (only used for `type=measure`). + example: '@duration' + type: string + order: + $ref: '#/components/schemas/SpansSortOrder' + type: + $ref: '#/components/schemas/SpansAggregateSortType' + type: object + SpansGroupByTotal: + default: false + description: >- + A resulting object to put the given computes in over all the matching + records. + oneOf: + - $ref: '#/components/schemas/SpansGroupByTotalBoolean' + - $ref: '#/components/schemas/SpansGroupByTotalString' + - $ref: '#/components/schemas/SpansGroupByTotalNumber' + SpansAggregateBucketValueSingleString: + description: A single string value. + type: string + SpansAggregateBucketValueSingleNumber: + description: A single number value. + format: double + type: number + SpansAggregateBucketValueTimeseries: + description: A timeseries array. + items: + $ref: '#/components/schemas/SpansAggregateBucketValueTimeseriesPoint' + type: array + x-generate-alias-as-model: true + MetricCustomSpaceAggregation: + description: A space aggregation for use in query. + enum: + - avg + - max + - min + - sum + example: sum + type: string + x-enum-varnames: + - AVG + - MAX + - MIN + - SUM + MetricCustomTimeAggregation: + description: A time aggregation for use in query. + enum: + - avg + - count + - max + - min + - sum + example: sum + type: string + x-enum-varnames: + - AVG + - COUNT + - MAX + - MIN + - SUM + QuerySortOrder: + default: desc + description: Direction of sort. + enum: + - asc + - desc + type: string + x-enum-varnames: + - ASC + - DESC + MetricsScalarQuery: + description: An individual scalar metrics query. + properties: + aggregator: + $ref: '#/components/schemas/MetricsAggregator' + data_source: + $ref: '#/components/schemas/MetricsDataSource' + name: + description: The variable name for use in formulas. + type: string + query: + description: A classic metrics query string. + example: avg:system.cpu.user{*} by {env} + type: string + required: + - data_source + - query + - aggregator + type: object + EventsScalarQuery: + description: An individual scalar events query. + properties: + compute: + $ref: '#/components/schemas/EventsCompute' + data_source: + $ref: '#/components/schemas/EventsDataSource' + group_by: + $ref: '#/components/schemas/EventsQueryGroupBys' + indexes: + description: The indexes in which to search. + example: + - main + items: + description: The unique index name. + example: main + type: string + type: array + name: + description: The variable name for use in formulas. + type: string + search: + $ref: '#/components/schemas/EventsSearch' + required: + - data_source + - compute + type: object + ScalarColumnTypeGroup: + default: group + description: The type of column present for groups. + enum: + - group + example: group + type: string + x-enum-varnames: + - GROUP + ScalarMeta: + description: Metadata for the resulting numerical values. + properties: + unit: + description: >- + Detailed information about the unit. - Custom metrics generated in-app from other products will return `null` for ingested volumes. - operationId: ListVolumesByMetricName - parameters: - - $ref: '#/components/parameters/MetricName' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MetricVolumesResponse' - description: Success - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too Many Requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: List distinct metric volumes by metric name - tags: - - Metrics - /api/v2/query/scalar: - post: - description: |- - Query scalar values (as seen on Query Value, Table, and Toplist widgets). - Multiple data sources are supported with the ability to - process the data using formulas and functions. - operationId: QueryScalarData - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ScalarFormulaQueryRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ScalarFormulaQueryResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - timeseries_query - summary: Query scalar data across multiple products - tags: - - Metrics - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is GA for Metrics, Real User Monitoring (RUM), and Cloud Cost Management data sources. - Support for logs is in beta. We are gradually onboarding support for more sources. If you have any - feedback, contact [Datadog Support](https://docs.datadoghq.com/help/). - /api/v2/query/timeseries: - post: - description: |- - Query timeseries data across various data sources and - process the data by applying formulas and functions. - operationId: QueryTimeseriesData - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TimeseriesFormulaQueryRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TimeseriesFormulaQueryResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/UnauthorizedResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - timeseries_query - summary: Query timeseries data across multiple products - tags: - - Metrics - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is GA for Metrics, Real User Monitoring (RUM), and Cloud Cost Management data sources. - Support for logs is in beta. We are gradually onboarding support for more sources. If you have any - feedback, contact [Datadog Support](https://docs.datadoghq.com/help/). - /api/v2/series: - post: - description: |- - The metrics end-point allows you to post time-series data that can be graphed on Datadog’s dashboards. - The maximum payload size is 500 kilobytes (512000 bytes). Compressed payloads must have a decompressed size of less than 5 megabytes (5242880 bytes). + First element describes the "primary unit" (for example, `bytes` in + `bytes per second`). - If you’re submitting metrics directly to the Datadog API without using DogStatsD, expect: + The second element describes the "per unit" (for example, `second` + in `bytes per second`). - - 64 bits for the timestamp - - 64 bits for the value - - 20 bytes for the metric names - - 50 bytes for the timeseries - - The full payload is approximately 100 bytes. + If the second element is not present, the API returns null. + items: + $ref: '#/components/schemas/Unit' + nullable: true + type: array + type: object + ScalarColumnTypeNumber: + default: number + description: The type of column present for numbers. + enum: + - number + example: number + type: string + x-enum-varnames: + - NUMBER + MetricsTimeseriesQuery: + description: An individual timeseries metrics query. + properties: + data_source: + $ref: '#/components/schemas/MetricsDataSource' + name: + description: The variable name for use in formulas. + type: string + query: + description: A classic metrics query string. + example: avg:system.cpu.user{*} by {env} + type: string + required: + - data_source + - query + type: object + EventsTimeseriesQuery: + description: An individual timeseries events query. + properties: + compute: + $ref: '#/components/schemas/EventsCompute' + data_source: + $ref: '#/components/schemas/EventsDataSource' + group_by: + $ref: '#/components/schemas/EventsQueryGroupBys' + indexes: + description: The indexes in which to search. + example: + - main + items: + description: The unique index name. + example: main + type: string + type: array + name: + description: The variable name for use in formulas. + type: string + search: + $ref: '#/components/schemas/EventsSearch' + required: + - data_source + - compute + type: object + GroupTags: + description: List of tags that apply to a single response value. + items: + description: A single tag that applies to a single response value. + example: env:production + type: string + type: array + Unit: + description: >- + Object containing the metric unit family, scale factor, name, and short + name. + nullable: true + properties: + family: + description: >- + Unit family, allows for conversion between units of the same family, + for scaling. + example: time + type: string + name: + description: Unit name + example: minute + type: string + plural: + description: Plural form of the unit name. + example: minutes + type: string + scale_factor: + description: Factor for scaling between units of the same family. + example: 60 + format: double + type: number + short_name: + description: Abbreviation of the unit. + example: min + type: string + type: object + SpansGroupByMissingString: + description: The missing value to use if there is string valued facet. + type: string + SpansGroupByMissingNumber: + description: The missing value to use if there is a number valued facet. + format: double + type: number + SpansSortOrder: + description: The order to use, ascending or descending. + enum: + - asc + - desc + example: asc + type: string + x-enum-varnames: + - ASCENDING + - DESCENDING + SpansAggregateSortType: + default: alphabetical + description: The type of sorting algorithm. + enum: + - alphabetical + - measure + type: string + x-enum-varnames: + - ALPHABETICAL + - MEASURE + SpansGroupByTotalBoolean: + description: If set to true, creates an additional bucket labeled "$facet_total". + type: boolean + SpansGroupByTotalString: + description: A string to use as the key value for the total bucket. + type: string + SpansGroupByTotalNumber: + description: A number to use as the key value for the total bucket. + format: double + type: number + SpansAggregateBucketValueTimeseriesPoint: + description: A timeseries point. + properties: + time: + description: The time value for this point. + example: '2023-06-08T11:55:00Z' + type: string + value: + description: The value for this point. + example: 19 + format: double + type: number + type: object + MetricsAggregator: + default: avg + description: The type of aggregation that can be performed on metrics-based queries. + enum: + - avg + - min + - max + - sum + - last + - percentile + - mean + - l2norm + - area + example: avg + type: string + x-enum-varnames: + - AVG + - MIN + - MAX + - SUM + - LAST + - PERCENTILE + - MEAN + - L2NORM + - AREA + MetricsDataSource: + default: metrics + description: A data source that is powered by the Metrics platform. + enum: + - metrics + - cloud_cost + example: metrics + type: string + x-enum-varnames: + - METRICS + - CLOUD_COST + EventsCompute: + description: The instructions for what to compute for this query. + properties: + aggregation: + $ref: '#/components/schemas/EventsAggregation' + interval: + description: Interval for compute in milliseconds. + example: 60000 + format: int64 + type: integer + metric: + description: The "measure" attribute on which to perform the computation. + type: string + required: + - aggregation + type: object + EventsDataSource: + default: logs + description: A data source that is powered by the Events Platform. + enum: + - logs + - rum + - dora + example: logs + type: string + x-enum-varnames: + - LOGS + - RUM + - DORA + EventsQueryGroupBys: + description: The list of facets on which to split results. + items: + $ref: '#/components/schemas/EventsGroupBy' + type: array + EventsSearch: + description: Configuration of the search/filter for an events query. + properties: + query: + description: The search/filter string for an events query. + example: status:warn service:foo + type: string + type: object + EventsAggregation: + default: count + description: The type of aggregation that can be performed on events-based queries. + enum: + - count + - cardinality + - pc75 + - pc90 + - pc95 + - pc98 + - pc99 + - sum + - min + - max + - avg + example: count + type: string + x-enum-varnames: + - COUNT + - CARDINALITY + - PC75 + - PC90 + - PC95 + - PC98 + - PC99 + - SUM + - MIN + - MAX + - AVG + EventsGroupBy: + description: A dimension on which to split a query's results. + properties: + facet: + description: The facet by which to split groups. + example: '@error.type' + type: string + limit: + default: 10 + description: >- + The maximum buckets to return for this group by. Note: at most 10000 + buckets are allowed. - Host name is one of the resources in the Resources field. - operationId: SubmitMetrics - parameters: - - description: HTTP header used to compress the media-type. - in: header - name: Content-Encoding - required: false + If grouping by multiple facets, the product of limits must not + exceed 10000. + example: 10 + format: int32 + maximum: 10000 + type: integer + sort: + $ref: '#/components/schemas/EventsGroupBySort' + required: + - facet + type: object + EventsGroupBySort: + description: The dimension by which to sort a query's results. + properties: + aggregation: + $ref: '#/components/schemas/EventsAggregation' + metric: + description: >- + The metric's calculated value which should be used to define the + sort order of a query's results. + example: '@duration' + type: string + order: + $ref: '#/components/schemas/QuerySortOrder' + type: + $ref: '#/components/schemas/EventsSortType' + required: + - aggregation + type: object + EventsSortType: + description: The type of sort to use on the calculated value. + enum: + - alphabetical + - measure + type: string + x-enum-varnames: + - ALPHABETICAL + - MEASURE + responses: + NotAuthorizedResponse: + content: + application/json: schema: - $ref: '#/components/schemas/MetricContentEncoding' - requestBody: - content: - application/json: - examples: - dynamic-points: - description: Post time-series data that can be graphed on Datadog’s dashboards. - externalValue: examples/metrics/dynamic-points.json.sh - summary: Dynamic Points - x-variables: - NOW: $(date +%s) - schema: - $ref: '#/components/schemas/MetricPayload' - required: true - responses: - '202': - content: - application/json: - schema: - $ref: '#/components/schemas/IntakePayloadAccepted' - description: Payload accepted - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '408': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Request timeout - '413': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Payload too large - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - summary: Submit metrics - tags: - - Metrics - x-codegen-request-body-name: body + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + ConflictResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + UnauthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unauthorized + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + SpansBadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request. + SpansForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Forbidden: Access denied.' + SpansUnprocessableEntityResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Unprocessable Entity. + SpansTooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Too many requests: The rate limit set by the API has been exceeded.' + parameters: + DatasetID: + description: The ID of a defined dataset. + example: 0879ce27-29a1-481f-a12e-bc2a48ec9ae1 + in: path + name: dataset_id + required: true + schema: + type: string + MetricName: + description: The name of the metric. + example: dist.http.endpoint.request + in: path + name: metric_name + required: true + schema: + type: string + x-stackQL-resources: + datasets: + id: datadog.metrics.datasets + name: datasets + title: Datasets + methods: + get_all_datasets: + operation: + $ref: '#/paths/~1api~1v2~1datasets/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_dataset: + operation: + $ref: '#/paths/~1api~1v2~1datasets/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_dataset: + operation: + $ref: '#/paths/~1api~1v2~1datasets~1{dataset_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_dataset: + operation: + $ref: '#/paths/~1api~1v2~1datasets~1{dataset_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_dataset: + operation: + $ref: '#/paths/~1api~1v2~1datasets~1{dataset_id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/datasets/methods/get_dataset' + - $ref: '#/components/x-stackQL-resources/datasets/methods/get_all_datasets' + insert: + - $ref: '#/components/x-stackQL-resources/datasets/methods/create_dataset' + update: [] + delete: + - $ref: '#/components/x-stackQL-resources/datasets/methods/delete_dataset' + replace: + - $ref: '#/components/x-stackQL-resources/datasets/methods/update_dataset' + tag_configurations: + id: datadog.metrics.tag_configurations + name: tag_configurations + title: Tag Configurations + methods: + list_tag_configurations: + operation: + $ref: '#/paths/~1api~1v2~1metrics/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + delete_bulk_tags_metrics_configuration: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1config~1bulk-tags/delete' + response: + mediaType: application/json + openAPIDocKey: '202' + create_bulk_tags_metrics_configuration: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1config~1bulk-tags/post' + response: + mediaType: application/json + openAPIDocKey: '202' + delete_tag_configuration: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + list_tag_configuration_by_name: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_tag_configuration: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + create_tag_configuration: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tags/post' + response: + mediaType: application/json + openAPIDocKey: '201' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/tag_configurations/methods/list_tag_configuration_by_name + - $ref: >- + #/components/x-stackQL-resources/tag_configurations/methods/list_tag_configurations + insert: + - $ref: >- + #/components/x-stackQL-resources/tag_configurations/methods/create_tag_configuration + - $ref: >- + #/components/x-stackQL-resources/tag_configurations/methods/create_bulk_tags_metrics_configuration + update: + - $ref: >- + #/components/x-stackQL-resources/tag_configurations/methods/update_tag_configuration + delete: + - $ref: >- + #/components/x-stackQL-resources/tag_configurations/methods/delete_tag_configuration + - $ref: >- + #/components/x-stackQL-resources/tag_configurations/methods/delete_bulk_tags_metrics_configuration + replace: [] + active_tag_configurations: + id: datadog.metrics.active_tag_configurations + name: active_tag_configurations + title: Active Tag Configurations + methods: + list_active_metric_configurations: + operation: + $ref: >- + #/paths/~1api~1v2~1metrics~1{metric_name}~1active-configurations/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/active_tag_configurations/methods/list_active_metric_configurations + insert: [] + update: [] + delete: [] + replace: [] + tags: + id: datadog.metrics.tags + name: tags + title: Tags + methods: + list_tags_by_metric_name: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1all-tags/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/tags/methods/list_tags_by_metric_name + insert: [] + update: [] + delete: [] + replace: [] + related_assets: + id: datadog.metrics.related_assets + name: related_assets + title: Related Assets + methods: + list_metric_assets: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1assets/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/related_assets/methods/list_metric_assets + insert: [] + update: [] + delete: [] + replace: [] + metrics_output_series: + id: datadog.metrics.metrics_output_series + name: metrics_output_series + title: Metrics Output Series + methods: + estimate_metrics_output_series: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1estimate/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/metrics_output_series/methods/estimate_metrics_output_series + insert: [] + update: [] + delete: [] + replace: [] + tag_cardinality_details: + id: datadog.metrics.tag_cardinality_details + name: tag_cardinality_details + title: Tag Cardinality Details + methods: + get_metric_tag_cardinality_details: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1tag-cardinalities/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/tag_cardinality_details/methods/get_metric_tag_cardinality_details + insert: [] + update: [] + delete: [] + replace: [] + volumes: + id: datadog.metrics.volumes + name: volumes + title: Volumes + methods: + list_volumes_by_metric_name: + operation: + $ref: '#/paths/~1api~1v2~1metrics~1{metric_name}~1volumes/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/volumes/methods/list_volumes_by_metric_name + insert: [] + update: [] + delete: [] + replace: [] + metrics: + id: datadog.metrics.metrics + name: metrics + title: Metrics + methods: + query_scalar_data: + operation: + $ref: '#/paths/~1api~1v2~1query~1scalar/post' + response: + mediaType: application/json + openAPIDocKey: '200' + query_timeseries_data: + operation: + $ref: '#/paths/~1api~1v2~1query~1timeseries/post' + response: + mediaType: application/json + openAPIDocKey: '200' + submit_metrics: + operation: + $ref: '#/paths/~1api~1v2~1series/post' + response: + mediaType: application/json + openAPIDocKey: '202' + sqlVerbs: + select: [] + insert: + - $ref: '#/components/x-stackQL-resources/metrics/methods/submit_metrics' + update: [] + delete: [] + replace: [] + spans: + id: datadog.metrics.spans + name: spans + title: Spans + methods: + aggregate_spans: + operation: + $ref: '#/paths/~1api~1v2~1spans~1analytics~1aggregate/post' + response: + mediaType: application/json + openAPIDocKey: '200' + list_spans_get: + operation: + $ref: '#/paths/~1api~1v2~1spans~1events/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + list_spans: + operation: + $ref: '#/paths/~1api~1v2~1spans~1events~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/spans/methods/list_spans_get' + insert: + - $ref: '#/components/x-stackQL-resources/spans/methods/list_spans' + update: [] + delete: [] + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/monitoring.yaml b/providers/src/datadog/v00.00.00000/services/monitoring.yaml new file mode 100644 index 00000000..01a995c9 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/monitoring.yaml @@ -0,0 +1,2085 @@ +openapi: 3.0.0 +info: + title: monitoring API + description: datadog monitoring API + version: '1.0' +paths: + /api/v2/monitor/notification_rule: + get: + description: Returns a list of all monitor notification rules. + operationId: GetMonitorNotificationRules + parameters: + - description: >- + The page to start paginating from. If `page` is not specified, the + argument defaults to the first page. + in: query + name: page + required: false + schema: + format: int32 + maximum: 1000000 + minimum: 0 + type: integer + - description: >- + The number of rules to return per page. If `per_page` is not + specified, the argument defaults to 100. + in: query + name: per_page + required: false + schema: + format: int32 + maximum: 1000 + minimum: 1 + type: integer + - description: >- + String for sort order, composed of field and sort order separated by + a colon, for example `name:asc`. Supported sort directions: `asc`, + `desc`. Supported fields: `name`, `created_at`. + in: query + name: sort + required: false + schema: + type: string + - description: >- + JSON-encoded filter object. Supported keys: + + * `text`: Free-text query matched against rule name, tags, and + recipients. + + * `tags`: Array of strings. Return rules that have any of these + tags. + + * `recipients`: Array of strings. Return rules that have any of + these recipients. + example: >- + {"text":"error","tags":["env:prod","team:my-team"],"recipients":["slack-monitor-app","email@example.com"]} + in: query + name: filters + required: false + schema: + type: string + - description: >- + Comma-separated list of resource paths for related resources to + include in the response. Supported resource + + path is `created_by`. + in: query + name: include + required: false + schema: + example: created_by + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorNotificationRuleListResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_read + summary: Get all monitor notification rules + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitors_read + post: + description: Creates a monitor notification rule. + operationId: CreateMonitorNotificationRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorNotificationRuleCreateRequest' + description: Request body to create a monitor notification rule. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorNotificationRuleResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a monitor notification rule + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + /api/v2/monitor/notification_rule/{rule_id}: + delete: + description: Deletes a monitor notification rule by `rule_id`. + operationId: DeleteMonitorNotificationRule + parameters: + - description: ID of the monitor notification rule to delete. + in: path + name: rule_id + required: true + schema: + type: string + responses: + '204': + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a monitor notification rule + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + get: + description: Returns a monitor notification rule by `rule_id`. + operationId: GetMonitorNotificationRule + parameters: + - description: ID of the monitor notification rule to fetch. + in: path + name: rule_id + required: true + schema: + type: string + - description: >- + Comma-separated list of resource paths for related resources to + include in the response. Supported resource + + path is `created_by`. + in: query + name: include + required: false + schema: + example: created_by + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorNotificationRuleResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_read + summary: Get a monitor notification rule + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitors_read + patch: + description: Updates a monitor notification rule by `rule_id`. + operationId: UpdateMonitorNotificationRule + parameters: + - description: ID of the monitor notification rule to update. + in: path + name: rule_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorNotificationRuleUpdateRequest' + description: Request body to update the monitor notification rule. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorNotificationRuleResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a monitor notification rule + tags: + - Monitors + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + /api/v2/monitor/policy: + get: + description: Get all monitor configuration policies. + operationId: ListMonitorConfigPolicies + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorConfigPolicyListResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_read + summary: Get all monitor configuration policies + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitors_read + post: + description: Create a monitor configuration policy. + operationId: CreateMonitorConfigPolicy + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorConfigPolicyCreateRequest' + description: Create a monitor configuration policy request body. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorConfigPolicyResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a monitor configuration policy + tags: + - Monitors + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + /api/v2/monitor/policy/{policy_id}: + delete: + description: Delete a monitor configuration policy. + operationId: DeleteMonitorConfigPolicy + parameters: + - description: ID of the monitor configuration policy. + in: path + name: policy_id + required: true + schema: + example: 00000000-0000-1234-0000-000000000000 + type: string + responses: + '204': + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a monitor configuration policy + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + get: + description: Get a monitor configuration policy by `policy_id`. + operationId: GetMonitorConfigPolicy + parameters: + - description: ID of the monitor configuration policy. + in: path + name: policy_id + required: true + schema: + example: 00000000-0000-1234-0000-000000000000 + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorConfigPolicyResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_read + summary: Get a monitor configuration policy + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitors_read + patch: + description: Edit a monitor configuration policy. + operationId: UpdateMonitorConfigPolicy + parameters: + - description: ID of the monitor configuration policy. + in: path + name: policy_id + required: true + schema: + example: 00000000-0000-1234-0000-000000000000 + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorConfigPolicyEditRequest' + description: Description of the update. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorConfigPolicyResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unprocessable Entity + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Edit a monitor configuration policy + tags: + - Monitors + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + /api/v2/monitor/template: + get: + description: Retrieve all monitor user templates. + operationId: ListMonitorUserTemplates + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorUserTemplateListResponse' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_read + summary: Get all monitor user templates + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitors_read + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + post: + description: Create a new monitor user template. + operationId: CreateMonitorUserTemplate + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorUserTemplateCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorUserTemplateCreateResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a monitor user template + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/monitor/template/validate: + post: + description: Validate the structure and content of a monitor user template. + operationId: ValidateMonitorUserTemplate + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorUserTemplateCreateRequest' + required: true + responses: + '204': + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Validate a monitor user template + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/monitor/template/{template_id}: + delete: + description: Delete an existing monitor user template by its ID. + operationId: DeleteMonitorUserTemplate + parameters: + - description: ID of the monitor user template. + in: path + name: template_id + required: true + schema: + type: string + responses: + '204': + description: OK + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a monitor user template + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + get: + description: Retrieve a monitor user template by its ID. + operationId: GetMonitorUserTemplate + parameters: + - description: ID of the monitor user template. + in: path + name: template_id + required: true + schema: + example: 00000000-0000-1234-0000-000000000000 + type: string + - description: >- + Whether to include all versions of the template in the response in + the versions field. + example: false + in: query + name: with_all_versions + required: false + schema: + type: boolean + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorUserTemplateResponse' + description: OK + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_read + summary: Get a monitor user template + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitors_read + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + put: + description: Creates a new version of an existing monitor user template. + operationId: UpdateMonitorUserTemplate + parameters: + - description: ID of the monitor user template. + in: path + name: template_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorUserTemplateUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorUserTemplateResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a monitor user template to a new version + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/monitor/template/{template_id}/validate: + post: + description: >- + Validate the structure and content of an existing monitor user template + being updated to a new version. + operationId: ValidateExistingMonitorUserTemplate + parameters: + - description: ID of the monitor user template. + in: path + name: template_id + required: true + schema: + example: 00000000-0000-1234-0000-000000000000 + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorUserTemplateUpdateRequest' + required: true + responses: + '204': + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Validate an existing monitor user template + tags: + - Monitors + x-permission: + operator: OR + permissions: + - monitor_config_policy_write + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/monitor/{monitor_id}/downtime_matches: + get: + description: Get all active downtimes for the specified monitor. + operationId: ListMonitorDowntimes + parameters: + - description: The id of the monitor. + in: path + name: monitor_id + required: true + schema: + format: int64 + type: integer + - $ref: '#/components/parameters/PageOffset' + - description: Maximum number of downtimes in the response. + example: 100 + in: query + name: page[limit] + required: false + schema: + default: 30 + format: int64 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/MonitorDowntimeMatchResponse' + description: OK + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Monitor Not Found error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_downtime + summary: Get active downtimes for a monitor + tags: + - Downtimes + x-codegen-request-body-name: body + x-pagination: + limitParam: page[limit] + pageOffsetParam: page[offset] + resultsPath: data + x-permission: + operator: OR + permissions: + - monitors_downtime + /api/v2/synthetics/settings/on_demand_concurrency_cap: + get: + description: Get the on-demand concurrency cap. + operationId: GetOnDemandConcurrencyCap + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OnDemandConcurrencyCapResponse' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get the on-demand concurrency cap + tags: + - Synthetics + x-permission: + operator: OR + permissions: + - billing_read + post: + description: Save new value for on-demand concurrency cap. + operationId: SetOnDemandConcurrencyCap + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OnDemandConcurrencyCapAttributes' + description: . + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OnDemandConcurrencyCapResponse' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Save new value for on-demand concurrency cap + tags: + - Synthetics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - billing_edit +components: + schemas: + MonitorNotificationRuleListResponse: + description: Response for retrieving all monitor notification rules. + properties: + data: + description: A list of monitor notification rules. + items: + $ref: '#/components/schemas/MonitorNotificationRuleData' + type: array + included: + description: Array of objects related to the monitor notification rules. + items: + $ref: '#/components/schemas/MonitorNotificationRuleResponseIncludedItem' + type: array + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + MonitorNotificationRuleCreateRequest: + description: Request for creating a monitor notification rule. + properties: + data: + $ref: '#/components/schemas/MonitorNotificationRuleCreateRequestData' + required: + - data + type: object + MonitorNotificationRuleResponse: + description: A monitor notification rule. + properties: + data: + $ref: '#/components/schemas/MonitorNotificationRuleData' + included: + description: >- + Array of objects related to the monitor notification rule that the + user requested. + items: + $ref: '#/components/schemas/MonitorNotificationRuleResponseIncludedItem' + type: array + type: object + MonitorNotificationRuleUpdateRequest: + description: Request for updating a monitor notification rule. + properties: + data: + $ref: '#/components/schemas/MonitorNotificationRuleUpdateRequestData' + required: + - data + type: object + MonitorConfigPolicyListResponse: + description: Response for retrieving all monitor configuration policies. + properties: + data: + description: An array of monitor configuration policies. + items: + $ref: '#/components/schemas/MonitorConfigPolicyResponseData' + type: array + type: object + MonitorConfigPolicyCreateRequest: + description: Request for creating a monitor configuration policy. + properties: + data: + $ref: '#/components/schemas/MonitorConfigPolicyCreateData' + required: + - data + type: object + MonitorConfigPolicyResponse: + description: Response for retrieving a monitor configuration policy. + properties: + data: + $ref: '#/components/schemas/MonitorConfigPolicyResponseData' + type: object + MonitorConfigPolicyEditRequest: + description: Request for editing a monitor configuration policy. + properties: + data: + $ref: '#/components/schemas/MonitorConfigPolicyEditData' + required: + - data + type: object + MonitorUserTemplateListResponse: + description: Response for retrieving all monitor user templates. + properties: + data: + description: An array of monitor user templates. + items: + $ref: '#/components/schemas/MonitorUserTemplateResponseData' + type: array + type: object + MonitorUserTemplateCreateRequest: + description: Request for creating a monitor user template. + properties: + data: + $ref: '#/components/schemas/MonitorUserTemplateCreateData' + required: + - data + type: object + MonitorUserTemplateCreateResponse: + description: Response for creating a monitor user template. + properties: + data: + $ref: '#/components/schemas/MonitorUserTemplateResponseData' + type: object + MonitorUserTemplateResponse: + description: Response for retrieving a monitor user template. + properties: + data: + $ref: '#/components/schemas/MonitorUserTemplateResponseDataWithVersions' + type: object + MonitorUserTemplateUpdateRequest: + description: Request for creating a new monitor user template version. + properties: + data: + $ref: '#/components/schemas/MonitorUserTemplateUpdateData' + required: + - data + type: object + MonitorDowntimeMatchResponse: + description: Response for retrieving all downtime matches for a monitor. + properties: + data: + description: An array of downtime matches. + items: + $ref: '#/components/schemas/MonitorDowntimeMatchResponseData' + type: array + meta: + $ref: '#/components/schemas/DowntimeMeta' + type: object + OnDemandConcurrencyCapResponse: + description: On-demand concurrency cap response. + properties: + data: + $ref: '#/components/schemas/OnDemandConcurrencyCap' + type: object + OnDemandConcurrencyCapAttributes: + description: On-demand concurrency cap attributes. + properties: + on_demand_concurrency_cap: + description: Value of the on-demand concurrency cap. + format: double + type: number + type: object + MonitorNotificationRuleData: + description: Monitor notification rule data. + properties: + attributes: + $ref: '#/components/schemas/MonitorNotificationRuleResponseAttributes' + id: + $ref: '#/components/schemas/MonitorNotificationRuleId' + relationships: + $ref: '#/components/schemas/MonitorNotificationRuleRelationships' + type: + $ref: '#/components/schemas/MonitorNotificationRuleResourceType' + type: object + MonitorNotificationRuleResponseIncludedItem: + description: An object related to a monitor notification rule. + oneOf: + - $ref: '#/components/schemas/User' + MonitorNotificationRuleCreateRequestData: + description: Object to create a monitor notification rule. + properties: + attributes: + $ref: '#/components/schemas/MonitorNotificationRuleAttributes' + type: + $ref: '#/components/schemas/MonitorNotificationRuleResourceType' + required: + - attributes + type: object + MonitorNotificationRuleUpdateRequestData: + description: Object to update a monitor notification rule. + properties: + attributes: + $ref: '#/components/schemas/MonitorNotificationRuleAttributes' + id: + $ref: '#/components/schemas/MonitorNotificationRuleId' + type: + $ref: '#/components/schemas/MonitorNotificationRuleResourceType' + required: + - id + - attributes + type: object + MonitorConfigPolicyResponseData: + description: A monitor configuration policy data. + properties: + attributes: + $ref: '#/components/schemas/MonitorConfigPolicyAttributeResponse' + id: + description: ID of this monitor configuration policy. + example: 00000000-0000-1234-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/MonitorConfigPolicyResourceType' + type: object + MonitorConfigPolicyCreateData: + description: A monitor configuration policy data. + properties: + attributes: + $ref: '#/components/schemas/MonitorConfigPolicyAttributeCreateRequest' + type: + $ref: '#/components/schemas/MonitorConfigPolicyResourceType' + required: + - type + - attributes + type: object + MonitorConfigPolicyEditData: + description: A monitor configuration policy data. + properties: + attributes: + $ref: '#/components/schemas/MonitorConfigPolicyAttributeEditRequest' + id: + description: ID of this monitor configuration policy. + example: 00000000-0000-1234-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/MonitorConfigPolicyResourceType' + required: + - id + - type + - attributes + type: object + MonitorUserTemplateResponseData: + description: Monitor user template list response data. + properties: + attributes: + $ref: '#/components/schemas/MonitorUserTemplateResponseAttributes' + id: + $ref: '#/components/schemas/MonitorUserTemplateId' + type: + $ref: '#/components/schemas/MonitorUserTemplateResourceType' + type: object + MonitorUserTemplateCreateData: + description: Monitor user template data. + properties: + attributes: + $ref: '#/components/schemas/MonitorUserTemplateRequestAttributes' + type: + $ref: '#/components/schemas/MonitorUserTemplateResourceType' + required: + - type + - attributes + type: object + MonitorUserTemplateResponseDataWithVersions: + description: Monitor user template data. + properties: + attributes: + $ref: '#/components/schemas/MonitorUserTemplate' + id: + $ref: '#/components/schemas/MonitorUserTemplateId' + type: + $ref: '#/components/schemas/MonitorUserTemplateResourceType' + type: object + MonitorUserTemplateUpdateData: + description: Monitor user template data. + properties: + attributes: + $ref: '#/components/schemas/MonitorUserTemplateRequestAttributes' + id: + $ref: '#/components/schemas/MonitorUserTemplateId' + type: + $ref: '#/components/schemas/MonitorUserTemplateResourceType' + required: + - id + - type + - attributes + type: object + MonitorDowntimeMatchResponseData: + description: A downtime match. + properties: + attributes: + $ref: '#/components/schemas/MonitorDowntimeMatchResponseAttributes' + id: + description: The downtime ID. + example: 00000000-0000-1234-0000-000000000000 + nullable: true + type: string + type: + $ref: '#/components/schemas/MonitorDowntimeMatchResourceType' + type: object + DowntimeMeta: + description: Pagination metadata returned by the API. + properties: + page: + $ref: '#/components/schemas/DowntimeMetaPage' + type: object + OnDemandConcurrencyCap: + description: On-demand concurrency cap. + properties: + attributes: + $ref: '#/components/schemas/OnDemandConcurrencyCapAttributes' + type: + $ref: '#/components/schemas/OnDemandConcurrencyCapType' + type: object + MonitorNotificationRuleResponseAttributes: + additionalProperties: {} + description: Attributes of the monitor notification rule. + properties: + created: + description: Creation time of the monitor notification rule. + example: '2020-01-02T03:04:00.000Z' + format: date-time + type: string + filter: + $ref: '#/components/schemas/MonitorNotificationRuleFilter' + modified: + description: Time the monitor notification rule was last modified. + example: '2020-01-02T03:04:00.000Z' + format: date-time + type: string + name: + $ref: '#/components/schemas/MonitorNotificationRuleName' + recipients: + $ref: '#/components/schemas/MonitorNotificationRuleRecipients' + type: object + MonitorNotificationRuleId: + description: The ID of the monitor notification rule. + example: 00000000-0000-1234-0000-000000000000 + type: string + MonitorNotificationRuleRelationships: + description: All relationships associated with monitor notification rule. + properties: + created_by: + $ref: '#/components/schemas/MonitorNotificationRuleRelationshipsCreatedBy' + type: object + MonitorNotificationRuleResourceType: + default: monitor-notification-rule + description: Monitor notification rule resource type. + enum: + - monitor-notification-rule + example: monitor-notification-rule + type: string + x-enum-varnames: + - MONITOR_NOTIFICATION_RULE + User: + description: User object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/UserAttributes' + id: + description: ID of the user. + type: string + relationships: + $ref: '#/components/schemas/UserResponseRelationships' + type: + $ref: '#/components/schemas/UsersType' + type: object + MonitorNotificationRuleAttributes: + additionalProperties: false + description: Attributes of the monitor notification rule. + properties: + filter: + $ref: '#/components/schemas/MonitorNotificationRuleFilter' + name: + $ref: '#/components/schemas/MonitorNotificationRuleName' + recipients: + $ref: '#/components/schemas/MonitorNotificationRuleRecipients' + required: + - name + - recipients + type: object + MonitorConfigPolicyAttributeResponse: + description: Policy and policy type for a monitor configuration policy. + properties: + policy: + $ref: '#/components/schemas/MonitorConfigPolicyPolicy' + policy_type: + $ref: '#/components/schemas/MonitorConfigPolicyType' + type: object + MonitorConfigPolicyResourceType: + default: monitor-config-policy + description: Monitor configuration policy resource type. + enum: + - monitor-config-policy + example: monitor-config-policy + type: string + x-enum-varnames: + - MONITOR_CONFIG_POLICY + MonitorConfigPolicyAttributeCreateRequest: + description: Policy and policy type for a monitor configuration policy. + properties: + policy: + $ref: '#/components/schemas/MonitorConfigPolicyPolicyCreateRequest' + policy_type: + $ref: '#/components/schemas/MonitorConfigPolicyType' + required: + - policy_type + - policy + type: object + MonitorConfigPolicyAttributeEditRequest: + description: Policy and policy type for a monitor configuration policy. + properties: + policy: + $ref: '#/components/schemas/MonitorConfigPolicyPolicy' + policy_type: + $ref: '#/components/schemas/MonitorConfigPolicyType' + required: + - policy_type + - policy + type: object + MonitorUserTemplateResponseAttributes: + additionalProperties: {} + description: Attributes for a monitor user template. + properties: + created: + $ref: '#/components/schemas/MonitorUserTemplateCreated' + description: + $ref: '#/components/schemas/MonitorUserTemplateDescription' + modified: + $ref: '#/components/schemas/MonitorUserTemplateModified' + monitor_definition: + additionalProperties: {} + description: >- + A valid monitor definition in the same format as the [V1 Monitor + API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor). + example: + message: You may need to add web hosts if this is consistently high. + name: Bytes received on host0 + query: avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100 + type: query alert + type: object + tags: + $ref: '#/components/schemas/MonitorUserTemplateTags' + template_variables: + $ref: '#/components/schemas/MonitorUserTemplateTemplateVariables' + title: + $ref: '#/components/schemas/MonitorUserTemplateTitle' + version: + $ref: '#/components/schemas/MonitorUserTemplateVersion' + type: object + MonitorUserTemplateId: + description: The unique identifier. + example: 00000000-0000-1234-0000-000000000000 + type: string + MonitorUserTemplateResourceType: + default: monitor-user-template + description: Monitor user template resource type. + enum: + - monitor-user-template + example: monitor-user-template + type: string + x-enum-varnames: + - MONITOR_USER_TEMPLATE + MonitorUserTemplateRequestAttributes: + additionalProperties: false + description: Attributes for a monitor user template. + properties: + description: + $ref: '#/components/schemas/MonitorUserTemplateDescription' + monitor_definition: + additionalProperties: {} + description: >- + A valid monitor definition in the same format as the [V1 Monitor + API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor). + example: + message: You may need to add web hosts if this is consistently high. + name: Bytes received on host0 + query: avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100 + type: query alert + type: object + tags: + $ref: '#/components/schemas/MonitorUserTemplateTags' + template_variables: + $ref: '#/components/schemas/MonitorUserTemplateTemplateVariables' + title: + $ref: '#/components/schemas/MonitorUserTemplateTitle' + required: + - title + - monitor_definition + - tags + type: object + MonitorUserTemplate: + additionalProperties: {} + description: A monitor user template object. + properties: + created: + $ref: '#/components/schemas/MonitorUserTemplateCreated' + description: + $ref: '#/components/schemas/MonitorUserTemplateDescription' + modified: + $ref: '#/components/schemas/MonitorUserTemplateModified' + monitor_definition: + additionalProperties: {} + description: >- + A valid monitor definition in the same format as the [V1 Monitor + API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor). + example: + message: You may need to add web hosts if this is consistently high. + name: Bytes received on host0 + query: avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100 + type: query alert + type: object + tags: + $ref: '#/components/schemas/MonitorUserTemplateTags' + template_variables: + $ref: '#/components/schemas/MonitorUserTemplateTemplateVariables' + title: + $ref: '#/components/schemas/MonitorUserTemplateTitle' + version: + $ref: '#/components/schemas/MonitorUserTemplateVersion' + versions: + description: All versions of the monitor user template. + items: + $ref: '#/components/schemas/SimpleMonitorUserTemplate' + type: array + type: object + MonitorDowntimeMatchResponseAttributes: + description: Downtime match details. + properties: + end: + description: The end of the downtime. + example: '2020-01-02T03:04:00.000Z' + format: date-time + nullable: true + type: string + groups: + description: An array of groups associated with the downtime. + example: + - service:postgres + - team:frontend + items: + description: An array of groups. + example: service:postgres + type: string + type: array + scope: + $ref: '#/components/schemas/DowntimeScope' + start: + description: The start of the downtime. + example: '2020-01-02T03:04:00.000Z' + format: date-time + type: string + type: object + MonitorDowntimeMatchResourceType: + default: downtime_match + description: Monitor Downtime Match resource type. + enum: + - downtime_match + example: downtime_match + type: string + x-enum-varnames: + - DOWNTIME_MATCH + DowntimeMetaPage: + description: Object containing the total filtered count. + properties: + total_filtered_count: + description: Total count of elements matched by the filter. + format: int64 + type: integer + type: object + OnDemandConcurrencyCapType: + description: On-demand concurrency cap type. + enum: + - on_demand_concurrency_cap + type: string + x-enum-varnames: + - ON_DEMAND_CONCURRENCY_CAP + MonitorNotificationRuleFilter: + description: Filter used to associate the notification rule with monitors. + oneOf: + - $ref: '#/components/schemas/MonitorNotificationRuleFilterTags' + MonitorNotificationRuleName: + description: The name of the monitor notification rule. + example: A notification rule name + maxLength: 1000 + minLength: 1 + type: string + MonitorNotificationRuleRecipients: + description: >- + A list of recipients to notify. Uses the same format as the monitor + `message` field. Must not start with an '@'. + example: + - slack-test-channel + - jira-test + items: + description: individual recipient. + maxLength: 255 + type: string + maxItems: 20 + minItems: 1 + type: array + uniqueItems: true + MonitorNotificationRuleRelationshipsCreatedBy: + description: The user who created the monitor notification rule. + properties: + data: + $ref: >- + #/components/schemas/MonitorNotificationRuleRelationshipsCreatedByData + type: object + UserAttributes: + description: Attributes of user object returned by the API. + properties: + created_at: + description: Creation time of the user. + format: date-time + type: string + disabled: + description: Whether the user is disabled. + type: boolean + email: + description: Email of the user. + type: string + handle: + description: Handle of the user. + type: string + icon: + description: URL of the user's icon. + type: string + mfa_enabled: + description: If user has MFA enabled. + readOnly: true + type: boolean + modified_at: + description: Time that the user was last modified. + format: date-time + type: string + name: + description: Name of the user. + nullable: true + type: string + service_account: + description: Whether the user is a service account. + type: boolean + status: + description: Status of the user. + type: string + title: + description: Title of the user. + nullable: true + type: string + verified: + description: Whether the user is verified. + type: boolean + type: object + UserResponseRelationships: + description: Relationships of the user object returned by the API. + properties: + org: + $ref: '#/components/schemas/RelationshipToOrganization' + other_orgs: + $ref: '#/components/schemas/RelationshipToOrganizations' + other_users: + $ref: '#/components/schemas/RelationshipToUsers' + roles: + $ref: '#/components/schemas/RelationshipToRoles' + type: object + UsersType: + default: users + description: Users resource type. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + MonitorConfigPolicyPolicy: + description: Configuration for the policy. + oneOf: + - $ref: '#/components/schemas/MonitorConfigPolicyTagPolicy' + MonitorConfigPolicyType: + default: tag + description: The monitor configuration policy type. + enum: + - tag + example: tag + type: string + x-enum-varnames: + - TAG + MonitorConfigPolicyPolicyCreateRequest: + description: Configuration for the policy. + oneOf: + - $ref: '#/components/schemas/MonitorConfigPolicyTagPolicyCreateRequest' + MonitorUserTemplateCreated: + description: The created timestamp of the template. + example: '2024-01-02T03:04:23.274966+00:00' + format: date-time + readOnly: true + type: string + MonitorUserTemplateDescription: + description: A brief description of the monitor user template. + example: This is a template for monitoring user activity. + nullable: true + type: string + MonitorUserTemplateModified: + description: The last modified timestamp. When the template version was created. + example: '2024-02-02T03:04:23.274966+00:00' + format: date-time + readOnly: true + type: string + MonitorUserTemplateTags: + description: The definition of `MonitorUserTemplateTags` object. + example: + - product:Our Custom App + - integration:Azure + items: + description: >- + Tags associated with the monitor user template. Must be key value. + Only 'product' and 'integration' keys are + + allowed. The value is the name of the category to display the template + under. Integrations can be filtered out in the UI. + + (Review note: This modeling of 'categories' is subject to change.) + example: us-east1 + minLength: 1 + type: string + uniqueItems: true + type: array + MonitorUserTemplateTemplateVariables: + description: The definition of `MonitorUserTemplateTemplateVariables` object. + items: + $ref: '#/components/schemas/MonitorUserTemplateTemplateVariablesItems' + type: array + MonitorUserTemplateTitle: + description: The title of the monitor user template. + example: Postgres CPU Monitor + type: string + MonitorUserTemplateVersion: + description: The version of the monitor user template. + example: 0 + format: int64 + nullable: true + readOnly: true + type: integer + SimpleMonitorUserTemplate: + description: A simplified version of a monitor user template. + properties: + created: + $ref: '#/components/schemas/MonitorUserTemplateCreated' + description: + $ref: '#/components/schemas/MonitorUserTemplateDescription' + id: + description: >- + The unique identifier. The initial version will match the template + ID. + example: 00000000-0000-1234-0000-000000000000 + type: string + monitor_definition: + additionalProperties: {} + description: >- + A valid monitor definition in the same format as the [V1 Monitor + API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor). + example: + message: You may need to add web hosts if this is consistently high. + name: Bytes received on host0 + query: avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100 + type: query alert + type: object + tags: + $ref: '#/components/schemas/MonitorUserTemplateTags' + template_variables: + $ref: '#/components/schemas/MonitorUserTemplateTemplateVariables' + title: + $ref: '#/components/schemas/MonitorUserTemplateTitle' + version: + $ref: '#/components/schemas/MonitorUserTemplateVersion' + type: object + DowntimeScope: + description: >- + The scope to which the downtime applies. Must follow the [common search + syntax](https://docs.datadoghq.com/logs/explorer/search_syntax/). + example: env:(staging OR prod) AND datacenter:us-east-1 + type: string + MonitorNotificationRuleFilterTags: + additionalProperties: false + description: Filter monitors by tags. Monitors must match all tags. + properties: + tags: + description: A list of monitor tags. + example: + - team:product + - host:abc + items: + maxLength: 255 + type: string + maxItems: 20 + minItems: 1 + type: array + uniqueItems: true + required: + - tags + type: object + MonitorNotificationRuleRelationshipsCreatedByData: + description: Data for the user who created the monitor notification rule. + nullable: true + properties: + id: + description: User ID of the monitor notification rule creator. + example: 00000000-0000-1234-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + type: object + RelationshipToOrganization: + description: Relationship to an organization. + properties: + data: + $ref: '#/components/schemas/RelationshipToOrganizationData' + required: + - data + type: object + RelationshipToOrganizations: + description: Relationship to organizations. + properties: + data: + description: Relationships to organization objects. + example: [] + items: + $ref: '#/components/schemas/RelationshipToOrganizationData' + type: array + required: + - data + type: object + RelationshipToUsers: + description: Relationship to users. + properties: + data: + description: Relationships to user objects. + example: [] + items: + $ref: '#/components/schemas/RelationshipToUserData' + type: array + required: + - data + type: object + RelationshipToRoles: + description: Relationship to roles. + properties: + data: + description: An array containing type and the unique identifier of a role. + items: + $ref: '#/components/schemas/RelationshipToRoleData' + type: array + type: object + MonitorConfigPolicyTagPolicy: + description: Tag attributes of a monitor configuration policy. + properties: + tag_key: + description: The key of the tag. + example: datacenter + maxLength: 255 + type: string + tag_key_required: + description: If a tag key is required for monitor creation. + example: true + type: boolean + valid_tag_values: + description: Valid values for the tag. + example: + - prod + - staging + items: + maxLength: 255 + type: string + type: array + type: object + MonitorConfigPolicyTagPolicyCreateRequest: + description: Tag attributes of a monitor configuration policy. + properties: + tag_key: + description: The key of the tag. + example: datacenter + maxLength: 255 + type: string + tag_key_required: + description: If a tag key is required for monitor creation. + example: true + type: boolean + valid_tag_values: + description: Valid values for the tag. + example: + - prod + - staging + items: + maxLength: 255 + type: string + type: array + required: + - tag_key + - tag_key_required + - valid_tag_values + type: object + MonitorUserTemplateTemplateVariablesItems: + additionalProperties: false + description: >- + List of objects representing template variables on the monitor which can + have selectable values. + properties: + available_values: + description: Available values for the variable. + example: + - value1 + - value2 + items: + minLength: 1 + type: string + uniqueItems: true + type: array + defaults: + description: Default values of the template variable. + example: + - defaultValue + items: + minLength: 0 + type: string + uniqueItems: true + type: array + name: + description: The name of the template variable. + example: regionName + type: string + tag_key: + description: >- + The tag key associated with the variable. This works the same as + dashboard template variables. + example: datacenter + type: string + required: + - name + type: object + RelationshipToOrganizationData: + description: Relationship to organization object. + properties: + id: + description: ID of the organization. + example: 00000000-0000-beef-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/OrganizationsType' + required: + - id + - type + type: object + RelationshipToUserData: + description: Relationship to user object. + properties: + id: + description: A unique identifier that represents the user. + example: 00000000-0000-0000-2345-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + required: + - id + - type + type: object + RelationshipToRoleData: + description: Relationship to role object. + properties: + id: + description: The unique identifier of the role. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + type: + $ref: '#/components/schemas/RolesType' + type: object + OrganizationsType: + default: orgs + description: Organizations resource type. + enum: + - orgs + example: orgs + type: string + x-enum-varnames: + - ORGS + RolesType: + default: roles + description: Roles type. + enum: + - roles + example: roles + type: string + x-enum-varnames: + - ROLES + responses: + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + parameters: + PageOffset: + description: Specific offset to use as the beginning of the returned page. + in: query + name: page[offset] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + x-stackQL-resources: + notification_rules: + id: datadog.monitoring.notification_rules + name: notification_rules + title: Notification Rules + methods: + get_monitor_notification_rules: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1notification_rule/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_monitor_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1notification_rule/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_monitor_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1notification_rule~1{rule_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_monitor_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1notification_rule~1{rule_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_monitor_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1notification_rule~1{rule_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/notification_rules/methods/get_monitor_notification_rule + - $ref: >- + #/components/x-stackQL-resources/notification_rules/methods/get_monitor_notification_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/notification_rules/methods/create_monitor_notification_rule + update: + - $ref: >- + #/components/x-stackQL-resources/notification_rules/methods/update_monitor_notification_rule + delete: + - $ref: >- + #/components/x-stackQL-resources/notification_rules/methods/delete_monitor_notification_rule + replace: [] + config_policies: + id: datadog.monitoring.config_policies + name: config_policies + title: Config Policies + methods: + list_monitor_config_policies: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1policy/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_monitor_config_policy: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1policy/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_monitor_config_policy: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1policy~1{policy_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_monitor_config_policy: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1policy~1{policy_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_monitor_config_policy: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1policy~1{policy_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/config_policies/methods/get_monitor_config_policy + - $ref: >- + #/components/x-stackQL-resources/config_policies/methods/list_monitor_config_policies + insert: + - $ref: >- + #/components/x-stackQL-resources/config_policies/methods/create_monitor_config_policy + update: + - $ref: >- + #/components/x-stackQL-resources/config_policies/methods/update_monitor_config_policy + delete: + - $ref: >- + #/components/x-stackQL-resources/config_policies/methods/delete_monitor_config_policy + replace: [] + user_templates: + id: datadog.monitoring.user_templates + name: user_templates + title: User Templates + methods: + list_monitor_user_templates: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1template/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_monitor_user_template: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1template/post' + response: + mediaType: application/json + openAPIDocKey: '200' + validate_monitor_user_template: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1template~1validate/post' + response: + mediaType: application/json + openAPIDocKey: '204' + delete_monitor_user_template: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1template~1{template_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_monitor_user_template: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1template~1{template_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_monitor_user_template: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1template~1{template_id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + validate_existing_monitor_user_template: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1template~1{template_id}~1validate/post' + response: + mediaType: application/json + openAPIDocKey: '204' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/user_templates/methods/get_monitor_user_template + - $ref: >- + #/components/x-stackQL-resources/user_templates/methods/list_monitor_user_templates + insert: + - $ref: >- + #/components/x-stackQL-resources/user_templates/methods/create_monitor_user_template + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/user_templates/methods/delete_monitor_user_template + replace: + - $ref: >- + #/components/x-stackQL-resources/user_templates/methods/update_monitor_user_template + downtimes: + id: datadog.monitoring.downtimes + name: downtimes + title: Downtimes + methods: + list_monitor_downtimes: + operation: + $ref: '#/paths/~1api~1v2~1monitor~1{monitor_id}~1downtime_matches/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/downtimes/methods/list_monitor_downtimes + insert: [] + update: [] + delete: [] + replace: [] + on_demand_concurrency_cap: + id: datadog.monitoring.on_demand_concurrency_cap + name: on_demand_concurrency_cap + title: On Demand Concurrency Cap + methods: + get_on_demand_concurrency_cap: + operation: + $ref: >- + #/paths/~1api~1v2~1synthetics~1settings~1on_demand_concurrency_cap/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + set_on_demand_concurrency_cap: + operation: + $ref: >- + #/paths/~1api~1v2~1synthetics~1settings~1on_demand_concurrency_cap/post + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/on_demand_concurrency_cap/methods/get_on_demand_concurrency_cap + insert: + - $ref: >- + #/components/x-stackQL-resources/on_demand_concurrency_cap/methods/set_on_demand_concurrency_cap + update: [] + delete: [] + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/monitors.yaml b/providers/src/datadog/v00.00.00000/services/monitors.yaml deleted file mode 100644 index aaee3613..00000000 --- a/providers/src/datadog/v00.00.00000/services/monitors.yaml +++ /dev/null @@ -1,1299 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - monitors - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - MonitorConfigPolicyListResponse: - description: Response for retrieving all monitor configuration policies. - properties: - data: - description: An array of monitor configuration policies. - items: - $ref: '#/components/schemas/MonitorConfigPolicyResponseData' - type: array - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - MonitorConfigPolicyResponseData: - description: A monitor configuration policy data. - properties: - attributes: - $ref: '#/components/schemas/MonitorConfigPolicyAttributeResponse' - id: - description: ID of this monitor configuration policy. - example: 00000000-0000-1234-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/MonitorConfigPolicyResourceType' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - MonitorConfigPolicyAttributeResponse: - description: Policy and policy type for a monitor configuration policy. - properties: - policy: - $ref: '#/components/schemas/MonitorConfigPolicyPolicy' - policy_type: - $ref: '#/components/schemas/MonitorConfigPolicyType' - type: object - MonitorConfigPolicyResourceType: - default: monitor-config-policy - description: Monitor configuration policy resource type. - enum: - - monitor-config-policy - example: monitor-config-policy - type: string - x-enum-varnames: - - MONITOR_CONFIG_POLICY - MonitorConfigPolicyPolicy: - description: Configuration for the policy. - oneOf: - - $ref: '#/components/schemas/MonitorConfigPolicyTagPolicy' - MonitorConfigPolicyType: - default: tag - description: The monitor configuration policy type. - enum: - - tag - example: tag - type: string - x-enum-varnames: - - TAG - MonitorConfigPolicyTagPolicy: - description: Tag attributes of a monitor configuration policy. - properties: - tag_key: - description: The key of the tag. - example: datacenter - maxLength: 255 - type: string - tag_key_required: - description: If a tag key is required for monitor creation. - example: true - type: boolean - valid_tag_values: - description: Valid values for the tag. - example: - - prod - - staging - items: - maxLength: 255 - type: string - type: array - type: object - MonitorConfigPolicyCreateRequest: - description: Request for creating a monitor configuration policy. - properties: - data: - $ref: '#/components/schemas/MonitorConfigPolicyCreateData' - required: - - data - type: object - MonitorConfigPolicyResponse: - description: Response for retrieving a monitor configuration policy. - properties: - data: - $ref: '#/components/schemas/MonitorConfigPolicyResponseData' - type: object - MonitorConfigPolicyCreateData: - description: A monitor configuration policy data. - properties: - attributes: - $ref: '#/components/schemas/MonitorConfigPolicyAttributeCreateRequest' - type: - $ref: '#/components/schemas/MonitorConfigPolicyResourceType' - required: - - type - - attributes - type: object - MonitorConfigPolicyAttributeCreateRequest: - description: Policy and policy type for a monitor configuration policy. - properties: - policy: - $ref: '#/components/schemas/MonitorConfigPolicyPolicyCreateRequest' - policy_type: - $ref: '#/components/schemas/MonitorConfigPolicyType' - required: - - policy_type - - policy - type: object - MonitorConfigPolicyPolicyCreateRequest: - description: Configuration for the policy. - oneOf: - - $ref: '#/components/schemas/MonitorConfigPolicyTagPolicyCreateRequest' - MonitorConfigPolicyTagPolicyCreateRequest: - description: Tag attributes of a monitor configuration policy. - properties: - tag_key: - description: The key of the tag. - example: datacenter - maxLength: 255 - type: string - tag_key_required: - description: If a tag key is required for monitor creation. - example: true - type: boolean - valid_tag_values: - description: Valid values for the tag. - example: - - prod - - staging - items: - maxLength: 255 - type: string - type: array - required: - - tag_key - - tag_key_required - - valid_tag_values - type: object - MonitorConfigPolicyEditRequest: - description: Request for editing a monitor configuration policy. - properties: - data: - $ref: '#/components/schemas/MonitorConfigPolicyEditData' - required: - - data - type: object - MonitorConfigPolicyEditData: - description: A monitor configuration policy data. - properties: - attributes: - $ref: '#/components/schemas/MonitorConfigPolicyAttributeEditRequest' - id: - description: ID of this monitor configuration policy. - example: 00000000-0000-1234-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/MonitorConfigPolicyResourceType' - required: - - id - - type - - attributes - type: object - MonitorConfigPolicyAttributeEditRequest: - description: Policy and policy type for a monitor configuration policy. - properties: - policy: - $ref: '#/components/schemas/MonitorConfigPolicyPolicy' - policy_type: - $ref: '#/components/schemas/MonitorConfigPolicyType' - required: - - policy_type - - policy - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - monitor_config_policies: - id: datadog.monitors.monitor_config_policies - name: monitor_config_policies - title: Monitor Config Policies - methods: - list_monitor_config_policies: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1policy/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_monitor_config_policies: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1policy/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_monitor_config_policy: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1policy/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_monitor_config_policy: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1policy~1{policy_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_monitor_config_policy: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1policy~1{policy_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_monitor_config_policy: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1policy~1{policy_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_monitor_config_policy: - operation: - $ref: '#/paths/~1api~1v2~1monitor~1policy~1{policy_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/monitor_config_policies/methods/get_monitor_config_policy' - - $ref: '#/components/x-stackQL-resources/monitor_config_policies/methods/list_monitor_config_policies' - insert: - - $ref: '#/components/x-stackQL-resources/monitor_config_policies/methods/create_monitor_config_policy' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/monitor_config_policies/methods/delete_monitor_config_policy' -paths: - /api/v2/monitor/policy: - get: - description: Get all monitor configuration policies. - operationId: ListMonitorConfigPolicies - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MonitorConfigPolicyListResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - monitors_read - summary: Get all monitor configuration policies - tags: - - Monitors - post: - description: Create a monitor configuration policy. - operationId: CreateMonitorConfigPolicy - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/MonitorConfigPolicyCreateRequest' - description: Create a monitor configuration policy request body. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MonitorConfigPolicyResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a monitor configuration policy - tags: - - Monitors - x-codegen-request-body-name: body - '/api/v2/monitor/policy/{policy_id}': - delete: - description: Delete a monitor configuration policy. - operationId: DeleteMonitorConfigPolicy - parameters: - - description: ID of the monitor configuration policy. - in: path - name: policy_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - responses: - '204': - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete a monitor configuration policy - tags: - - Monitors - get: - description: Get a monitor configuration policy by `policy_id`. - operationId: GetMonitorConfigPolicy - parameters: - - description: ID of the monitor configuration policy. - in: path - name: policy_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MonitorConfigPolicyResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - monitors_read - summary: Get a monitor configuration policy - tags: - - Monitors - patch: - description: Edit a monitor configuration policy. - operationId: UpdateMonitorConfigPolicy - parameters: - - description: ID of the monitor configuration policy. - in: path - name: policy_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/MonitorConfigPolicyEditRequest' - description: Description of the update. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/MonitorConfigPolicyResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unprocessable Entity - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Edit a monitor configuration policy - tags: - - Monitors - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/okta_integration.yaml b/providers/src/datadog/v00.00.00000/services/okta_integration.yaml deleted file mode 100644 index 19b9a5ca..00000000 --- a/providers/src/datadog/v00.00.00000/services/okta_integration.yaml +++ /dev/null @@ -1,1222 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - okta_integration - description: Okta_Integration -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - OktaAccountsResponse: - description: The expected response schema when getting Okta accounts. - properties: - data: - description: List of Okta accounts. - items: - $ref: '#/components/schemas/OktaAccountResponseData' - type: array - type: object - OktaAccountResponseData: - description: Data object of an Okta account - properties: - attributes: - $ref: '#/components/schemas/OktaAccountAttributes' - id: - description: 'The ID of the Okta account, a UUID hash of the account name.' - example: f749daaf-682e-4208-a38d-c9b43162c609 - type: string - type: - $ref: '#/components/schemas/OktaAccountType' - required: - - attributes - - id - - type - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - OktaAccountAttributes: - description: Attributes object for an Okta account. - properties: - api_key: - description: The API key of the Okta account. - type: string - writeOnly: true - auth_method: - description: The authorization method for an Okta account. - example: oauth - type: string - client_id: - description: The Client ID of an Okta app integration. - type: string - client_secret: - description: The client secret of an Okta app integration. - type: string - writeOnly: true - domain: - description: The domain of the Okta account. - example: 'https://example.okta.com/' - type: string - name: - description: The name of the Okta account. - example: Okta-Prod - type: string - required: - - auth_method - - domain - - name - type: object - OktaAccountType: - default: okta-accounts - description: Account type for an Okta account. - enum: - - okta-accounts - example: okta-accounts - type: string - x-enum-varnames: - - OKTA_ACCOUNTS - OktaAccountRequest: - description: Request object for an Okta account. - properties: - data: - $ref: '#/components/schemas/OktaAccount' - required: - - data - type: object - OktaAccountResponse: - description: Response object for an Okta account. - properties: - data: - $ref: '#/components/schemas/OktaAccount' - type: object - OktaAccount: - description: Schema for an Okta account. - properties: - attributes: - $ref: '#/components/schemas/OktaAccountAttributes' - id: - description: 'The ID of the Okta account, a UUID hash of the account name.' - example: f749daaf-682e-4208-a38d-c9b43162c609 - type: string - type: - $ref: '#/components/schemas/OktaAccountType' - required: - - attributes - - type - type: object - OktaAccountUpdateRequest: - description: Payload schema when updating an Okta account. - properties: - data: - $ref: '#/components/schemas/OktaAccountUpdateRequestData' - required: - - data - type: object - OktaAccountUpdateRequestData: - description: Data object for updating an Okta account. - properties: - attributes: - $ref: '#/components/schemas/OktaAccountUpdateRequestAttributes' - type: - $ref: '#/components/schemas/OktaAccountType' - OktaAccountUpdateRequestAttributes: - description: Attributes object for updating an Okta account. - properties: - api_key: - description: The API key of the Okta account. - type: string - writeOnly: true - auth_method: - description: The authorization method for an Okta account. - example: oauth - type: string - client_id: - description: The Client ID of an Okta app integration. - type: string - client_secret: - description: The client secret of an Okta app integration. - type: string - writeOnly: true - domain: - description: The domain associated with an Okta account. - example: 'https://dev-test.okta.com/' - type: string - required: - - auth_method - - domain - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - okta_accounts: - id: datadog.okta_integration.okta_accounts - name: okta_accounts - title: Okta Accounts - methods: - list_okta_accounts: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_okta_accounts: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_okta_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_okta_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts~1{account_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_okta_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts~1{account_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_okta_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts~1{account_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_okta_account: - operation: - $ref: '#/paths/~1api~1v2~1integrations~1okta~1accounts~1{account_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/okta_accounts/methods/get_okta_account' - - $ref: '#/components/x-stackQL-resources/okta_accounts/methods/list_okta_accounts' - insert: - - $ref: '#/components/x-stackQL-resources/okta_accounts/methods/create_okta_account' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/okta_accounts/methods/delete_okta_account' -paths: - /api/v2/integrations/okta/accounts: - get: - description: List Okta accounts. - operationId: ListOktaAccounts - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OktaAccountsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List Okta accounts - tags: - - Okta Integration - post: - description: Create an Okta account. - operationId: CreateOktaAccount - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/OktaAccountRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/OktaAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Add Okta account - tags: - - Okta Integration - x-codegen-request-body-name: body - '/api/v2/integrations/okta/accounts/{account_id}': - delete: - description: Delete an Okta account. - operationId: DeleteOktaAccount - parameters: - - description: None - in: path - name: account_id - required: true - schema: - type: string - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete Okta account - tags: - - Okta Integration - get: - description: Get an Okta account. - operationId: GetOktaAccount - parameters: - - description: None - in: path - name: account_id - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OktaAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get Okta account - tags: - - Okta Integration - patch: - description: Update an Okta account. - operationId: UpdateOktaAccount - parameters: - - description: None - in: path - name: account_id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/OktaAccountUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OktaAccountResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update Okta account - tags: - - Okta Integration - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/opsgenie_integration.yaml b/providers/src/datadog/v00.00.00000/services/opsgenie_integration.yaml deleted file mode 100644 index d688d737..00000000 --- a/providers/src/datadog/v00.00.00000/services/opsgenie_integration.yaml +++ /dev/null @@ -1,1248 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - opsgenie_integration - description: Opsgenie_Integration -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - OpsgenieServicesResponse: - description: Response with a list of Opsgenie services. - properties: - data: - description: An array of Opsgenie services. - example: - - attributes: - custom_url: null - name: fake-opsgenie-service-name - region: us - id: 596da4af-0563-4097-90ff-07230c3f9db3 - type: opsgenie-service - - attributes: - custom_url: null - name: fake-opsgenie-service-name-2 - region: eu - id: 0d2937f1-b561-44fa-914a-99910f848014 - type: opsgenie-service - items: - $ref: '#/components/schemas/OpsgenieServiceResponseData' - type: array - required: - - data - type: object - OpsgenieServiceResponseData: - description: Opsgenie service data from a response. - properties: - attributes: - $ref: '#/components/schemas/OpsgenieServiceResponseAttributes' - id: - description: The ID of the Opsgenie service. - example: 596da4af-0563-4097-90ff-07230c3f9db3 - type: string - type: - $ref: '#/components/schemas/OpsgenieServiceType' - required: - - id - - type - - attributes - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - OpsgenieServiceResponseAttributes: - description: The attributes from an Opsgenie service response. - properties: - custom_url: - description: The custom URL for a custom region. - example: null - nullable: true - type: string - name: - description: The name for the Opsgenie service. - example: fake-opsgenie-service-name - type: string - region: - $ref: '#/components/schemas/OpsgenieServiceRegionType' - type: object - OpsgenieServiceType: - default: opsgenie-service - description: Opsgenie service resource type. - enum: - - opsgenie-service - example: opsgenie-service - type: string - x-enum-varnames: - - OPSGENIE_SERVICE - OpsgenieServiceRegionType: - description: The region for the Opsgenie service. - enum: - - us - - eu - - custom - example: us - type: string - x-enum-varnames: - - US - - EU - - CUSTOM - OpsgenieServiceCreateRequest: - description: Create request for an Opsgenie service. - properties: - data: - $ref: '#/components/schemas/OpsgenieServiceCreateData' - required: - - data - type: object - OpsgenieServiceResponse: - description: Response of an Opsgenie service. - properties: - data: - $ref: '#/components/schemas/OpsgenieServiceResponseData' - required: - - data - type: object - OpsgenieServiceCreateData: - description: Opsgenie service data for a create request. - properties: - attributes: - $ref: '#/components/schemas/OpsgenieServiceCreateAttributes' - type: - $ref: '#/components/schemas/OpsgenieServiceType' - required: - - type - - attributes - type: object - OpsgenieServiceCreateAttributes: - description: The Opsgenie service attributes for a create request. - properties: - custom_url: - description: The custom URL for a custom region. - example: 'https://example.com' - type: string - name: - description: The name for the Opsgenie service. - example: fake-opsgenie-service-name - type: string - opsgenie_api_key: - description: The Opsgenie API key for your Opsgenie service. - example: 00000000-0000-0000-0000-000000000000 - type: string - region: - $ref: '#/components/schemas/OpsgenieServiceRegionType' - required: - - name - - opsgenie_api_key - - region - type: object - OpsgenieServiceUpdateRequest: - description: Update request for an Opsgenie service. - properties: - data: - $ref: '#/components/schemas/OpsgenieServiceUpdateData' - required: - - data - type: object - OpsgenieServiceUpdateData: - description: Opsgenie service for an update request. - properties: - attributes: - $ref: '#/components/schemas/OpsgenieServiceUpdateAttributes' - id: - description: The ID of the Opsgenie service. - example: 596da4af-0563-4097-90ff-07230c3f9db3 - type: string - type: - $ref: '#/components/schemas/OpsgenieServiceType' - required: - - id - - type - - attributes - type: object - OpsgenieServiceUpdateAttributes: - description: The Opsgenie service attributes for an update request. - properties: - custom_url: - description: The custom URL for a custom region. - example: 'https://example.com' - nullable: true - type: string - name: - description: The name for the Opsgenie service. - example: fake-opsgenie-service-name - type: string - opsgenie_api_key: - description: The Opsgenie API key for your Opsgenie service. - example: 00000000-0000-0000-0000-000000000000 - type: string - region: - $ref: '#/components/schemas/OpsgenieServiceRegionType' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ConflictResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - opsgenie_services: - id: datadog.opsgenie_integration.opsgenie_services - name: opsgenie_services - title: Opsgenie Services - methods: - list_opsgenie_services: - operation: - $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_opsgenie_services: - operation: - $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_opsgenie_service: - operation: - $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_opsgenie_service: - operation: - $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services~1{integration_service_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_opsgenie_service: - operation: - $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services~1{integration_service_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_opsgenie_service: - operation: - $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services~1{integration_service_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_opsgenie_service: - operation: - $ref: '#/paths/~1api~1v2~1integration~1opsgenie~1services~1{integration_service_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/opsgenie_services/methods/get_opsgenie_service' - - $ref: '#/components/x-stackQL-resources/opsgenie_services/methods/list_opsgenie_services' - insert: - - $ref: '#/components/x-stackQL-resources/opsgenie_services/methods/create_opsgenie_service' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/opsgenie_services/methods/delete_opsgenie_service' -paths: - /api/v2/integration/opsgenie/services: - get: - description: Get a list of all services from the Datadog Opsgenie integration. - operationId: ListOpsgenieServices - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OpsgenieServicesResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get all service objects - tags: - - Opsgenie Integration - post: - description: Create a new service object in the Opsgenie integration. - operationId: CreateOpsgenieService - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/OpsgenieServiceCreateRequest' - description: Opsgenie service payload - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/OpsgenieServiceResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a new service object - tags: - - Opsgenie Integration - x-codegen-request-body-name: body - '/api/v2/integration/opsgenie/services/{integration_service_id}': - delete: - description: Delete a single service object in the Datadog Opsgenie integration. - operationId: DeleteOpsgenieService - parameters: - - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete a single service object - tags: - - Opsgenie Integration - get: - description: Get a single service from the Datadog Opsgenie integration. - operationId: GetOpsgenieService - parameters: - - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OpsgenieServiceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get a single service object - tags: - - Opsgenie Integration - patch: - description: Update a single service object in the Datadog Opsgenie integration. - operationId: UpdateOpsgenieService - parameters: - - $ref: '#/components/parameters/OpsgenieServiceIDPathParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/OpsgenieServiceUpdateRequest' - description: Opsgenie service payload. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OpsgenieServiceResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update a single service object - tags: - - Opsgenie Integration - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/organization.yaml b/providers/src/datadog/v00.00.00000/services/organization.yaml new file mode 100644 index 00000000..9dcd88bd --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/organization.yaml @@ -0,0 +1,10531 @@ +openapi: 3.0.0 +info: + title: organization API + description: datadog organization API + version: '1.0' +paths: + /api/v2/api_keys: + get: + description: List all API keys available for your account. + operationId: ListAPIKeys + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - $ref: '#/components/parameters/APIKeysSortParameter' + - $ref: '#/components/parameters/APIKeyFilterParameter' + - $ref: '#/components/parameters/APIKeyFilterCreatedAtStartParameter' + - $ref: '#/components/parameters/APIKeyFilterCreatedAtEndParameter' + - $ref: '#/components/parameters/APIKeyFilterModifiedAtStartParameter' + - $ref: '#/components/parameters/APIKeyFilterModifiedAtEndParameter' + - $ref: '#/components/parameters/APIKeyIncludeParameter' + - $ref: '#/components/parameters/APIKeyReadConfigReadEnabledParameter' + - $ref: '#/components/parameters/APIKeyCategoryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/APIKeysResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all API keys + tags: + - Key Management + x-permission: + operator: OR + permissions: + - api_keys_read + post: + description: Create an API key. + operationId: CreateAPIKey + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/APIKeyCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/APIKeyResponse' + description: Created + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create an API key + tags: + - Key Management + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - api_keys_write + /api/v2/api_keys/{api_key_id}: + delete: + description: Delete an API key. + operationId: DeleteAPIKey + parameters: + - $ref: '#/components/parameters/APIKeyId' + responses: + '204': + description: No Content + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete an API key + tags: + - Key Management + x-permission: + operator: OR + permissions: + - api_keys_delete + get: + description: Get an API key. + operationId: GetAPIKey + parameters: + - $ref: '#/components/parameters/APIKeyId' + - $ref: '#/components/parameters/APIKeyIncludeParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/APIKeyResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get API key + tags: + - Key Management + x-permission: + operator: OR + permissions: + - api_keys_read + patch: + description: Update an API key. + operationId: UpdateAPIKey + parameters: + - $ref: '#/components/parameters/APIKeyId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/APIKeyUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/APIKeyResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Edit an API key + tags: + - Key Management + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - api_keys_write + /api/v2/application_keys: + get: + description: List all application keys available for your org + operationId: ListApplicationKeys + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - $ref: '#/components/parameters/ApplicationKeysSortParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtStartParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtEndParameter' + - $ref: '#/components/parameters/ApplicationKeyIncludeParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListApplicationKeysResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all application keys + tags: + - Key Management + x-permission: + operator: OR + permissions: + - org_app_keys_read + /api/v2/application_keys/{app_key_id}: + delete: + description: Delete an application key + operationId: DeleteApplicationKey + parameters: + - $ref: '#/components/parameters/ApplicationKeyID' + responses: + '204': + description: No Content + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete an application key + tags: + - Key Management + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - org_app_keys_write + get: + description: Get an application key for your org. + operationId: GetApplicationKey + parameters: + - $ref: '#/components/parameters/ApplicationKeyID' + - $ref: '#/components/parameters/ApplicationKeyIncludeParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get an application key + tags: + - Key Management + x-permission: + operator: OR + permissions: + - org_app_keys_read + patch: + description: Edit an application key + operationId: UpdateApplicationKey + parameters: + - $ref: '#/components/parameters/ApplicationKeyID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Edit an application key + tags: + - Key Management + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - org_app_keys_write + /api/v2/audit/events: + get: + description: >- + List endpoint returns events that match a Audit Logs search query. + + [Results are paginated][1]. + + + Use this endpoint to see your latest Audit Logs events. + + + [1]: + https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination + operationId: ListAuditLogs + parameters: + - description: Search query following Audit Logs syntax. + example: '@type:session @application_id:xxxx' + in: query + name: filter[query] + required: false + schema: + type: string + - description: Minimum timestamp for requested events. + example: '2019-01-02T09:42:36.320Z' + in: query + name: filter[from] + required: false + schema: + format: date-time + type: string + - description: Maximum timestamp for requested events. + example: '2019-01-03T09:42:36.320Z' + in: query + name: filter[to] + required: false + schema: + format: date-time + type: string + - description: Order of events in results. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/AuditLogsSort' + - description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + in: query + name: page[cursor] + required: false + schema: + type: string + - description: Maximum number of events in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 10 + format: int32 + maximum: 1000 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AuditLogsEventsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a list of Audit Logs events + tags: + - Audit + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + x-permission: + operator: OR + permissions: + - audit_logs_read + /api/v2/audit/events/search: + post: + description: >- + List endpoint returns Audit Logs events that match an Audit search + query. + + [Results are paginated][1]. + + + Use this endpoint to build complex Audit Logs events filtering and + search. + + + [1]: + https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination + operationId: SearchAuditLogs + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AuditLogsSearchEventsRequest' + required: false + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AuditLogsEventsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Search Audit Logs events + tags: + - Audit + x-codegen-request-body-name: body + x-pagination: + cursorParam: body.page.cursor + cursorPath: meta.page.after + limitParam: body.page.limit + resultsPath: data + x-permission: + operator: OR + permissions: + - audit_logs_read + /api/v2/authn_mappings: + get: + description: List all AuthN Mappings in the org. + operationId: ListAuthNMappings + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - description: Sort AuthN Mappings depending on the given field. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/AuthNMappingsSort' + - description: Filter all mappings by the given string. + in: query + name: filter + required: false + schema: + type: string + - description: >- + Filter by mapping resource type. Defaults to "role" if not + specified. + in: query + name: resource_type + schema: + $ref: '#/components/schemas/AuthNMappingResourceType' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AuthNMappingsResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List all AuthN Mappings + tags: + - AuthN Mappings + x-permission: + operator: OR + permissions: + - user_access_read + post: + description: Create an AuthN Mapping. + operationId: CreateAuthNMapping + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AuthNMappingCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AuthNMappingResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create an AuthN Mapping + tags: + - AuthN Mappings + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + /api/v2/authn_mappings/{authn_mapping_id}: + delete: + description: Delete an AuthN Mapping specified by AuthN Mapping UUID. + operationId: DeleteAuthNMapping + parameters: + - $ref: '#/components/parameters/AuthNMappingID' + responses: + '204': + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete an AuthN Mapping + tags: + - AuthN Mappings + x-permission: + operator: OR + permissions: + - user_access_manage + get: + description: Get an AuthN Mapping specified by the AuthN Mapping UUID. + operationId: GetAuthNMapping + parameters: + - $ref: '#/components/parameters/AuthNMappingID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AuthNMappingResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get an AuthN Mapping by UUID + tags: + - AuthN Mappings + x-permission: + operator: OR + permissions: + - user_access_read + patch: + description: Edit an AuthN Mapping. + operationId: UpdateAuthNMapping + parameters: + - $ref: '#/components/parameters/AuthNMappingID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AuthNMappingUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AuthNMappingResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '409': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unprocessable Entity + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Edit an AuthN Mapping + tags: + - AuthN Mappings + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + /api/v2/current_user/application_keys: + get: + description: List all application keys available for current user + operationId: ListCurrentUserApplicationKeys + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - $ref: '#/components/parameters/ApplicationKeysSortParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtStartParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtEndParameter' + - $ref: '#/components/parameters/ApplicationKeyIncludeParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListApplicationKeysResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all application keys owned by current user + tags: + - Key Management + x-permission: + operator: OR + permissions: + - user_app_keys + post: + description: Create an application key for current user + operationId: CreateCurrentUserApplicationKey + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyResponse' + description: Created + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create an application key for current user + tags: + - Key Management + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_app_keys + /api/v2/current_user/application_keys/{app_key_id}: + delete: + description: Delete an application key owned by current user + operationId: DeleteCurrentUserApplicationKey + parameters: + - $ref: '#/components/parameters/ApplicationKeyID' + responses: + '204': + description: No Content + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete an application key owned by current user + tags: + - Key Management + x-permission: + operator: OR + permissions: + - user_app_keys + get: + description: Get an application key owned by current user + operationId: GetCurrentUserApplicationKey + parameters: + - $ref: '#/components/parameters/ApplicationKeyID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get one application key owned by current user + tags: + - Key Management + x-permission: + operator: OR + permissions: + - user_app_keys + patch: + description: Edit an application key owned by current user + operationId: UpdateCurrentUserApplicationKey + parameters: + - $ref: '#/components/parameters/ApplicationKeyID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Edit an application key owned by current user + tags: + - Key Management + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_app_keys + /api/v2/deletion/data/{product}: + post: + description: >- + Creates a data deletion request by providing a query and a timeframe + targeting the proper data. + operationId: CreateDataDeletionRequest + parameters: + - $ref: '#/components/parameters/ProductName' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateDataDeletionRequestBody' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CreateDataDeletionResponseBody' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '412': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Precondition failed error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + '500': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Internal server error + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Creates a data deletion request + tags: + - Data Deletion + x-permission: + operator: OR + permissions: + - rum_delete_data + - logs_delete_data + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/deletion/requests: + get: + description: >- + Gets a list of data deletion requests based on several filter + parameters. + operationId: GetDataDeletionRequests + parameters: + - description: >- + The next page of the previous search. If the next_page parameter is + included, the rest of the query elements are ignored. + example: cGFnZTI= + in: query + name: next_page + required: false + schema: + type: string + - description: Retrieve only the requests related to the given product. + example: logs + in: query + name: product + required: false + schema: + type: string + - description: Retrieve only the requests that matches the given query. + example: service:xyz host:abc + in: query + name: query + required: false + schema: + type: string + - description: Retrieve only the requests with the given status. + example: pending + in: query + name: status + required: false + schema: + type: string + - description: Sets the page size of the search. + example: '50' + in: query + name: page_size + required: false + schema: + default: 50 + format: int64 + maximum: 50 + minimum: 1 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetDataDeletionsResponseBody' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + '500': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Internal server error + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Gets a list of data deletion requests + tags: + - Data Deletion + x-permission: + operator: OR + permissions: + - rum_delete_data + - logs_delete_data + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/deletion/requests/{id}/cancel: + put: + description: Cancels a data deletion request by providing its ID. + operationId: CancelDataDeletionRequest + parameters: + - $ref: '#/components/parameters/RequestId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CancelDataDeletionResponseBody' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '412': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Precondition failed error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + '500': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Internal server error + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Cancels a data deletion request + tags: + - Data Deletion + x-permission: + operator: OR + permissions: + - rum_delete_data + - logs_delete_data + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/domain_allowlist: + get: + description: Get the domain allowlist for an organization. + operationId: GetDomainAllowlist + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DomainAllowlistResponse' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - org_management + - AuthZ: + - monitors_write + summary: Get Domain Allowlist + tags: + - Domain Allowlist + x-permission: + operator: OR + permissions: + - org_management + - monitors_write + - generate_dashboard_reports + - generate_log_reports + - manage_log_reports + patch: + description: Update the domain allowlist for an organization. + operationId: PatchDomainAllowlist + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DomainAllowlistRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DomainAllowlistResponse' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - org_management + - AuthZ: + - monitors_write + summary: Sets Domain Allowlist + tags: + - Domain Allowlist + x-permission: + operator: OR + permissions: + - org_management + - monitors_write + - generate_dashboard_reports + - generate_log_reports + - manage_log_reports + /api/v2/ip_allowlist: + get: + description: Returns the IP allowlist and its enabled or disabled state. + operationId: GetIPAllowlist + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IPAllowlistResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - org_management + summary: Get IP Allowlist + tags: + - IP Allowlist + x-permission: + operator: OR + permissions: + - org_management + patch: + description: Edit the entries in the IP allowlist, and enable or disable it. + operationId: UpdateIPAllowlist + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IPAllowlistUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IPAllowlistResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - org_management + summary: Update IP Allowlist + tags: + - IP Allowlist + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - org_management + /api/v2/org_configs: + get: + description: Returns all Org Configs (name, description, and value). + operationId: ListOrgConfigs + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConfigListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Org Configs + tags: + - Organizations + x-permission: + operator: OPEN + permissions: [] + /api/v2/org_configs/{org_config_name}: + get: + description: Return the name, description, and value of a specific Org Config. + operationId: GetOrgConfig + parameters: + - $ref: '#/components/parameters/OrgConfigName' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConfigGetResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a specific Org Config value + tags: + - Organizations + x-permission: + operator: OPEN + permissions: [] + patch: + description: Update the value of a specific Org Config. + operationId: UpdateOrgConfig + parameters: + - $ref: '#/components/parameters/OrgConfigName' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConfigWriteRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConfigGetResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a specific Org Config + tags: + - Organizations + x-permission: + operator: OR + permissions: + - org_management + /api/v2/org_connections: + get: + description: Returns a list of org connections. + operationId: ListOrgConnections + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConnectionListResponse' + description: OK + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - org_connections_read + summary: List Org Connections + tags: + - Org Connections + x-permission: + operator: OR + permissions: + - org_connections_read + post: + description: Create a new org connection between the current org and a target org. + operationId: CreateOrgConnections + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConnectionCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConnectionResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - org_connections_write + summary: Create Org Connection + tags: + - Org Connections + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - org_connections_write + /api/v2/org_connections/{connection_id}: + delete: + description: Delete an existing org connection. + operationId: DeleteOrgConnections + parameters: + - $ref: '#/components/parameters/OrgConnectionId' + responses: + '200': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - org_connections_write + summary: Delete Org Connection + tags: + - Org Connections + x-permission: + operator: OR + permissions: + - org_connections_write + patch: + description: Update an existing org connection. + operationId: UpdateOrgConnections + parameters: + - $ref: '#/components/parameters/OrgConnectionId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConnectionUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/OrgConnectionResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - org_connections_write + summary: Update Org Connection + tags: + - Org Connections + x-permission: + operator: OR + permissions: + - org_connections_write + /api/v2/permissions: + get: + description: Returns a list of all permissions, including name, description, and ID. + operationId: ListPermissions + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PermissionsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: List permissions + tags: + - Roles + x-permission: + operator: OR + permissions: + - user_access_read + /api/v2/restriction_policy/{resource_id}: + delete: + description: Deletes the restriction policy associated with a specified resource. + operationId: DeleteRestrictionPolicy + parameters: + - $ref: '#/components/parameters/ResourceID' + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Delete a restriction policy + tags: + - Restriction Policies + x-permission: + operator: OPEN + permissions: [] + get: + description: Retrieves the restriction policy associated with a specified resource. + operationId: GetRestrictionPolicy + parameters: + - $ref: '#/components/parameters/ResourceID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RestrictionPolicyResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get a restriction policy + tags: + - Restriction Policies + x-permission: + operator: OPEN + permissions: [] + post: + description: |- + Updates the restriction policy associated with a resource. + + #### Supported resources + Restriction policies can be applied to the following resources: + - Dashboards: `dashboard` + - Integration Services: `integration-service` + - Integration Webhooks: `integration-webhook` + - Notebooks: `notebook` + - Powerpacks: `powerpack` + - Reference Tables: `reference-table` + - Security Rules: `security-rule` + - Service Level Objectives: `slo` + - Synthetic Global Variables: `synthetics-global-variable` + - Synthetic Tests: `synthetics-test` + - Synthetic Private Locations: `synthetics-private-location` + - Monitors: `monitor` + - Workflows: `workflow` + - App Builder Apps: `app-builder-app` + - Connections: `connection` + - Connection Groups: `connection-group` + - RUM Applications: `rum-application` + - Cross Org Connections: `cross-org-connection` + - Spreadsheets: `spreadsheet` + - On-Call Schedules: `on-call-schedule` + - On-Call Escalation Policies: `on-call-escalation-policy` + - On-Call Team Routing Rules: `on-call-team-routing-rules` + + #### Supported relations for resources + Resource Type | Supported Relations + ----------------------------|-------------------------- + Dashboards | `viewer`, `editor` + Integration Services | `viewer`, `editor` + Integration Webhooks | `viewer`, `editor` + Notebooks | `viewer`, `editor` + Powerpacks | `viewer`, `editor` + Security Rules | `viewer`, `editor` + Service Level Objectives | `viewer`, `editor` + Synthetic Global Variables | `viewer`, `editor` + Synthetic Tests | `viewer`, `editor` + Synthetic Private Locations | `viewer`, `editor` + Monitors | `viewer`, `editor` + Reference Tables | `viewer`, `editor` + Workflows | `viewer`, `runner`, `editor` + App Builder Apps | `viewer`, `editor` + Connections | `viewer`, `resolver`, `editor` + Connection Groups | `viewer`, `editor` + RUM Application | `viewer`, `editor` + Cross Org Connections | `viewer`, `editor` + Spreadsheets | `viewer`, `editor` + On-Call Schedules | `viewer`, `overrider`, `editor` + On-Call Escalation Policies | `viewer`, `editor` + On-Call Team Routing Rules | `viewer`, `editor` + operationId: UpdateRestrictionPolicy + parameters: + - $ref: '#/components/parameters/ResourceID' + - description: >- + Allows admins (users with the `user_access_manage` permission) to + remove their own access from the resource if set to `true`. By + default, this is set to `false`, preventing admins from locking + themselves out. + in: query + name: allow_self_lockout + required: false + schema: + type: boolean + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RestrictionPolicyUpdateRequest' + description: Restriction policy payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RestrictionPolicyResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Update a restriction policy + tags: + - Restriction Policies + x-codegen-request-body-name: body + x-permission: + operator: OPEN + permissions: [] + /api/v2/roles: + get: + description: Returns all roles, including their names and their unique identifiers. + operationId: ListRoles + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - description: >- + Sort roles depending on the given field. Sort order is **ascending** + by default. + + Sort order is **descending** if the field is prefixed by a negative + sign, for example: + + `sort=-name`. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/RolesSort' + - description: Filter all roles by the given string. + in: query + name: filter + required: false + schema: + type: string + - description: Filter all roles by the given list of role IDs. + in: query + name: filter[id] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RolesResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: List roles + tags: + - Roles + x-permission: + operator: OR + permissions: + - user_access_read + post: + description: Create a new role for your organization. + operationId: CreateRole + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RoleCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RoleCreateResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Create role + tags: + - Roles + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + /api/v2/roles/{role_id}: + delete: + description: Disables a role. + operationId: DeleteRole + parameters: + - $ref: '#/components/parameters/RoleID' + responses: + '204': + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Delete role + tags: + - Roles + x-codegen-request-body-name: body + get: + description: Get a role in the organization specified by the role’s `role_id`. + operationId: GetRole + parameters: + - $ref: '#/components/parameters/RoleID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RoleResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: Get a role + tags: + - Roles + x-codegen-request-body-name: body + patch: + description: >- + Edit a role. Can only be used with application keys belonging to + administrators. + operationId: UpdateRole + parameters: + - $ref: '#/components/parameters/RoleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RoleUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RoleUpdateResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unprocessable Entity + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Update a role + tags: + - Roles + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + /api/v2/roles/{role_id}/clone: + post: + description: Clone an existing role + operationId: CloneRole + parameters: + - $ref: '#/components/parameters/RoleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RoleCloneRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/RoleResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '409': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Create a new role by cloning an existing role + tags: + - Roles + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + /api/v2/roles/{role_id}/permissions: + delete: + description: Removes a permission from a role. + operationId: RemovePermissionFromRole + parameters: + - $ref: '#/components/parameters/RoleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RelationshipToPermission' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PermissionsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Revoke permission + tags: + - Roles + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + get: + description: Returns a list of all permissions for a single role. + operationId: ListRolePermissions + parameters: + - $ref: '#/components/parameters/RoleID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PermissionsResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: List permissions for a role + tags: + - Roles + x-codegen-request-body-name: body + post: + description: Adds a permission to a role. + operationId: AddPermissionToRole + parameters: + - $ref: '#/components/parameters/RoleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RelationshipToPermission' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PermissionsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Grant permission to a role + tags: + - Roles + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + /api/v2/roles/{role_id}/users: + delete: + description: Removes a user from a role. + operationId: RemoveUserFromRole + parameters: + - $ref: '#/components/parameters/RoleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RelationshipToUser' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UsersResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Remove a user from a role + tags: + - Roles + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + get: + description: Gets all users of a role. + operationId: ListRoleUsers + parameters: + - $ref: '#/components/parameters/RoleID' + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - description: >- + User attribute to order results by. Sort order is **ascending** by + default. + + Sort order is **descending** if the field is prefixed by a negative + sign, + + for example `sort=-name`. Options: `name`, `email`, `status`. + in: query + name: sort + required: false + schema: + default: name + type: string + - description: Filter all users by the given string. Defaults to no filtering. + in: query + name: filter + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UsersResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: Get all users of a role + tags: + - Roles + post: + description: Adds a user to a role. + operationId: AddUserToRole + parameters: + - $ref: '#/components/parameters/RoleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RelationshipToUser' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UsersResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Add a user to a role + tags: + - Roles + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + /api/v2/saml_configurations/idp_metadata: + post: + description: >- + Endpoint for uploading IdP metadata for SAML setup. + + + Use this endpoint to upload or replace IdP metadata for SAML login + configuration. + operationId: UploadIdPMetadata + requestBody: + content: + multipart/form-data: + schema: + $ref: '#/components/schemas/IdPMetadataFormData' + required: true + responses: + '200': + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Upload IdP metadata + tags: + - Organizations + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - org_management + /api/v2/service_accounts: + post: + description: Create a service account for your organization. + operationId: CreateServiceAccount + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ServiceAccountCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/UserResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a service account + tags: + - Service Accounts + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - service_account_write + /api/v2/service_accounts/{service_account_id}/application_keys: + get: + description: List all application keys available for this service account. + operationId: ListServiceAccountApplicationKeys + parameters: + - $ref: '#/components/parameters/ServiceAccountID' + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - $ref: '#/components/parameters/ApplicationKeysSortParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtStartParameter' + - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtEndParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListApplicationKeysResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List application keys for this service account + tags: + - Service Accounts + x-permission: + operator: OR + permissions: + - service_account_write + post: + description: Create an application key for this service account. + operationId: CreateServiceAccountApplicationKey + parameters: + - $ref: '#/components/parameters/ServiceAccountID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyResponse' + description: Created + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create an application key for this service account + tags: + - Service Accounts + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - service_account_write + /api/v2/service_accounts/{service_account_id}/application_keys/{app_key_id}: + delete: + description: Delete an application key owned by this service account. + operationId: DeleteServiceAccountApplicationKey + parameters: + - $ref: '#/components/parameters/ServiceAccountID' + - $ref: '#/components/parameters/ApplicationKeyID' + responses: + '204': + description: No Content + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete an application key for this service account + tags: + - Service Accounts + x-permission: + operator: OR + permissions: + - service_account_write + get: + description: Get an application key owned by this service account. + operationId: GetServiceAccountApplicationKey + parameters: + - $ref: '#/components/parameters/ServiceAccountID' + - $ref: '#/components/parameters/ApplicationKeyID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PartialApplicationKeyResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get one application key for this service account + tags: + - Service Accounts + x-permission: + operator: OR + permissions: + - service_account_write + patch: + description: Edit an application key owned by this service account. + operationId: UpdateServiceAccountApplicationKey + parameters: + - $ref: '#/components/parameters/ServiceAccountID' + - $ref: '#/components/parameters/ApplicationKeyID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationKeyUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PartialApplicationKeyResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Edit an application key for this service account + tags: + - Service Accounts + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - service_account_write + /api/v2/team: + get: + description: >- + Get all teams. + + Can be used to search for teams using the `filter[keyword]` and + `filter[me]` query parameters. + operationId: ListTeams + parameters: + - $ref: '#/components/parameters/PageNumber' + - $ref: '#/components/parameters/PageSize' + - description: Specifies the order of the returned teams + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/ListTeamsSort' + - description: >- + Included related resources optionally requested. Allowed enum + values: `team_links, user_team_permissions` + in: query + name: include + required: false + schema: + items: + $ref: '#/components/schemas/ListTeamsInclude' + type: array + - description: Search query. Can be team name, team handle, or email of team member + in: query + name: filter[keyword] + required: false + schema: + type: string + - description: When true, only returns teams the current user belongs to + in: query + name: filter[me] + required: false + schema: + type: boolean + - description: List of fields that need to be fetched. + explode: false + in: query + name: fields[team] + required: false + schema: + items: + $ref: '#/components/schemas/TeamsField' + type: array + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamsResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Get all teams + tags: + - Teams + x-pagination: + limitParam: page[size] + pageParam: page[number] + resultsPath: data + x-permission: + operator: OR + permissions: + - teams_read + post: + description: >- + Create a new team. + + User IDs passed through the `users` relationship field are added to the + team. + operationId: CreateTeam + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/TeamCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamResponse' + description: CREATED + '403': + $ref: '#/components/responses/ForbiddenResponse' + '409': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + - teams_manage + summary: Create a team + tags: + - Teams + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - teams_read + - teams_manage + /api/v2/team/sync: + post: + description: >- + This endpoint attempts to link your existing Datadog teams with GitHub + teams by matching their names. + + It evaluates all current Datadog teams and compares them against teams + in the GitHub organization + + connected to your Datadog account, based on Datadog Team handle and + GitHub Team slug + + (lowercased and kebab-cased). + + + This operation is read-only on the GitHub side, no teams will be + modified or created. + + + [A GitHub organization must be connected to your Datadog + account](https://docs.datadoghq.com/integrations/github/), + + and the GitHub App integrated with Datadog must have the `Members Read` + permission. Matching is performed by comparing the Datadog team handle + to the GitHub team slug + + using a normalized exact match; case is ignored and spaces are removed. + No modifications are made + + to teams in GitHub. This will not create new Teams in Datadog. + operationId: SyncTeams + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/TeamSyncRequest' + required: true + responses: + '200': + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + '500': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Internal Server Error - Unexpected error during linking. + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_manage + summary: Link Teams with GitHub Teams + tags: + - Teams + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - teams_manage + x-unstable: >- + **Note**: This endpoint is in Preview. To request access, fill out this + [form](https://www.datadoghq.com/product-preview/github-integration-for-teams/). + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/team/{super_team_id}/member_teams: + get: + description: Get all member teams. + operationId: ListMemberTeams + parameters: + - description: None + in: path + name: super_team_id + required: true + schema: + type: string + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - description: List of fields that need to be fetched. + explode: false + in: query + name: fields[team] + required: false + schema: + items: + $ref: '#/components/schemas/TeamsField' + type: array + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamsResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Get all member teams + tags: + - Teams + x-pagination: + limitParam: page[size] + pageParam: page[number] + resultsPath: data + x-permission: + operator: OR + permissions: + - teams_read + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + post: + description: >- + Add a member team. + + Adds the team given by the `id` in the body as a member team of the + super team. + operationId: AddMemberTeam + parameters: + - description: None + in: path + name: super_team_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AddMemberTeamRequest' + required: true + responses: + '204': + description: Added + '403': + $ref: '#/components/responses/ForbiddenResponse' + '409': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Add a member team + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/team/{super_team_id}/member_teams/{member_team_id}: + delete: + description: Remove a super team's member team identified by `member_team_id`. + operationId: RemoveMemberTeam + parameters: + - description: None + in: path + name: super_team_id + required: true + schema: + type: string + - description: None + in: path + name: member_team_id + required: true + schema: + type: string + responses: + '204': + description: No Content + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Remove a member team + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read + x-unstable: |- + **Note**: This endpoint is in Preview. If you have any feedback, + contact [Datadog support](https://docs.datadoghq.com/help/). + /api/v2/team/{team_id}: + delete: + description: Remove a team using the team's `id`. + operationId: DeleteTeam + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + responses: + '204': + description: No Content + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + - teams_manage + summary: Remove a team + tags: + - Teams + x-permission: + operator: AND + permissions: + - teams_read + - teams_manage + get: + description: Get a single team using the team's `id`. + operationId: GetTeam + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Get a team + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read + patch: + description: >- + Update a team using the team's `id`. + + If the `team_links` relationship is present, the associated links are + updated to be in the order they appear in the array, and any existing + team links not present are removed. + operationId: UpdateTeam + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/TeamUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '409': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Update a team + tags: + - Teams + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - teams_read + /api/v2/team/{team_id}/links: + get: + description: Get all links for a given team. + operationId: GetTeamLinks + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamLinksResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Get links for a team + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read + post: + description: Add a new link to a team. + operationId: CreateTeamLink + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/TeamLinkCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamLinkResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Create a team link + tags: + - Teams + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - teams_read + /api/v2/team/{team_id}/links/{link_id}: + delete: + description: Remove a link from a team. + operationId: DeleteTeamLink + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + - description: None + in: path + name: link_id + required: true + schema: + type: string + responses: + '204': + description: No Content + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Remove a team link + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read + get: + description: Get a single link for a team. + operationId: GetTeamLink + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + - description: None + in: path + name: link_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamLinkResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Get a team link + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read + patch: + description: Update a team link. + operationId: UpdateTeamLink + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + - description: None + in: path + name: link_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/TeamLinkCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamLinkResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Update a team link + tags: + - Teams + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - teams_read + /api/v2/team/{team_id}/memberships: + get: + description: Get a paginated list of members for a team + operationId: GetTeamMemberships + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - description: Specifies the order of returned team memberships + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/GetTeamMembershipsSort' + - description: Search query, can be user email or name + in: query + name: filter[keyword] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UserTeamsResponse' + description: Represents a user's association to a team + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Get team memberships + tags: + - Teams + x-pagination: + limitParam: page[size] + pageParam: page[number] + resultsPath: data + x-permission: + operator: OR + permissions: + - teams_read + post: + description: Add a user to a team. + operationId: CreateTeamMembership + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UserTeamRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UserTeamResponse' + description: Represents a user's association to a team + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '409': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Add a user to a team + tags: + - Teams + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - teams_read + /api/v2/team/{team_id}/memberships/{user_id}: + delete: + description: Remove a user from a team. + operationId: DeleteTeamMembership + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + - description: None + in: path + name: user_id + required: true + schema: + type: string + responses: + '204': + description: No Content + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Remove a user from a team + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read + patch: + description: Update a user's membership attributes on a team. + operationId: UpdateTeamMembership + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + - description: None + in: path + name: user_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UserTeamUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UserTeamResponse' + description: Represents a user's association to a team + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Update a user's membership attributes on a team + tags: + - Teams + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - teams_read + /api/v2/team/{team_id}/permission-settings: + get: + description: Get all permission settings for a given team. + operationId: GetTeamPermissionSettings + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamPermissionSettingsResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Get permission settings for a team + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read + /api/v2/team/{team_id}/permission-settings/{action}: + put: + description: Update a team permission setting for a given team. + operationId: UpdateTeamPermissionSetting + parameters: + - description: None + in: path + name: team_id + required: true + schema: + type: string + - description: None + in: path + name: action + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/TeamPermissionSettingUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamPermissionSettingResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Update permission setting for team + tags: + - Teams + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - teams_read + /api/v2/usage/application_security: + get: + deprecated: true + description: >- + Get hourly usage for application security . + + **Note:** This endpoint has been deprecated. Hourly usage data for all + products is now available in the [Get hourly usage by product family + API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family) + operationId: GetUsageApplicationSecurityMonitoring + parameters: + - description: >- + Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` + for usage beginning at this hour. + in: query + name: start_hr + required: true + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` + for usage ending + + **before** this hour. + in: query + name: end_hr + required: false + schema: + format: date-time + type: string + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: >- + #/components/schemas/UsageApplicationSecurityMonitoringResponse + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + summary: Get hourly usage for application security + tags: + - Usage Metering + x-permission: + operator: OR + permissions: + - usage_read + /api/v2/usage/billing_dimension_mapping: + get: + description: >- + Get a mapping of billing dimensions to the corresponding keys for the + supported usage metering public API endpoints. + + Mapping data is updated on a monthly cadence. + + + This endpoint is only accessible to [parent-level + organizations](https://docs.datadoghq.com/account_management/multi_organization/). + operationId: GetBillingDimensionMapping + parameters: + - description: >- + Datetime in ISO-8601 format, UTC, and for mappings beginning this + month. Defaults to the current month. + in: query + name: filter[month] + required: false + schema: + format: date-time + type: string + - description: >- + String to specify whether to retrieve active billing dimension + mappings for the contract or for all available mappings. Allowed + views have the string `active` or `all`. Defaults to `active`. + in: query + name: filter[view] + required: false + schema: + default: active + type: string + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/BillingDimensionsMappingResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + summary: Get billing dimension mapping for usage endpoints + tags: + - Usage Metering + x-permission: + operator: OR + permissions: + - usage_read + /api/v2/usage/cost_by_org: + get: + deprecated: true + description: >- + Get cost across multi-org account. + + Cost by org data for a given month becomes available no later than the + 16th of the following month. + + **Note:** This endpoint has been deprecated. Please use the new endpoint + + [`/historical_cost`](https://docs.datadoghq.com/api/latest/usage-metering/#get-historical-cost-across-your-account) + + instead. + + + This endpoint is only accessible for [parent-level + organizations](https://docs.datadoghq.com/account_management/multi_organization/). + operationId: GetCostByOrg + parameters: + - description: >- + Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for + cost beginning this month. + in: query + name: start_month + required: true + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for + cost ending this month. + in: query + name: end_month + required: false + schema: + format: date-time + type: string + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/CostByOrgResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + - billing_read + summary: Get cost across multi-org account + tags: + - Usage Metering + x-permission: + operator: AND + permissions: + - usage_read + - billing_read + /api/v2/usage/estimated_cost: + get: + description: >- + Get estimated cost across multi-org and single root-org accounts. + + Estimated cost data is only available for the current month and previous + month + + and is delayed by up to 72 hours from when it was incurred. + + To access historical costs prior to this, use the `/historical_cost` + endpoint. + + + This endpoint is only accessible for [parent-level + organizations](https://docs.datadoghq.com/account_management/multi_organization/). + operationId: GetEstimatedCostByOrg + parameters: + - description: >- + String to specify whether cost is broken down at a parent-org level + or at the sub-org level. Available views are `summary` and + `sub-org`. Defaults to `summary`. + in: query + name: view + required: false + schema: + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for + cost beginning this month. **Either start_month or start_date should + be specified, but not both.** (start_month cannot go beyond two + months in the past). Provide an `end_month` to view month-over-month + cost. + in: query + name: start_month + required: false + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for + cost ending this month. + in: query + name: end_month + required: false + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for + cost beginning this day. **Either start_month or start_date should + be specified, but not both.** (start_date cannot go beyond two + months in the past). Provide an `end_date` to view day-over-day + cumulative cost. + in: query + name: start_date + required: false + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for + cost ending this day. + in: query + name: end_date + required: false + schema: + format: date-time + type: string + - description: >- + Boolean to specify whether to include accounts connected to the + current account as partner customers in the Datadog partner network + program. Defaults to `false`. + in: query + name: include_connected_accounts + required: false + schema: + default: false + type: boolean + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/CostByOrgResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + - billing_read + summary: Get estimated cost across your account + tags: + - Usage Metering + x-permission: + operator: AND + permissions: + - usage_read + - billing_read + /api/v2/usage/historical_cost: + get: + description: >- + Get historical cost across multi-org and single root-org accounts. + + Cost data for a given month becomes available no later than the 16th of + the following month. + + + This endpoint is only accessible for [parent-level + organizations](https://docs.datadoghq.com/account_management/multi_organization/). + operationId: GetHistoricalCostByOrg + parameters: + - description: >- + Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for + cost beginning this month. + in: query + name: start_month + required: true + schema: + format: date-time + type: string + - description: >- + String to specify whether cost is broken down at a parent-org level + or at the sub-org level. Available views are `summary` and + `sub-org`. Defaults to `summary`. + in: query + name: view + required: false + schema: + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for + cost ending this month. + in: query + name: end_month + required: false + schema: + format: date-time + type: string + - description: >- + Boolean to specify whether to include accounts connected to the + current account as partner customers in the Datadog partner network + program. Defaults to `false`. + in: query + name: include_connected_accounts + required: false + schema: + default: false + type: boolean + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/CostByOrgResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + - billing_read + summary: Get historical cost across your account + tags: + - Usage Metering + x-permission: + operator: AND + permissions: + - usage_read + - billing_read + /api/v2/usage/hourly_usage: + get: + description: Get hourly usage by product family. + operationId: GetHourlyUsage + parameters: + - description: >- + Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] + for usage beginning at this hour. + in: query + name: filter[timestamp][start] + required: true + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] + for usage ending **before** this hour. + in: query + name: filter[timestamp][end] + required: false + schema: + format: date-time + type: string + - description: >- + Comma separated list of product families to retrieve. Available + families are `all`, `analyzed_logs`, + + `application_security`, `audit_trail`, `serverless`, `ci_app`, + `cloud_cost_management`, `cloud_siem`, + + `csm_container_enterprise`, `csm_host_enterprise`, `cspm`, + `custom_events`, `cws`, `dbm`, `error_tracking`, + + `fargate`, `infra_hosts`, `incident_management`, `indexed_logs`, + `indexed_spans`, `ingested_spans`, `iot`, + + `lambda_traced_invocations`, `llm_observability`, `logs`, + `network_flows`, `network_hosts`, `network_monitoring`, + + `observability_pipelines`, `online_archive`, `profiling`, + `product_analytics`, `rum`, `rum_browser_sessions`, + + `rum_mobile_sessions`, `sds`, `snmp`, `software_delivery`, + `synthetics_api`, `synthetics_browser`, + + `synthetics_mobile`, `synthetics_parallel_testing`, `timeseries`, + `vuln_management` and `workflow_executions`. + + The following product family has been **deprecated**: `audit_logs`. + in: query + name: filter[product_families] + required: true + schema: + type: string + - description: Include child org usage in the response. Defaults to false. + in: query + name: filter[include_descendants] + required: false + schema: + default: false + type: boolean + - description: >- + Boolean to specify whether to include accounts connected to the + current account as partner customers in the Datadog partner network + program. Defaults to false. + in: query + name: filter[include_connected_accounts] + required: false + schema: + default: false + type: boolean + - description: >- + Include breakdown of usage by subcategories where applicable (for + product family logs only). Defaults to false. + in: query + name: filter[include_breakdown] + required: false + schema: + default: false + type: boolean + - description: >- + Comma separated list of product family versions to use in the format + `product_family:version`. For example, + + `infra_hosts:1.0.0`. If this parameter is not used, the API will use + the latest version of each requested + + product family. Currently all families have one version `1.0.0`. + in: query + name: filter[versions] + required: false + schema: + type: string + - description: >- + Maximum number of results to return (between 1 and 500) - defaults + to 500 if limit not specified. + in: query + name: page[limit] + required: false + schema: + default: 500 + format: int32 + maximum: 500 + minimum: 1 + type: integer + - description: >- + List following results with a next_record_id provided in the + previous query. + in: query + name: page[next_record_id] + required: false + schema: + type: string + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/HourlyUsageResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + summary: Get hourly usage by product family + tags: + - Usage Metering + x-permission: + operator: OR + permissions: + - usage_read + /api/v2/usage/lambda_traced_invocations: + get: + deprecated: true + description: >- + Get hourly usage for Lambda traced invocations. + + **Note:** This endpoint has been deprecated.. Hourly usage data for all + products is now available in the [Get hourly usage by product family + API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family) + operationId: GetUsageLambdaTracedInvocations + parameters: + - description: >- + Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` + for usage beginning at this hour. + in: query + name: start_hr + required: true + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` + for usage ending + + **before** this hour. + in: query + name: end_hr + required: false + schema: + format: date-time + type: string + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/UsageLambdaTracedInvocationsResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + summary: Get hourly usage for Lambda traced invocations + tags: + - Usage Metering + x-permission: + operator: OR + permissions: + - usage_read + /api/v2/usage/observability_pipelines: + get: + deprecated: true + description: >- + Get hourly usage for observability pipelines. + + **Note:** This endpoint has been deprecated. Hourly usage data for all + products is now available in the [Get hourly usage by product family + API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family) + operationId: GetUsageObservabilityPipelines + parameters: + - description: >- + Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` + for usage beginning at this hour. + in: query + name: start_hr + required: true + schema: + format: date-time + type: string + - description: >- + Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` + for usage ending + + **before** this hour. + in: query + name: end_hr + required: false + schema: + format: date-time + type: string + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/UsageObservabilityPipelinesResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + summary: Get hourly usage for observability pipelines + tags: + - Usage Metering + x-permission: + operator: OR + permissions: + - usage_read + /api/v2/usage/projected_cost: + get: + description: >- + Get projected cost across multi-org and single root-org accounts. + + Projected cost data is only available for the current month and becomes + available around the 12th of the month. + + + This endpoint is only accessible for [parent-level + organizations](https://docs.datadoghq.com/account_management/multi_organization/). + operationId: GetProjectedCost + parameters: + - description: >- + String to specify whether cost is broken down at a parent-org level + or at the sub-org level. Available views are `summary` and + `sub-org`. Defaults to `summary`. + in: query + name: view + required: false + schema: + type: string + - description: >- + Boolean to specify whether to include accounts connected to the + current account as partner customers in the Datadog partner network + program. Defaults to `false`. + in: query + name: include_connected_accounts + required: false + schema: + default: false + type: boolean + responses: + '200': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/ProjectedCostResponse' + description: OK + '400': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden - User is not authorized + '429': + content: + application/json;datetime-format=rfc3339: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - usage_read + - billing_read + summary: Get projected cost across your account + tags: + - Usage Metering + x-permission: + operator: AND + permissions: + - usage_read + - billing_read + /api/v2/user_invitations: + post: + description: >- + Sends emails to one or more users inviting them to join the + organization. + operationId: SendInvitations + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UserInvitationsRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/UserInvitationsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_invite + summary: Send invitation emails + tags: + - Users + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_invite + /api/v2/user_invitations/{user_invitation_uuid}: + get: + description: Returns a single user invitation by its UUID. + operationId: GetInvitation + parameters: + - description: The UUID of the user invitation. + in: path + name: user_invitation_uuid + required: true + schema: + example: 00000000-0000-0000-3456-000000000000 + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UserInvitationResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_invite + summary: Get a user invitation + tags: + - Users + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_invite + /api/v2/users: + get: + description: |- + Get the list of all users in the organization. This list includes + all users even if they are deactivated or unverified. + operationId: ListUsers + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - description: >- + User attribute to order results by. Sort order is ascending by + default. + + Sort order is descending if the field + + is prefixed by a negative sign, for example `sort=-name`. Options: + `name`, + + `modified_at`, `user_count`. + in: query + name: sort + required: false + schema: + default: name + example: name + type: string + - description: 'Direction of sort. Options: `asc`, `desc`.' + in: query + name: sort_dir + required: false + schema: + $ref: '#/components/schemas/QuerySortOrder' + - description: Filter all users by the given string. Defaults to no filtering. + in: query + name: filter + required: false + schema: + type: string + - description: >- + Filter on status attribute. + + Comma separated list, with possible values `Active`, `Pending`, and + `Disabled`. + + Defaults to no filtering. + in: query + name: filter[status] + required: false + schema: + example: Active + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UsersResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: List all users + tags: + - Users + x-codegen-request-body-name: body + x-pagination: + limitParam: page[size] + pageParam: page[number] + resultsPath: data + x-permission: + operator: OR + permissions: + - user_access_read + post: + description: Create a user for your organization. + operationId: CreateUser + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UserCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/UserResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_invite + summary: Create a user + tags: + - Users + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_invite + /api/v2/users/{user_id}: + delete: + description: |- + Disable a user. Can only be used with an application key belonging + to an administrator user. + operationId: DisableUser + parameters: + - $ref: '#/components/parameters/UserID' + responses: + '204': + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Disable a user + tags: + - Users + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + - service_account_write + get: + description: Get a user in the organization specified by the user’s `user_id`. + operationId: GetUser + parameters: + - $ref: '#/components/parameters/UserID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UserResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: Get user details + tags: + - Users + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_read + patch: + description: |- + Edit a user. Can only be used with an application key belonging + to an administrator user. + operationId: UpdateUser + parameters: + - $ref: '#/components/parameters/UserID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UserUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UserResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unprocessable Entity + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_manage + summary: Update a user + tags: + - Users + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_manage + - service_account_write + /api/v2/users/{user_id}/orgs: + get: + description: >- + Get a user organization. Returns the user information and all + organizations + + joined by this user. + operationId: ListUserOrganizations + parameters: + - $ref: '#/components/parameters/UserID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UserResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get a user organization + tags: + - Users + x-codegen-request-body-name: body + x-permission: + operator: OPEN + permissions: [] + /api/v2/users/{user_id}/permissions: + get: + description: |- + Get a user permission set. Returns a list of the user’s permissions + granted by the associated user's roles. + operationId: ListUserPermissions + parameters: + - $ref: '#/components/parameters/UserID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/PermissionsResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication error + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - user_access_read + summary: Get a user permissions + tags: + - Users + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - user_access_read + /api/v2/users/{user_uuid}/memberships: + get: + description: Get a list of memberships for a user + operationId: GetUserMemberships + parameters: + - description: None + in: path + name: user_uuid + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UserTeamsResponse' + description: Represents a user's association to a team + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - teams_read + summary: Get user memberships + tags: + - Teams + x-permission: + operator: OR + permissions: + - teams_read +components: + schemas: + APIKeysResponse: + description: Response for a list of API keys. + properties: + data: + description: Array of API keys. + items: + $ref: '#/components/schemas/PartialAPIKey' + type: array + included: + description: Array of objects related to the API key. + items: + $ref: '#/components/schemas/APIKeyResponseIncludedItem' + type: array + meta: + $ref: '#/components/schemas/APIKeysResponseMeta' + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + APIKeyCreateRequest: + description: Request used to create an API key. + properties: + data: + $ref: '#/components/schemas/APIKeyCreateData' + required: + - data + type: object + APIKeyResponse: + description: Response for retrieving an API key. + properties: + data: + $ref: '#/components/schemas/FullAPIKey' + included: + description: Array of objects related to the API key. + items: + $ref: '#/components/schemas/APIKeyResponseIncludedItem' + type: array + type: object + APIKeyUpdateRequest: + description: Request used to update an API key. + properties: + data: + $ref: '#/components/schemas/APIKeyUpdateData' + required: + - data + type: object + ListApplicationKeysResponse: + description: Response for a list of application keys. + properties: + data: + description: Array of application keys. + items: + $ref: '#/components/schemas/PartialApplicationKey' + type: array + included: + description: Array of objects related to the application key. + items: + $ref: '#/components/schemas/ApplicationKeyResponseIncludedItem' + type: array + meta: + $ref: '#/components/schemas/ApplicationKeyResponseMeta' + type: object + ApplicationKeyResponse: + description: Response for retrieving an application key. + properties: + data: + $ref: '#/components/schemas/FullApplicationKey' + included: + description: Array of objects related to the application key. + items: + $ref: '#/components/schemas/ApplicationKeyResponseIncludedItem' + type: array + type: object + ApplicationKeyUpdateRequest: + description: Request used to update an application key. + properties: + data: + $ref: '#/components/schemas/ApplicationKeyUpdateData' + required: + - data + type: object + AuditLogsSort: + description: Sort parameters when querying events. + enum: + - timestamp + - '-timestamp' + type: string + x-enum-varnames: + - TIMESTAMP_ASCENDING + - TIMESTAMP_DESCENDING + AuditLogsEventsResponse: + description: >- + Response object with all events matching the request and pagination + information. + properties: + data: + description: Array of events matching the request. + items: + $ref: '#/components/schemas/AuditLogsEvent' + type: array + links: + $ref: '#/components/schemas/AuditLogsResponseLinks' + meta: + $ref: '#/components/schemas/AuditLogsResponseMetadata' + type: object + AuditLogsSearchEventsRequest: + description: The request for a Audit Logs events list. + properties: + filter: + $ref: '#/components/schemas/AuditLogsQueryFilter' + options: + $ref: '#/components/schemas/AuditLogsQueryOptions' + page: + $ref: '#/components/schemas/AuditLogsQueryPageOptions' + sort: + $ref: '#/components/schemas/AuditLogsSort' + type: object + AuthNMappingsSort: + description: Sorting options for AuthN Mappings. + enum: + - created_at + - '-created_at' + - role_id + - '-role_id' + - saml_assertion_attribute_id + - '-saml_assertion_attribute_id' + - role.name + - '-role.name' + - saml_assertion_attribute.attribute_key + - '-saml_assertion_attribute.attribute_key' + - saml_assertion_attribute.attribute_value + - '-saml_assertion_attribute.attribute_value' + type: string + x-enum-varnames: + - CREATED_AT_ASCENDING + - CREATED_AT_DESCENDING + - ROLE_ID_ASCENDING + - ROLE_ID_DESCENDING + - SAML_ASSERTION_ATTRIBUTE_ID_ASCENDING + - SAML_ASSERTION_ATTRIBUTE_ID_DESCENDING + - ROLE_NAME_ASCENDING + - ROLE_NAME_DESCENDING + - SAML_ASSERTION_ATTRIBUTE_KEY_ASCENDING + - SAML_ASSERTION_ATTRIBUTE_KEY_DESCENDING + - SAML_ASSERTION_ATTRIBUTE_VALUE_ASCENDING + - SAML_ASSERTION_ATTRIBUTE_VALUE_DESCENDING + AuthNMappingResourceType: + description: The type of resource being mapped to. + enum: + - role + - team + type: string + x-enum-varnames: + - ROLE + - TEAM + AuthNMappingsResponse: + description: Array of AuthN Mappings response. + properties: + data: + description: Array of returned AuthN Mappings. + items: + $ref: '#/components/schemas/AuthNMapping' + type: array + included: + description: Included data in the AuthN Mapping response. + items: + $ref: '#/components/schemas/AuthNMappingIncluded' + type: array + meta: + $ref: '#/components/schemas/ResponseMetaAttributes' + type: object + AuthNMappingCreateRequest: + description: Request for creating an AuthN Mapping. + properties: + data: + $ref: '#/components/schemas/AuthNMappingCreateData' + required: + - data + type: object + AuthNMappingResponse: + description: AuthN Mapping response from the API. + properties: + data: + $ref: '#/components/schemas/AuthNMapping' + included: + description: Included data in the AuthN Mapping response. + items: + $ref: '#/components/schemas/AuthNMappingIncluded' + type: array + type: object + AuthNMappingUpdateRequest: + description: Request to update an AuthN Mapping. + properties: + data: + $ref: '#/components/schemas/AuthNMappingUpdateData' + required: + - data + type: object + ApplicationKeyCreateRequest: + description: Request used to create an application key. + properties: + data: + $ref: '#/components/schemas/ApplicationKeyCreateData' + required: + - data + type: object + CreateDataDeletionRequestBody: + description: Object needed to create a data deletion request. + properties: + data: + $ref: '#/components/schemas/CreateDataDeletionRequestBodyData' + required: + - data + type: object + CreateDataDeletionResponseBody: + description: The response from the create data deletion request endpoint. + properties: + data: + $ref: '#/components/schemas/DataDeletionResponseItem' + meta: + $ref: '#/components/schemas/DataDeletionResponseMeta' + type: object + GetDataDeletionsResponseBody: + description: The response from the get data deletion requests endpoint. + properties: + data: + description: The list of data deletion requests that matches the query. + items: + $ref: '#/components/schemas/DataDeletionResponseItem' + type: array + meta: + $ref: '#/components/schemas/DataDeletionResponseMeta' + type: object + CancelDataDeletionResponseBody: + description: The response from the cancel data deletion request endpoint. + properties: + data: + $ref: '#/components/schemas/DataDeletionResponseItem' + meta: + $ref: '#/components/schemas/DataDeletionResponseMeta' + type: object + DomainAllowlistResponse: + description: Response containing information about the email domain allowlist. + properties: + data: + $ref: '#/components/schemas/DomainAllowlistResponseData' + type: object + DomainAllowlistRequest: + description: Request containing the desired email domain allowlist configuration. + properties: + data: + $ref: '#/components/schemas/DomainAllowlist' + required: + - data + type: object + IPAllowlistResponse: + description: Response containing information about the IP allowlist. + properties: + data: + $ref: '#/components/schemas/IPAllowlistData' + type: object + IPAllowlistUpdateRequest: + description: Update the IP allowlist. + properties: + data: + $ref: '#/components/schemas/IPAllowlistData' + required: + - data + type: object + OrgConfigListResponse: + description: A response with multiple Org Configs. + properties: + data: + description: An array of Org Configs. + items: + $ref: '#/components/schemas/OrgConfigRead' + type: array + required: + - data + type: object + OrgConfigGetResponse: + description: A response with a single Org Config. + properties: + data: + $ref: '#/components/schemas/OrgConfigRead' + required: + - data + type: object + OrgConfigWriteRequest: + description: A request to update an Org Config. + properties: + data: + $ref: '#/components/schemas/OrgConfigWrite' + required: + - data + type: object + OrgConnectionListResponse: + description: Response containing a list of org connections. + properties: + data: + description: List of org connections. + items: + $ref: '#/components/schemas/OrgConnection' + type: array + meta: + $ref: '#/components/schemas/OrgConnectionListResponseMeta' + required: + - data + type: object + OrgConnectionCreateRequest: + description: Request to create an org connection. + properties: + data: + $ref: '#/components/schemas/OrgConnectionCreate' + required: + - data + type: object + OrgConnectionResponse: + description: Response containing a single org connection. + properties: + data: + $ref: '#/components/schemas/OrgConnection' + required: + - data + type: object + OrgConnectionUpdateRequest: + description: Request to update an org connection. + properties: + data: + $ref: '#/components/schemas/OrgConnectionUpdate' + required: + - data + type: object + PermissionsResponse: + description: Payload with API-returned permissions. + properties: + data: + description: Array of permissions. + items: + $ref: '#/components/schemas/Permission' + type: array + type: object + RestrictionPolicyResponse: + description: Response containing information about a single restriction policy. + properties: + data: + $ref: '#/components/schemas/RestrictionPolicy' + required: + - data + type: object + RestrictionPolicyUpdateRequest: + description: Update request for a restriction policy. + properties: + data: + $ref: '#/components/schemas/RestrictionPolicy' + required: + - data + type: object + RolesSort: + default: name + description: Sorting options for roles. + enum: + - name + - '-name' + - modified_at + - '-modified_at' + - user_count + - '-user_count' + type: string + x-enum-varnames: + - NAME_ASCENDING + - NAME_DESCENDING + - MODIFIED_AT_ASCENDING + - MODIFIED_AT_DESCENDING + - USER_COUNT_ASCENDING + - USER_COUNT_DESCENDING + RolesResponse: + description: Response containing information about multiple roles. + properties: + data: + description: Array of returned roles. + items: + $ref: '#/components/schemas/Role' + type: array + meta: + $ref: '#/components/schemas/ResponseMetaAttributes' + type: object + RoleCreateRequest: + description: Create a role. + properties: + data: + $ref: '#/components/schemas/RoleCreateData' + required: + - data + type: object + RoleCreateResponse: + description: Response containing information about a created role. + properties: + data: + $ref: '#/components/schemas/RoleCreateResponseData' + type: object + RoleResponse: + description: Response containing information about a single role. + properties: + data: + $ref: '#/components/schemas/Role' + type: object + RoleUpdateRequest: + description: Update a role. + properties: + data: + $ref: '#/components/schemas/RoleUpdateData' + required: + - data + type: object + RoleUpdateResponse: + description: Response containing information about an updated role. + properties: + data: + $ref: '#/components/schemas/RoleUpdateResponseData' + type: object + RoleCloneRequest: + description: Request to create a role by cloning an existing role. + properties: + data: + $ref: '#/components/schemas/RoleClone' + required: + - data + type: object + RelationshipToPermission: + description: Relationship to a permissions object. + properties: + data: + $ref: '#/components/schemas/RelationshipToPermissionData' + type: object + RelationshipToUser: + description: Relationship to user. + properties: + data: + $ref: '#/components/schemas/RelationshipToUserData' + required: + - data + type: object + UsersResponse: + description: Response containing information about multiple users. + properties: + data: + description: Array of returned users. + items: + $ref: '#/components/schemas/User' + type: array + included: + description: Array of objects related to the users. + items: + $ref: '#/components/schemas/UserResponseIncludedItem' + type: array + meta: + $ref: '#/components/schemas/ResponseMetaAttributes' + readOnly: true + type: object + IdPMetadataFormData: + description: The form data submitted to upload IdP metadata + properties: + idp_file: + description: The IdP metadata XML file + format: binary + type: string + x-mimetype: application/xml + type: object + ServiceAccountCreateRequest: + description: Create a service account. + properties: + data: + $ref: '#/components/schemas/ServiceAccountCreateData' + required: + - data + type: object + UserResponse: + description: Response containing information about a single user. + properties: + data: + $ref: '#/components/schemas/User' + included: + description: Array of objects related to the user. + items: + $ref: '#/components/schemas/UserResponseIncludedItem' + type: array + type: object + PartialApplicationKeyResponse: + description: Response for retrieving a partial application key. + properties: + data: + $ref: '#/components/schemas/PartialApplicationKey' + included: + description: Array of objects related to the application key. + items: + $ref: '#/components/schemas/ApplicationKeyResponseIncludedItem' + type: array + type: object + ListTeamsSort: + description: Specifies the order of the returned teams + enum: + - name + - '-name' + - user_count + - '-user_count' + type: string + x-enum-varnames: + - NAME + - _NAME + - USER_COUNT + - _USER_COUNT + ListTeamsInclude: + description: Included related resources optionally requested. + enum: + - team_links + - user_team_permissions + type: string + x-enum-varnames: + - TEAM_LINKS + - USER_TEAM_PERMISSIONS + TeamsField: + description: Supported teams field. + enum: + - id + - name + - handle + - summary + - description + - avatar + - banner + - visible_modules + - hidden_modules + - created_at + - modified_at + - user_count + - link_count + - team_links + - user_team_permissions + type: string + x-enum-varnames: + - ID + - NAME + - HANDLE + - SUMMARY + - DESCRIPTION + - AVATAR + - BANNER + - VISIBLE_MODULES + - HIDDEN_MODULES + - CREATED_AT + - MODIFIED_AT + - USER_COUNT + - LINK_COUNT + - TEAM_LINKS + - USER_TEAM_PERMISSIONS + TeamsResponse: + description: Response with multiple teams + properties: + data: + description: Teams response data + items: + $ref: '#/components/schemas/Team' + type: array + included: + description: Resources related to the team + items: + $ref: '#/components/schemas/TeamIncluded' + type: array + links: + $ref: '#/components/schemas/TeamsResponseLinks' + meta: + $ref: '#/components/schemas/TeamsResponseMeta' + type: object + TeamCreateRequest: + description: Request to create a team + properties: + data: + $ref: '#/components/schemas/TeamCreate' + required: + - data + type: object + TeamResponse: + description: Response with a team + properties: + data: + $ref: '#/components/schemas/Team' + type: object + TeamSyncRequest: + description: Team sync request. + example: + data: + attributes: + source: github + type: link + type: team_sync_bulk + properties: + data: + $ref: '#/components/schemas/TeamSyncData' + required: + - data + type: object + AddMemberTeamRequest: + description: Request to add a member team to super team's hierarchy + properties: + data: + $ref: '#/components/schemas/MemberTeam' + required: + - data + type: object + TeamUpdateRequest: + description: Team update request + properties: + data: + $ref: '#/components/schemas/TeamUpdate' + required: + - data + type: object + TeamLinksResponse: + description: Team links response + properties: + data: + description: Team links response data + items: + $ref: '#/components/schemas/TeamLink' + type: array + type: object + TeamLinkCreateRequest: + description: Team link create request + properties: + data: + $ref: '#/components/schemas/TeamLinkCreate' + required: + - data + type: object + TeamLinkResponse: + description: Team link response + properties: + data: + $ref: '#/components/schemas/TeamLink' + type: object + GetTeamMembershipsSort: + description: Specifies the order of returned team memberships + enum: + - manager_name + - '-manager_name' + - name + - '-name' + - handle + - '-handle' + - email + - '-email' + type: string + x-enum-varnames: + - MANAGER_NAME + - _MANAGER_NAME + - NAME + - _NAME + - HANDLE + - _HANDLE + - EMAIL + - _EMAIL + UserTeamsResponse: + description: Team memberships response + properties: + data: + description: Team memberships response data + items: + $ref: '#/components/schemas/UserTeam' + type: array + included: + description: Resources related to the team memberships + items: + $ref: '#/components/schemas/UserTeamIncluded' + type: array + links: + $ref: '#/components/schemas/TeamsResponseLinks' + meta: + $ref: '#/components/schemas/TeamsResponseMeta' + type: object + UserTeamRequest: + description: Team membership request + properties: + data: + $ref: '#/components/schemas/UserTeamCreate' + required: + - data + type: object + UserTeamResponse: + description: Team membership response + properties: + data: + $ref: '#/components/schemas/UserTeam' + included: + description: Resources related to the team memberships + items: + $ref: '#/components/schemas/UserTeamIncluded' + type: array + type: object + UserTeamUpdateRequest: + description: Team membership request + properties: + data: + $ref: '#/components/schemas/UserTeamUpdate' + required: + - data + type: object + TeamPermissionSettingsResponse: + description: Team permission settings response + properties: + data: + description: Team permission settings response data + items: + $ref: '#/components/schemas/TeamPermissionSetting' + type: array + type: object + TeamPermissionSettingUpdateRequest: + description: Team permission setting update request + properties: + data: + $ref: '#/components/schemas/TeamPermissionSettingUpdate' + required: + - data + type: object + TeamPermissionSettingResponse: + description: Team permission setting response + properties: + data: + $ref: '#/components/schemas/TeamPermissionSetting' + type: object + UsageApplicationSecurityMonitoringResponse: + description: Application Security Monitoring usage response. + properties: + data: + description: Response containing Application Security Monitoring usage. + items: + $ref: '#/components/schemas/UsageDataObject' + type: array + type: object + BillingDimensionsMappingResponse: + description: Billing dimensions mapping response. + properties: + data: + $ref: '#/components/schemas/BillingDimensionsMappingBody' + type: object + CostByOrgResponse: + description: Chargeback Summary response. + properties: + data: + description: Response containing Chargeback Summary. + items: + $ref: '#/components/schemas/CostByOrg' + type: array + type: object + HourlyUsageResponse: + description: Hourly usage response. + properties: + data: + description: Response containing hourly usage. + items: + $ref: '#/components/schemas/HourlyUsage' + type: array + meta: + $ref: '#/components/schemas/HourlyUsageMetadata' + type: object + UsageLambdaTracedInvocationsResponse: + description: Lambda Traced Invocations usage response. + properties: + data: + description: Response containing Lambda Traced Invocations usage. + items: + $ref: '#/components/schemas/UsageDataObject' + type: array + type: object + UsageObservabilityPipelinesResponse: + description: Observability Pipelines usage response. + properties: + data: + description: Response containing Observability Pipelines usage. + items: + $ref: '#/components/schemas/UsageDataObject' + type: array + type: object + ProjectedCostResponse: + description: Projected Cost response. + properties: + data: + description: Response containing Projected Cost. + items: + $ref: '#/components/schemas/ProjectedCost' + type: array + type: object + UserInvitationsRequest: + description: Object to invite users to join the organization. + properties: + data: + description: List of user invitations. + example: [] + items: + $ref: '#/components/schemas/UserInvitationData' + type: array + required: + - data + type: object + UserInvitationsResponse: + description: User invitations as returned by the API. + properties: + data: + description: Array of user invitations. + items: + $ref: '#/components/schemas/UserInvitationResponseData' + type: array + type: object + UserInvitationResponse: + description: User invitation as returned by the API. + properties: + data: + $ref: '#/components/schemas/UserInvitationResponseData' + type: object + QuerySortOrder: + default: desc + description: Direction of sort. + enum: + - asc + - desc + type: string + x-enum-varnames: + - ASC + - DESC + UserCreateRequest: + description: Create a user. + properties: + data: + $ref: '#/components/schemas/UserCreateData' + required: + - data + type: object + UserUpdateRequest: + description: Update a user. + properties: + data: + $ref: '#/components/schemas/UserUpdateData' + required: + - data + type: object + APIKeysSort: + default: name + description: Sorting options + enum: + - created_at + - '-created_at' + - last4 + - '-last4' + - modified_at + - '-modified_at' + - name + - '-name' + type: string + x-enum-varnames: + - CREATED_AT_ASCENDING + - CREATED_AT_DESCENDING + - LAST4_ASCENDING + - LAST4_DESCENDING + - MODIFIED_AT_ASCENDING + - MODIFIED_AT_DESCENDING + - NAME_ASCENDING + - NAME_DESCENDING + PartialAPIKey: + description: Partial Datadog API key. + properties: + attributes: + $ref: '#/components/schemas/PartialAPIKeyAttributes' + id: + description: ID of the API key. + type: string + relationships: + $ref: '#/components/schemas/APIKeyRelationships' + type: + $ref: '#/components/schemas/APIKeysType' + type: object + APIKeyResponseIncludedItem: + description: An object related to an API key. + oneOf: + - $ref: '#/components/schemas/User' + - $ref: '#/components/schemas/LeakedKey' + APIKeysResponseMeta: + description: Additional information related to api keys response. + properties: + max_allowed: + description: Max allowed number of API keys. + format: int64 + type: integer + page: + $ref: '#/components/schemas/APIKeysResponseMetaPage' + type: object + APIKeyCreateData: + description: Object used to create an API key. + properties: + attributes: + $ref: '#/components/schemas/APIKeyCreateAttributes' + type: + $ref: '#/components/schemas/APIKeysType' + required: + - attributes + - type + type: object + FullAPIKey: + description: Datadog API key. + properties: + attributes: + $ref: '#/components/schemas/FullAPIKeyAttributes' + id: + description: ID of the API key. + type: string + relationships: + $ref: '#/components/schemas/APIKeyRelationships' + type: + $ref: '#/components/schemas/APIKeysType' + type: object + APIKeyUpdateData: + description: Object used to update an API key. + properties: + attributes: + $ref: '#/components/schemas/APIKeyUpdateAttributes' + id: + description: ID of the API key. + example: 00112233-4455-6677-8899-aabbccddeeff + type: string + type: + $ref: '#/components/schemas/APIKeysType' + required: + - attributes + - id + - type + type: object + ApplicationKeysSort: + default: name + description: Sorting options + enum: + - created_at + - '-created_at' + - last4 + - '-last4' + - name + - '-name' + type: string + x-enum-varnames: + - CREATED_AT_ASCENDING + - CREATED_AT_DESCENDING + - LAST4_ASCENDING + - LAST4_DESCENDING + - NAME_ASCENDING + - NAME_DESCENDING + PartialApplicationKey: + description: Partial Datadog application key. + properties: + attributes: + $ref: '#/components/schemas/PartialApplicationKeyAttributes' + id: + description: ID of the application key. + type: string + relationships: + $ref: '#/components/schemas/ApplicationKeyRelationships' + type: + $ref: '#/components/schemas/ApplicationKeysType' + type: object + ApplicationKeyResponseIncludedItem: + description: An object related to an application key. + oneOf: + - $ref: '#/components/schemas/User' + - $ref: '#/components/schemas/Role' + - $ref: '#/components/schemas/LeakedKey' + ApplicationKeyResponseMeta: + description: Additional information related to the application key response. + properties: + max_allowed_per_user: + description: Max allowed number of application keys per user. + format: int64 + type: integer + page: + $ref: '#/components/schemas/ApplicationKeyResponseMetaPage' + type: object + FullApplicationKey: + description: Datadog application key. + properties: + attributes: + $ref: '#/components/schemas/FullApplicationKeyAttributes' + id: + description: ID of the application key. + type: string + relationships: + $ref: '#/components/schemas/ApplicationKeyRelationships' + type: + $ref: '#/components/schemas/ApplicationKeysType' + type: object + ApplicationKeyUpdateData: + description: Object used to update an application key. + properties: + attributes: + $ref: '#/components/schemas/ApplicationKeyUpdateAttributes' + id: + description: ID of the application key. + example: 00112233-4455-6677-8899-aabbccddeeff + type: string + type: + $ref: '#/components/schemas/ApplicationKeysType' + required: + - attributes + - id + - type + type: object + AuditLogsEvent: + description: >- + Object description of an Audit Logs event after it is processed and + stored by Datadog. + properties: + attributes: + $ref: '#/components/schemas/AuditLogsEventAttributes' + id: + description: Unique ID of the event. + example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA + type: string + type: + $ref: '#/components/schemas/AuditLogsEventType' + type: object + AuditLogsResponseLinks: + description: Links attributes. + properties: + next: + description: >- + Link for the next set of results. Note that the request can also be + made using the + + POST endpoint. + example: >- + https://app.datadoghq.com/api/v2/audit/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + AuditLogsResponseMetadata: + description: The metadata associated with a request. + properties: + elapsed: + description: Time elapsed in milliseconds. + example: 132 + format: int64 + type: integer + page: + $ref: '#/components/schemas/AuditLogsResponsePage' + request_id: + description: The identifier of the request. + example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR + type: string + status: + $ref: '#/components/schemas/AuditLogsResponseStatus' + warnings: + description: >- + A list of warnings (non-fatal errors) encountered. Partial results + may return if + + warnings are present in the response. + items: + $ref: '#/components/schemas/AuditLogsWarning' + type: array + type: object + AuditLogsQueryFilter: + description: Search and filter query settings. + properties: + from: + default: now-15m + description: >- + Minimum time for the requested events. Supports date, math, and + regular timestamps (in milliseconds). + example: now-15m + type: string + query: + default: '*' + description: Search query following the Audit Logs search syntax. + example: '@type:session AND @session.type:user' + type: string + to: + default: now + description: >- + Maximum time for the requested events. Supports date, math, and + regular timestamps (in milliseconds). + example: now + type: string + type: object + AuditLogsQueryOptions: + description: >- + Global query options that are used during the query. + + Note: Specify either timezone or time offset, not both. Otherwise, the + query fails. + properties: + time_offset: + description: Time offset (in seconds) to apply to the query. + format: int64 + type: integer + timezone: + default: UTC + description: >- + The timezone can be specified as GMT, UTC, an offset from UTC (like + UTC+1), or as a Timezone Database identifier (like + America/New_York). + example: GMT + type: string + type: object + AuditLogsQueryPageOptions: + description: Paging attributes for listing events. + properties: + cursor: + description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + limit: + default: 10 + description: Maximum number of events in the response. + example: 25 + format: int32 + maximum: 1000 + type: integer + type: object + AuthNMapping: + description: The AuthN Mapping object returned by API. + properties: + attributes: + $ref: '#/components/schemas/AuthNMappingAttributes' + id: + description: ID of the AuthN Mapping. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + relationships: + $ref: '#/components/schemas/AuthNMappingRelationships' + type: + $ref: '#/components/schemas/AuthNMappingsType' + required: + - id + - type + type: object + AuthNMappingIncluded: + description: Included data in the AuthN Mapping response. + oneOf: + - $ref: '#/components/schemas/SAMLAssertionAttribute' + - $ref: '#/components/schemas/Role' + - $ref: '#/components/schemas/AuthNMappingTeam' + ResponseMetaAttributes: + description: Object describing meta attributes of response. + properties: + page: + $ref: '#/components/schemas/Pagination' + type: object + AuthNMappingCreateData: + description: Data for creating an AuthN Mapping. + properties: + attributes: + $ref: '#/components/schemas/AuthNMappingCreateAttributes' + relationships: + $ref: '#/components/schemas/AuthNMappingCreateRelationships' + type: + $ref: '#/components/schemas/AuthNMappingsType' + required: + - type + type: object + AuthNMappingUpdateData: + description: Data for updating an AuthN Mapping. + properties: + attributes: + $ref: '#/components/schemas/AuthNMappingUpdateAttributes' + id: + description: ID of the AuthN Mapping. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + relationships: + $ref: '#/components/schemas/AuthNMappingUpdateRelationships' + type: + $ref: '#/components/schemas/AuthNMappingsType' + required: + - id + - type + type: object + ApplicationKeyCreateData: + description: Object used to create an application key. + properties: + attributes: + $ref: '#/components/schemas/ApplicationKeyCreateAttributes' + type: + $ref: '#/components/schemas/ApplicationKeysType' + required: + - attributes + - type + type: object + CreateDataDeletionRequestBodyData: + description: Data needed to create a data deletion request. + properties: + attributes: + $ref: '#/components/schemas/CreateDataDeletionRequestBodyAttributes' + type: + $ref: '#/components/schemas/CreateDataDeletionRequestBodyDataType' + required: + - attributes + - type + type: object + DataDeletionResponseItem: + description: The created data deletion request information. + properties: + attributes: + $ref: '#/components/schemas/DataDeletionResponseItemAttributes' + id: + description: The ID of the created data deletion request. + example: '1' + type: string + type: + description: The type of the request created. + example: deletion_request + type: string + required: + - id + - type + - attributes + type: object + DataDeletionResponseMeta: + description: The metadata of the data deletion response. + properties: + count_product: + additionalProperties: + format: int64 + type: integer + description: The total deletion requests created by product. + example: + logs: 8 + rum: 7 + type: object + count_status: + additionalProperties: + format: int64 + type: integer + description: The total deletion requests created by status. + example: + completed: 10 + pending: 5 + type: object + next_page: + description: >- + The next page when searching deletion requests created in the + current organization. + example: cGFnZTI= + type: string + product: + description: The product of the deletion request. + example: logs + type: string + request_status: + description: The status of the executed request. + example: canceled + type: string + type: object + DomainAllowlistResponseData: + description: The email domain allowlist response for an org. + properties: + attributes: + $ref: '#/components/schemas/DomainAllowlistResponseDataAttributes' + id: + description: The unique identifier of the org. + nullable: true + type: string + type: + $ref: '#/components/schemas/DomainAllowlistType' + required: + - type + type: object + DomainAllowlist: + description: The email domain allowlist for an org. + properties: + attributes: + $ref: '#/components/schemas/DomainAllowlistAttributes' + id: + description: The unique identifier of the org. + nullable: true + type: string + type: + $ref: '#/components/schemas/DomainAllowlistType' + required: + - type + type: object + IPAllowlistData: + description: IP allowlist data. + properties: + attributes: + $ref: '#/components/schemas/IPAllowlistAttributes' + id: + description: The unique identifier of the org. + type: string + type: + $ref: '#/components/schemas/IPAllowlistType' + required: + - type + type: object + OrgConfigRead: + description: A single Org Config. + properties: + attributes: + $ref: '#/components/schemas/OrgConfigReadAttributes' + id: + description: A unique identifier for an Org Config. + example: abcd1234 + type: string + type: + $ref: '#/components/schemas/OrgConfigType' + required: + - id + - type + - attributes + type: object + OrgConfigWrite: + description: An Org Config write operation. + properties: + attributes: + $ref: '#/components/schemas/OrgConfigWriteAttributes' + type: + $ref: '#/components/schemas/OrgConfigType' + required: + - type + - attributes + type: object + OrgConnection: + description: An org connection. + properties: + attributes: + $ref: '#/components/schemas/OrgConnectionAttributes' + id: + description: The unique identifier of the org connection. + example: f9ec96b0-8c8a-4b0a-9b0a-1b2c3d4e5f6a + format: uuid + type: string + relationships: + $ref: '#/components/schemas/OrgConnectionRelationships' + type: + $ref: '#/components/schemas/OrgConnectionType' + required: + - id + - type + - attributes + - relationships + type: object + OrgConnectionListResponseMeta: + description: Pagination metadata. + properties: + page: + $ref: '#/components/schemas/OrgConnectionListResponseMetaPage' + type: object + OrgConnectionCreate: + description: Org connection creation data. + properties: + attributes: + $ref: '#/components/schemas/OrgConnectionCreateAttributes' + relationships: + $ref: '#/components/schemas/OrgConnectionCreateRelationships' + type: + $ref: '#/components/schemas/OrgConnectionType' + required: + - type + - attributes + - relationships + type: object + OrgConnectionUpdate: + description: Org connection update data. + properties: + attributes: + $ref: '#/components/schemas/OrgConnectionUpdateAttributes' + id: + description: The unique identifier of the org connection. + example: f9ec96b0-8c8a-4b0a-9b0a-1b2c3d4e5f6a + format: uuid + type: string + type: + $ref: '#/components/schemas/OrgConnectionType' + required: + - type + - id + - attributes + type: object + Permission: + description: Permission object. + properties: + attributes: + $ref: '#/components/schemas/PermissionAttributes' + id: + description: ID of the permission. + type: string + type: + $ref: '#/components/schemas/PermissionsType' + required: + - type + type: object + RestrictionPolicy: + description: Restriction policy object. + properties: + attributes: + $ref: '#/components/schemas/RestrictionPolicyAttributes' + id: + description: >- + The identifier, always equivalent to the value specified in the + `resource_id` path parameter. + example: dashboard:abc-def-ghi + type: string + type: + $ref: '#/components/schemas/RestrictionPolicyType' + required: + - type + - id + - attributes + type: object + Role: + description: Role object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/RoleAttributes' + id: + description: The unique identifier of the role. + type: string + relationships: + $ref: '#/components/schemas/RoleResponseRelationships' + type: + $ref: '#/components/schemas/RolesType' + required: + - type + type: object + RoleCreateData: + description: Data related to the creation of a role. + properties: + attributes: + $ref: '#/components/schemas/RoleCreateAttributes' + relationships: + $ref: '#/components/schemas/RoleRelationships' + type: + $ref: '#/components/schemas/RolesType' + required: + - attributes + type: object + RoleCreateResponseData: + description: Role object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/RoleCreateAttributes' + id: + description: The unique identifier of the role. + type: string + relationships: + $ref: '#/components/schemas/RoleResponseRelationships' + type: + $ref: '#/components/schemas/RolesType' + required: + - type + type: object + RoleUpdateData: + description: Data related to the update of a role. + properties: + attributes: + $ref: '#/components/schemas/RoleUpdateAttributes' + id: + description: The unique identifier of the role. + example: 00000000-0000-1111-0000-000000000000 + type: string + relationships: + $ref: '#/components/schemas/RoleRelationships' + type: + $ref: '#/components/schemas/RolesType' + required: + - attributes + - type + - id + type: object + RoleUpdateResponseData: + description: Role object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/RoleUpdateAttributes' + id: + description: The unique identifier of the role. + type: string + relationships: + $ref: '#/components/schemas/RoleResponseRelationships' + type: + $ref: '#/components/schemas/RolesType' + required: + - type + type: object + RoleClone: + description: Data for the clone role request. + properties: + attributes: + $ref: '#/components/schemas/RoleCloneAttributes' + type: + $ref: '#/components/schemas/RolesType' + required: + - type + - attributes + type: object + RelationshipToPermissionData: + description: Relationship to permission object. + properties: + id: + description: ID of the permission. + type: string + type: + $ref: '#/components/schemas/PermissionsType' + type: object + RelationshipToUserData: + description: Relationship to user object. + properties: + id: + description: A unique identifier that represents the user. + example: 00000000-0000-0000-2345-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + required: + - id + - type + type: object + User: + description: User object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/UserAttributes' + id: + description: ID of the user. + type: string + relationships: + $ref: '#/components/schemas/UserResponseRelationships' + type: + $ref: '#/components/schemas/UsersType' + type: object + UserResponseIncludedItem: + description: An object related to a user. + oneOf: + - $ref: '#/components/schemas/Organization' + - $ref: '#/components/schemas/Permission' + - $ref: '#/components/schemas/Role' + ServiceAccountCreateData: + description: Object to create a service account User. + properties: + attributes: + $ref: '#/components/schemas/ServiceAccountCreateAttributes' + relationships: + $ref: '#/components/schemas/UserRelationships' + type: + $ref: '#/components/schemas/UsersType' + required: + - attributes + - type + type: object + Team: + description: A team + properties: + attributes: + $ref: '#/components/schemas/TeamAttributes' + id: + description: The team's identifier + example: aeadc05e-98a8-11ec-ac2c-da7ad0900001 + type: string + relationships: + $ref: '#/components/schemas/TeamRelationships' + type: + $ref: '#/components/schemas/TeamType' + required: + - attributes + - id + - type + type: object + TeamIncluded: + description: Included resources related to the team + oneOf: + - $ref: '#/components/schemas/User' + - $ref: '#/components/schemas/TeamLink' + - $ref: '#/components/schemas/UserTeamPermission' + TeamsResponseLinks: + description: Teams response links. + properties: + first: + description: First link. + type: string + last: + description: Last link. + nullable: true + type: string + next: + description: Next link. + type: string + prev: + description: Previous link. + nullable: true + type: string + self: + description: Current link. + type: string + type: object + TeamsResponseMeta: + description: Teams response metadata. + properties: + pagination: + $ref: '#/components/schemas/TeamsResponseMetaPagination' + type: object + TeamCreate: + description: Team create + properties: + attributes: + $ref: '#/components/schemas/TeamCreateAttributes' + relationships: + $ref: '#/components/schemas/TeamCreateRelationships' + type: + $ref: '#/components/schemas/TeamType' + required: + - attributes + - type + type: object + TeamSyncData: + description: Team sync data. + properties: + attributes: + $ref: '#/components/schemas/TeamSyncAttributes' + type: + $ref: '#/components/schemas/TeamSyncBulkType' + required: + - attributes + - type + type: object + MemberTeam: + description: A member team + properties: + id: + description: The member team's identifier + example: aeadc05e-98a8-11ec-ac2c-da7ad0900001 + type: string + type: + $ref: '#/components/schemas/MemberTeamType' + required: + - id + - type + type: object + TeamUpdate: + description: Team update request + properties: + attributes: + $ref: '#/components/schemas/TeamUpdateAttributes' + relationships: + $ref: '#/components/schemas/TeamUpdateRelationships' + type: + $ref: '#/components/schemas/TeamType' + required: + - attributes + - type + type: object + TeamLink: + description: Team link + properties: + attributes: + $ref: '#/components/schemas/TeamLinkAttributes' + id: + description: The team link's identifier + example: b8626d7e-cedd-11eb-abf5-da7ad0900001 + type: string + type: + $ref: '#/components/schemas/TeamLinkType' + required: + - attributes + - id + - type + type: object + TeamLinkCreate: + description: Team link create + properties: + attributes: + $ref: '#/components/schemas/TeamLinkAttributes' + type: + $ref: '#/components/schemas/TeamLinkType' + required: + - attributes + - type + type: object + UserTeam: + description: A user's relationship with a team + properties: + attributes: + $ref: '#/components/schemas/UserTeamAttributes' + id: + description: The ID of a user's relationship with a team + example: TeamMembership-aeadc05e-98a8-11ec-ac2c-da7ad0900001-38835 + type: string + relationships: + $ref: '#/components/schemas/UserTeamRelationships' + type: + $ref: '#/components/schemas/UserTeamType' + required: + - id + - type + type: object + UserTeamIncluded: + description: Included resources related to the team membership + oneOf: + - $ref: '#/components/schemas/User' + - $ref: '#/components/schemas/Team' + UserTeamCreate: + description: A user's relationship with a team + properties: + attributes: + $ref: '#/components/schemas/UserTeamAttributes' + relationships: + $ref: '#/components/schemas/UserTeamRelationships' + type: + $ref: '#/components/schemas/UserTeamType' + required: + - type + type: object + UserTeamUpdate: + description: A user's relationship with a team + properties: + attributes: + $ref: '#/components/schemas/UserTeamAttributes' + type: + $ref: '#/components/schemas/UserTeamType' + required: + - type + type: object + TeamPermissionSetting: + description: Team permission setting + properties: + attributes: + $ref: '#/components/schemas/TeamPermissionSettingAttributes' + id: + description: The team permission setting's identifier + example: TeamPermission-aeadc05e-98a8-11ec-ac2c-da7ad0900001-edit + type: string + type: + $ref: '#/components/schemas/TeamPermissionSettingType' + required: + - id + - type + type: object + TeamPermissionSettingUpdate: + description: Team permission setting update + properties: + attributes: + $ref: '#/components/schemas/TeamPermissionSettingUpdateAttributes' + type: + $ref: '#/components/schemas/TeamPermissionSettingType' + required: + - type + type: object + UsageDataObject: + description: Usage data. + properties: + attributes: + $ref: '#/components/schemas/UsageAttributesObject' + id: + description: Unique ID of the response. + type: string + type: + $ref: '#/components/schemas/UsageTimeSeriesType' + type: object + BillingDimensionsMappingBody: + description: Billing dimensions mapping data. + items: + $ref: '#/components/schemas/BillingDimensionsMappingBodyItem' + type: array + CostByOrg: + description: Cost data. + properties: + attributes: + $ref: '#/components/schemas/CostByOrgAttributes' + id: + description: Unique ID of the response. + type: string + type: + $ref: '#/components/schemas/CostByOrgType' + type: object + HourlyUsage: + description: Hourly usage for a product family for an org. + properties: + attributes: + $ref: '#/components/schemas/HourlyUsageAttributes' + id: + description: Unique ID of the response. + type: string + type: + $ref: '#/components/schemas/UsageTimeSeriesType' + type: object + HourlyUsageMetadata: + description: The object containing document metadata. + properties: + pagination: + $ref: '#/components/schemas/HourlyUsagePagination' + type: object + ProjectedCost: + description: Projected Cost data. + properties: + attributes: + $ref: '#/components/schemas/ProjectedCostAttributes' + id: + description: Unique ID of the response. + type: string + type: + $ref: '#/components/schemas/ProjectedCostType' + type: object + UserInvitationData: + description: Object to create a user invitation. + properties: + relationships: + $ref: '#/components/schemas/UserInvitationRelationships' + type: + $ref: '#/components/schemas/UserInvitationsType' + required: + - type + - relationships + type: object + UserInvitationResponseData: + description: Object of a user invitation returned by the API. + properties: + attributes: + $ref: '#/components/schemas/UserInvitationDataAttributes' + id: + description: ID of the user invitation. + type: string + relationships: + $ref: '#/components/schemas/UserInvitationRelationships' + type: + $ref: '#/components/schemas/UserInvitationsType' + type: object + UserCreateData: + description: Object to create a user. + properties: + attributes: + $ref: '#/components/schemas/UserCreateAttributes' + relationships: + $ref: '#/components/schemas/UserRelationships' + type: + $ref: '#/components/schemas/UsersType' + required: + - attributes + - type + type: object + UserUpdateData: + description: Object to update a user. + properties: + attributes: + $ref: '#/components/schemas/UserUpdateAttributes' + id: + description: ID of the user. + example: 00000000-0000-feed-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + required: + - attributes + - type + - id + type: object + PartialAPIKeyAttributes: + description: Attributes of a partial API key. + properties: + category: + description: The category of the API key. + type: string + created_at: + description: Creation date of the API key. + example: '2020-11-23T10:00:00.000Z' + readOnly: true + type: string + last4: + description: The last four characters of the API key. + example: abcd + maxLength: 4 + minLength: 4 + readOnly: true + type: string + modified_at: + description: Date the API key was last modified. + example: '2020-11-23T10:00:00.000Z' + readOnly: true + type: string + name: + description: Name of the API key. + example: API Key for submitting metrics + type: string + remote_config_read_enabled: + description: The remote config read enabled status. + type: boolean + type: object + APIKeyRelationships: + description: Resources related to the API key. + properties: + created_by: + $ref: '#/components/schemas/RelationshipToUser' + modified_by: + $ref: '#/components/schemas/NullableRelationshipToUser' + type: object + APIKeysType: + default: api_keys + description: API Keys resource type. + enum: + - api_keys + example: api_keys + type: string + x-enum-varnames: + - API_KEYS + LeakedKey: + description: The definition of LeakedKey object. + properties: + attributes: + $ref: '#/components/schemas/LeakedKeyAttributes' + id: + description: The LeakedKey id. + example: id + type: string + type: + $ref: '#/components/schemas/LeakedKeyType' + required: + - attributes + - id + - type + type: object + APIKeysResponseMetaPage: + description: Additional information related to the API keys response. + properties: + total_filtered_count: + description: Total filtered application key count. + format: int64 + type: integer + type: object + APIKeyCreateAttributes: + description: Attributes used to create an API Key. + properties: + category: + description: The APIKeyCreateAttributes category. + type: string + name: + description: Name of the API key. + example: API Key for submitting metrics + type: string + remote_config_read_enabled: + description: The APIKeyCreateAttributes remote_config_read_enabled. + type: boolean + required: + - name + type: object + FullAPIKeyAttributes: + description: Attributes of a full API key. + properties: + category: + description: The category of the API key. + type: string + created_at: + description: Creation date of the API key. + example: '2020-11-23T10:00:00.000Z' + format: date-time + readOnly: true + type: string + key: + description: The API key. + readOnly: true + type: string + last4: + description: The last four characters of the API key. + example: abcd + maxLength: 4 + minLength: 4 + readOnly: true + type: string + modified_at: + description: Date the API key was last modified. + example: '2020-11-23T10:00:00.000Z' + format: date-time + readOnly: true + type: string + name: + description: Name of the API key. + example: API Key for submitting metrics + type: string + remote_config_read_enabled: + description: The remote config read enabled status. + type: boolean + type: object + APIKeyUpdateAttributes: + description: Attributes used to update an API Key. + properties: + category: + description: The APIKeyUpdateAttributes category. + type: string + name: + description: Name of the API key. + example: API Key for submitting metrics + type: string + remote_config_read_enabled: + description: The APIKeyUpdateAttributes remote_config_read_enabled. + type: boolean + required: + - name + type: object + PartialApplicationKeyAttributes: + description: Attributes of a partial application key. + properties: + created_at: + description: Creation date of the application key. + example: '2020-11-23T10:00:00.000Z' + readOnly: true + type: string + last4: + description: The last four characters of the application key. + example: abcd + maxLength: 4 + minLength: 4 + readOnly: true + type: string + name: + description: Name of the application key. + example: Application Key for managing dashboards + type: string + scopes: + description: Array of scopes to grant the application key. + example: + - dashboards_read + - dashboards_write + - dashboards_public_share + items: + description: Name of scope. + type: string + nullable: true + type: array + type: object + ApplicationKeyRelationships: + description: Resources related to the application key. + properties: + owned_by: + $ref: '#/components/schemas/RelationshipToUser' + type: object + ApplicationKeysType: + default: application_keys + description: Application Keys resource type. + enum: + - application_keys + example: application_keys + type: string + x-enum-varnames: + - APPLICATION_KEYS + ApplicationKeyResponseMetaPage: + description: Additional information related to the application key response. + properties: + total_filtered_count: + description: Total filtered application key count. + format: int64 + type: integer + type: object + FullApplicationKeyAttributes: + description: Attributes of a full application key. + properties: + created_at: + description: Creation date of the application key. + example: '2020-11-23T10:00:00.000Z' + format: date-time + readOnly: true + type: string + key: + description: The application key. + readOnly: true + type: string + last4: + description: The last four characters of the application key. + example: abcd + maxLength: 4 + minLength: 4 + readOnly: true + type: string + name: + description: Name of the application key. + example: Application Key for managing dashboards + type: string + scopes: + description: Array of scopes to grant the application key. + example: + - dashboards_read + - dashboards_write + - dashboards_public_share + items: + description: Name of scope. + type: string + nullable: true + type: array + type: object + ApplicationKeyUpdateAttributes: + description: Attributes used to update an application Key. + properties: + name: + description: Name of the application key. + example: Application Key for managing dashboards + type: string + scopes: + description: Array of scopes to grant the application key. + example: + - dashboards_read + - dashboards_write + - dashboards_public_share + items: + description: Name of scope. + type: string + nullable: true + type: array + type: object + AuditLogsEventAttributes: + description: JSON object containing all event attributes and their associated values. + properties: + attributes: + additionalProperties: {} + description: JSON object of attributes from Audit Logs events. + example: + customAttribute: 123 + duration: 2345 + type: object + message: + description: Message of the event. + type: string + service: + description: >- + Name of the application or service generating Audit Logs events. + + This name is used to correlate Audit Logs to APM, so make sure you + specify the same + + value when you use both products. + example: web-app + type: string + tags: + description: Array of tags associated with your event. + example: + - team:A + items: + description: Tag associated with your event. + type: string + type: array + timestamp: + description: Timestamp of your event. + example: '2019-01-02T09:42:36.320Z' + format: date-time + type: string + type: object + AuditLogsEventType: + default: audit + description: Type of the event. + enum: + - audit + example: audit + type: string + x-enum-varnames: + - Audit + AuditLogsResponsePage: + description: Paging attributes. + properties: + after: + description: >- + The cursor to use to get the next results, if any. To make the next + request, use the same parameters with the addition of + `page[cursor]`. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + AuditLogsResponseStatus: + description: The status of the response. + enum: + - done + - timeout + example: done + type: string + x-enum-varnames: + - DONE + - TIMEOUT + AuditLogsWarning: + description: Warning message indicating something that went wrong with the query. + properties: + code: + description: Unique code for this type of warning. + example: unknown_index + type: string + detail: + description: Detailed explanation of this specific warning. + example: 'indexes: foo, bar' + type: string + title: + description: Short human-readable summary of the warning. + example: >- + One or several indexes are missing or invalid, results hold data + from the other indexes + type: string + type: object + AuthNMappingAttributes: + description: Attributes of AuthN Mapping. + properties: + attribute_key: + description: >- + Key portion of a key/value pair of the attribute sent from the + Identity Provider. + example: member-of + type: string + attribute_value: + description: >- + Value portion of a key/value pair of the attribute sent from the + Identity Provider. + example: Development + type: string + created_at: + description: Creation time of the AuthN Mapping. + format: date-time + readOnly: true + type: string + modified_at: + description: Time of last AuthN Mapping modification. + format: date-time + readOnly: true + type: string + saml_assertion_attribute_id: + description: The ID of the SAML assertion attribute. + example: '0' + type: string + type: object + AuthNMappingRelationships: + description: All relationships associated with AuthN Mapping. + properties: + role: + $ref: '#/components/schemas/RelationshipToRole' + saml_assertion_attribute: + $ref: '#/components/schemas/RelationshipToSAMLAssertionAttribute' + team: + $ref: '#/components/schemas/RelationshipToTeam' + type: object + AuthNMappingsType: + default: authn_mappings + description: AuthN Mappings resource type. + enum: + - authn_mappings + example: authn_mappings + type: string + x-enum-varnames: + - AUTHN_MAPPINGS + SAMLAssertionAttribute: + description: SAML assertion attribute. + properties: + attributes: + $ref: '#/components/schemas/SAMLAssertionAttributeAttributes' + id: + description: The ID of the SAML assertion attribute. + example: '0' + type: string + type: + $ref: '#/components/schemas/SAMLAssertionAttributesType' + required: + - id + - type + type: object + AuthNMappingTeam: + description: Team. + properties: + attributes: + $ref: '#/components/schemas/AuthNMappingTeamAttributes' + id: + description: The ID of the Team. + example: f9bb8444-af7f-11ec-ac2c-da7ad0900001 + type: string + type: + $ref: '#/components/schemas/TeamType' + type: object + Pagination: + description: Pagination object. + properties: + total_count: + description: Total count. + format: int64 + type: integer + total_filtered_count: + description: Total count of elements matched by the filter. + format: int64 + type: integer + type: object + AuthNMappingCreateAttributes: + description: Key/Value pair of attributes used for create request. + properties: + attribute_key: + description: >- + Key portion of a key/value pair of the attribute sent from the + Identity Provider. + example: member-of + type: string + attribute_value: + description: >- + Value portion of a key/value pair of the attribute sent from the + Identity Provider. + example: Development + type: string + type: object + AuthNMappingCreateRelationships: + description: Relationship of AuthN Mapping create object to a Role or Team. + oneOf: + - $ref: '#/components/schemas/AuthNMappingRelationshipToRole' + - $ref: '#/components/schemas/AuthNMappingRelationshipToTeam' + AuthNMappingUpdateAttributes: + description: Key/Value pair of attributes used for update request. + properties: + attribute_key: + description: >- + Key portion of a key/value pair of the attribute sent from the + Identity Provider. + example: member-of + type: string + attribute_value: + description: >- + Value portion of a key/value pair of the attribute sent from the + Identity Provider. + example: Development + type: string + type: object + AuthNMappingUpdateRelationships: + description: Relationship of AuthN Mapping update object to a Role or Team. + oneOf: + - $ref: '#/components/schemas/AuthNMappingRelationshipToRole' + - $ref: '#/components/schemas/AuthNMappingRelationshipToTeam' + ApplicationKeyCreateAttributes: + description: Attributes used to create an application Key. + properties: + name: + description: Name of the application key. + example: Application Key for managing dashboards + type: string + scopes: + description: Array of scopes to grant the application key. + example: + - dashboards_read + - dashboards_write + - dashboards_public_share + items: + description: Name of scope. + type: string + nullable: true + type: array + required: + - name + type: object + CreateDataDeletionRequestBodyAttributes: + description: Attributes for creating a data deletion request. + properties: + from: + description: Start of requested time window, milliseconds since Unix epoch. + example: 1672527600000 + format: int64 + type: integer + indexes: + description: >- + List of indexes for the search. If not provided, the search is + performed in all indexes. + example: + - test-index + - test-index-2 + items: + description: Individual index. + type: string + type: array + query: + additionalProperties: + type: string + description: Query for creating a data deletion request. + example: + host: abc + service: xyz + type: object + to: + description: End of requested time window, milliseconds since Unix epoch. + example: 1704063600000 + format: int64 + type: integer + required: + - query + - from + - to + type: object + CreateDataDeletionRequestBodyDataType: + description: The deletion request type. + enum: + - create_deletion_req + example: create_deletion_req + type: string + x-enum-varnames: + - CREATE_DELETION_REQ + DataDeletionResponseItemAttributes: + description: Deletion attribute for data deletion response. + properties: + created_at: + description: Creation time of the deletion request. + example: '2024-01-01T00:00:00.000000Z' + type: string + created_by: + description: User who created the deletion request. + example: test.user@datadoghq.com + type: string + from_time: + description: Start of requested time window, milliseconds since Unix epoch. + example: 1672527600000 + format: int64 + type: integer + indexes: + description: >- + List of indexes for the search. If not provided, the search is + performed in all indexes. + example: + - test-index + - test-index-2 + items: + description: Individual index. + type: string + type: array + is_created: + description: >- + Whether the deletion request is fully created or not. It can take + several minutes to fully create a deletion request depending on the + target query and timeframe. + example: true + type: boolean + org_id: + description: Organization ID. + example: 321813 + format: int64 + type: integer + product: + description: Product name. + example: logs + type: string + query: + description: Query for creating a data deletion request. + example: service:xyz host:abc + type: string + starting_at: + description: Starting time of the process to delete the requested data. + example: '2024-01-01T02:00:00.000000Z' + type: string + status: + description: Status of the deletion request. + example: pending + type: string + to_time: + description: End of requested time window, milliseconds since Unix epoch. + example: 1704063600000 + format: int64 + type: integer + total_unrestricted: + description: >- + Total number of elements to be deleted. Only the data accessible to + the current user that matches the query and timeframe provided will + be deleted. + example: 100 + format: int64 + type: integer + updated_at: + description: Update time of the deletion request. + example: '2024-01-01T00:00:00.000000Z' + type: string + required: + - created_at + - created_by + - from_time + - is_created + - org_id + - product + - query + - starting_at + - status + - to_time + - total_unrestricted + - updated_at + type: object + DomainAllowlistResponseDataAttributes: + description: The details of the email domain allowlist. + properties: + domains: + description: The list of domains in the email domain allowlist. + items: + type: string + type: array + enabled: + description: Whether the email domain allowlist is enabled for the org. + type: boolean + type: object + DomainAllowlistType: + default: domain_allowlist + description: Email domain allowlist allowlist type. + enum: + - domain_allowlist + example: domain_allowlist + type: string + x-enum-varnames: + - DOMAIN_ALLOWLIST + DomainAllowlistAttributes: + description: The details of the email domain allowlist. + properties: + domains: + description: The list of domains in the email domain allowlist. + items: + type: string + type: array + enabled: + description: Whether the email domain allowlist is enabled for the org. + type: boolean + type: object + IPAllowlistAttributes: + description: Attributes of the IP allowlist. + properties: + enabled: + description: Whether the IP allowlist logic is enabled or not. + type: boolean + entries: + description: Array of entries in the IP allowlist. + items: + $ref: '#/components/schemas/IPAllowlistEntry' + type: array + type: object + IPAllowlistType: + default: ip_allowlist + description: IP allowlist type. + enum: + - ip_allowlist + example: ip_allowlist + type: string + x-enum-varnames: + - IP_ALLOWLIST + OrgConfigReadAttributes: + description: Readable attributes of an Org Config. + properties: + description: + description: The description of an Org Config. + example: Frobulate the turbo encabulator manifold + type: string + modified_at: + description: The timestamp of the last Org Config update (if any). + format: date-time + nullable: true + type: string + name: + description: The machine-friendly name of an Org Config. + example: monitor_timezone + type: string + value: + description: The value of an Org Config. + value_type: + description: The type of an Org Config value. + example: bool + type: string + required: + - name + - description + - value_type + - value + type: object + OrgConfigType: + description: Data type of an Org Config. + enum: + - org_configs + example: org_configs + type: string + x-enum-varnames: + - ORG_CONFIGS + OrgConfigWriteAttributes: + description: Writable attributes of an Org Config. + properties: + value: + description: The value of an Org Config. + required: + - value + type: object + OrgConnectionAttributes: + description: Org connection attributes. + properties: + connection_types: + description: List of connection types. + example: + - logs + - metrics + items: + $ref: '#/components/schemas/OrgConnectionTypeEnum' + type: array + created_at: + description: Timestamp when the connection was created. + example: '2023-01-01T12:00:00Z' + format: date-time + type: string + required: + - connection_types + - created_at + type: object + OrgConnectionRelationships: + description: Related organizations and user. + properties: + created_by: + $ref: '#/components/schemas/OrgConnectionUserRelationship' + sink_org: + $ref: '#/components/schemas/OrgConnectionOrgRelationship' + source_org: + $ref: '#/components/schemas/OrgConnectionOrgRelationship' + type: object + OrgConnectionType: + description: Org connection type. + enum: + - org_connection + example: org_connection + type: string + x-enum-varnames: + - ORG_CONNECTION + OrgConnectionListResponseMetaPage: + description: Page information. + properties: + total_count: + description: Total number of org connections. + example: 0 + format: int64 + type: integer + total_filtered_count: + description: Total number of org connections matching the filter. + example: 0 + format: int64 + type: integer + type: object + OrgConnectionCreateAttributes: + description: Attributes for creating an org connection. + properties: + connection_types: + description: List of connection types to establish. + example: + - logs + items: + $ref: '#/components/schemas/OrgConnectionTypeEnum' + minItems: 1 + type: array + required: + - connection_types + type: object + OrgConnectionCreateRelationships: + description: Relationships for org connection creation. + properties: + sink_org: + $ref: '#/components/schemas/OrgConnectionOrgRelationship' + required: + - sink_org + type: object + OrgConnectionUpdateAttributes: + description: Attributes for updating an org connection. + properties: + connection_types: + description: Updated list of connection types. + example: + - logs + - metrics + items: + $ref: '#/components/schemas/OrgConnectionTypeEnum' + minItems: 1 + type: array + required: + - connection_types + type: object + PermissionAttributes: + description: Attributes of a permission. + properties: + created: + description: Creation time of the permission. + format: date-time + type: string + description: + description: Description of the permission. + type: string + display_name: + description: Displayed name for the permission. + type: string + display_type: + description: Display type. + type: string + group_name: + description: Name of the permission group. + type: string + name: + description: Name of the permission. + type: string + restricted: + description: Whether or not the permission is restricted. + type: boolean + type: object + PermissionsType: + default: permissions + description: Permissions resource type. + enum: + - permissions + example: permissions + type: string + x-enum-varnames: + - PERMISSIONS + RestrictionPolicyAttributes: + description: Restriction policy attributes. + example: + bindings: [] + properties: + bindings: + description: An array of bindings. + items: + $ref: '#/components/schemas/RestrictionPolicyBinding' + type: array + required: + - bindings + type: object + RestrictionPolicyType: + default: restriction_policy + description: Restriction policy type. + enum: + - restriction_policy + example: restriction_policy + type: string + x-enum-varnames: + - RESTRICTION_POLICY + RoleAttributes: + description: Attributes of the role. + properties: + created_at: + description: Creation time of the role. + format: date-time + readOnly: true + type: string + modified_at: + description: Time of last role modification. + format: date-time + readOnly: true + type: string + name: + description: >- + The name of the role. The name is neither unique nor a stable + identifier of the role. + type: string + user_count: + description: Number of users with that role. + format: int64 + readOnly: true + type: integer + type: object + RoleResponseRelationships: + description: Relationships of the role object returned by the API. + properties: + permissions: + $ref: '#/components/schemas/RelationshipToPermissions' + type: object + RolesType: + default: roles + description: Roles type. + enum: + - roles + example: roles + type: string + x-enum-varnames: + - ROLES + RoleCreateAttributes: + description: Attributes of the created role. + properties: + created_at: + description: Creation time of the role. + format: date-time + readOnly: true + type: string + modified_at: + description: Time of last role modification. + format: date-time + readOnly: true + type: string + name: + description: Name of the role. + example: developers + type: string + required: + - name + type: object + RoleRelationships: + description: Relationships of the role object. + properties: + permissions: + $ref: '#/components/schemas/RelationshipToPermissions' + type: object + RoleUpdateAttributes: + description: Attributes of the role. + properties: + created_at: + description: Creation time of the role. + format: date-time + readOnly: true + type: string + modified_at: + description: Time of last role modification. + format: date-time + readOnly: true + type: string + name: + description: Name of the role. + type: string + user_count: + description: The user count. + format: int32 + maximum: 2147483647 + type: integer + type: object + RoleCloneAttributes: + description: Attributes required to create a new role by cloning an existing one. + properties: + name: + description: Name of the new role that is cloned. + example: cloned-role + type: string + required: + - name + type: object + UsersType: + default: users + description: Users resource type. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + UserAttributes: + description: Attributes of user object returned by the API. + properties: + created_at: + description: Creation time of the user. + format: date-time + type: string + disabled: + description: Whether the user is disabled. + type: boolean + email: + description: Email of the user. + type: string + handle: + description: Handle of the user. + type: string + icon: + description: URL of the user's icon. + type: string + mfa_enabled: + description: If user has MFA enabled. + readOnly: true + type: boolean + modified_at: + description: Time that the user was last modified. + format: date-time + type: string + name: + description: Name of the user. + nullable: true + type: string + service_account: + description: Whether the user is a service account. + type: boolean + status: + description: Status of the user. + type: string + title: + description: Title of the user. + nullable: true + type: string + verified: + description: Whether the user is verified. + type: boolean + type: object + UserResponseRelationships: + description: Relationships of the user object returned by the API. + properties: + org: + $ref: '#/components/schemas/RelationshipToOrganization' + other_orgs: + $ref: '#/components/schemas/RelationshipToOrganizations' + other_users: + $ref: '#/components/schemas/RelationshipToUsers' + roles: + $ref: '#/components/schemas/RelationshipToRoles' + type: object + Organization: + description: Organization object. + properties: + attributes: + $ref: '#/components/schemas/OrganizationAttributes' + id: + description: ID of the organization. + type: string + type: + $ref: '#/components/schemas/OrganizationsType' + required: + - type + type: object + ServiceAccountCreateAttributes: + description: Attributes of the created user. + properties: + email: + description: The email of the user. + example: jane.doe@example.com + type: string + name: + description: The name of the user. + type: string + service_account: + description: Whether the user is a service account. Must be true. + example: true + type: boolean + title: + description: The title of the user. + type: string + required: + - email + - service_account + type: object + UserRelationships: + description: Relationships of the user object. + properties: + roles: + $ref: '#/components/schemas/RelationshipToRoles' + type: object + TeamAttributes: + description: Team attributes + properties: + avatar: + description: >- + Unicode representation of the avatar for the team, limited to a + single grapheme + example: 🥑 + nullable: true + type: string + banner: + description: Banner selection for the team + format: int64 + nullable: true + type: integer + created_at: + description: Creation date of the team + format: date-time + type: string + description: + description: Free-form markdown description/content for the team's homepage + nullable: true + type: string + handle: + description: The team's identifier + example: example-team + maxLength: 195 + type: string + hidden_modules: + description: Collection of hidden modules for the team + items: + description: String identifier of the module + type: string + type: array + link_count: + description: The number of links belonging to the team + format: int32 + maximum: 2147483647 + readOnly: true + type: integer + modified_at: + description: Modification date of the team + format: date-time + type: string + name: + description: The name of the team + example: Example Team + maxLength: 200 + type: string + summary: + description: A brief summary of the team, derived from the `description` + maxLength: 120 + nullable: true + type: string + user_count: + description: The number of users belonging to the team + format: int32 + maximum: 2147483647 + readOnly: true + type: integer + visible_modules: + description: Collection of visible modules for the team + items: + description: String identifier of the module + type: string + type: array + required: + - handle + - name + type: object + TeamRelationships: + description: Resources related to a team + properties: + team_links: + $ref: '#/components/schemas/RelationshipToTeamLinks' + user_team_permissions: + $ref: '#/components/schemas/RelationshipToUserTeamPermission' + type: object + TeamType: + default: team + description: Team type + enum: + - team + example: team + type: string + x-enum-varnames: + - TEAM + UserTeamPermission: + description: A user's permissions for a given team + properties: + attributes: + $ref: '#/components/schemas/UserTeamPermissionAttributes' + id: + description: The user team permission's identifier + example: UserTeamPermissions-aeadc05e-98a8-11ec-ac2c-da7ad0900001-416595 + type: string + type: + $ref: '#/components/schemas/UserTeamPermissionType' + required: + - id + - type + type: object + TeamsResponseMetaPagination: + description: Teams response metadata. + properties: + first_offset: + description: The first offset. + format: int64 + type: integer + last_offset: + description: The last offset. + format: int64 + type: integer + limit: + description: Pagination limit. + format: int64 + type: integer + next_offset: + description: The next offset. + format: int64 + type: integer + offset: + description: The offset. + format: int64 + type: integer + prev_offset: + description: The previous offset. + format: int64 + type: integer + total: + description: Total results. + format: int64 + type: integer + type: + description: Offset type. + type: string + type: object + TeamCreateAttributes: + description: Team creation attributes + properties: + avatar: + description: >- + Unicode representation of the avatar for the team, limited to a + single grapheme + example: 🥑 + nullable: true + type: string + banner: + description: Banner selection for the team + format: int64 + nullable: true + type: integer + description: + description: Free-form markdown description/content for the team's homepage + type: string + handle: + description: The team's identifier + example: example-team + maxLength: 195 + type: string + hidden_modules: + description: Collection of hidden modules for the team + items: + description: String identifier of the module + type: string + type: array + name: + description: The name of the team + example: Example Team + maxLength: 200 + type: string + visible_modules: + description: Collection of visible modules for the team + items: + description: String identifier of the module + type: string + type: array + required: + - handle + - name + type: object + TeamCreateRelationships: + description: Relationships formed with the team on creation + properties: + users: + $ref: '#/components/schemas/RelationshipToUsers' + type: object + TeamSyncAttributes: + description: Team sync attributes. + properties: + source: + $ref: '#/components/schemas/TeamSyncAttributesSource' + type: + $ref: '#/components/schemas/TeamSyncAttributesType' + required: + - source + - type + type: object + TeamSyncBulkType: + description: Team sync bulk type. + enum: + - team_sync_bulk + example: team_sync_bulk + type: string + x-enum-varnames: + - TEAM_SYNC_BULK + MemberTeamType: + default: member_teams + description: Member team type + enum: + - member_teams + example: member_teams + type: string + x-enum-varnames: + - MEMBER_TEAMS + TeamUpdateAttributes: + description: Team update attributes + properties: + avatar: + description: >- + Unicode representation of the avatar for the team, limited to a + single grapheme + example: 🥑 + nullable: true + type: string + banner: + description: Banner selection for the team + format: int64 + nullable: true + type: integer + description: + description: Free-form markdown description/content for the team's homepage + type: string + handle: + description: The team's identifier + example: example-team + maxLength: 195 + type: string + hidden_modules: + description: Collection of hidden modules for the team + items: + description: String identifier of the module + type: string + type: array + name: + description: The name of the team + example: Example Team + maxLength: 200 + type: string + visible_modules: + description: Collection of visible modules for the team + items: + description: String identifier of the module + type: string + type: array + required: + - handle + - name + type: object + TeamUpdateRelationships: + description: Team update relationships + properties: + team_links: + $ref: '#/components/schemas/RelationshipToTeamLinks' + type: object + TeamLinkAttributes: + description: Team link attributes + properties: + label: + description: The link's label + example: Link label + maxLength: 256 + type: string + position: + description: The link's position, used to sort links for the team + format: int32 + maximum: 2147483647 + type: integer + team_id: + description: ID of the team the link is associated with + readOnly: true + type: string + url: + description: The URL for the link + example: https://example.com + type: string + required: + - label + - url + type: object + TeamLinkType: + default: team_links + description: Team link type + enum: + - team_links + example: team_links + type: string + x-enum-varnames: + - TEAM_LINKS + UserTeamAttributes: + description: Team membership attributes + properties: + provisioned_by: + description: >- + The mechanism responsible for provisioning the team relationship. + + Possible values: null for added by a user, "service_account" if + added by a service account, and "saml_mapping" if provisioned via + SAML mapping. + nullable: true + readOnly: true + type: string + provisioned_by_id: + description: >- + UUID of the User or Service Account who provisioned this team + membership, or null if provisioned via SAML mapping. + nullable: true + readOnly: true + type: string + role: + $ref: '#/components/schemas/UserTeamRole' + type: object + UserTeamRelationships: + description: Relationship between membership and a user + properties: + team: + $ref: '#/components/schemas/RelationshipToUserTeamTeam' + user: + $ref: '#/components/schemas/RelationshipToUserTeamUser' + type: object + UserTeamType: + default: team_memberships + description: Team membership type + enum: + - team_memberships + example: team_memberships + type: string + x-enum-varnames: + - TEAM_MEMBERSHIPS + TeamPermissionSettingAttributes: + description: Team permission setting attributes + properties: + action: + $ref: '#/components/schemas/TeamPermissionSettingSerializerAction' + editable: + description: >- + Whether or not the permission setting is editable by the current + user + readOnly: true + type: boolean + options: + $ref: '#/components/schemas/TeamPermissionSettingValues' + title: + description: The team permission name + readOnly: true + type: string + value: + $ref: '#/components/schemas/TeamPermissionSettingValue' + type: object + TeamPermissionSettingType: + default: team_permission_settings + description: Team permission setting type + enum: + - team_permission_settings + example: team_permission_settings + type: string + x-enum-varnames: + - TEAM_PERMISSION_SETTINGS + TeamPermissionSettingUpdateAttributes: + description: Team permission setting update attributes + properties: + value: + $ref: '#/components/schemas/TeamPermissionSettingValue' + type: object + UsageAttributesObject: + description: Usage attributes data. + properties: + org_name: + description: The organization name. + type: string + product_family: + description: The product for which usage is being reported. + type: string + public_id: + description: The organization public ID. + type: string + region: + description: The region of the Datadog instance that the organization belongs to. + type: string + timeseries: + description: List of usage data reported for each requested hour. + items: + $ref: '#/components/schemas/UsageTimeSeriesObject' + type: array + usage_type: + $ref: '#/components/schemas/HourlyUsageType' + type: object + UsageTimeSeriesType: + default: usage_timeseries + description: Type of usage data. + enum: + - usage_timeseries + example: usage_timeseries + type: string + x-enum-varnames: + - USAGE_TIMESERIES + BillingDimensionsMappingBodyItem: + description: The mapping data for each billing dimension. + properties: + attributes: + $ref: '#/components/schemas/BillingDimensionsMappingBodyItemAttributes' + id: + description: ID of the billing dimension. + type: string + type: + $ref: '#/components/schemas/ActiveBillingDimensionsType' + type: object + CostByOrgAttributes: + description: Cost attributes data. + properties: + account_name: + description: The account name. + type: string + account_public_id: + description: The account public ID. + type: string + charges: + description: List of charges data reported for the requested month. + items: + $ref: '#/components/schemas/ChargebackBreakdown' + type: array + date: + description: The month requested. + format: date-time + type: string + org_name: + description: The organization name. + type: string + public_id: + description: The organization public ID. + type: string + region: + description: The region of the Datadog instance that the organization belongs to. + type: string + total_cost: + description: The total cost of products for the month. + format: double + type: number + type: object + CostByOrgType: + default: cost_by_org + description: Type of cost data. + enum: + - cost_by_org + example: cost_by_org + type: string + x-enum-varnames: + - COST_BY_ORG + HourlyUsageAttributes: + description: >- + Attributes of hourly usage for a product family for an org for a time + period. + properties: + account_name: + description: The account name. + type: string + account_public_id: + description: The account public ID. + type: string + measurements: + description: >- + List of the measured usage values for the product family for the org + for the time period. + items: + $ref: '#/components/schemas/HourlyUsageMeasurement' + type: array + org_name: + description: The organization name. + type: string + product_family: + description: The product for which usage is being reported. + type: string + public_id: + description: The organization public ID. + type: string + region: + description: The region of the Datadog instance that the organization belongs to. + type: string + timestamp: + description: Datetime in ISO-8601 format, UTC. The hour for the usage. + format: date-time + type: string + type: object + HourlyUsagePagination: + description: The metadata for the current pagination. + properties: + next_record_id: + description: >- + The cursor to get the next results (if any). To make the next + request, use the same parameters and add `next_record_id`. + nullable: true + type: string + type: object + ProjectedCostAttributes: + description: Projected Cost attributes data. + properties: + account_name: + description: The account name. + type: string + account_public_id: + description: The account public ID. + type: string + charges: + description: List of charges data reported for the requested month. + items: + $ref: '#/components/schemas/ChargebackBreakdown' + type: array + date: + description: The month requested. + format: date-time + type: string + org_name: + description: The organization name. + type: string + projected_total_cost: + description: The total projected cost of products for the month. + format: double + type: number + public_id: + description: The organization public ID. + type: string + region: + description: The region of the Datadog instance that the organization belongs to. + type: string + type: object + ProjectedCostType: + default: projected_cost + description: Type of cost data. + enum: + - projected_cost + example: projected_cost + type: string + x-enum-varnames: + - PROJECt_COST + UserInvitationRelationships: + description: Relationships data for user invitation. + properties: + user: + $ref: '#/components/schemas/RelationshipToUser' + required: + - user + type: object + UserInvitationsType: + default: user_invitations + description: User invitations type. + enum: + - user_invitations + example: user_invitations + type: string + x-enum-varnames: + - USER_INVITATIONS + UserInvitationDataAttributes: + description: Attributes of a user invitation. + properties: + created_at: + description: Creation time of the user invitation. + format: date-time + type: string + expires_at: + description: Time of invitation expiration. + format: date-time + type: string + invite_type: + description: Type of invitation. + type: string + uuid: + description: UUID of the user invitation. + type: string + type: object + UserCreateAttributes: + description: Attributes of the created user. + properties: + email: + description: The email of the user. + example: jane.doe@example.com + type: string + name: + description: The name of the user. + type: string + title: + description: The title of the user. + type: string + required: + - email + type: object + UserUpdateAttributes: + description: Attributes of the edited user. + properties: + disabled: + description: If the user is enabled or disabled. + type: boolean + email: + description: The email of the user. + type: string + name: + description: The name of the user. + type: string + type: object + NullableRelationshipToUser: + description: Relationship to user. + nullable: true + properties: + data: + $ref: '#/components/schemas/NullableRelationshipToUserData' + required: + - data + type: object + LeakedKeyAttributes: + description: The definition of LeakedKeyAttributes object. + properties: + date: + description: The LeakedKeyAttributes date. + example: '2017-07-21T17:32:28Z' + format: date-time + type: string + leak_source: + description: The LeakedKeyAttributes leak_source. + type: string + required: + - date + type: object + LeakedKeyType: + default: leaked_keys + description: The definition of LeakedKeyType object. + enum: + - leaked_keys + example: leaked_keys + type: string + x-enum-varnames: + - LEAKED_KEYS + RelationshipToRole: + description: Relationship to role. + properties: + data: + $ref: '#/components/schemas/RelationshipToRoleData' + type: object + RelationshipToSAMLAssertionAttribute: + description: AuthN Mapping relationship to SAML Assertion Attribute. + properties: + data: + $ref: '#/components/schemas/RelationshipToSAMLAssertionAttributeData' + required: + - data + type: object + RelationshipToTeam: + description: Relationship to team. + properties: + data: + $ref: '#/components/schemas/RelationshipToTeamData' + type: object + SAMLAssertionAttributeAttributes: + description: Key/Value pair of attributes used in SAML assertion attributes. + properties: + attribute_key: + description: >- + Key portion of a key/value pair of the attribute sent from the + Identity Provider. + example: member-of + type: string + attribute_value: + description: >- + Value portion of a key/value pair of the attribute sent from the + Identity Provider. + example: Development + type: string + type: object + SAMLAssertionAttributesType: + default: saml_assertion_attributes + description: SAML assertion attributes resource type. + enum: + - saml_assertion_attributes + example: saml_assertion_attributes + type: string + x-enum-varnames: + - SAML_ASSERTION_ATTRIBUTES + AuthNMappingTeamAttributes: + description: Team attributes. + properties: + avatar: + description: >- + Unicode representation of the avatar for the team, limited to a + single grapheme + example: 🥑 + nullable: true + type: string + banner: + description: Banner selection for the team + format: int64 + nullable: true + type: integer + handle: + description: The team's identifier + example: example-team + maxLength: 195 + type: string + link_count: + description: The number of links belonging to the team + format: int32 + maximum: 2147483647 + readOnly: true + type: integer + name: + description: The name of the team + example: Example Team + maxLength: 200 + type: string + summary: + description: A brief summary of the team, derived from the `description` + maxLength: 120 + nullable: true + type: string + user_count: + description: The number of users belonging to the team + format: int32 + maximum: 2147483647 + readOnly: true + type: integer + type: object + AuthNMappingRelationshipToRole: + description: Relationship of AuthN Mapping to a Role. + properties: + role: + $ref: '#/components/schemas/RelationshipToRole' + required: + - role + type: object + AuthNMappingRelationshipToTeam: + description: Relationship of AuthN Mapping to a Team. + properties: + team: + $ref: '#/components/schemas/RelationshipToTeam' + required: + - team + type: object + IPAllowlistEntry: + description: IP allowlist entry object. + properties: + data: + $ref: '#/components/schemas/IPAllowlistEntryData' + required: + - data + type: object + OrgConnectionTypeEnum: + description: Available connection types between organizations. + enum: + - logs + - metrics + example: logs + type: string + x-enum-varnames: + - LOGS + - METRICS + OrgConnectionUserRelationship: + description: User relationship. + properties: + data: + $ref: '#/components/schemas/OrgConnectionUserRelationshipData' + type: object + OrgConnectionOrgRelationship: + description: Org relationship. + properties: + data: + $ref: '#/components/schemas/OrgConnectionOrgRelationshipData' + type: object + RestrictionPolicyBinding: + description: Specifies which principals are associated with a relation. + properties: + principals: + description: >- + An array of principals. A principal is a subject or group of + subjects. + + Each principal is formatted as `type:id`. Supported types: `role`, + `team`, `user`, and `org`. + + The org ID can be obtained through the api/v2/current_user API. + + The user principal type accepts service account IDs. + example: + - role:00000000-0000-1111-0000-000000000000 + items: + description: >- + Subject or group of subjects. Each principal is formatted as + `type:id`. + + Supported types: `role`, `team`, `user`, and `org`. + + The org ID can be obtained through the api/v2/current_user API. + + The user principal type accepts service account IDs. + type: string + type: array + relation: + description: The role/level of access. + example: editor + type: string + required: + - relation + - principals + type: object + RelationshipToPermissions: + description: Relationship to multiple permissions objects. + properties: + data: + description: Relationships to permission objects. + items: + $ref: '#/components/schemas/RelationshipToPermissionData' + type: array + type: object + RelationshipToOrganization: + description: Relationship to an organization. + properties: + data: + $ref: '#/components/schemas/RelationshipToOrganizationData' + required: + - data + type: object + RelationshipToOrganizations: + description: Relationship to organizations. + properties: + data: + description: Relationships to organization objects. + example: [] + items: + $ref: '#/components/schemas/RelationshipToOrganizationData' + type: array + required: + - data + type: object + RelationshipToUsers: + description: Relationship to users. + properties: + data: + description: Relationships to user objects. + example: [] + items: + $ref: '#/components/schemas/RelationshipToUserData' + type: array + required: + - data + type: object + RelationshipToRoles: + description: Relationship to roles. + properties: + data: + description: An array containing type and the unique identifier of a role. + items: + $ref: '#/components/schemas/RelationshipToRoleData' + type: array + type: object + OrganizationAttributes: + description: Attributes of the organization. + properties: + created_at: + description: Creation time of the organization. + format: date-time + type: string + description: + description: Description of the organization. + type: string + disabled: + description: Whether or not the organization is disabled. + type: boolean + modified_at: + description: Time of last organization modification. + format: date-time + type: string + name: + description: Name of the organization. + type: string + public_id: + description: Public ID of the organization. + type: string + sharing: + description: Sharing type of the organization. + type: string + url: + description: URL of the site that this organization exists at. + type: string + type: object + OrganizationsType: + default: orgs + description: Organizations resource type. + enum: + - orgs + example: orgs + type: string + x-enum-varnames: + - ORGS + RelationshipToTeamLinks: + description: Relationship between a team and a team link + properties: + data: + description: Related team links + items: + $ref: '#/components/schemas/RelationshipToTeamLinkData' + type: array + links: + $ref: '#/components/schemas/TeamRelationshipsLinks' + type: object + RelationshipToUserTeamPermission: + description: Relationship between a user team permission and a team + properties: + data: + $ref: '#/components/schemas/RelationshipToUserTeamPermissionData' + links: + $ref: '#/components/schemas/TeamRelationshipsLinks' + type: object + UserTeamPermissionAttributes: + description: User team permission attributes + properties: + permissions: + description: >- + Object of team permission actions and boolean values that a logged + in user can perform on this team. + readOnly: true + type: object + type: object + UserTeamPermissionType: + default: user_team_permissions + description: User team permission type + enum: + - user_team_permissions + example: user_team_permissions + type: string + x-enum-varnames: + - USER_TEAM_PERMISSIONS + TeamSyncAttributesSource: + description: >- + The external source platform for team synchronization. Only "github" is + supported. + enum: + - github + example: github + type: string + x-enum-varnames: + - GITHUB + TeamSyncAttributesType: + description: >- + The type of synchronization operation. Only "link" is supported, which + links existing teams by matching names. + enum: + - link + example: link + type: string + x-enum-varnames: + - LINK + UserTeamRole: + description: The user's role within the team + enum: + - admin + nullable: true + type: string + x-enum-varnames: + - ADMIN + RelationshipToUserTeamTeam: + description: Relationship between team membership and team + properties: + data: + $ref: '#/components/schemas/RelationshipToUserTeamTeamData' + required: + - data + type: object + RelationshipToUserTeamUser: + description: Relationship between team membership and user + properties: + data: + $ref: '#/components/schemas/RelationshipToUserTeamUserData' + required: + - data + type: object + TeamPermissionSettingSerializerAction: + description: The identifier for the action + enum: + - manage_membership + - edit + readOnly: true + type: string + x-enum-varnames: + - MANAGE_MEMBERSHIP + - EDIT + TeamPermissionSettingValues: + description: Possible values for action + items: + $ref: '#/components/schemas/TeamPermissionSettingValue' + readOnly: true + type: array + TeamPermissionSettingValue: + description: What type of user is allowed to perform the specified action + enum: + - admins + - members + - organization + - user_access_manage + - teams_manage + type: string + x-enum-varnames: + - ADMINS + - MEMBERS + - ORGANIZATION + - USER_ACCESS_MANAGE + - TEAMS_MANAGE + UsageTimeSeriesObject: + description: Usage timeseries data. + properties: + timestamp: + description: Datetime in ISO-8601 format, UTC. The hour for the usage. + format: date-time + type: string + value: + description: >- + Contains the number measured for the given usage_type during the + hour. + format: int64 + nullable: true + type: integer + type: object + HourlyUsageType: + description: Usage type that is being measured. + enum: + - app_sec_host_count + - observability_pipelines_bytes_processed + - lambda_traced_invocations_count + example: observability_pipelines_bytes_processed + type: string + x-enum-varnames: + - APP_SEC_HOST_COUNT + - OBSERVABILITY_PIPELINES_BYTES_PROCESSSED + - LAMBDA_TRACED_INVOCATIONS_COUNT + BillingDimensionsMappingBodyItemAttributes: + description: Mapping of billing dimensions to endpoint keys. + properties: + endpoints: + description: >- + List of supported endpoints with their keys mapped to the + billing_dimension. + items: + $ref: >- + #/components/schemas/BillingDimensionsMappingBodyItemAttributesEndpointsItems + type: array + in_app_label: + description: Label used for the billing dimension in the Plan & Usage charts. + example: APM Hosts + type: string + timestamp: + description: >- + Month in ISO-8601 format, UTC, and precise to the second: + `[YYYY-MM-DDThh:mm:ss]`. + format: date-time + type: string + type: object + ActiveBillingDimensionsType: + default: billing_dimensions + description: Type of active billing dimensions data. + enum: + - billing_dimensions + type: string + x-enum-varnames: + - BILLING_DIMENSIONS + ChargebackBreakdown: + description: Charges breakdown. + properties: + charge_type: + description: The type of charge for a particular product. + example: on_demand + type: string + cost: + description: >- + The cost for a particular product and charge type during a given + month. + format: double + type: number + product_name: + description: The product for which cost is being reported. + example: infra_host + type: string + type: object + HourlyUsageMeasurement: + description: Usage amount for a given usage type. + properties: + usage_type: + description: Type of usage. + type: string + value: + description: >- + Contains the number measured for the given usage_type during the + hour. + format: int64 + nullable: true + type: integer + type: object + NullableRelationshipToUserData: + description: Relationship to user object. + nullable: true + properties: + id: + description: A unique identifier that represents the user. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + required: + - id + - type + type: object + RelationshipToRoleData: + description: Relationship to role object. + properties: + id: + description: The unique identifier of the role. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + type: + $ref: '#/components/schemas/RolesType' + type: object + RelationshipToSAMLAssertionAttributeData: + description: Data of AuthN Mapping relationship to SAML Assertion Attribute. + properties: + id: + description: The ID of the SAML assertion attribute. + example: '0' + type: string + type: + $ref: '#/components/schemas/SAMLAssertionAttributesType' + required: + - id + - type + type: object + RelationshipToTeamData: + description: Relationship to Team object. + properties: + id: + description: The unique identifier of the team. + example: f9bb8444-af7f-11ec-ac2c-da7ad0900001 + type: string + type: + $ref: '#/components/schemas/TeamType' + type: object + IPAllowlistEntryData: + description: Data of the IP allowlist entry object. + properties: + attributes: + $ref: '#/components/schemas/IPAllowlistEntryAttributes' + id: + description: The unique identifier of the IP allowlist entry. + type: string + type: + $ref: '#/components/schemas/IPAllowlistEntryType' + required: + - type + type: object + OrgConnectionUserRelationshipData: + description: The data for a user relationship. + properties: + id: + description: User UUID. + example: usr123abc456 + type: string + name: + description: User name. + example: John Doe + type: string + type: + $ref: '#/components/schemas/OrgConnectionUserRelationshipDataType' + type: object + OrgConnectionOrgRelationshipData: + description: The definition of `OrgConnectionOrgRelationshipData` object. + properties: + id: + description: Org UUID. + example: f9ec96b0-8c8a-4b0a-9b0a-1b2c3d4e5f6a + type: string + name: + description: Org name. + example: Example Org + type: string + type: + $ref: '#/components/schemas/OrgConnectionOrgRelationshipDataType' + type: object + RelationshipToOrganizationData: + description: Relationship to organization object. + properties: + id: + description: ID of the organization. + example: 00000000-0000-beef-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/OrganizationsType' + required: + - id + - type + type: object + RelationshipToTeamLinkData: + description: Relationship between a link and a team + properties: + id: + description: The team link's identifier + example: f9bb8444-af7f-11ec-ac2c-da7ad0900001 + type: string + type: + $ref: '#/components/schemas/TeamLinkType' + required: + - id + - type + type: object + TeamRelationshipsLinks: + description: Links attributes. + properties: + related: + description: Related link. + example: /api/v2/team/c75a4a8e-20c7-11ee-a3a5-da7ad0900002/links + type: string + type: object + RelationshipToUserTeamPermissionData: + description: Related user team permission data + properties: + id: + description: The ID of the user team permission + example: UserTeamPermissions-aeadc05e-98a8-11ec-ac2c-da7ad0900001-416595 + type: string + type: + $ref: '#/components/schemas/UserTeamPermissionType' + required: + - id + - type + type: object + RelationshipToUserTeamTeamData: + description: The team associated with the membership + properties: + id: + description: The ID of the team associated with the membership + example: d7e15d9d-d346-43da-81d8-3d9e71d9a5e9 + type: string + type: + $ref: '#/components/schemas/UserTeamTeamType' + required: + - id + - type + type: object + RelationshipToUserTeamUserData: + description: A user's relationship with a team + properties: + id: + description: The ID of the user associated with the team + example: b8626d7e-cedd-11eb-abf5-da7ad0900001 + type: string + type: + $ref: '#/components/schemas/UserTeamUserType' + required: + - id + - type + type: object + BillingDimensionsMappingBodyItemAttributesEndpointsItems: + description: An endpoint's keys mapped to the billing_dimension. + properties: + id: + description: The URL for the endpoint. + example: api/v1/usage/billable-summary + type: string + keys: + description: The billing dimension. + example: + - apm_host_top99p + - apm_host_sum + items: + example: apm_host_top99p + type: string + type: array + status: + $ref: >- + #/components/schemas/BillingDimensionsMappingBodyItemAttributesEndpointsItemsStatus + type: object + IPAllowlistEntryAttributes: + description: Attributes of the IP allowlist entry. + properties: + cidr_block: + description: The CIDR block describing the IP range of the entry. + type: string + created_at: + description: Creation time of the entry. + format: date-time + readOnly: true + type: string + modified_at: + description: Time of last entry modification. + format: date-time + readOnly: true + type: string + note: + description: A note describing the IP allowlist entry. + type: string + type: object + IPAllowlistEntryType: + default: ip_allowlist_entry + description: IP allowlist Entry type. + enum: + - ip_allowlist_entry + example: ip_allowlist_entry + type: string + x-enum-varnames: + - IP_ALLOWLIST_ENTRY + OrgConnectionUserRelationshipDataType: + description: The type of the user relationship. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + OrgConnectionOrgRelationshipDataType: + description: The type of the organization relationship. + enum: + - orgs + example: orgs + type: string + x-enum-varnames: + - ORGS + UserTeamTeamType: + default: team + description: User team team type + enum: + - team + example: team + type: string + x-enum-varnames: + - TEAM + UserTeamUserType: + default: users + description: User team user type + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + BillingDimensionsMappingBodyItemAttributesEndpointsItemsStatus: + description: Denotes whether mapping keys were available for this endpoint. + enum: + - OK + - NOT_FOUND + type: string + x-enum-varnames: + - OK + - NOT_FOUND + responses: + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + UnauthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unauthorized + ConflictResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + parameters: + PageSize: + description: Size for a given page. The maximum allowed value is 100. + in: query + name: page[size] + required: false + schema: + default: 10 + example: 10 + format: int64 + type: integer + PageNumber: + description: Specific page number to return. + in: query + name: page[number] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + APIKeysSortParameter: + description: |- + API key attribute used to sort results. Sort order is ascending + by default. In order to specify a descending sort, prefix the + attribute with a minus sign. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/APIKeysSort' + APIKeyFilterParameter: + description: Filter API keys by the specified string. + in: query + name: filter + required: false + schema: + type: string + APIKeyFilterCreatedAtStartParameter: + description: Only include API keys created on or after the specified date. + in: query + name: filter[created_at][start] + required: false + schema: + example: '2020-11-24T18:46:21+00:00' + type: string + APIKeyFilterCreatedAtEndParameter: + description: Only include API keys created on or before the specified date. + in: query + name: filter[created_at][end] + required: false + schema: + example: '2020-11-24T18:46:21+00:00' + type: string + APIKeyFilterModifiedAtStartParameter: + description: Only include API keys modified on or after the specified date. + in: query + name: filter[modified_at][start] + required: false + schema: + example: '2020-11-24T18:46:21+00:00' + type: string + APIKeyFilterModifiedAtEndParameter: + description: Only include API keys modified on or before the specified date. + in: query + name: filter[modified_at][end] + required: false + schema: + example: '2020-11-24T18:46:21+00:00' + type: string + APIKeyIncludeParameter: + description: >- + Comma separated list of resource paths for related resources to include + in the response. Supported resource paths are `created_by` and + `modified_by`. + in: query + name: include + required: false + schema: + example: created_by,modified_by + type: string + APIKeyReadConfigReadEnabledParameter: + description: Filter API keys by remote config read enabled status. + in: query + name: filter[remote_config_read_enabled] + required: false + schema: + type: boolean + APIKeyCategoryParameter: + description: Filter API keys by category. + in: query + name: filter[category] + required: false + schema: + type: string + APIKeyId: + description: The ID of the API key. + in: path + name: api_key_id + required: true + schema: + type: string + ApplicationKeysSortParameter: + description: |- + Application key attribute used to sort results. Sort order is ascending + by default. In order to specify a descending sort, prefix the + attribute with a minus sign. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/ApplicationKeysSort' + ApplicationKeyFilterParameter: + description: Filter application keys by the specified string. + in: query + name: filter + required: false + schema: + type: string + ApplicationKeyFilterCreatedAtStartParameter: + description: Only include application keys created on or after the specified date. + in: query + name: filter[created_at][start] + required: false + schema: + example: '2020-11-24T18:46:21+00:00' + type: string + ApplicationKeyFilterCreatedAtEndParameter: + description: Only include application keys created on or before the specified date. + in: query + name: filter[created_at][end] + required: false + schema: + example: '2020-11-24T18:46:21+00:00' + type: string + ApplicationKeyIncludeParameter: + description: >- + Resource path for related resources to include in the response. Only + `owned_by` is supported. + in: query + name: include + required: false + schema: + example: owned_by + type: string + ApplicationKeyID: + description: The ID of the application key. + in: path + name: app_key_id + required: true + schema: + type: string + AuthNMappingID: + description: The UUID of the AuthN Mapping. + in: path + name: authn_mapping_id + required: true + schema: + type: string + ProductName: + description: Name of the product to be deleted, either `logs` or `rum`. + in: path + name: product + required: true + schema: + type: string + RequestId: + description: ID of the deletion request. + in: path + name: id + required: true + schema: + type: string + OrgConfigName: + description: The name of an Org Config. + in: path + name: org_config_name + required: true + schema: + example: monitor_timezone + type: string + OrgConnectionId: + description: The unique identifier of the org connection. + in: path + name: connection_id + required: true + schema: + example: f9ec96b0-8c8a-4b0a-9b0a-1b2c3d4e5f6a + format: uuid + type: string + ResourceID: + description: >- + Identifier, formatted as `type:id`. Supported types: `dashboard`, + `integration-service`, `integration-webhook`, `notebook`, + `reference-table`, `security-rule`, `slo`, `workflow`, + `app-builder-app`, `connection`, `connection-group`, `rum-application`, + `cross-org-connection`, `spreadsheet`, `on-call-schedule`, + `on-call-escalation-policy`, `on-call-team-routing-rules. + example: dashboard:abc-def-ghi + in: path + name: resource_id + required: true + schema: + type: string + RoleID: + description: The unique identifier of the role. + in: path + name: role_id + required: true + schema: + type: string + ServiceAccountID: + description: The ID of the service account. + in: path + name: service_account_id + required: true + schema: + example: 00000000-0000-1234-0000-000000000000 + type: string + UserID: + description: The ID of the user. + in: path + name: user_id + required: true + schema: + example: 00000000-0000-9999-0000-000000000000 + type: string + x-stackQL-resources: + api_keys: + id: datadog.organization.api_keys + name: api_keys + title: Api Keys + methods: + list_apikeys: + operation: + $ref: '#/paths/~1api~1v2~1api_keys/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_apikey: + operation: + $ref: '#/paths/~1api~1v2~1api_keys/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_apikey: + operation: + $ref: '#/paths/~1api~1v2~1api_keys~1{api_key_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_apikey: + operation: + $ref: '#/paths/~1api~1v2~1api_keys~1{api_key_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_apikey: + operation: + $ref: '#/paths/~1api~1v2~1api_keys~1{api_key_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/api_keys/methods/get_apikey' + - $ref: '#/components/x-stackQL-resources/api_keys/methods/list_apikeys' + insert: + - $ref: '#/components/x-stackQL-resources/api_keys/methods/create_apikey' + update: + - $ref: '#/components/x-stackQL-resources/api_keys/methods/update_apikey' + delete: + - $ref: '#/components/x-stackQL-resources/api_keys/methods/delete_apikey' + replace: [] + application_keys: + id: datadog.organization.application_keys + name: application_keys + title: Application Keys + methods: + list_application_keys: + operation: + $ref: '#/paths/~1api~1v2~1application_keys/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + delete_application_key: + operation: + $ref: '#/paths/~1api~1v2~1application_keys~1{app_key_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_application_key: + operation: + $ref: '#/paths/~1api~1v2~1application_keys~1{app_key_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_application_key: + operation: + $ref: '#/paths/~1api~1v2~1application_keys~1{app_key_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/application_keys/methods/get_application_key + - $ref: >- + #/components/x-stackQL-resources/application_keys/methods/list_application_keys + insert: [] + update: + - $ref: >- + #/components/x-stackQL-resources/application_keys/methods/update_application_key + delete: + - $ref: >- + #/components/x-stackQL-resources/application_keys/methods/delete_application_key + replace: [] + audit_logs: + id: datadog.organization.audit_logs + name: audit_logs + title: Audit Logs + methods: + list_audit_logs: + operation: + $ref: '#/paths/~1api~1v2~1audit~1events/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + search_audit_logs: + operation: + $ref: '#/paths/~1api~1v2~1audit~1events~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/audit_logs/methods/list_audit_logs + insert: [] + update: [] + delete: [] + replace: [] + authn_mappings: + id: datadog.organization.authn_mappings + name: authn_mappings + title: Authn Mappings + methods: + list_auth_nmappings: + operation: + $ref: '#/paths/~1api~1v2~1authn_mappings/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_auth_nmapping: + operation: + $ref: '#/paths/~1api~1v2~1authn_mappings/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_auth_nmapping: + operation: + $ref: '#/paths/~1api~1v2~1authn_mappings~1{authn_mapping_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_auth_nmapping: + operation: + $ref: '#/paths/~1api~1v2~1authn_mappings~1{authn_mapping_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_auth_nmapping: + operation: + $ref: '#/paths/~1api~1v2~1authn_mappings~1{authn_mapping_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/authn_mappings/methods/get_auth_nmapping + - $ref: >- + #/components/x-stackQL-resources/authn_mappings/methods/list_auth_nmappings + insert: + - $ref: >- + #/components/x-stackQL-resources/authn_mappings/methods/create_auth_nmapping + update: + - $ref: >- + #/components/x-stackQL-resources/authn_mappings/methods/update_auth_nmapping + delete: + - $ref: >- + #/components/x-stackQL-resources/authn_mappings/methods/delete_auth_nmapping + replace: [] + current_user_application_keys: + id: datadog.organization.current_user_application_keys + name: current_user_application_keys + title: Current User Application Keys + methods: + list_current_user_application_keys: + operation: + $ref: '#/paths/~1api~1v2~1current_user~1application_keys/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_current_user_application_key: + operation: + $ref: '#/paths/~1api~1v2~1current_user~1application_keys/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_current_user_application_key: + operation: + $ref: >- + #/paths/~1api~1v2~1current_user~1application_keys~1{app_key_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_current_user_application_key: + operation: + $ref: >- + #/paths/~1api~1v2~1current_user~1application_keys~1{app_key_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_current_user_application_key: + operation: + $ref: >- + #/paths/~1api~1v2~1current_user~1application_keys~1{app_key_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/current_user_application_keys/methods/get_current_user_application_key + - $ref: >- + #/components/x-stackQL-resources/current_user_application_keys/methods/list_current_user_application_keys + insert: + - $ref: >- + #/components/x-stackQL-resources/current_user_application_keys/methods/create_current_user_application_key + update: + - $ref: >- + #/components/x-stackQL-resources/current_user_application_keys/methods/update_current_user_application_key + delete: + - $ref: >- + #/components/x-stackQL-resources/current_user_application_keys/methods/delete_current_user_application_key + replace: [] + data_deletion_requests: + id: datadog.organization.data_deletion_requests + name: data_deletion_requests + title: Data Deletion Requests + methods: + create_data_deletion_request: + operation: + $ref: '#/paths/~1api~1v2~1deletion~1data~1{product}/post' + response: + mediaType: application/json + openAPIDocKey: '200' + get_data_deletion_requests: + operation: + $ref: '#/paths/~1api~1v2~1deletion~1requests/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + cancel_data_deletion_request: + operation: + $ref: '#/paths/~1api~1v2~1deletion~1requests~1{id}~1cancel/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/data_deletion_requests/methods/get_data_deletion_requests + insert: + - $ref: >- + #/components/x-stackQL-resources/data_deletion_requests/methods/create_data_deletion_request + update: [] + delete: [] + replace: [] + domain_allowlist: + id: datadog.organization.domain_allowlist + name: domain_allowlist + title: Domain Allowlist + methods: + get_domain_allowlist: + operation: + $ref: '#/paths/~1api~1v2~1domain_allowlist/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + patch_domain_allowlist: + operation: + $ref: '#/paths/~1api~1v2~1domain_allowlist/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/domain_allowlist/methods/get_domain_allowlist + insert: [] + update: + - $ref: >- + #/components/x-stackQL-resources/domain_allowlist/methods/patch_domain_allowlist + delete: [] + replace: [] + ip_allowlist: + id: datadog.organization.ip_allowlist + name: ip_allowlist + title: Ip Allowlist + methods: + get_ipallowlist: + operation: + $ref: '#/paths/~1api~1v2~1ip_allowlist/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_ipallowlist: + operation: + $ref: '#/paths/~1api~1v2~1ip_allowlist/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/ip_allowlist/methods/get_ipallowlist + insert: [] + update: + - $ref: >- + #/components/x-stackQL-resources/ip_allowlist/methods/update_ipallowlist + delete: [] + replace: [] + configs: + id: datadog.organization.configs + name: configs + title: Configs + methods: + list_org_configs: + operation: + $ref: '#/paths/~1api~1v2~1org_configs/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + get_org_config: + operation: + $ref: '#/paths/~1api~1v2~1org_configs~1{org_config_name}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_org_config: + operation: + $ref: '#/paths/~1api~1v2~1org_configs~1{org_config_name}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/configs/methods/get_org_config' + - $ref: '#/components/x-stackQL-resources/configs/methods/list_org_configs' + insert: [] + update: + - $ref: '#/components/x-stackQL-resources/configs/methods/update_org_config' + delete: [] + replace: [] + connections: + id: datadog.organization.connections + name: connections + title: Connections + methods: + list_org_connections: + operation: + $ref: '#/paths/~1api~1v2~1org_connections/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_org_connections: + operation: + $ref: '#/paths/~1api~1v2~1org_connections/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_org_connections: + operation: + $ref: '#/paths/~1api~1v2~1org_connections~1{connection_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '200' + update_org_connections: + operation: + $ref: '#/paths/~1api~1v2~1org_connections~1{connection_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/connections/methods/list_org_connections + insert: + - $ref: >- + #/components/x-stackQL-resources/connections/methods/create_org_connections + update: + - $ref: >- + #/components/x-stackQL-resources/connections/methods/update_org_connections + delete: + - $ref: >- + #/components/x-stackQL-resources/connections/methods/delete_org_connections + replace: [] + permissions: + id: datadog.organization.permissions + name: permissions + title: Permissions + methods: + list_permissions: + operation: + $ref: '#/paths/~1api~1v2~1permissions/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/permissions/methods/list_permissions + insert: [] + update: [] + delete: [] + replace: [] + restriction_policies: + id: datadog.organization.restriction_policies + name: restriction_policies + title: Restriction Policies + methods: + delete_restriction_policy: + operation: + $ref: '#/paths/~1api~1v2~1restriction_policy~1{resource_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_restriction_policy: + operation: + $ref: '#/paths/~1api~1v2~1restriction_policy~1{resource_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_restriction_policy: + operation: + $ref: '#/paths/~1api~1v2~1restriction_policy~1{resource_id}/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/restriction_policies/methods/get_restriction_policy + insert: [] + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/restriction_policies/methods/delete_restriction_policy + replace: + - $ref: >- + #/components/x-stackQL-resources/restriction_policies/methods/update_restriction_policy + roles: + id: datadog.organization.roles + name: roles + title: Roles + methods: + list_roles: + operation: + $ref: '#/paths/~1api~1v2~1roles/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_role: + operation: + $ref: '#/paths/~1api~1v2~1roles/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_role: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_role: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_role: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + clone_role: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1clone/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/roles/methods/get_role' + - $ref: '#/components/x-stackQL-resources/roles/methods/list_roles' + insert: + - $ref: '#/components/x-stackQL-resources/roles/methods/create_role' + update: + - $ref: '#/components/x-stackQL-resources/roles/methods/update_role' + delete: + - $ref: '#/components/x-stackQL-resources/roles/methods/delete_role' + replace: [] + role_permissions: + id: datadog.organization.role_permissions + name: role_permissions + title: Role Permissions + methods: + remove_permission_from_role: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1permissions/delete' + response: + mediaType: application/json + openAPIDocKey: '200' + list_role_permissions: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1permissions/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + add_permission_to_role: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1permissions/post' + response: + mediaType: application/json + openAPIDocKey: '200' + remove_user_from_role: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1users/delete' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/role_permissions/methods/list_role_permissions + insert: + - $ref: >- + #/components/x-stackQL-resources/role_permissions/methods/add_permission_to_role + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/role_permissions/methods/remove_permission_from_role + - $ref: >- + #/components/x-stackQL-resources/role_permissions/methods/remove_user_from_role + replace: [] + role_users: + id: datadog.organization.role_users + name: role_users + title: Role Users + methods: + list_role_users: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1users/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + add_user_to_role: + operation: + $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1users/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/role_users/methods/list_role_users + insert: + - $ref: >- + #/components/x-stackQL-resources/role_users/methods/add_user_to_role + update: [] + delete: [] + replace: [] + idp_metadata: + id: datadog.organization.idp_metadata + name: idp_metadata + title: Idp Metadata + methods: + upload_id_pmetadata: + operation: + $ref: '#/paths/~1api~1v2~1saml_configurations~1idp_metadata/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: [] + insert: [] + update: [] + delete: [] + replace: [] + service_accounts: + id: datadog.organization.service_accounts + name: service_accounts + title: Service Accounts + methods: + create_service_account: + operation: + $ref: '#/paths/~1api~1v2~1service_accounts/post' + response: + mediaType: application/json + openAPIDocKey: '201' + sqlVerbs: + select: [] + insert: + - $ref: >- + #/components/x-stackQL-resources/service_accounts/methods/create_service_account + update: [] + delete: [] + replace: [] + service_account_keys: + id: datadog.organization.service_account_keys + name: service_account_keys + title: Service Account Keys + methods: + list_service_account_application_keys: + operation: + $ref: >- + #/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_service_account_application_key: + operation: + $ref: >- + #/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_service_account_application_key: + operation: + $ref: >- + #/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys~1{app_key_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_service_account_application_key: + operation: + $ref: >- + #/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys~1{app_key_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_service_account_application_key: + operation: + $ref: >- + #/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys~1{app_key_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/service_account_keys/methods/get_service_account_application_key + - $ref: >- + #/components/x-stackQL-resources/service_account_keys/methods/list_service_account_application_keys + insert: + - $ref: >- + #/components/x-stackQL-resources/service_account_keys/methods/create_service_account_application_key + update: + - $ref: >- + #/components/x-stackQL-resources/service_account_keys/methods/update_service_account_application_key + delete: + - $ref: >- + #/components/x-stackQL-resources/service_account_keys/methods/delete_service_account_application_key + replace: [] + teams: + id: datadog.organization.teams + name: teams + title: Teams + methods: + list_teams: + operation: + $ref: '#/paths/~1api~1v2~1team/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_team: + operation: + $ref: '#/paths/~1api~1v2~1team/post' + response: + mediaType: application/json + openAPIDocKey: '201' + sync_teams: + operation: + $ref: '#/paths/~1api~1v2~1team~1sync/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_team: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_team: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_team: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/teams/methods/get_team' + - $ref: '#/components/x-stackQL-resources/teams/methods/list_teams' + insert: + - $ref: '#/components/x-stackQL-resources/teams/methods/create_team' + update: + - $ref: '#/components/x-stackQL-resources/teams/methods/update_team' + delete: + - $ref: '#/components/x-stackQL-resources/teams/methods/delete_team' + replace: [] + team_members: + id: datadog.organization.team_members + name: team_members + title: Team Members + methods: + list_member_teams: + operation: + $ref: '#/paths/~1api~1v2~1team~1{super_team_id}~1member_teams/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + add_member_team: + operation: + $ref: '#/paths/~1api~1v2~1team~1{super_team_id}~1member_teams/post' + response: + mediaType: application/json + openAPIDocKey: '204' + remove_member_team: + operation: + $ref: >- + #/paths/~1api~1v2~1team~1{super_team_id}~1member_teams~1{member_team_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/team_members/methods/list_member_teams + insert: + - $ref: >- + #/components/x-stackQL-resources/team_members/methods/add_member_team + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/team_members/methods/remove_member_team + replace: [] + team_links: + id: datadog.organization.team_links + name: team_links + title: Team Links + methods: + get_team_links: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_team_link: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_team_link: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links~1{link_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_team_link: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links~1{link_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_team_link: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links~1{link_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/team_links/methods/get_team_link' + - $ref: '#/components/x-stackQL-resources/team_links/methods/get_team_links' + insert: + - $ref: >- + #/components/x-stackQL-resources/team_links/methods/create_team_link + update: + - $ref: >- + #/components/x-stackQL-resources/team_links/methods/update_team_link + delete: + - $ref: >- + #/components/x-stackQL-resources/team_links/methods/delete_team_link + replace: [] + team_memberships: + id: datadog.organization.team_memberships + name: team_memberships + title: Team Memberships + methods: + get_team_memberships: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_team_membership: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_team_membership: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships~1{user_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + update_team_membership: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships~1{user_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/team_memberships/methods/get_team_memberships + insert: + - $ref: >- + #/components/x-stackQL-resources/team_memberships/methods/create_team_membership + update: + - $ref: >- + #/components/x-stackQL-resources/team_memberships/methods/update_team_membership + delete: + - $ref: >- + #/components/x-stackQL-resources/team_memberships/methods/delete_team_membership + replace: [] + team_permission_settings: + id: datadog.organization.team_permission_settings + name: team_permission_settings + title: Team Permission Settings + methods: + get_team_permission_settings: + operation: + $ref: '#/paths/~1api~1v2~1team~1{team_id}~1permission-settings/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_team_permission_setting: + operation: + $ref: >- + #/paths/~1api~1v2~1team~1{team_id}~1permission-settings~1{action}/put + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/team_permission_settings/methods/get_team_permission_settings + insert: [] + update: [] + delete: [] + replace: + - $ref: >- + #/components/x-stackQL-resources/team_permission_settings/methods/update_team_permission_setting + usage_application_security_monitoring: + id: datadog.organization.usage_application_security_monitoring + name: usage_application_security_monitoring + title: Usage Application Security Monitoring + methods: + get_usage_application_security_monitoring: + operation: + $ref: '#/paths/~1api~1v2~1usage~1application_security/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/usage_application_security_monitoring/methods/get_usage_application_security_monitoring + insert: [] + update: [] + delete: [] + replace: [] + billing_dimension_mapping: + id: datadog.organization.billing_dimension_mapping + name: billing_dimension_mapping + title: Billing Dimension Mapping + methods: + get_billing_dimension_mapping: + operation: + $ref: '#/paths/~1api~1v2~1usage~1billing_dimension_mapping/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/billing_dimension_mapping/methods/get_billing_dimension_mapping + insert: [] + update: [] + delete: [] + replace: [] + cost_by_org: + id: datadog.organization.cost_by_org + name: cost_by_org + title: Cost By Org + methods: + get_cost_by_org: + operation: + $ref: '#/paths/~1api~1v2~1usage~1cost_by_org/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/cost_by_org/methods/get_cost_by_org + insert: [] + update: [] + delete: [] + replace: [] + estimated_cost_by_org: + id: datadog.organization.estimated_cost_by_org + name: estimated_cost_by_org + title: Estimated Cost By Org + methods: + get_estimated_cost_by_org: + operation: + $ref: '#/paths/~1api~1v2~1usage~1estimated_cost/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/estimated_cost_by_org/methods/get_estimated_cost_by_org + insert: [] + update: [] + delete: [] + replace: [] + historical_cost_by_org: + id: datadog.organization.historical_cost_by_org + name: historical_cost_by_org + title: Historical Cost By Org + methods: + get_historical_cost_by_org: + operation: + $ref: '#/paths/~1api~1v2~1usage~1historical_cost/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/historical_cost_by_org/methods/get_historical_cost_by_org + insert: [] + update: [] + delete: [] + replace: [] + hourly_usage: + id: datadog.organization.hourly_usage + name: hourly_usage + title: Hourly Usage + methods: + get_hourly_usage: + operation: + $ref: '#/paths/~1api~1v2~1usage~1hourly_usage/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/hourly_usage/methods/get_hourly_usage + insert: [] + update: [] + delete: [] + replace: [] + lambda_traced_invocations_usage: + id: datadog.organization.lambda_traced_invocations_usage + name: lambda_traced_invocations_usage + title: Lambda Traced Invocations Usage + methods: + get_usage_lambda_traced_invocations: + operation: + $ref: '#/paths/~1api~1v2~1usage~1lambda_traced_invocations/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/lambda_traced_invocations_usage/methods/get_usage_lambda_traced_invocations + insert: [] + update: [] + delete: [] + replace: [] + observability_pipelines_usage: + id: datadog.organization.observability_pipelines_usage + name: observability_pipelines_usage + title: Observability Pipelines Usage + methods: + get_usage_observability_pipelines: + operation: + $ref: '#/paths/~1api~1v2~1usage~1observability_pipelines/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/observability_pipelines_usage/methods/get_usage_observability_pipelines + insert: [] + update: [] + delete: [] + replace: [] + projected_cost: + id: datadog.organization.projected_cost + name: projected_cost + title: Projected Cost + methods: + get_projected_cost: + operation: + $ref: '#/paths/~1api~1v2~1usage~1projected_cost/get' + response: + mediaType: application/json;datetime-format=rfc3339 + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/projected_cost/methods/get_projected_cost + insert: [] + update: [] + delete: [] + replace: [] + invitations: + id: datadog.organization.invitations + name: invitations + title: Invitations + methods: + send_invitations: + operation: + $ref: '#/paths/~1api~1v2~1user_invitations/post' + response: + mediaType: application/json + openAPIDocKey: '201' + get_invitation: + operation: + $ref: '#/paths/~1api~1v2~1user_invitations~1{user_invitation_uuid}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/invitations/methods/get_invitation + insert: [] + update: [] + delete: [] + replace: [] + users: + id: datadog.organization.users + name: users + title: Users + methods: + list_users: + operation: + $ref: '#/paths/~1api~1v2~1users/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_user: + operation: + $ref: '#/paths/~1api~1v2~1users/post' + response: + mediaType: application/json + openAPIDocKey: '201' + disable_user: + operation: + $ref: '#/paths/~1api~1v2~1users~1{user_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_user: + operation: + $ref: '#/paths/~1api~1v2~1users~1{user_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_user: + operation: + $ref: '#/paths/~1api~1v2~1users~1{user_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/users/methods/get_user' + - $ref: '#/components/x-stackQL-resources/users/methods/list_users' + insert: + - $ref: '#/components/x-stackQL-resources/users/methods/create_user' + update: + - $ref: '#/components/x-stackQL-resources/users/methods/update_user' + delete: [] + replace: [] + user_organizations: + id: datadog.organization.user_organizations + name: user_organizations + title: User Organizations + methods: + list_user_organizations: + operation: + $ref: '#/paths/~1api~1v2~1users~1{user_id}~1orgs/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/user_organizations/methods/list_user_organizations + insert: [] + update: [] + delete: [] + replace: [] + user_permissions: + id: datadog.organization.user_permissions + name: user_permissions + title: User Permissions + methods: + list_user_permissions: + operation: + $ref: '#/paths/~1api~1v2~1users~1{user_id}~1permissions/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/user_permissions/methods/list_user_permissions + insert: [] + update: [] + delete: [] + replace: [] + user_team_memberships: + id: datadog.organization.user_team_memberships + name: user_team_memberships + title: User Team Memberships + methods: + get_user_memberships: + operation: + $ref: '#/paths/~1api~1v2~1users~1{user_uuid}~1memberships/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/user_team_memberships/methods/get_user_memberships + insert: [] + update: [] + delete: [] + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/organizations.yaml b/providers/src/datadog/v00.00.00000/services/organizations.yaml deleted file mode 100644 index e64a4f34..00000000 --- a/providers/src/datadog/v00.00.00000/services/organizations.yaml +++ /dev/null @@ -1,932 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - organizations - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - IdPMetadataFormData: - description: The form data submitted to upload IdP metadata - properties: - idp_file: - description: The IdP metadata XML file - format: binary - type: string - x-mimetype: application/xml - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - idp_metadata: - id: datadog.organizations.idp_metadata - name: idp_metadata - title: Idp Metadata - methods: - uploadidp_metadata: - operation: - $ref: '#/paths/~1api~1v2~1saml_configurations~1idp_metadata/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: [] - insert: [] - update: [] - delete: [] -paths: - /api/v2/saml_configurations/idp_metadata: - post: - description: |- - Endpoint for uploading IdP metadata for SAML setup. - - Use this endpoint to upload or replace IdP metadata for SAML login configuration. - operationId: UploadIdPMetadata - requestBody: - content: - multipart/form-data: - schema: - $ref: '#/components/schemas/IdPMetadataFormData' - required: true - responses: - '200': - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Upload IdP metadata - tags: - - Organizations - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/powerpack.yaml b/providers/src/datadog/v00.00.00000/services/powerpack.yaml deleted file mode 100644 index 95201ff8..00000000 --- a/providers/src/datadog/v00.00.00000/services/powerpack.yaml +++ /dev/null @@ -1,1642 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - powerpack - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ListPowerpacksResponse: - description: Response object which includes all powerpack configurations. - properties: - data: - description: List of powerpack definitions. - items: - $ref: '#/components/schemas/PowerpackData' - type: array - included: - description: Array of objects related to the users. - items: - $ref: '#/components/schemas/User' - type: array - links: - $ref: '#/components/schemas/PowerpackResponseLinks' - meta: - $ref: '#/components/schemas/PowerpacksResponseMeta' - type: object - PowerpackData: - description: Powerpack data object. - properties: - attributes: - $ref: '#/components/schemas/PowerpackAttributes' - id: - description: ID of the powerpack. - type: string - relationships: - $ref: '#/components/schemas/PowerpackRelationships' - type: - description: 'Type of widget, must be powerpack.' - example: powerpack - type: string - type: object - User: - description: User object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserAttributes' - id: - description: ID of the user. - type: string - relationships: - $ref: '#/components/schemas/UserResponseRelationships' - type: - $ref: '#/components/schemas/UsersType' - type: object - PowerpackResponseLinks: - description: Links attributes. - properties: - first: - description: Link to last page. - type: string - last: - description: Link to first page. - example: 'https://app.datadoghq.com/api/v2/powerpacks?page[offset]=0&page[limit]=25' - nullable: true - type: string - next: - description: Link for the next set of results. - example: 'https://app.datadoghq.com/api/v2/powerpacks?page[offset]=25&page[limit]=25' - type: string - prev: - description: Link for the previous set of results. - nullable: true - type: string - self: - description: Link to current page. - example: 'https://app.datadoghq.com/api/v2/powerpacks' - type: string - type: object - PowerpacksResponseMeta: - description: Powerpack response metadata. - properties: - pagination: - $ref: '#/components/schemas/PowerpacksResponseMetaPagination' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - PowerpackAttributes: - description: Powerpack attribute object. - properties: - description: - description: Description of this powerpack. - example: Powerpack for ABC - type: string - group_widget: - $ref: '#/components/schemas/PowerpackGroupWidget' - name: - description: Name of the powerpack. - example: Sample Powerpack - type: string - tags: - description: List of tags to identify this powerpack. - example: - - 'tag:foo1' - items: - maxLength: 80 - type: string - maxItems: 8 - type: array - template_variables: - description: List of template variables for this powerpack. - example: - - defaults: - - '*' - name: test - items: - $ref: '#/components/schemas/PowerpackTemplateVariable' - type: array - required: - - group_widget - - name - type: object - PowerpackRelationships: - description: Powerpack relationship object. - properties: - author: - $ref: '#/components/schemas/RelationshipToUser' - type: object - UserAttributes: - description: Attributes of user object returned by the API. - properties: - created_at: - description: Creation time of the user. - format: date-time - type: string - disabled: - description: Whether the user is disabled. - type: boolean - email: - description: Email of the user. - type: string - handle: - description: Handle of the user. - type: string - icon: - description: URL of the user's icon. - type: string - modified_at: - description: Time that the user was last modified. - format: date-time - type: string - name: - description: Name of the user. - nullable: true - type: string - service_account: - description: Whether the user is a service account. - type: boolean - status: - description: Status of the user. - type: string - title: - description: Title of the user. - nullable: true - type: string - verified: - description: Whether the user is verified. - type: boolean - type: object - UserResponseRelationships: - description: Relationships of the user object returned by the API. - properties: - org: - $ref: '#/components/schemas/RelationshipToOrganization' - other_orgs: - $ref: '#/components/schemas/RelationshipToOrganizations' - other_users: - $ref: '#/components/schemas/RelationshipToUsers' - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - UsersType: - default: users - description: Users resource type. - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - PowerpacksResponseMetaPagination: - description: Powerpack response pagination metadata. - properties: - first_offset: - description: The first offset. - format: int64 - type: integer - last_offset: - description: The last offset. - format: int64 - nullable: true - type: integer - limit: - description: Pagination limit. - format: int64 - type: integer - next_offset: - description: The next offset. - format: int64 - type: integer - offset: - description: The offset. - format: int64 - type: integer - prev_offset: - description: The previous offset. - format: int64 - type: integer - total: - description: Total results. - format: int64 - type: integer - type: - description: Offset type. - type: string - type: object - PowerpackGroupWidget: - description: Powerpack group widget definition object. - properties: - definition: - $ref: '#/components/schemas/PowerpackGroupWidgetDefinition' - layout: - $ref: '#/components/schemas/PowerpackGroupWidgetLayout' - live_span: - $ref: '#/components/schemas/WidgetLiveSpan' - required: - - definition - type: object - PowerpackTemplateVariable: - description: Powerpack template variables. - properties: - defaults: - description: 'One or many template variable default values within the saved view, which are unioned together using `OR` if more than one is specified.' - items: - description: One or many default values of the template variable. - minLength: 1 - type: string - type: array - name: - description: The name of the variable. - example: datacenter - type: string - required: - - name - type: object - RelationshipToUser: - description: Relationship to user. - properties: - data: - $ref: '#/components/schemas/RelationshipToUserData' - required: - - data - type: object - RelationshipToOrganization: - description: Relationship to an organization. - properties: - data: - $ref: '#/components/schemas/RelationshipToOrganizationData' - required: - - data - type: object - RelationshipToOrganizations: - description: Relationship to organizations. - properties: - data: - description: Relationships to organization objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToOrganizationData' - type: array - required: - - data - type: object - RelationshipToUsers: - description: Relationship to users. - properties: - data: - description: Relationships to user objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToUserData' - type: array - required: - - data - type: object - RelationshipToRoles: - description: Relationship to roles. - properties: - data: - description: An array containing type and the unique identifier of a role. - items: - $ref: '#/components/schemas/RelationshipToRoleData' - type: array - type: object - PowerpackGroupWidgetDefinition: - description: Powerpack group widget object. - properties: - layout_type: - description: Layout type of widgets. - example: ordered - type: string - show_title: - description: Boolean indicating whether powerpack group title should be visible or not. - example: true - type: boolean - title: - description: Name for the group widget. - example: Sample Powerpack - type: string - type: - description: 'Type of widget, must be group.' - example: group - type: string - widgets: - description: Widgets inside the powerpack. - example: - - definition: - content: example - type: note - layout: - height: 5 - width: 10 - x: 0 - 'y': 0 - items: - $ref: '#/components/schemas/PowerpackInnerWidgets' - type: array - required: - - widgets - - layout_type - - type - type: object - PowerpackGroupWidgetLayout: - description: Powerpack group widget layout. - properties: - height: - description: The height of the widget. Should be a non-negative integer. - example: 0 - format: int64 - minimum: 0 - type: integer - width: - description: The width of the widget. Should be a non-negative integer. - example: 0 - format: int64 - minimum: 0 - type: integer - x: - description: The position of the widget on the x (horizontal) axis. Should be a non-negative integer. - example: 0 - format: int64 - minimum: 0 - type: integer - 'y': - description: The position of the widget on the y (vertical) axis. Should be a non-negative integer. - example: 0 - format: int64 - minimum: 0 - type: integer - required: - - x - - 'y' - - width - - height - type: object - WidgetLiveSpan: - description: The available timeframes depend on the widget you are using. - enum: - - 1m - - 5m - - 10m - - 15m - - 30m - - 1h - - 4h - - 1d - - 2d - - 1w - - 1mo - - 3mo - - 6mo - - 1y - - alert - example: 5m - type: string - x-enum-varnames: - - PAST_ONE_MINUTE - - PAST_FIVE_MINUTES - - PAST_TEN_MINUTES - - PAST_FIFTEEN_MINUTES - - PAST_THIRTY_MINUTES - - PAST_ONE_HOUR - - PAST_FOUR_HOURS - - PAST_ONE_DAY - - PAST_TWO_DAYS - - PAST_ONE_WEEK - - PAST_ONE_MONTH - - PAST_THREE_MONTHS - - PAST_SIX_MONTHS - - PAST_ONE_YEAR - - ALERT - RelationshipToUserData: - description: Relationship to user object. - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - RelationshipToOrganizationData: - description: Relationship to organization object. - properties: - id: - description: ID of the organization. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - id - - type - type: object - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - PowerpackInnerWidgets: - description: Powerpack group widget definition of individual widgets. - properties: - definition: - additionalProperties: {} - description: Information about widget. - example: - definition: - content: example - type: note - type: object - layout: - $ref: '#/components/schemas/PowerpackInnerWidgetLayout' - required: - - definition - type: object - OrganizationsType: - default: orgs - description: Organizations resource type. - enum: - - orgs - example: orgs - type: string - x-enum-varnames: - - ORGS - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - PowerpackInnerWidgetLayout: - description: Powerpack inner widget layout. - properties: - height: - description: The height of the widget. Should be a non-negative integer. - example: 0 - format: int64 - minimum: 0 - type: integer - width: - description: The width of the widget. Should be a non-negative integer. - example: 0 - format: int64 - minimum: 0 - type: integer - x: - description: The position of the widget on the x (horizontal) axis. Should be a non-negative integer. - example: 0 - format: int64 - minimum: 0 - type: integer - 'y': - description: The position of the widget on the y (vertical) axis. Should be a non-negative integer. - example: 0 - format: int64 - minimum: 0 - type: integer - required: - - x - - 'y' - - width - - height - type: object - Powerpack: - description: Powerpacks are templated groups of dashboard widgets you can save from an existing dashboard and turn into reusable packs in the widget tray. - properties: - data: - $ref: '#/components/schemas/PowerpackData' - type: object - PowerpackResponse: - description: Response object which includes a single powerpack configuration. - properties: - data: - $ref: '#/components/schemas/PowerpackData' - included: - description: Array of objects related to the users. - items: - $ref: '#/components/schemas/User' - type: array - readOnly: true - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - powerpacks: - id: datadog.powerpack.powerpacks - name: powerpacks - title: Powerpacks - methods: - list_powerpacks: - operation: - $ref: '#/paths/~1api~1v2~1powerpacks/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_powerpacks: - operation: - $ref: '#/paths/~1api~1v2~1powerpacks/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_powerpack: - operation: - $ref: '#/paths/~1api~1v2~1powerpacks/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_powerpack: - operation: - $ref: '#/paths/~1api~1v2~1powerpacks~1{powerpack_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_powerpack: - operation: - $ref: '#/paths/~1api~1v2~1powerpacks~1{powerpack_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_powerpack: - operation: - $ref: '#/paths/~1api~1v2~1powerpacks~1{powerpack_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_powerpack: - operation: - $ref: '#/paths/~1api~1v2~1powerpacks~1{powerpack_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/powerpacks/methods/get_powerpack' - - $ref: '#/components/x-stackQL-resources/powerpacks/methods/list_powerpacks' - insert: - - $ref: '#/components/x-stackQL-resources/powerpacks/methods/create_powerpack' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/powerpacks/methods/delete_powerpack' -paths: - /api/v2/powerpacks: - get: - description: Get a list of all powerpacks. - operationId: ListPowerpacks - parameters: - - description: Maximum number of powerpacks in the response. - example: 25 - in: query - name: 'page[limit]' - required: false - schema: - default: 25 - format: int64 - maximum: 1000 - type: integer - - $ref: '#/components/parameters/PageOffset' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ListPowerpacksResponse' - description: OK - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - dashboards_read - summary: Get all powerpacks - tags: - - Powerpack - x-pagination: - limitParam: 'page[limit]' - pageOffsetParam: 'page[offset]' - resultsPath: data - post: - description: Create a powerpack. - operationId: CreatePowerpack - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/Powerpack' - description: Create a powerpack request body. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PowerpackResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - dashboards_write - summary: Create a new powerpack - tags: - - Powerpack - x-codegen-request-body-name: body - '/api/v2/powerpacks/{powerpack_id}': - delete: - description: Delete a powerpack. - operationId: DeletePowerpack - parameters: - - description: Powerpack id - in: path - name: powerpack_id - required: true - schema: - type: string - responses: - '204': - description: OK - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Powerpack Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - dashboards_write - summary: Delete a powerpack - tags: - - Powerpack - get: - description: Get a powerpack. - operationId: GetPowerpack - parameters: - - description: ID of the powerpack. - in: path - name: powerpack_id - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PowerpackResponse' - description: OK - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Powerpack Not Found. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - dashboards_read - summary: Get a Powerpack - tags: - - Powerpack - patch: - description: Update a powerpack. - operationId: UpdatePowerpack - parameters: - - description: ID of the powerpack. - in: path - name: powerpack_id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/Powerpack' - description: Update a powerpack request body. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PowerpackResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Powerpack Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - dashboards_write - summary: Update a powerpack - tags: - - Powerpack - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/processes.yaml b/providers/src/datadog/v00.00.00000/services/processes.yaml deleted file mode 100644 index 4a140e7e..00000000 --- a/providers/src/datadog/v00.00.00000/services/processes.yaml +++ /dev/null @@ -1,1072 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - processes - description: The processes API allows you to query processes data for your organization. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ProcessSummariesResponse: - description: List of process summaries. - properties: - data: - description: Array of process summary objects. - items: - $ref: '#/components/schemas/ProcessSummary' - type: array - meta: - $ref: '#/components/schemas/ProcessSummariesMeta' - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - ProcessSummary: - description: Process summary object. - properties: - attributes: - $ref: '#/components/schemas/ProcessSummaryAttributes' - id: - description: Process ID. - type: string - type: - $ref: '#/components/schemas/ProcessSummaryType' - type: object - ProcessSummariesMeta: - description: Response metadata object. - properties: - page: - $ref: '#/components/schemas/ProcessSummariesMetaPage' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - ProcessSummaryAttributes: - description: Attributes for a process summary. - properties: - cmdline: - description: Process command line. - type: string - host: - description: Host running the process. - type: string - pid: - description: Process ID. - format: int64 - type: integer - ppid: - description: Parent process ID. - format: int64 - type: integer - start: - description: Time the process was started. - type: string - tags: - description: List of tags associated with the process. - items: - description: A tag associated with the process. - type: string - type: array - timestamp: - description: Time the process was seen. - type: string - user: - description: Process owner. - type: string - type: object - ProcessSummaryType: - default: process - description: Type of process summary. - enum: - - process - example: process - type: string - x-enum-varnames: - - PROCESS - ProcessSummariesMetaPage: - description: Paging attributes. - properties: - after: - description: |- - The cursor used to get the next results, if any. To make the next request, use the same - parameters with the addition of the `page[cursor]`. - example: 911abf1204838d9cdfcb9a96d0b6a1bd03e1b514074f1ce1737c4cbd - type: string - size: - description: Number of results returned. - format: int32 - maximum: 10000 - minimum: 0 - type: integer - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - processes: - id: datadog.processes.processes - name: processes - title: Processes - methods: - list_processes: - operation: - $ref: '#/paths/~1api~1v2~1processes/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_processes: - operation: - $ref: '#/paths/~1api~1v2~1processes/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/processes/methods/list_processes' - insert: [] - update: [] - delete: [] -paths: - /api/v2/processes: - get: - description: Get all processes for your organization. - operationId: ListProcesses - parameters: - - description: String to search processes by. - in: query - name: search - required: false - schema: - type: string - - description: Comma-separated list of tags to filter processes by. - example: 'account:prod,user:admin' - in: query - name: tags - required: false - schema: - type: string - - description: |- - Unix timestamp (number of seconds since epoch) of the start of the query window. - If not provided, the start of the query window will be 15 minutes before the `to` timestamp. If neither - `from` nor `to` are provided, the query window will be `[now - 15m, now]`. - in: query - name: from - required: false - schema: - format: int64 - type: integer - - description: |- - Unix timestamp (number of seconds since epoch) of the end of the query window. - If not provided, the end of the query window will be 15 minutes after the `from` timestamp. If neither - `from` nor `to` are provided, the query window will be `[now - 15m, now]`. - in: query - name: to - required: false - schema: - format: int64 - type: integer - - description: Maximum number of results returned. - in: query - name: 'page[limit]' - required: false - schema: - default: 1000 - format: int32 - maximum: 10000 - minimum: 1 - type: integer - - description: |- - String to query the next page of results. - This key is provided with each valid response from the API in `meta.page.after`. - in: query - name: 'page[cursor]' - required: false - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ProcessSummariesResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get all processes - tags: - - Processes - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data diff --git a/providers/src/datadog/v00.00.00000/services/remote_config.yaml b/providers/src/datadog/v00.00.00000/services/remote_config.yaml new file mode 100644 index 00000000..18f6f300 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/remote_config.yaml @@ -0,0 +1,6784 @@ +openapi: 3.0.0 +info: + title: remote_config API + description: datadog remote_config API + version: '1.0' +paths: + /api/v2/remote_config/products/asm/waf/custom_rules: + get: + description: Retrieve a list of WAF custom rule. + operationId: ListApplicationSecurityWAFCustomRules + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleListResponse + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List all WAF custom rules + tags: + - Application Security + post: + description: Create a new WAF custom rule with the given parameters. + operationId: CreateApplicationSecurityWafCustomRule + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleCreateRequest + description: The definition of the new WAF Custom Rule. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleResponse' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a WAF custom rule + tags: + - Application Security + x-codegen-request-body-name: body + /api/v2/remote_config/products/asm/waf/custom_rules/{custom_rule_id}: + delete: + description: Delete a specific WAF custom rule. + operationId: DeleteApplicationSecurityWafCustomRule + parameters: + - $ref: '#/components/parameters/ApplicationSecurityWafCustomRuleIDParam' + responses: + '204': + description: No Content + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a WAF Custom Rule + tags: + - Application Security + x-terraform-resource: appsec_waf_custom_rule + get: + description: Retrieve a WAF custom rule by ID. + operationId: GetApplicationSecurityWafCustomRule + parameters: + - $ref: '#/components/parameters/ApplicationSecurityWafCustomRuleIDParam' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a WAF custom rule + tags: + - Application Security + x-terraform-resource: appsec_waf_custom_rule + put: + description: |- + Update a specific WAF custom Rule. + Returns the Custom Rule object when the request is successful. + operationId: UpdateApplicationSecurityWafCustomRule + parameters: + - $ref: '#/components/parameters/ApplicationSecurityWafCustomRuleIDParam' + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleUpdateRequest + description: New definition of the WAF Custom Rule. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a WAF Custom Rule + tags: + - Application Security + x-codegen-request-body-name: body + x-terraform-resource: appsec_waf_custom_rule + /api/v2/remote_config/products/asm/waf/exclusion_filters: + get: + description: Retrieve a list of WAF exclusion filters. + operationId: ListApplicationSecurityWafExclusionFilters + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFiltersResponse + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List all WAF exclusion filters + tags: + - Application Security + x-permission: + operator: AND + permissions: + - appsec_protect_read + x-terraform-resource: appsec_waf_exclusion_filter + post: + description: >- + Create a new WAF exclusion filter with the given parameters. + + + A request matched by an exclusion filter will be ignored by the + Application Security WAF product. + + Go to https://app.datadoghq.com/security/appsec/passlist to review + existing exclusion filters (also called passlist entries). + operationId: CreateApplicationSecurityWafExclusionFilter + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterCreateRequest + description: The definition of the new WAF exclusion filter. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterResponse + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a WAF exclusion filter + tags: + - Application Security + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - appsec_protect_write + x-terraform-resource: appsec_waf_exclusion_filter + /api/v2/remote_config/products/asm/waf/exclusion_filters/{exclusion_filter_id}: + delete: + description: Delete a specific WAF exclusion filter using its identifier. + operationId: DeleteApplicationSecurityWafExclusionFilter + parameters: + - $ref: '#/components/parameters/ApplicationSecurityWafExclusionFilterID' + responses: + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a WAF exclusion filter + tags: + - Application Security + x-permission: + operator: AND + permissions: + - appsec_protect_write + x-terraform-resource: appsec_waf_exclusion_filter + get: + description: Retrieve a specific WAF exclusion filter using its identifier. + operationId: GetApplicationSecurityWafExclusionFilter + parameters: + - $ref: '#/components/parameters/ApplicationSecurityWafExclusionFilterID' + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterResponse + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a WAF exclusion filter + tags: + - Application Security + x-permission: + operator: AND + permissions: + - appsec_protect_read + x-terraform-resource: appsec_waf_exclusion_filter + put: + description: |- + Update a specific WAF exclusion filter using its identifier. + Returns the exclusion filter object when the request is successful. + operationId: UpdateApplicationSecurityWafExclusionFilter + parameters: + - $ref: '#/components/parameters/ApplicationSecurityWafExclusionFilterID' + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterUpdateRequest + description: The exclusion filter to update. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterResponse + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a WAF exclusion filter + tags: + - Application Security + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - appsec_protect_write + x-terraform-resource: appsec_waf_exclusion_filter + /api/v2/remote_config/products/cws/agent_rules: + get: + description: >- + Get the list of Workload Protection agent rules. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: ListCSMThreatsAgentRules + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityQueryAgentPolicyID' + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/CloudWorkloadSecurityAgentRulesListResponse + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all Workload Protection agent rules + tags: + - CSM Threats + post: + description: >- + Create a new Workload Protection agent rule with the given parameters. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: CreateCSMThreatsAgentRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateRequest' + description: The definition of the new agent rule + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a Workload Protection agent rule + tags: + - CSM Threats + x-codegen-request-body-name: body + /api/v2/remote_config/products/cws/agent_rules/{agent_rule_id}: + delete: + description: >- + Delete a specific Workload Protection agent rule. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: DeleteCSMThreatsAgentRule + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' + - $ref: '#/components/parameters/CloudWorkloadSecurityQueryAgentPolicyID' + responses: + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a Workload Protection agent rule + tags: + - CSM Threats + get: + description: >- + Get the details of a specific Workload Protection agent rule. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: GetCSMThreatsAgentRule + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' + - $ref: '#/components/parameters/CloudWorkloadSecurityQueryAgentPolicyID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a Workload Protection agent rule + tags: + - CSM Threats + patch: + description: >- + Update a specific Workload Protection Agent rule. + + Returns the agent rule object when the request is successful. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: UpdateCSMThreatsAgentRule + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' + - $ref: '#/components/parameters/CloudWorkloadSecurityQueryAgentPolicyID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateRequest' + description: New definition of the agent rule + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a Workload Protection agent rule + tags: + - CSM Threats + x-codegen-request-body-name: body + /api/v2/remote_config/products/cws/policy: + get: + description: >- + Get the list of Workload Protection policies. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: ListCSMThreatsAgentPolicies + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/CloudWorkloadSecurityAgentPoliciesListResponse + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all Workload Protection policies + tags: + - CSM Threats + post: + description: >- + Create a new Workload Protection policy with the given parameters. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: CreateCSMThreatsAgentPolicy + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/CloudWorkloadSecurityAgentPolicyCreateRequest + description: The definition of the new Agent policy + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a Workload Protection policy + tags: + - CSM Threats + x-codegen-request-body-name: body + /api/v2/remote_config/products/cws/policy/download: + get: + description: >- + The download endpoint generates a Workload Protection policy file from + your currently active + + Workload Protection agent rules, and downloads them as a `.policy` file. + This file can then be deployed to + + your agents to update the policy running in your environment. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: DownloadCSMThreatsPolicy + responses: + '200': + content: + application/zip: + schema: + format: binary + type: string + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Download the Workload Protection policy + tags: + - CSM Threats + /api/v2/remote_config/products/cws/policy/{policy_id}: + delete: + description: >- + Delete a specific Workload Protection policy. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: DeleteCSMThreatsAgentPolicy + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityPathAgentPolicyID' + responses: + '202': + description: OK + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a Workload Protection policy + tags: + - CSM Threats + get: + description: >- + Get the details of a specific Workload Protection policy. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: GetCSMThreatsAgentPolicy + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityPathAgentPolicyID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a Workload Protection policy + tags: + - CSM Threats + patch: + description: >- + Update a specific Workload Protection policy. + + Returns the policy object when the request is successful. + + + **Note**: This endpoint is not available for the Government (US1-FED) + site. Please reference the (US1-FED) specific resource below. + operationId: UpdateCSMThreatsAgentPolicy + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityPathAgentPolicyID' + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/CloudWorkloadSecurityAgentPolicyUpdateRequest + description: New definition of the Agent policy + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a Workload Protection policy + tags: + - CSM Threats + x-codegen-request-body-name: body + /api/v2/remote_config/products/obs_pipelines/pipelines: + get: + description: Retrieve a list of pipelines. + operationId: ListPipelines + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListPipelinesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List pipelines + tags: + - Observability Pipelines + x-permission: + operator: OR + permissions: + - observability_pipelines_read + x-unstable: >- + **Note**: This endpoint is in Preview. Fill out this + [form](https://www.datadoghq.com/product-preview/observability-pipelines-api-and-terraform-support/) + to request access. + post: + description: Create a new pipeline. + operationId: CreatePipeline + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ObservabilityPipelineSpec' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/ObservabilityPipeline' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a new pipeline + tags: + - Observability Pipelines + x-permission: + operator: OR + permissions: + - observability_pipelines_deploy + x-unstable: >- + **Note**: This endpoint is in Preview. Fill out this + [form](https://www.datadoghq.com/product-preview/observability-pipelines-api-and-terraform-support/) + to request access. + /api/v2/remote_config/products/obs_pipelines/pipelines/validate: + post: + description: > + Validates a pipeline configuration without creating or updating any + resources. + + Returns a list of validation errors, if any. + operationId: ValidatePipeline + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ObservabilityPipelineSpec' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ValidationResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Validate an observability pipeline + tags: + - Observability Pipelines + x-permission: + operator: OR + permissions: + - observability_pipelines_read + x-unstable: >- + **Note**: This endpoint is in Preview. Fill out this + [form](https://www.datadoghq.com/product-preview/observability-pipelines-api-and-terraform-support/) + to request access. + /api/v2/remote_config/products/obs_pipelines/pipelines/{pipeline_id}: + delete: + description: Delete a pipeline. + operationId: DeletePipeline + parameters: + - description: The ID of the pipeline to delete. + in: path + name: pipeline_id + required: true + schema: + type: string + responses: + '204': + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '409': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a pipeline + tags: + - Observability Pipelines + x-permission: + operator: OR + permissions: + - observability_pipelines_delete + x-unstable: >- + **Note**: This endpoint is in Preview. Fill out this + [form](https://www.datadoghq.com/product-preview/observability-pipelines-api-and-terraform-support/) + to request access. + get: + description: Get a specific pipeline by its ID. + operationId: GetPipeline + parameters: + - description: The ID of the pipeline to retrieve. + in: path + name: pipeline_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ObservabilityPipeline' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a specific pipeline + tags: + - Observability Pipelines + x-permission: + operator: OR + permissions: + - observability_pipelines_read + x-unstable: >- + **Note**: This endpoint is in Preview. Fill out this + [form](https://www.datadoghq.com/product-preview/observability-pipelines-api-and-terraform-support/) + to request access. + put: + description: Update a pipeline. + operationId: UpdatePipeline + parameters: + - description: The ID of the pipeline to update. + in: path + name: pipeline_id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ObservabilityPipeline' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ObservabilityPipeline' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a pipeline + tags: + - Observability Pipelines + x-permission: + operator: OR + permissions: + - observability_pipelines_deploy + x-unstable: >- + **Note**: This endpoint is in Preview. Fill out this + [form](https://www.datadoghq.com/product-preview/observability-pipelines-api-and-terraform-support/) + to request access. +components: + schemas: + ApplicationSecurityWafCustomRuleListResponse: + description: Response object that includes a list of WAF custom rules. + properties: + data: + description: The WAF custom rule data. + items: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleData' + type: array + type: object + ApplicationSecurityWafCustomRuleCreateRequest: + description: Request object that includes the custom rule to create. + properties: + data: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleCreateData' + required: + - data + type: object + ApplicationSecurityWafCustomRuleResponse: + description: Response object that includes a single WAF custom rule. + properties: + data: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleData' + type: object + ApplicationSecurityWafCustomRuleUpdateRequest: + description: Request object that includes the Custom Rule to update. + properties: + data: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleUpdateData' + required: + - data + type: object + ApplicationSecurityWafExclusionFiltersResponse: + description: Response object for multiple WAF exclusion filters. + properties: + data: + description: A list of WAF exclusion filters. + items: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterResource' + type: array + type: object + ApplicationSecurityWafExclusionFilterCreateRequest: + description: Request object for creating a single WAF exclusion filter. + properties: + data: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterCreateData' + required: + - data + type: object + ApplicationSecurityWafExclusionFilterResponse: + description: Response object for a single WAF exclusion filter. + properties: + data: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterResource' + type: object + ApplicationSecurityWafExclusionFilterUpdateRequest: + description: Request object for updating a single WAF exclusion filter. + properties: + data: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterUpdateData' + required: + - data + type: object + CloudWorkloadSecurityAgentRulesListResponse: + description: Response object that includes a list of Agent rule + properties: + data: + description: A list of Agent rules objects + items: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleData' + type: array + type: object + CloudWorkloadSecurityAgentRuleCreateRequest: + description: Request object that includes the Agent rule to create + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateData' + required: + - data + type: object + CloudWorkloadSecurityAgentRuleResponse: + description: Response object that includes an Agent rule + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleData' + type: object + CloudWorkloadSecurityAgentRuleUpdateRequest: + description: >- + Request object that includes the Agent rule with the attributes to + update + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateData' + required: + - data + type: object + CloudWorkloadSecurityAgentPoliciesListResponse: + description: Response object that includes a list of Agent policies + properties: + data: + description: A list of Agent policy objects + items: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyData' + type: array + type: object + CloudWorkloadSecurityAgentPolicyCreateRequest: + description: Request object that includes the Agent policy to create + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyCreateData' + required: + - data + type: object + CloudWorkloadSecurityAgentPolicyResponse: + description: Response object that includes an Agent policy + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyData' + type: object + CloudWorkloadSecurityAgentPolicyUpdateRequest: + description: >- + Request object that includes the Agent policy with the attributes to + update + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyUpdateData' + required: + - data + type: object + ListPipelinesResponse: + description: >- + Represents the response payload containing a list of pipelines and + associated metadata. + properties: + data: + description: The `schema` `data`. + items: + $ref: '#/components/schemas/ObservabilityPipelineData' + type: array + meta: + $ref: '#/components/schemas/ListPipelinesResponseMeta' + required: + - data + type: object + ObservabilityPipelineSpec: + description: >- + Input schema representing an observability pipeline configuration. Used + in create and validate requests. + properties: + data: + $ref: '#/components/schemas/ObservabilityPipelineSpecData' + required: + - data + type: object + ObservabilityPipeline: + description: Top-level schema representing a pipeline. + properties: + data: + $ref: '#/components/schemas/ObservabilityPipelineData' + required: + - data + type: object + ValidationResponse: + description: Response containing validation errors. + example: + errors: + - meta: + field: region + id: datadog-agent-source + message: Field 'region' is required + title: Field 'region' is required + properties: + errors: + description: The `ValidationResponse` `errors`. + items: + $ref: '#/components/schemas/ValidationError' + type: array + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + ApplicationSecurityWafCustomRuleData: + description: Object for a single WAF custom rule. + properties: + attributes: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleAttributes' + id: + description: The ID of the custom rule. + example: 2857c47d-1e3a-4300-8b2f-dc24089c084b + readOnly: true + type: string + type: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleType' + type: object + ApplicationSecurityWafCustomRuleCreateData: + description: Object for a single WAF custom rule. + properties: + attributes: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleCreateAttributes + type: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleType' + required: + - attributes + - type + type: object + ApplicationSecurityWafCustomRuleUpdateData: + description: Object for a single WAF Custom Rule. + properties: + attributes: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleUpdateAttributes + type: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleType' + required: + - attributes + - type + type: object + ApplicationSecurityWafExclusionFilterResource: + description: A JSON:API resource for an WAF exclusion filter. + properties: + attributes: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterAttributes' + id: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterID' + type: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterType' + type: object + ApplicationSecurityWafExclusionFilterCreateData: + description: Object for creating a single WAF exclusion filter. + properties: + attributes: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterCreateAttributes + type: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterType' + required: + - attributes + - type + type: object + ApplicationSecurityWafExclusionFilterUpdateData: + description: Object for updating a single WAF exclusion filter. + properties: + attributes: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterUpdateAttributes + type: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterType' + required: + - attributes + - type + type: object + CloudWorkloadSecurityAgentRuleData: + description: Object for a single Agent rule + properties: + attributes: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleAttributes' + id: + description: The ID of the Agent rule + example: 3dd-0uc-h1s + type: string + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' + type: object + CloudWorkloadSecurityAgentRuleCreateData: + description: Object for a single Agent rule + properties: + attributes: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateAttributes' + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' + required: + - attributes + - type + type: object + CloudWorkloadSecurityAgentRuleUpdateData: + description: Object for a single Agent rule + properties: + attributes: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateAttributes' + id: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleID' + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' + required: + - attributes + - type + type: object + CloudWorkloadSecurityAgentPolicyData: + description: Object for a single Agent policy + properties: + attributes: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyAttributes' + id: + description: The ID of the Agent policy + example: 6517fcc1-cec7-4394-a655-8d6e9d085255 + type: string + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyType' + type: object + CloudWorkloadSecurityAgentPolicyCreateData: + description: Object for a single Agent rule + properties: + attributes: + $ref: >- + #/components/schemas/CloudWorkloadSecurityAgentPolicyCreateAttributes + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyType' + required: + - attributes + - type + type: object + CloudWorkloadSecurityAgentPolicyUpdateData: + description: Object for a single Agent policy + properties: + attributes: + $ref: >- + #/components/schemas/CloudWorkloadSecurityAgentPolicyUpdateAttributes + id: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyID' + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentPolicyType' + required: + - attributes + - type + type: object + ObservabilityPipelineData: + description: Contains the pipeline’s ID, type, and configuration attributes. + properties: + attributes: + $ref: '#/components/schemas/ObservabilityPipelineDataAttributes' + id: + description: Unique identifier for the pipeline. + example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 + type: string + type: + default: pipelines + description: >- + The resource type identifier. For pipeline resources, this should + always be set to `pipelines`. + example: pipelines + type: string + required: + - id + - type + - attributes + type: object + ListPipelinesResponseMeta: + description: Metadata about the response. + properties: + totalCount: + description: The total number of pipelines. + example: 42 + format: int64 + type: integer + type: object + ObservabilityPipelineSpecData: + description: Contains the the pipeline configuration. + properties: + attributes: + $ref: '#/components/schemas/ObservabilityPipelineDataAttributes' + type: + default: pipelines + description: >- + The resource type identifier. For pipeline resources, this should + always be set to `pipelines`. + example: pipelines + type: string + required: + - type + - attributes + type: object + ValidationError: + description: >- + Represents a single validation error, including a human-readable title + and metadata. + properties: + meta: + $ref: '#/components/schemas/ValidationErrorMeta' + title: + description: A short, human-readable summary of the error. + example: Field 'region' is required + type: string + required: + - title + - meta + type: object + ApplicationSecurityWafCustomRuleAttributes: + description: A WAF custom rule. + properties: + action: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleAction' + blocking: + description: Indicates whether the WAF custom rule will block the request. + example: false + type: boolean + conditions: + description: >- + Conditions for which the WAF Custom Rule will triggers, all + conditions needs to match in order for the WAF + + rule to trigger. + items: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleCondition' + type: array + enabled: + description: Indicates whether the WAF custom rule is enabled. + example: false + type: boolean + metadata: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleMetadata' + name: + description: The Name of the WAF custom rule. + example: Block request from bad useragent + type: string + path_glob: + description: The path glob for the WAF custom rule. + example: /api/search/* + type: string + scope: + description: The scope of the WAF custom rule. + items: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleScope' + type: array + tags: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleTags' + required: + - enabled + - blocking + - name + - tags + - conditions + type: object + ApplicationSecurityWafCustomRuleType: + default: custom_rule + description: The type of the resource. The value should always be `custom_rule`. + enum: + - custom_rule + example: custom_rule + type: string + x-enum-varnames: + - CUSTOM_RULE + ApplicationSecurityWafCustomRuleCreateAttributes: + description: Create a new WAF custom rule. + properties: + action: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleAction' + blocking: + description: Indicates whether the WAF custom rule will block the request. + example: false + type: boolean + conditions: + description: >- + Conditions for which the WAF Custom Rule will triggers, all + conditions needs to match in order for the WAF + + rule to trigger + items: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleCondition' + type: array + enabled: + description: Indicates whether the WAF custom rule is enabled. + example: false + type: boolean + name: + description: The Name of the WAF custom rule. + example: Block request from a bad useragent + type: string + path_glob: + description: The path glob for the WAF custom rule. + example: /api/search/* + type: string + scope: + description: The scope of the WAF custom rule. + items: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleScope' + type: array + tags: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleTags' + required: + - enabled + - blocking + - name + - tags + - conditions + type: object + ApplicationSecurityWafCustomRuleUpdateAttributes: + description: Update a WAF custom rule. + properties: + action: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleAction' + blocking: + description: Indicates whether the WAF custom rule will block the request. + example: false + type: boolean + conditions: + description: >- + Conditions for which the WAF Custom Rule will triggers, all + conditions needs to match in order for the WAF + + rule to trigger. + items: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleCondition' + type: array + enabled: + description: Indicates whether the WAF custom rule is enabled. + example: false + type: boolean + name: + description: The Name of the WAF custom rule. + example: Block request from bad useragent + type: string + path_glob: + description: The path glob for the WAF custom rule. + example: /api/search/* + type: string + scope: + description: The scope of the WAF custom rule. + items: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleScope' + type: array + tags: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleTags' + required: + - enabled + - blocking + - name + - tags + - conditions + type: object + ApplicationSecurityWafExclusionFilterAttributes: + description: Attributes describing a WAF exclusion filter. + properties: + description: + description: A description for the exclusion filter. + example: Exclude false positives on a path + type: string + enabled: + description: Indicates whether the exclusion filter is enabled. + example: true + type: boolean + event_query: + description: >- + The event query matched by the legacy exclusion filter. Cannot be + created nor updated. + type: string + ip_list: + description: >- + The client IP addresses matched by the exclusion filter (CIDR + notation is supported). + items: + example: 198.51.100.72 + type: string + type: array + metadata: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterMetadata' + on_match: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterOnMatch' + parameters: + description: >- + A list of parameters matched by the exclusion filter in the HTTP + query string and HTTP request body. Nested parameters can be matched + by joining fields with a dot character. + items: + example: list.search.query + type: string + type: array + path_glob: + description: The HTTP path glob expression matched by the exclusion filter. + example: /accounts/* + type: string + rules_target: + description: The WAF rules targeted by the exclusion filter. + items: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterRulesTarget + type: array + scope: + description: The services where the exclusion filter is deployed. + items: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterScope' + type: array + search_query: + description: >- + Generated event search query for traces matching the exclusion + filter. + readOnly: true + type: string + type: object + ApplicationSecurityWafExclusionFilterID: + description: The identifier of the WAF exclusion filter. + example: 3dd-0uc-h1s + readOnly: true + type: string + ApplicationSecurityWafExclusionFilterType: + default: exclusion_filter + description: Type of the resource. The value should always be `exclusion_filter`. + enum: + - exclusion_filter + example: exclusion_filter + type: string + x-enum-varnames: + - EXCLUSION_FILTER + ApplicationSecurityWafExclusionFilterCreateAttributes: + description: Attributes for creating a WAF exclusion filter. + properties: + description: + description: A description for the exclusion filter. + example: Exclude false positives on a path + type: string + enabled: + description: Indicates whether the exclusion filter is enabled. + example: true + type: boolean + ip_list: + description: >- + The client IP addresses matched by the exclusion filter (CIDR + notation is supported). + items: + example: 198.51.100.72 + type: string + type: array + on_match: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterOnMatch' + parameters: + description: >- + A list of parameters matched by the exclusion filter in the HTTP + query string and HTTP request body. Nested parameters can be matched + by joining fields with a dot character. + items: + example: list.search.query + type: string + type: array + path_glob: + description: The HTTP path glob expression matched by the exclusion filter. + example: /accounts/* + type: string + rules_target: + description: The WAF rules targeted by the exclusion filter. + items: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterRulesTarget + type: array + scope: + description: The services where the exclusion filter is deployed. + items: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterScope' + type: array + required: + - description + - enabled + type: object + ApplicationSecurityWafExclusionFilterUpdateAttributes: + description: Attributes for updating a WAF exclusion filter. + properties: + description: + description: A description for the exclusion filter. + example: Exclude false positives on a path + type: string + enabled: + description: Indicates whether the exclusion filter is enabled. + example: true + type: boolean + ip_list: + description: >- + The client IP addresses matched by the exclusion filter (CIDR + notation is supported). + items: + example: 198.51.100.72 + type: string + type: array + on_match: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterOnMatch' + parameters: + description: >- + A list of parameters matched by the exclusion filter in the HTTP + query string and HTTP request body. Nested parameters can be matched + by joining fields with a dot character. + items: + example: list.search.query + type: string + type: array + path_glob: + description: The HTTP path glob expression matched by the exclusion filter. + example: /accounts/* + type: string + rules_target: + description: The WAF rules targeted by the exclusion filter. + items: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterRulesTarget + type: array + scope: + description: The services where the exclusion filter is deployed. + items: + $ref: '#/components/schemas/ApplicationSecurityWafExclusionFilterScope' + type: array + required: + - description + - enabled + type: object + CloudWorkloadSecurityAgentRuleAttributes: + description: A Cloud Workload Security Agent rule returned by the API + properties: + actions: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActions' + agentConstraint: + description: The version of the Agent + type: string + blocking: + description: The blocking policies that the rule belongs to + items: + type: string + type: array + category: + description: The category of the Agent rule + example: Process Activity + type: string + creationAuthorUuId: + description: The ID of the user who created the rule + example: e51c9744-d158-11ec-ad23-da7ad0900002 + type: string + creationDate: + description: When the Agent rule was created, timestamp in milliseconds + example: 1624366480320 + format: int64 + type: integer + creator: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreatorAttributes' + defaultRule: + description: Whether the rule is included by default + example: false + type: boolean + description: + description: The description of the Agent rule + example: My Agent rule + type: string + disabled: + description: The disabled policies that the rule belongs to + items: + type: string + type: array + enabled: + description: Whether the Agent rule is enabled + example: true + type: boolean + expression: + description: The SECL expression of the Agent rule + example: exec.file.name == "sh" + type: string + filters: + description: The platforms the Agent rule is supported on + items: + type: string + type: array + monitoring: + description: The monitoring policies that the rule belongs to + items: + type: string + type: array + name: + description: The name of the Agent rule + example: my_agent_rule + type: string + product_tags: + description: The list of product tags associated with the rule + items: + type: string + type: array + updateAuthorUuId: + description: The ID of the user who updated the rule + example: e51c9744-d158-11ec-ad23-da7ad0900002 + type: string + updateDate: + description: Timestamp in milliseconds when the Agent rule was last updated + example: 1624366480320 + format: int64 + type: integer + updatedAt: + description: When the Agent rule was last updated, timestamp in milliseconds + example: 1624366480320 + format: int64 + type: integer + updater: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdaterAttributes' + version: + description: The version of the Agent rule + example: 23 + format: int64 + type: integer + type: object + CloudWorkloadSecurityAgentRuleType: + default: agent_rule + description: The type of the resource, must always be `agent_rule` + enum: + - agent_rule + example: agent_rule + type: string + x-enum-varnames: + - AGENT_RULE + CloudWorkloadSecurityAgentRuleCreateAttributes: + description: Create a new Cloud Workload Security Agent rule. + properties: + actions: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActions' + blocking: + description: The blocking policies that the rule belongs to + items: + type: string + type: array + description: + description: The description of the Agent rule. + example: My Agent rule + type: string + disabled: + description: The disabled policies that the rule belongs to + items: + type: string + type: array + enabled: + description: Whether the Agent rule is enabled + example: true + type: boolean + expression: + description: The SECL expression of the Agent rule. + example: exec.file.name == "sh" + type: string + filters: + description: The platforms the Agent rule is supported on + items: + type: string + type: array + monitoring: + description: The monitoring policies that the rule belongs to + items: + type: string + type: array + name: + description: The name of the Agent rule. + example: my_agent_rule + type: string + policy_id: + description: The ID of the policy where the Agent rule is saved + example: a8c8e364-6556-434d-b798-a4c23de29c0b + type: string + product_tags: + description: The list of product tags associated with the rule + items: + type: string + type: array + required: + - name + - expression + type: object + CloudWorkloadSecurityAgentRuleUpdateAttributes: + description: Update an existing Cloud Workload Security Agent rule + properties: + actions: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActions' + blocking: + description: The blocking policies that the rule belongs to + items: + type: string + type: array + description: + description: The description of the Agent rule + example: My Agent rule + type: string + disabled: + description: The disabled policies that the rule belongs to + items: + type: string + type: array + enabled: + description: Whether the Agent rule is enabled + example: true + type: boolean + expression: + description: The SECL expression of the Agent rule + example: exec.file.name == "sh" + type: string + monitoring: + description: The monitoring policies that the rule belongs to + items: + type: string + type: array + policy_id: + description: The ID of the policy where the Agent rule is saved + example: a8c8e364-6556-434d-b798-a4c23de29c0b + type: string + product_tags: + description: The list of product tags associated with the rule + items: + type: string + type: array + type: object + CloudWorkloadSecurityAgentRuleID: + description: The ID of the Agent rule + example: 3dd-0uc-h1s + type: string + CloudWorkloadSecurityAgentPolicyAttributes: + description: A Cloud Workload Security Agent policy returned by the API + properties: + blockingRulesCount: + description: The number of rules with the blocking feature in this policy + example: 100 + format: int32 + maximum: 2147483647 + type: integer + datadogManaged: + description: Whether the policy is managed by Datadog + example: false + type: boolean + description: + description: The description of the policy + example: My agent policy + type: string + disabledRulesCount: + description: The number of rules that are disabled in this policy + example: 100 + format: int32 + maximum: 2147483647 + type: integer + enabled: + description: Whether the Agent policy is enabled + example: true + type: boolean + hostTags: + description: The host tags defining where this policy is deployed + items: + type: string + type: array + hostTagsLists: + description: >- + The host tags defining where this policy is deployed, the inner + values are linked with AND, the outer values are linked with OR + items: + items: + type: string + type: array + type: array + monitoringRulesCount: + description: The number of rules in the monitoring state in this policy + example: 100 + format: int32 + maximum: 2147483647 + type: integer + name: + description: The name of the policy + example: my_agent_policy + type: string + policyVersion: + description: The version of the policy + example: '1' + type: string + priority: + description: The priority of the policy + example: 10 + format: int64 + type: integer + ruleCount: + description: The number of rules in this policy + example: 100 + format: int32 + maximum: 2147483647 + type: integer + updateDate: + description: Timestamp in milliseconds when the policy was last updated + example: 1624366480320 + format: int64 + type: integer + updatedAt: + description: When the policy was last updated, timestamp in milliseconds + example: 1624366480320 + format: int64 + type: integer + updater: + $ref: >- + #/components/schemas/CloudWorkloadSecurityAgentPolicyUpdaterAttributes + type: object + CloudWorkloadSecurityAgentPolicyType: + default: policy + description: The type of the resource, must always be `policy` + enum: + - policy + example: policy + type: string + x-enum-varnames: + - POLICY + CloudWorkloadSecurityAgentPolicyCreateAttributes: + description: Create a new Cloud Workload Security Agent policy + properties: + description: + description: The description of the policy + example: My agent policy + type: string + enabled: + description: Whether the policy is enabled + example: true + type: boolean + hostTags: + description: The host tags defining where this policy is deployed + items: + type: string + type: array + hostTagsLists: + description: >- + The host tags defining where this policy is deployed, the inner + values are linked with AND, the outer values are linked with OR + items: + items: + type: string + type: array + type: array + name: + description: The name of the policy + example: my_agent_policy + type: string + required: + - name + type: object + CloudWorkloadSecurityAgentPolicyUpdateAttributes: + description: Update an existing Cloud Workload Security Agent policy + properties: + description: + description: The description of the policy + example: My agent policy + type: string + enabled: + description: Whether the policy is enabled + example: true + type: boolean + hostTags: + description: The host tags defining where this policy is deployed + items: + type: string + type: array + hostTagsLists: + description: >- + The host tags defining where this policy is deployed, the inner + values are linked with AND, the outer values are linked with OR + items: + items: + type: string + type: array + type: array + name: + description: The name of the policy + example: my_agent_policy + type: string + type: object + CloudWorkloadSecurityAgentPolicyID: + description: The ID of the Agent policy + example: 6517fcc1-cec7-4394-a655-8d6e9d085255 + type: string + ObservabilityPipelineDataAttributes: + description: >- + Defines the pipeline’s name and its components (sources, processors, and + destinations). + properties: + config: + $ref: '#/components/schemas/ObservabilityPipelineConfig' + name: + description: Name of the pipeline. + example: Main Observability Pipeline + type: string + required: + - name + - config + type: object + ValidationErrorMeta: + description: >- + Describes additional metadata for validation errors, including field + names and error messages. + properties: + field: + description: The field name that caused the error. + example: region + type: string + id: + description: The ID of the component in which the error occurred. + example: datadog-agent-source + type: string + message: + description: The detailed error message. + example: Field 'region' is required + type: string + required: + - message + type: object + ApplicationSecurityWafCustomRuleAction: + description: The definition of `ApplicationSecurityWafCustomRuleAction` object. + properties: + action: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleActionAction' + parameters: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleActionParameters + type: object + ApplicationSecurityWafCustomRuleCondition: + description: One condition of the WAF Custom Rule. + properties: + operator: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleConditionOperator + parameters: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleConditionParameters + required: + - operator + - parameters + type: object + ApplicationSecurityWafCustomRuleMetadata: + description: Metadata associated with the WAF Custom Rule. + properties: + added_at: + description: The date and time the WAF custom rule was created. + example: '2021-01-01T00:00:00Z' + format: date-time + type: string + added_by: + description: The handle of the user who created the WAF custom rule. + example: john.doe@datadoghq.com + type: string + added_by_name: + description: The name of the user who created the WAF custom rule. + example: John Doe + type: string + modified_at: + description: The date and time the WAF custom rule was last updated. + example: '2021-01-01T00:00:00Z' + format: date-time + type: string + modified_by: + description: The handle of the user who last updated the WAF custom rule. + example: john.doe@datadoghq.com + type: string + modified_by_name: + description: The name of the user who last updated the WAF custom rule. + example: John Doe + type: string + readOnly: true + type: object + ApplicationSecurityWafCustomRuleScope: + description: The scope of the WAF custom rule. + properties: + env: + description: The environment scope for the WAF custom rule. + example: prod + type: string + service: + description: The service scope for the WAF custom rule. + example: billing-service + type: string + required: + - service + - env + type: object + ApplicationSecurityWafCustomRuleTags: + additionalProperties: + type: string + description: >- + Tags associated with the WAF Custom Rule. The concatenation of category + and type will form the security + + activity field associated with the traces. + maxProperties: 32 + properties: + category: + $ref: '#/components/schemas/ApplicationSecurityWafCustomRuleTagsCategory' + type: + description: >- + The type of the WAF rule, associated with the category will form the + security activity. + example: users.login.success + type: string + required: + - category + - type + type: object + ApplicationSecurityWafExclusionFilterMetadata: + description: Extra information about the exclusion filter. + properties: + added_at: + description: The creation date of the exclusion filter. + format: date-time + type: string + added_by: + description: The handle of the user who created the exclusion filter. + type: string + added_by_name: + description: The name of the user who created the exclusion filter. + type: string + modified_at: + description: The last modification date of the exclusion filter. + format: date-time + type: string + modified_by: + description: The handle of the user who last modified the exclusion filter. + type: string + modified_by_name: + description: The name of the user who last modified the exclusion filter. + type: string + readOnly: true + type: object + ApplicationSecurityWafExclusionFilterOnMatch: + description: >- + The action taken when the exclusion filter matches. When set to + `monitor`, security traces are emitted but the requests are not blocked. + By default, security traces are not emitted and the requests are not + blocked. + enum: + - monitor + type: string + x-enum-varnames: + - MONITOR + ApplicationSecurityWafExclusionFilterRulesTarget: + description: Target WAF rules based either on an identifier or tags. + properties: + rule_id: + description: Target a single WAF rule based on its identifier. + example: dog-913-009 + type: string + tags: + $ref: >- + #/components/schemas/ApplicationSecurityWafExclusionFilterRulesTargetTags + type: object + ApplicationSecurityWafExclusionFilterScope: + description: Deploy on services based on their environment and/or service name. + properties: + env: + description: Deploy on this environment. + example: www + type: string + service: + description: Deploy on this service. + example: prod + type: string + type: object + CloudWorkloadSecurityAgentRuleActions: + description: The array of actions the rule can perform if triggered + items: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleAction' + nullable: true + type: array + CloudWorkloadSecurityAgentRuleCreatorAttributes: + description: The attributes of the user who created the Agent rule + properties: + handle: + description: The handle of the user + example: datadog.user@example.com + type: string + name: + description: The name of the user + example: Datadog User + nullable: true + type: string + type: object + CloudWorkloadSecurityAgentRuleUpdaterAttributes: + description: The attributes of the user who last updated the Agent rule + properties: + handle: + description: The handle of the user + example: datadog.user@example.com + type: string + name: + description: The name of the user + example: Datadog User + nullable: true + type: string + type: object + CloudWorkloadSecurityAgentPolicyUpdaterAttributes: + description: The attributes of the user who last updated the policy + properties: + handle: + description: The handle of the user + example: datadog.user@example.com + type: string + name: + description: The name of the user + example: Datadog User + nullable: true + type: string + type: object + ObservabilityPipelineConfig: + description: >- + Specifies the pipeline's configuration, including its sources, + processors, and destinations. + properties: + destinations: + description: A list of destination components where processed logs are sent. + example: + - id: datadog-logs-destination + inputs: + - filter-processor + type: datadog_logs + items: + $ref: '#/components/schemas/ObservabilityPipelineConfigDestinationItem' + type: array + processors: + description: A list of processors that transform or enrich log data. + example: + - id: filter-processor + include: service:my-service + inputs: + - datadog-agent-source + type: filter + items: + $ref: '#/components/schemas/ObservabilityPipelineConfigProcessorItem' + type: array + sources: + description: A list of configured data sources for the pipeline. + example: + - id: datadog-agent-source + type: datadog_agent + items: + $ref: '#/components/schemas/ObservabilityPipelineConfigSourceItem' + type: array + required: + - sources + - destinations + type: object + ApplicationSecurityWafCustomRuleActionAction: + default: block_request + description: >- + Override the default action to take when the WAF custom rule would + block. + enum: + - redirect_request + - block_request + example: block_request + type: string + x-enum-varnames: + - REDIRECT_REQUEST + - BLOCK_REQUEST + ApplicationSecurityWafCustomRuleActionParameters: + description: >- + The definition of `ApplicationSecurityWafCustomRuleActionParameters` + object. + properties: + location: + description: The location to redirect to when the WAF custom rule triggers. + example: /blocking + type: string + status_code: + default: 403 + description: The status code to return when the WAF custom rule triggers. + example: 403 + format: int64 + type: integer + type: object + ApplicationSecurityWafCustomRuleConditionOperator: + description: Operator to use for the WAF Condition. + enum: + - match_regex + - '!match_regex' + - phrase_match + - '!phrase_match' + - is_xss + - is_sqli + - exact_match + - '!exact_match' + - ip_match + - '!ip_match' + - capture_data + example: match_regex + type: string + x-enum-varnames: + - MATCH_REGEX + - NOT_MATCH_REGEX + - PHRASE_MATCH + - NOT_PHRASE_MATCH + - IS_XSS + - IS_SQLI + - EXACT_MATCH + - NOT_EXACT_MATCH + - IP_MATCH + - NOT_IP_MATCH + - CAPTURE_DATA + ApplicationSecurityWafCustomRuleConditionParameters: + description: The scope of the WAF custom rule. + properties: + data: + description: >- + Identifier of a list of data from the denylist. Can only be used as + substitution from the list parameter. + example: blocked_users + type: string + inputs: + description: >- + List of inputs on which at least one should match with the given + operator. + items: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleConditionInput + type: array + list: + description: >- + List of value to use with the condition. Only used with the + phrase_match, !phrase_match, exact_match and + + !exact_match operator. + items: + type: string + type: array + options: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleConditionOptions + regex: + description: >- + Regex to use with the condition. Only used with match_regex and + !match_regex operator. + example: path.* + type: string + value: + description: >- + Store the captured value in the specified tag name. Only used with + the capture_data operator. + example: custom_tag + type: string + required: + - inputs + type: object + ApplicationSecurityWafCustomRuleTagsCategory: + description: >- + The category of the WAF Rule, can be either `business_logic`, + `attack_attempt` or `security_response`. + enum: + - attack_attempt + - business_logic + - security_response + example: business_logic + type: string + x-enum-varnames: + - ATTACK_ATTEMPT + - BUSINESS_LOGIC + - SECURITY_RESPONSE + ApplicationSecurityWafExclusionFilterRulesTargetTags: + additionalProperties: + type: string + description: Target multiple WAF rules based on their tags. + properties: + category: + description: The category of the targeted WAF rules. + example: attack_attempt + type: string + type: + description: The type of the targeted WAF rules. + example: lfi + type: string + type: object + CloudWorkloadSecurityAgentRuleAction: + description: The action the rule can perform if triggered + properties: + filter: + description: SECL expression used to target the container to apply the action on + type: string + hash: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActionHash' + kill: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleKill' + metadata: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActionMetadata' + set: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActionSet' + type: object + ObservabilityPipelineConfigDestinationItem: + description: A destination for the pipeline. + oneOf: + - $ref: '#/components/schemas/ObservabilityPipelineDatadogLogsDestination' + - $ref: '#/components/schemas/ObservabilityPipelineAmazonS3Destination' + - $ref: >- + #/components/schemas/ObservabilityPipelineGoogleCloudStorageDestination + - $ref: '#/components/schemas/ObservabilityPipelineSplunkHecDestination' + - $ref: '#/components/schemas/ObservabilityPipelineSumoLogicDestination' + - $ref: '#/components/schemas/ObservabilityPipelineElasticsearchDestination' + - $ref: '#/components/schemas/ObservabilityPipelineRsyslogDestination' + - $ref: '#/components/schemas/ObservabilityPipelineSyslogNgDestination' + - $ref: '#/components/schemas/AzureStorageDestination' + - $ref: '#/components/schemas/MicrosoftSentinelDestination' + - $ref: '#/components/schemas/ObservabilityPipelineGoogleChronicleDestination' + - $ref: '#/components/schemas/ObservabilityPipelineNewRelicDestination' + - $ref: '#/components/schemas/ObservabilityPipelineSentinelOneDestination' + - $ref: '#/components/schemas/ObservabilityPipelineOpenSearchDestination' + - $ref: >- + #/components/schemas/ObservabilityPipelineAmazonOpenSearchDestination + - $ref: '#/components/schemas/ObservabilityPipelineSocketDestination' + - $ref: >- + #/components/schemas/ObservabilityPipelineAmazonSecurityLakeDestination + - $ref: >- + #/components/schemas/ObservabilityPipelineCrowdStrikeNextGenSiemDestination + ObservabilityPipelineConfigProcessorItem: + description: A processor for the pipeline. + oneOf: + - $ref: '#/components/schemas/ObservabilityPipelineFilterProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineParseJSONProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineQuotaProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineAddFieldsProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineRemoveFieldsProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineRenameFieldsProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineGenerateMetricsProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineSampleProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineParseGrokProcessor' + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessor + - $ref: '#/components/schemas/ObservabilityPipelineOcsfMapperProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineAddEnvVarsProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineDedupeProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineEnrichmentTableProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineReduceProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineThrottleProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineCustomProcessor' + - $ref: '#/components/schemas/ObservabilityPipelineDatadogTagsProcessor' + ObservabilityPipelineConfigSourceItem: + description: A data source for the pipeline. + oneOf: + - $ref: '#/components/schemas/ObservabilityPipelineKafkaSource' + - $ref: '#/components/schemas/ObservabilityPipelineDatadogAgentSource' + - $ref: '#/components/schemas/ObservabilityPipelineSplunkTcpSource' + - $ref: '#/components/schemas/ObservabilityPipelineSplunkHecSource' + - $ref: '#/components/schemas/ObservabilityPipelineAmazonS3Source' + - $ref: '#/components/schemas/ObservabilityPipelineFluentdSource' + - $ref: '#/components/schemas/ObservabilityPipelineFluentBitSource' + - $ref: '#/components/schemas/ObservabilityPipelineHttpServerSource' + - $ref: '#/components/schemas/ObservabilityPipelineSumoLogicSource' + - $ref: '#/components/schemas/ObservabilityPipelineRsyslogSource' + - $ref: '#/components/schemas/ObservabilityPipelineSyslogNgSource' + - $ref: '#/components/schemas/ObservabilityPipelineAmazonDataFirehoseSource' + - $ref: '#/components/schemas/ObservabilityPipelineGooglePubSubSource' + - $ref: '#/components/schemas/ObservabilityPipelineHttpClientSource' + - $ref: '#/components/schemas/ObservabilityPipelineLogstashSource' + - $ref: '#/components/schemas/ObservabilityPipelineSocketSource' + ApplicationSecurityWafCustomRuleConditionInput: + description: Input from the request on which the condition should apply. + properties: + address: + $ref: >- + #/components/schemas/ApplicationSecurityWafCustomRuleConditionInputAddress + key_path: + description: Specific path for the input. + items: + type: string + type: array + required: + - address + type: object + ApplicationSecurityWafCustomRuleConditionOptions: + description: Options for the operator of this condition. + properties: + case_sensitive: + default: false + description: Evaluate the value as case sensitive. + type: boolean + min_length: + default: 0 + description: >- + Only evaluate this condition if the value has a minimum amount of + characters. + format: int64 + type: integer + type: object + CloudWorkloadSecurityAgentRuleActionHash: + additionalProperties: {} + description: An empty object indicating the hash action + type: object + CloudWorkloadSecurityAgentRuleKill: + description: Kill system call applied on the container matching the rule + properties: + signal: + description: Supported signals for the kill system call + type: string + type: object + CloudWorkloadSecurityAgentRuleActionMetadata: + description: The metadata action applied on the scope matching the rule + properties: + image_tag: + description: The image tag of the metadata action + type: string + service: + description: The service of the metadata action + type: string + short_image: + description: The short image of the metadata action + type: string + type: object + CloudWorkloadSecurityAgentRuleActionSet: + description: The set action applied on the scope matching the rule + properties: + append: + description: Whether the value should be appended to the field + type: boolean + field: + description: The field of the set action + type: string + name: + description: The name of the set action + type: string + scope: + description: The scope of the set action + type: string + size: + description: The size of the set action + format: int64 + type: integer + ttl: + description: The time to live of the set action + format: int64 + type: integer + value: + description: The value of the set action + type: string + type: object + ObservabilityPipelineDatadogLogsDestination: + description: The `datadog_logs` destination forwards logs to Datadog Log Management. + properties: + id: + description: The unique identifier for this component. + example: datadog-logs-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineDatadogLogsDestinationType' + required: + - id + - type + - inputs + type: object + ObservabilityPipelineAmazonS3Destination: + description: >- + The `amazon_s3` destination sends your logs in Datadog-rehydratable + format to an Amazon S3 bucket for archiving. + properties: + auth: + $ref: '#/components/schemas/ObservabilityPipelineAwsAuth' + bucket: + description: S3 bucket name. + example: error-logs + type: string + id: + description: Unique identifier for the destination component. + example: amazon-s3-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + key_prefix: + description: Optional prefix for object keys. + type: string + region: + description: AWS region of the S3 bucket. + example: us-east-1 + type: string + storage_class: + $ref: >- + #/components/schemas/ObservabilityPipelineAmazonS3DestinationStorageClass + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineAmazonS3DestinationType' + required: + - id + - type + - inputs + - bucket + - region + - storage_class + type: object + ObservabilityPipelineGoogleCloudStorageDestination: + description: > + The `google_cloud_storage` destination stores logs in a Google Cloud + Storage (GCS) bucket. + + It requires a bucket name, GCP authentication, and metadata fields. + properties: + acl: + $ref: >- + #/components/schemas/ObservabilityPipelineGoogleCloudStorageDestinationAcl + auth: + $ref: '#/components/schemas/ObservabilityPipelineGcpAuth' + bucket: + description: Name of the GCS bucket. + example: error-logs + type: string + id: + description: Unique identifier for the destination component. + example: gcs-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + key_prefix: + description: Optional prefix for object keys within the GCS bucket. + type: string + metadata: + description: Custom metadata to attach to each object uploaded to the GCS bucket. + items: + $ref: '#/components/schemas/ObservabilityPipelineMetadataEntry' + type: array + storage_class: + $ref: >- + #/components/schemas/ObservabilityPipelineGoogleCloudStorageDestinationStorageClass + type: + $ref: >- + #/components/schemas/ObservabilityPipelineGoogleCloudStorageDestinationType + required: + - id + - type + - inputs + - bucket + - auth + - storage_class + - acl + type: object + ObservabilityPipelineSplunkHecDestination: + description: > + The `splunk_hec` destination forwards logs to Splunk using the HTTP + Event Collector (HEC). + properties: + auto_extract_timestamp: + description: > + If `true`, Splunk tries to extract timestamps from incoming log + events. + + If `false`, Splunk assigns the time the event was received. + example: true + type: boolean + encoding: + $ref: >- + #/components/schemas/ObservabilityPipelineSplunkHecDestinationEncoding + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: splunk-hec-destination + type: string + index: + description: Optional name of the Splunk index where logs are written. + example: main + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + sourcetype: + description: The Splunk sourcetype to assign to log events. + example: custom_sourcetype + type: string + type: + $ref: '#/components/schemas/ObservabilityPipelineSplunkHecDestinationType' + required: + - id + - type + - inputs + type: object + ObservabilityPipelineSumoLogicDestination: + description: The `sumo_logic` destination forwards logs to Sumo Logic. + properties: + encoding: + $ref: >- + #/components/schemas/ObservabilityPipelineSumoLogicDestinationEncoding + header_custom_fields: + description: A list of custom headers to include in the request to Sumo Logic. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineSumoLogicDestinationHeaderCustomFieldsItem + type: array + header_host_name: + description: Optional override for the host name header. + example: host-123 + type: string + header_source_category: + description: Optional override for the source category header. + example: source-category + type: string + header_source_name: + description: Optional override for the source name header. + example: source-name + type: string + id: + description: The unique identifier for this component. + example: sumo-logic-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineSumoLogicDestinationType' + required: + - id + - type + - inputs + type: object + ObservabilityPipelineElasticsearchDestination: + description: The `elasticsearch` destination writes logs to an Elasticsearch cluster. + properties: + api_version: + $ref: >- + #/components/schemas/ObservabilityPipelineElasticsearchDestinationApiVersion + bulk_index: + description: The index to write logs to in Elasticsearch. + example: logs-index + type: string + id: + description: The unique identifier for this component. + example: elasticsearch-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + type: + $ref: >- + #/components/schemas/ObservabilityPipelineElasticsearchDestinationType + required: + - id + - type + - inputs + type: object + ObservabilityPipelineRsyslogDestination: + description: >- + The `rsyslog` destination forwards logs to an external `rsyslog` server + over TCP or UDP using the syslog protocol. + properties: + id: + description: The unique identifier for this component. + example: rsyslog-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + keepalive: + description: Optional socket keepalive duration in milliseconds. + example: 60000 + format: int64 + minimum: 0 + type: integer + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineRsyslogDestinationType' + required: + - id + - type + - inputs + type: object + ObservabilityPipelineSyslogNgDestination: + description: >- + The `syslog_ng` destination forwards logs to an external `syslog-ng` + server over TCP or UDP using the syslog protocol. + properties: + id: + description: The unique identifier for this component. + example: syslog-ng-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + keepalive: + description: Optional socket keepalive duration in milliseconds. + example: 60000 + format: int64 + minimum: 0 + type: integer + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineSyslogNgDestinationType' + required: + - id + - type + - inputs + type: object + AzureStorageDestination: + description: >- + The `azure_storage` destination forwards logs to an Azure Blob Storage + container. + properties: + blob_prefix: + description: Optional prefix for blobs written to the container. + example: logs/ + type: string + container_name: + description: The name of the Azure Blob Storage container to store logs in. + example: my-log-container + type: string + id: + description: The unique identifier for this component. + example: azure-storage-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - processor-id + items: + type: string + type: array + type: + $ref: '#/components/schemas/AzureStorageDestinationType' + required: + - id + - type + - inputs + - container_name + type: object + MicrosoftSentinelDestination: + description: >- + The `microsoft_sentinel` destination forwards logs to Microsoft + Sentinel. + properties: + client_id: + description: Azure AD client ID used for authentication. + example: a1b2c3d4-5678-90ab-cdef-1234567890ab + type: string + dcr_immutable_id: + description: The immutable ID of the Data Collection Rule (DCR). + example: dcr-uuid-1234 + type: string + id: + description: The unique identifier for this component. + example: sentinel-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + table: + description: The name of the Log Analytics table where logs are sent. + example: CustomLogsTable + type: string + tenant_id: + description: Azure AD tenant ID. + example: abcdef12-3456-7890-abcd-ef1234567890 + type: string + type: + $ref: '#/components/schemas/MicrosoftSentinelDestinationType' + required: + - id + - type + - inputs + - client_id + - tenant_id + - dcr_immutable_id + - table + type: object + ObservabilityPipelineGoogleChronicleDestination: + description: The `google_chronicle` destination sends logs to Google Chronicle. + properties: + auth: + $ref: '#/components/schemas/ObservabilityPipelineGcpAuth' + customer_id: + description: The Google Chronicle customer ID. + example: abcdefg123456789 + type: string + encoding: + $ref: >- + #/components/schemas/ObservabilityPipelineGoogleChronicleDestinationEncoding + id: + description: The unique identifier for this component. + example: google-chronicle-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - parse-json-processor + items: + type: string + type: array + log_type: + description: The log type metadata associated with the Chronicle destination. + example: nginx_logs + type: string + type: + $ref: >- + #/components/schemas/ObservabilityPipelineGoogleChronicleDestinationType + required: + - id + - type + - inputs + - auth + - customer_id + type: object + ObservabilityPipelineNewRelicDestination: + description: The `new_relic` destination sends logs to the New Relic platform. + properties: + id: + description: The unique identifier for this component. + example: new-relic-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - parse-json-processor + items: + type: string + type: array + region: + $ref: '#/components/schemas/ObservabilityPipelineNewRelicDestinationRegion' + type: + $ref: '#/components/schemas/ObservabilityPipelineNewRelicDestinationType' + required: + - id + - type + - inputs + - region + type: object + ObservabilityPipelineSentinelOneDestination: + description: The `sentinel_one` destination sends logs to SentinelOne. + properties: + id: + description: The unique identifier for this component. + example: sentinelone-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + region: + $ref: >- + #/components/schemas/ObservabilityPipelineSentinelOneDestinationRegion + type: + $ref: '#/components/schemas/ObservabilityPipelineSentinelOneDestinationType' + required: + - id + - type + - inputs + - region + type: object + ObservabilityPipelineOpenSearchDestination: + description: The `opensearch` destination writes logs to an OpenSearch cluster. + properties: + bulk_index: + description: The index to write logs to. + example: logs-index + type: string + id: + description: The unique identifier for this component. + example: opensearch-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineOpenSearchDestinationType' + required: + - id + - type + - inputs + type: object + ObservabilityPipelineAmazonOpenSearchDestination: + description: The `amazon_opensearch` destination writes logs to Amazon OpenSearch. + properties: + auth: + $ref: >- + #/components/schemas/ObservabilityPipelineAmazonOpenSearchDestinationAuth + bulk_index: + description: The index to write logs to. + example: logs-index + type: string + id: + description: The unique identifier for this component. + example: elasticsearch-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + type: + $ref: >- + #/components/schemas/ObservabilityPipelineAmazonOpenSearchDestinationType + required: + - id + - type + - inputs + - auth + type: object + ObservabilityPipelineSocketDestination: + description: | + The `socket` destination sends logs over TCP or UDP to a remote server. + properties: + encoding: + $ref: '#/components/schemas/ObservabilityPipelineSocketDestinationEncoding' + framing: + $ref: '#/components/schemas/ObservabilityPipelineSocketDestinationFraming' + id: + description: The unique identifier for this component. + example: socket-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + mode: + $ref: '#/components/schemas/ObservabilityPipelineSocketDestinationMode' + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + description: TLS configuration. Relevant only when `mode` is `tcp`. + type: + $ref: '#/components/schemas/ObservabilityPipelineSocketDestinationType' + required: + - id + - type + - inputs + - encoding + - framing + - mode + type: object + ObservabilityPipelineAmazonSecurityLakeDestination: + description: > + The `amazon_security_lake` destination sends your logs to Amazon + Security Lake. + properties: + auth: + $ref: '#/components/schemas/ObservabilityPipelineAwsAuth' + bucket: + description: Name of the Amazon S3 bucket in Security Lake (3-63 characters). + example: security-lake-bucket + type: string + custom_source_name: + description: Custom source name for the logs in Security Lake. + example: my-custom-source + type: string + id: + description: Unique identifier for the destination component. + example: amazon-security-lake-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + region: + description: AWS region of the S3 bucket. + example: us-east-1 + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: >- + #/components/schemas/ObservabilityPipelineAmazonSecurityLakeDestinationType + required: + - id + - type + - inputs + - bucket + - region + - custom_source_name + type: object + ObservabilityPipelineCrowdStrikeNextGenSiemDestination: + description: >- + The `crowdstrike_next_gen_siem` destination forwards logs to CrowdStrike + Next Gen SIEM. + properties: + compression: + $ref: >- + #/components/schemas/ObservabilityPipelineCrowdStrikeNextGenSiemDestinationCompression + encoding: + $ref: >- + #/components/schemas/ObservabilityPipelineCrowdStrikeNextGenSiemDestinationEncoding + id: + description: The unique identifier for this component. + example: crowdstrike-ngsiem-destination + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - filter-processor + items: + type: string + type: array + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: >- + #/components/schemas/ObservabilityPipelineCrowdStrikeNextGenSiemDestinationType + required: + - id + - type + - inputs + - encoding + type: object + ObservabilityPipelineFilterProcessor: + description: >- + The `filter` processor allows conditional processing of logs based on a + Datadog search query. Logs that match the `include` query are passed + through; others are discarded. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (for example, as the + `input` to downstream components). + example: filter-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs should pass + through the filter. Logs that match this query continue to + downstream components; others are dropped. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineFilterProcessorType' + required: + - id + - type + - include + - inputs + type: object + ObservabilityPipelineParseJSONProcessor: + description: >- + The `parse_json` processor extracts JSON from a specified field and + flattens it into the event. This is useful when logs contain embedded + JSON as a string. + properties: + field: + description: The name of the log field that contains a JSON string. + example: message + type: string + id: + description: >- + A unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: parse-json-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineParseJSONProcessorType' + required: + - id + - type + - include + - field + - inputs + type: object + ObservabilityPipelineQuotaProcessor: + description: >- + The Quota Processor measures logging traffic for logs that match a + specified filter. When the configured daily quota is met, the processor + can drop or alert. + properties: + drop_events: + description: >- + If set to `true`, logs that matched the quota filter and sent after + the quota has been met are dropped; only logs that did not match the + filter query continue through the pipeline. + example: false + type: boolean + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (for example, as the + `input` to downstream components). + example: quota-processor + type: string + ignore_when_missing_partitions: + description: >- + If `true`, the processor skips quota checks when partition fields + are missing from the logs. + type: boolean + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + limit: + $ref: '#/components/schemas/ObservabilityPipelineQuotaProcessorLimit' + name: + description: Name of the quota. + example: MyQuota + type: string + overflow_action: + $ref: >- + #/components/schemas/ObservabilityPipelineQuotaProcessorOverflowAction + overrides: + description: >- + A list of alternate quota rules that apply to specific sets of + events, identified by matching field values. Each override can + define a custom limit. + items: + $ref: '#/components/schemas/ObservabilityPipelineQuotaProcessorOverride' + type: array + partition_fields: + description: >- + A list of fields used to segment log traffic for quota enforcement. + Quotas are tracked independently by unique combinations of these + field values. + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineQuotaProcessorType' + required: + - id + - type + - include + - name + - drop_events + - limit + - inputs + type: object + ObservabilityPipelineAddFieldsProcessor: + description: The `add_fields` processor adds static key-value fields to logs. + properties: + fields: + description: >- + A list of static fields (key-value pairs) that is added to each log + event processed by this component. + items: + $ref: '#/components/schemas/ObservabilityPipelineFieldValue' + type: array + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (for example, as the + `input` to downstream components). + example: add-fields-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineAddFieldsProcessorType' + required: + - id + - type + - include + - fields + - inputs + type: object + ObservabilityPipelineRemoveFieldsProcessor: + description: The `remove_fields` processor deletes specified fields from logs. + properties: + fields: + description: A list of field names to be removed from each log event. + example: + - field1 + - field2 + items: + type: string + type: array + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: remove-fields-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: The `PipelineRemoveFieldsProcessor` `inputs`. + example: + - datadog-agent-source + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineRemoveFieldsProcessorType' + required: + - id + - type + - include + - fields + - inputs + type: object + ObservabilityPipelineRenameFieldsProcessor: + description: The `rename_fields` processor changes field names. + properties: + fields: + description: >- + A list of rename rules specifying which fields to rename in the + event, what to rename them to, and whether to preserve the original + fields. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineRenameFieldsProcessorField + type: array + id: + description: >- + A unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: rename-fields-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineRenameFieldsProcessorType' + required: + - id + - type + - include + - fields + - inputs + type: object + ObservabilityPipelineGenerateMetricsProcessor: + description: > + The `generate_datadog_metrics` processor creates custom metrics from + logs and sends them to Datadog. + + Metrics can be counters, gauges, or distributions and optionally grouped + by log fields. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline. + example: generate-metrics-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + processor. + example: + - source-id + items: + type: string + type: array + metrics: + description: Configuration for generating individual metrics. + items: + $ref: '#/components/schemas/ObservabilityPipelineGeneratedMetric' + type: array + type: + $ref: >- + #/components/schemas/ObservabilityPipelineGenerateMetricsProcessorType + required: + - id + - type + - inputs + - include + - metrics + type: object + ObservabilityPipelineSampleProcessor: + description: >- + The `sample` processor allows probabilistic sampling of logs at a fixed + rate. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (for example, as the + `input` to downstream components). + example: sample-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + percentage: + description: The percentage of logs to sample. + example: 10 + format: double + type: number + rate: + description: Number of events to sample (1 in N). + example: 10 + format: int64 + minimum: 1 + type: integer + type: + $ref: '#/components/schemas/ObservabilityPipelineSampleProcessorType' + required: + - id + - type + - include + - inputs + type: object + ObservabilityPipelineParseGrokProcessor: + description: >- + The `parse_grok` processor extracts structured fields from unstructured + log messages using Grok patterns. + properties: + disable_library_rules: + default: false + description: >- + If set to `true`, disables the default Grok rules provided by + Datadog. + example: true + type: boolean + id: + description: A unique identifier for this processor. + example: parse-grok-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + rules: + description: >- + The list of Grok parsing rules. If multiple matching rules are + provided, they are evaluated in order. The first successful match is + applied. + items: + $ref: '#/components/schemas/ObservabilityPipelineParseGrokProcessorRule' + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineParseGrokProcessorType' + required: + - id + - type + - include + - inputs + - rules + type: object + ObservabilityPipelineSensitiveDataScannerProcessor: + description: >- + The `sensitive_data_scanner` processor detects and optionally redacts + sensitive data in log events. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: sensitive-scanner + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: source:prod + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - parse-json-processor + items: + type: string + type: array + rules: + description: >- + A list of rules for identifying and acting on sensitive data + patterns. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorRule + type: array + type: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorType + required: + - id + - type + - include + - inputs + - rules + type: object + ObservabilityPipelineOcsfMapperProcessor: + description: >- + The `ocsf_mapper` processor transforms logs into the OCSF schema using a + predefined mapping configuration. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline. + example: ocsf-mapper-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + processor. + example: + - filter-processor + items: + type: string + type: array + mappings: + description: A list of mapping rules to convert events to the OCSF format. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineOcsfMapperProcessorMapping + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineOcsfMapperProcessorType' + required: + - id + - type + - include + - inputs + - mappings + type: object + ObservabilityPipelineAddEnvVarsProcessor: + description: >- + The `add_env_vars` processor adds environment variable values to log + events. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + processor in the pipeline. + example: add-env-vars-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the input for this + processor. + example: + - datadog-agent-source + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineAddEnvVarsProcessorType' + variables: + description: A list of environment variable mappings to apply to log fields. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineAddEnvVarsProcessorVariable + type: array + required: + - id + - type + - include + - inputs + - variables + type: object + ObservabilityPipelineDedupeProcessor: + description: The `dedupe` processor removes duplicate fields in log events. + properties: + fields: + description: A list of log field paths to check for duplicates. + example: + - log.message + - log.error + items: + type: string + type: array + id: + description: The unique identifier for this processor. + example: dedupe-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the input for this + processor. + example: + - parse-json-processor + items: + type: string + type: array + mode: + $ref: '#/components/schemas/ObservabilityPipelineDedupeProcessorMode' + type: + $ref: '#/components/schemas/ObservabilityPipelineDedupeProcessorType' + required: + - id + - type + - include + - inputs + - fields + - mode + type: object + ObservabilityPipelineEnrichmentTableProcessor: + description: >- + The `enrichment_table` processor enriches logs using a static CSV file + or GeoIP database. + properties: + file: + $ref: '#/components/schemas/ObservabilityPipelineEnrichmentTableFile' + geoip: + $ref: '#/components/schemas/ObservabilityPipelineEnrichmentTableGeoIp' + id: + description: The unique identifier for this processor. + example: enrichment-table-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: source:my-source + type: string + inputs: + description: >- + A list of component IDs whose output is used as the input for this + processor. + example: + - add-fields-processor + items: + type: string + type: array + target: + description: Path where enrichment results should be stored in the log. + example: enriched.geoip + type: string + type: + $ref: >- + #/components/schemas/ObservabilityPipelineEnrichmentTableProcessorType + required: + - id + - type + - include + - inputs + - target + type: object + ObservabilityPipelineReduceProcessor: + description: >- + The `reduce` processor aggregates and merges logs based on matching keys + and merge strategies. + properties: + group_by: + description: A list of fields used to group log events for merging. + example: + - log.user.id + - log.device.id + items: + type: string + type: array + id: + description: The unique identifier for this processor. + example: reduce-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: env:prod + type: string + inputs: + description: >- + A list of component IDs whose output is used as the input for this + processor. + example: + - parse-json-processor + items: + type: string + type: array + merge_strategies: + description: >- + List of merge strategies defining how values from grouped events + should be combined. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineReduceProcessorMergeStrategy + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineReduceProcessorType' + required: + - id + - type + - include + - inputs + - group_by + - merge_strategies + type: object + ObservabilityPipelineThrottleProcessor: + description: >- + The `throttle` processor limits the number of events that pass through + over a given time window. + properties: + group_by: + description: >- + Optional list of fields used to group events before the threshold + has been reached. + example: + - log.user.id + items: + type: string + type: array + id: + description: The unique identifier for this processor. + example: throttle-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: env:prod + type: string + inputs: + description: >- + A list of component IDs whose output is used as the input for this + processor. + example: + - datadog-agent-source + items: + type: string + type: array + threshold: + description: >- + the number of events allowed in a given time window. Events sent + after the threshold has been reached, are dropped. + example: 1000 + format: int64 + type: integer + type: + $ref: '#/components/schemas/ObservabilityPipelineThrottleProcessorType' + window: + description: The time window in seconds over which the threshold applies. + example: 60 + format: double + type: number + required: + - id + - type + - include + - inputs + - threshold + - window + type: object + ObservabilityPipelineCustomProcessor: + description: >- + The `custom_processor` processor transforms events using [Vector Remap + Language (VRL)](https://vector.dev/docs/reference/vrl/) scripts with + advanced filtering capabilities. + properties: + id: + description: The unique identifier for this processor. + example: remap-vrl-processor + type: string + include: + default: '*' + description: >- + A Datadog search query used to determine which logs this processor + targets. This field should always be set to `*` for the + custom_processor processor. + example: '*' + type: string + inputs: + description: >- + A list of component IDs whose output is used as the input for this + processor. + example: + - datadog-agent-source + items: + type: string + type: array + remaps: + description: Array of VRL remap rules. + items: + $ref: '#/components/schemas/ObservabilityPipelineCustomProcessorRemap' + minItems: 1 + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineCustomProcessorType' + required: + - id + - type + - include + - remaps + - inputs + type: object + ObservabilityPipelineDatadogTagsProcessor: + description: >- + The `datadog_tags` processor includes or excludes specific Datadog tags + in your logs. + properties: + action: + $ref: '#/components/schemas/ObservabilityPipelineDatadogTagsProcessorAction' + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (for example, as the + `input` to downstream components). + example: datadog-tags-processor + type: string + include: + description: >- + A Datadog search query used to determine which logs this processor + targets. + example: service:my-service + type: string + inputs: + description: >- + A list of component IDs whose output is used as the `input` for this + component. + example: + - datadog-agent-source + items: + type: string + type: array + keys: + description: A list of tag keys. + example: + - env + - service + - version + items: + type: string + type: array + mode: + $ref: '#/components/schemas/ObservabilityPipelineDatadogTagsProcessorMode' + type: + $ref: '#/components/schemas/ObservabilityPipelineDatadogTagsProcessorType' + required: + - id + - type + - include + - mode + - action + - keys + - inputs + type: object + ObservabilityPipelineKafkaSource: + description: The `kafka` source ingests data from Apache Kafka topics. + properties: + group_id: + description: Consumer group ID used by the Kafka client. + example: consumer-group-0 + type: string + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: kafka-source + type: string + librdkafka_options: + description: >- + Optional list of advanced Kafka client configuration options, + defined as key-value pairs. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineKafkaSourceLibrdkafkaOption + type: array + sasl: + $ref: '#/components/schemas/ObservabilityPipelineKafkaSourceSasl' + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + topics: + description: >- + A list of Kafka topic names to subscribe to. The source ingests + messages from each topic specified. + example: + - topic1 + - topic2 + items: + type: string + type: array + type: + $ref: '#/components/schemas/ObservabilityPipelineKafkaSourceType' + required: + - id + - type + - group_id + - topics + type: object + ObservabilityPipelineDatadogAgentSource: + description: The `datadog_agent` source collects logs from the Datadog Agent. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: datadog-agent-source + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineDatadogAgentSourceType' + required: + - id + - type + type: object + ObservabilityPipelineSplunkTcpSource: + description: > + The `splunk_tcp` source receives logs from a Splunk Universal Forwarder + over TCP. + + TLS is supported for secure transmission. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: splunk-tcp-source + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineSplunkTcpSourceType' + required: + - id + - type + type: object + ObservabilityPipelineSplunkHecSource: + description: > + The `splunk_hec` source implements the Splunk HTTP Event Collector (HEC) + API. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: splunk-hec-source + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineSplunkHecSourceType' + required: + - id + - type + type: object + ObservabilityPipelineAmazonS3Source: + description: | + The `amazon_s3` source ingests logs from an Amazon S3 bucket. + It supports AWS authentication and TLS encryption. + properties: + auth: + $ref: '#/components/schemas/ObservabilityPipelineAwsAuth' + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: aws-s3-source + type: string + region: + description: AWS region where the S3 bucket resides. + example: us-east-1 + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineAmazonS3SourceType' + required: + - id + - type + - region + type: object + ObservabilityPipelineFluentdSource: + description: The `fluentd` source ingests logs from a Fluentd-compatible service. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (for example, as the + `input` to downstream components). + example: fluent-source + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineFluentdSourceType' + required: + - id + - type + type: object + ObservabilityPipelineFluentBitSource: + description: The `fluent_bit` source ingests logs from Fluent Bit. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (for example, as the + `input` to downstream components). + example: fluent-source + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineFluentBitSourceType' + required: + - id + - type + type: object + ObservabilityPipelineHttpServerSource: + description: >- + The `http_server` source collects logs over HTTP POST from external + services. + properties: + auth_strategy: + $ref: >- + #/components/schemas/ObservabilityPipelineHttpServerSourceAuthStrategy + decoding: + $ref: '#/components/schemas/ObservabilityPipelineDecoding' + id: + description: Unique ID for the HTTP server source. + example: http-server-source + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineHttpServerSourceType' + required: + - id + - type + - auth_strategy + - decoding + type: object + ObservabilityPipelineSumoLogicSource: + description: The `sumo_logic` source receives logs from Sumo Logic collectors. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: sumo-logic-source + type: string + type: + $ref: '#/components/schemas/ObservabilityPipelineSumoLogicSourceType' + required: + - id + - type + type: object + ObservabilityPipelineRsyslogSource: + description: >- + The `rsyslog` source listens for logs over TCP or UDP from an `rsyslog` + server using the syslog protocol. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: rsyslog-source + type: string + mode: + $ref: '#/components/schemas/ObservabilityPipelineSyslogSourceMode' + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineRsyslogSourceType' + required: + - id + - type + - mode + type: object + ObservabilityPipelineSyslogNgSource: + description: >- + The `syslog_ng` source listens for logs over TCP or UDP from a + `syslog-ng` server using the syslog protocol. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: syslog-ng-source + type: string + mode: + $ref: '#/components/schemas/ObservabilityPipelineSyslogSourceMode' + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineSyslogNgSourceType' + required: + - id + - type + - mode + type: object + ObservabilityPipelineAmazonDataFirehoseSource: + description: The `amazon_data_firehose` source ingests logs from AWS Data Firehose. + properties: + auth: + $ref: '#/components/schemas/ObservabilityPipelineAwsAuth' + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: amazon-firehose-source + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: >- + #/components/schemas/ObservabilityPipelineAmazonDataFirehoseSourceType + required: + - id + - type + type: object + ObservabilityPipelineGooglePubSubSource: + description: >- + The `google_pubsub` source ingests logs from a Google Cloud Pub/Sub + subscription. + properties: + auth: + $ref: '#/components/schemas/ObservabilityPipelineGcpAuth' + decoding: + $ref: '#/components/schemas/ObservabilityPipelineDecoding' + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: google-pubsub-source + type: string + project: + description: The GCP project ID that owns the Pub/Sub subscription. + example: my-gcp-project + type: string + subscription: + description: The Pub/Sub subscription name from which messages are consumed. + example: logs-subscription + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineGooglePubSubSourceType' + required: + - id + - type + - auth + - decoding + - project + - subscription + type: object + ObservabilityPipelineHttpClientSource: + description: >- + The `http_client` source scrapes logs from HTTP endpoints at regular + intervals. + properties: + auth_strategy: + $ref: >- + #/components/schemas/ObservabilityPipelineHttpClientSourceAuthStrategy + decoding: + $ref: '#/components/schemas/ObservabilityPipelineDecoding' + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: http-client-source + type: string + scrape_interval_secs: + description: The interval (in seconds) between HTTP scrape requests. + example: 60 + format: int64 + type: integer + scrape_timeout_secs: + description: The timeout (in seconds) for each scrape request. + example: 10 + format: int64 + type: integer + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineHttpClientSourceType' + required: + - id + - type + - decoding + type: object + ObservabilityPipelineLogstashSource: + description: The `logstash` source ingests logs from a Logstash forwarder. + properties: + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: logstash-source + type: string + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + type: + $ref: '#/components/schemas/ObservabilityPipelineLogstashSourceType' + required: + - id + - type + type: object + ObservabilityPipelineSocketSource: + description: | + The `socket` source ingests logs over TCP or UDP. + properties: + framing: + $ref: '#/components/schemas/ObservabilityPipelineSocketSourceFraming' + id: + description: >- + The unique identifier for this component. Used to reference this + component in other parts of the pipeline (e.g., as input to + downstream components). + example: socket-source + type: string + mode: + $ref: '#/components/schemas/ObservabilityPipelineSocketSourceMode' + tls: + $ref: '#/components/schemas/ObservabilityPipelineTls' + description: TLS configuration. Relevant only when `mode` is `tcp`. + type: + $ref: '#/components/schemas/ObservabilityPipelineSocketSourceType' + required: + - id + - type + - mode + - framing + type: object + ApplicationSecurityWafCustomRuleConditionInputAddress: + description: Input from the request on which the condition should apply. + enum: + - server.db.statement + - server.io.fs.file + - server.io.net.url + - server.sys.shell.cmd + - server.request.method + - server.request.uri.raw + - server.request.path_params + - server.request.query + - server.request.headers.no_cookies + - server.request.cookies + - server.request.trailers + - server.request.body + - server.response.status + - server.response.headers.no_cookies + - server.response.trailers + - grpc.server.request.metadata + - grpc.server.request.message + - grpc.server.method + - graphql.server.all_resolvers + - usr.id + - http.client_ip + example: server.db.statement + type: string + x-enum-varnames: + - SERVER_DB_STATEMENT + - SERVER_IO_FS_FILE + - SERVER_IO_NET_URL + - SERVER_SYS_SHELL_CMD + - SERVER_REQUEST_METHOD + - SERVER_REQUEST_URI_RAW + - SERVER_REQUEST_PATH_PARAMS + - SERVER_REQUEST_QUERY + - SERVER_REQUEST_HEADERS_NO_COOKIES + - SERVER_REQUEST_COOKIES + - SERVER_REQUEST_TRAILERS + - SERVER_REQUEST_BODY + - SERVER_RESPONSE_STATUS + - SERVER_RESPONSE_HEADERS_NO_COOKIES + - SERVER_RESPONSE_TRAILERS + - GRPC_SERVER_REQUEST_METADATA + - GRPC_SERVER_REQUEST_MESSAGE + - GRPC_SERVER_METHOD + - GRAPHQL_SERVER_ALL_RESOLVERS + - USR_ID + - HTTP_CLIENT_IP + ObservabilityPipelineDatadogLogsDestinationType: + default: datadog_logs + description: The destination type. The value should always be `datadog_logs`. + enum: + - datadog_logs + example: datadog_logs + type: string + x-enum-varnames: + - DATADOG_LOGS + ObservabilityPipelineAwsAuth: + description: > + AWS authentication credentials used for accessing AWS services such as + S3. + + If omitted, the system’s default credentials are used (for example, the + IAM role and environment variables). + properties: + assume_role: + description: The Amazon Resource Name (ARN) of the role to assume. + type: string + external_id: + description: A unique identifier for cross-account role assumption. + type: string + session_name: + description: >- + A session identifier used for logging and tracing the assumed role + session. + type: string + type: object + ObservabilityPipelineAmazonS3DestinationStorageClass: + description: S3 storage class. + enum: + - STANDARD + - REDUCED_REDUNDANCY + - INTELLIGENT_TIERING + - STANDARD_IA + - EXPRESS_ONEZONE + - ONEZONE_IA + - GLACIER + - GLACIER_IR + - DEEP_ARCHIVE + example: STANDARD + type: string + x-enum-varnames: + - STANDARD + - REDUCED_REDUNDANCY + - INTELLIGENT_TIERING + - STANDARD_IA + - EXPRESS_ONEZONE + - ONEZONE_IA + - GLACIER + - GLACIER_IR + - DEEP_ARCHIVE + ObservabilityPipelineTls: + description: >- + Configuration for enabling TLS encryption between the pipeline component + and external services. + properties: + ca_file: + description: >- + Path to the Certificate Authority (CA) file used to validate the + server’s TLS certificate. + type: string + crt_file: + description: >- + Path to the TLS client certificate file used to authenticate the + pipeline component with upstream or downstream services. + example: /path/to/cert.crt + type: string + key_file: + description: >- + Path to the private key file associated with the TLS client + certificate. Used for mutual TLS authentication. + type: string + required: + - crt_file + type: object + ObservabilityPipelineAmazonS3DestinationType: + default: amazon_s3 + description: The destination type. Always `amazon_s3`. + enum: + - amazon_s3 + example: amazon_s3 + type: string + x-enum-varnames: + - AMAZON_S3 + ObservabilityPipelineGoogleCloudStorageDestinationAcl: + description: Access control list setting for objects written to the bucket. + enum: + - private + - project-private + - public-read + - authenticated-read + - bucket-owner-read + - bucket-owner-full-control + example: private + type: string + x-enum-varnames: + - PRIVATE + - PROJECTNOT_PRIVATE + - PUBLICNOT_READ + - AUTHENTICATEDNOT_READ + - BUCKETNOT_OWNERNOT_READ + - BUCKETNOT_OWNERNOT_FULLNOT_CONTROL + ObservabilityPipelineGcpAuth: + description: | + GCP credentials used to authenticate with Google Cloud Storage. + properties: + credentials_file: + description: Path to the GCP service account key file. + example: /var/secrets/gcp-credentials.json + type: string + required: + - credentials_file + type: object + ObservabilityPipelineMetadataEntry: + description: A custom metadata entry. + properties: + name: + description: The metadata key. + example: environment + type: string + value: + description: The metadata value. + example: production + type: string + required: + - name + - value + type: object + ObservabilityPipelineGoogleCloudStorageDestinationStorageClass: + description: Storage class used for objects stored in GCS. + enum: + - STANDARD + - NEARLINE + - COLDLINE + - ARCHIVE + example: STANDARD + type: string + x-enum-varnames: + - STANDARD + - NEARLINE + - COLDLINE + - ARCHIVE + ObservabilityPipelineGoogleCloudStorageDestinationType: + default: google_cloud_storage + description: The destination type. Always `google_cloud_storage`. + enum: + - google_cloud_storage + example: google_cloud_storage + type: string + x-enum-varnames: + - GOOGLE_CLOUD_STORAGE + ObservabilityPipelineSplunkHecDestinationEncoding: + description: Encoding format for log events. + enum: + - json + - raw_message + example: json + type: string + x-enum-varnames: + - JSON + - RAW_MESSAGE + ObservabilityPipelineSplunkHecDestinationType: + default: splunk_hec + description: The destination type. Always `splunk_hec`. + enum: + - splunk_hec + example: splunk_hec + type: string + x-enum-varnames: + - SPLUNK_HEC + ObservabilityPipelineSumoLogicDestinationEncoding: + description: The output encoding format. + enum: + - json + - raw_message + - logfmt + example: json + type: string + x-enum-varnames: + - JSON + - RAW_MESSAGE + - LOGFMT + ObservabilityPipelineSumoLogicDestinationHeaderCustomFieldsItem: + description: Single key-value pair used as a custom log header for Sumo Logic. + properties: + name: + description: The header field name. + example: X-Sumo-Category + type: string + value: + description: The header field value. + example: my-app-logs + type: string + required: + - name + - value + type: object + ObservabilityPipelineSumoLogicDestinationType: + default: sumo_logic + description: The destination type. The value should always be `sumo_logic`. + enum: + - sumo_logic + example: sumo_logic + type: string + x-enum-varnames: + - SUMO_LOGIC + ObservabilityPipelineElasticsearchDestinationApiVersion: + description: The Elasticsearch API version to use. Set to `auto` to auto-detect. + enum: + - auto + - v6 + - v7 + - v8 + example: auto + type: string + x-enum-varnames: + - AUTO + - V6 + - V7 + - V8 + ObservabilityPipelineElasticsearchDestinationType: + default: elasticsearch + description: The destination type. The value should always be `elasticsearch`. + enum: + - elasticsearch + example: elasticsearch + type: string + x-enum-varnames: + - ELASTICSEARCH + ObservabilityPipelineRsyslogDestinationType: + default: rsyslog + description: The destination type. The value should always be `rsyslog`. + enum: + - rsyslog + example: rsyslog + type: string + x-enum-varnames: + - RSYSLOG + ObservabilityPipelineSyslogNgDestinationType: + default: syslog_ng + description: The destination type. The value should always be `syslog_ng`. + enum: + - syslog_ng + example: syslog_ng + type: string + x-enum-varnames: + - SYSLOG_NG + AzureStorageDestinationType: + default: azure_storage + description: The destination type. The value should always be `azure_storage`. + enum: + - azure_storage + example: azure_storage + type: string + x-enum-varnames: + - AZURE_STORAGE + MicrosoftSentinelDestinationType: + default: microsoft_sentinel + description: The destination type. The value should always be `microsoft_sentinel`. + enum: + - microsoft_sentinel + example: microsoft_sentinel + type: string + x-enum-varnames: + - MICROSOFT_SENTINEL + ObservabilityPipelineGoogleChronicleDestinationEncoding: + description: The encoding format for the logs sent to Chronicle. + enum: + - json + - raw_message + example: json + type: string + x-enum-varnames: + - JSON + - RAW_MESSAGE + ObservabilityPipelineGoogleChronicleDestinationType: + default: google_chronicle + description: The destination type. The value should always be `google_chronicle`. + enum: + - google_chronicle + example: google_chronicle + type: string + x-enum-varnames: + - GOOGLE_CHRONICLE + ObservabilityPipelineNewRelicDestinationRegion: + description: The New Relic region. + enum: + - us + - eu + example: us + type: string + x-enum-varnames: + - US + - EU + ObservabilityPipelineNewRelicDestinationType: + default: new_relic + description: The destination type. The value should always be `new_relic`. + enum: + - new_relic + example: new_relic + type: string + x-enum-varnames: + - NEW_RELIC + ObservabilityPipelineSentinelOneDestinationRegion: + description: The SentinelOne region to send logs to. + enum: + - us + - eu + - ca + - data_set_us + example: us + type: string + x-enum-varnames: + - US + - EU + - CA + - DATA_SET_US + ObservabilityPipelineSentinelOneDestinationType: + default: sentinel_one + description: The destination type. The value should always be `sentinel_one`. + enum: + - sentinel_one + example: sentinel_one + type: string + x-enum-varnames: + - SENTINEL_ONE + ObservabilityPipelineOpenSearchDestinationType: + default: opensearch + description: The destination type. The value should always be `opensearch`. + enum: + - opensearch + example: opensearch + type: string + x-enum-varnames: + - OPENSEARCH + ObservabilityPipelineAmazonOpenSearchDestinationAuth: + description: > + Authentication settings for the Amazon OpenSearch destination. + + The `strategy` field determines whether basic or AWS-based + authentication is used. + properties: + assume_role: + description: The ARN of the role to assume (used with `aws` strategy). + type: string + aws_region: + description: AWS region + type: string + external_id: + description: External ID for the assumed role (used with `aws` strategy). + type: string + session_name: + description: Session name for the assumed role (used with `aws` strategy). + type: string + strategy: + $ref: >- + #/components/schemas/ObservabilityPipelineAmazonOpenSearchDestinationAuthStrategy + required: + - strategy + type: object + ObservabilityPipelineAmazonOpenSearchDestinationType: + default: amazon_opensearch + description: The destination type. The value should always be `amazon_opensearch`. + enum: + - amazon_opensearch + example: amazon_opensearch + type: string + x-enum-varnames: + - AMAZON_OPENSEARCH + ObservabilityPipelineSocketDestinationEncoding: + description: Encoding format for log events. + enum: + - json + - raw_message + example: json + type: string + x-enum-varnames: + - JSON + - RAW_MESSAGE + ObservabilityPipelineSocketDestinationFraming: + description: Framing method configuration. + oneOf: + - $ref: >- + #/components/schemas/ObservabilityPipelineSocketDestinationFramingNewlineDelimited + - $ref: >- + #/components/schemas/ObservabilityPipelineSocketDestinationFramingBytes + - $ref: >- + #/components/schemas/ObservabilityPipelineSocketDestinationFramingCharacterDelimited + ObservabilityPipelineSocketDestinationMode: + description: Protocol used to send logs. + enum: + - tcp + - udp + example: tcp + type: string + x-enum-varnames: + - TCP + - UDP + ObservabilityPipelineSocketDestinationType: + default: socket + description: The destination type. The value should always be `socket`. + enum: + - socket + example: socket + type: string + x-enum-varnames: + - SOCKET + ObservabilityPipelineAmazonSecurityLakeDestinationType: + default: amazon_security_lake + description: The destination type. Always `amazon_security_lake`. + enum: + - amazon_security_lake + example: amazon_security_lake + type: string + x-enum-varnames: + - AMAZON_SECURITY_LAKE + ObservabilityPipelineCrowdStrikeNextGenSiemDestinationCompression: + description: Compression configuration for log events. + properties: + algorithm: + $ref: >- + #/components/schemas/ObservabilityPipelineCrowdStrikeNextGenSiemDestinationCompressionAlgorithm + level: + description: Compression level. + example: 6 + format: int64 + type: integer + required: + - algorithm + type: object + ObservabilityPipelineCrowdStrikeNextGenSiemDestinationEncoding: + description: Encoding format for log events. + enum: + - json + - raw_message + example: json + type: string + x-enum-varnames: + - JSON + - RAW_MESSAGE + ObservabilityPipelineCrowdStrikeNextGenSiemDestinationType: + default: crowdstrike_next_gen_siem + description: >- + The destination type. The value should always be + `crowdstrike_next_gen_siem`. + enum: + - crowdstrike_next_gen_siem + example: crowdstrike_next_gen_siem + type: string + x-enum-varnames: + - CROWDSTRIKE_NEXT_GEN_SIEM + ObservabilityPipelineFilterProcessorType: + default: filter + description: The processor type. The value should always be `filter`. + enum: + - filter + example: filter + type: string + x-enum-varnames: + - FILTER + ObservabilityPipelineParseJSONProcessorType: + default: parse_json + description: The processor type. The value should always be `parse_json`. + enum: + - parse_json + example: parse_json + type: string + x-enum-varnames: + - PARSE_JSON + ObservabilityPipelineQuotaProcessorLimit: + description: >- + The maximum amount of data or number of events allowed before the quota + is enforced. Can be specified in bytes or events. + properties: + enforce: + $ref: >- + #/components/schemas/ObservabilityPipelineQuotaProcessorLimitEnforceType + limit: + description: The limit for quota enforcement. + example: 1000 + format: int64 + type: integer + required: + - enforce + - limit + type: object + ObservabilityPipelineQuotaProcessorOverflowAction: + description: | + The action to take when the quota is exceeded. Options: + - `drop`: Drop the event. + - `no_action`: Let the event pass through. + - `overflow_routing`: Route to an overflow destination. + enum: + - drop + - no_action + - overflow_routing + example: drop + type: string + x-enum-varnames: + - DROP + - NO_ACTION + - OVERFLOW_ROUTING + ObservabilityPipelineQuotaProcessorOverride: + description: >- + Defines a custom quota limit that applies to specific log events based + on matching field values. + properties: + fields: + description: >- + A list of field matchers used to apply a specific override. If an + event matches all listed key-value pairs, the corresponding override + limit is enforced. + items: + $ref: '#/components/schemas/ObservabilityPipelineFieldValue' + type: array + limit: + $ref: '#/components/schemas/ObservabilityPipelineQuotaProcessorLimit' + required: + - fields + - limit + type: object + ObservabilityPipelineQuotaProcessorType: + default: quota + description: The processor type. The value should always be `quota`. + enum: + - quota + example: quota + type: string + x-enum-varnames: + - QUOTA + ObservabilityPipelineFieldValue: + description: Represents a static key-value pair used in various processors. + properties: + name: + description: The field name. + example: field_name + type: string + value: + description: The field value. + example: field_value + type: string + required: + - name + - value + type: object + ObservabilityPipelineAddFieldsProcessorType: + default: add_fields + description: The processor type. The value should always be `add_fields`. + enum: + - add_fields + example: add_fields + type: string + x-enum-varnames: + - ADD_FIELDS + ObservabilityPipelineRemoveFieldsProcessorType: + default: remove_fields + description: The processor type. The value should always be `remove_fields`. + enum: + - remove_fields + example: remove_fields + type: string + x-enum-varnames: + - REMOVE_FIELDS + ObservabilityPipelineRenameFieldsProcessorField: + description: Defines how to rename a field in log events. + properties: + destination: + description: The field name to assign the renamed value to. + example: destination_field + type: string + preserve_source: + description: >- + Indicates whether the original field, that is received from the + source, should be kept (`true`) or removed (`false`) after renaming. + example: false + type: boolean + source: + description: The original field name in the log event that should be renamed. + example: source_field + type: string + required: + - source + - destination + - preserve_source + type: object + ObservabilityPipelineRenameFieldsProcessorType: + default: rename_fields + description: The processor type. The value should always be `rename_fields`. + enum: + - rename_fields + example: rename_fields + type: string + x-enum-varnames: + - RENAME_FIELDS + ObservabilityPipelineGeneratedMetric: + description: > + Defines a log-based custom metric, including its name, type, filter, + value computation strategy, + + and optional grouping fields. + properties: + group_by: + description: Optional fields used to group the metric series. + example: + - service + - env + items: + type: string + type: array + include: + description: Datadog filter query to match logs for metric generation. + example: service:billing + type: string + metric_type: + $ref: '#/components/schemas/ObservabilityPipelineGeneratedMetricMetricType' + name: + description: Name of the custom metric to be created. + example: logs.processed + type: string + value: + $ref: '#/components/schemas/ObservabilityPipelineMetricValue' + required: + - name + - include + - metric_type + - value + type: object + ObservabilityPipelineGenerateMetricsProcessorType: + default: generate_datadog_metrics + description: The processor type. Always `generate_datadog_metrics`. + enum: + - generate_datadog_metrics + example: generate_datadog_metrics + type: string + x-enum-varnames: + - GENERATE_DATADOG_METRICS + ObservabilityPipelineSampleProcessorType: + default: sample + description: The processor type. The value should always be `sample`. + enum: + - sample + example: sample + type: string + x-enum-varnames: + - SAMPLE + ObservabilityPipelineParseGrokProcessorRule: + description: > + A Grok parsing rule used in the `parse_grok` processor. Each rule + defines how to extract structured fields + + from a specific log field using Grok patterns. + properties: + match_rules: + description: > + A list of Grok parsing rules that define how to extract fields from + the source field. + + Each rule must contain a name and a valid Grok pattern. + example: + - name: MyParsingRule + rule: '%{word:user} connected on %{date("MM/dd/yyyy"):date}' + items: + $ref: >- + #/components/schemas/ObservabilityPipelineParseGrokProcessorRuleMatchRule + type: array + source: + description: The name of the field in the log event to apply the Grok rules to. + example: message + type: string + support_rules: + description: > + A list of Grok helper rules that can be referenced by the parsing + rules. + example: + - name: user + rule: '%{word:user.name}' + items: + $ref: >- + #/components/schemas/ObservabilityPipelineParseGrokProcessorRuleSupportRule + type: array + required: + - source + - match_rules + type: object + ObservabilityPipelineParseGrokProcessorType: + default: parse_grok + description: The processor type. The value should always be `parse_grok`. + enum: + - parse_grok + example: parse_grok + type: string + x-enum-varnames: + - PARSE_GROK + ObservabilityPipelineSensitiveDataScannerProcessorRule: + description: >- + Defines a rule for detecting sensitive data, including matching pattern, + scope, and the action to take. + properties: + keyword_options: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorKeywordOptions + name: + description: A name identifying the rule. + example: Redact Credit Card Numbers + type: string + on_match: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorAction + pattern: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorPattern + scope: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScope + tags: + description: Tags assigned to this rule for filtering and classification. + example: + - pii + - ccn + items: + type: string + type: array + required: + - name + - tags + - pattern + - scope + - on_match + type: object + ObservabilityPipelineSensitiveDataScannerProcessorType: + default: sensitive_data_scanner + description: The processor type. The value should always be `sensitive_data_scanner`. + enum: + - sensitive_data_scanner + example: sensitive_data_scanner + type: string + x-enum-varnames: + - SENSITIVE_DATA_SCANNER + ObservabilityPipelineOcsfMapperProcessorMapping: + description: >- + Defines how specific events are transformed to OCSF using a mapping + configuration. + properties: + include: + description: >- + A Datadog search query used to select the logs that this mapping + should apply to. + example: service:my-service + type: string + mapping: + $ref: >- + #/components/schemas/ObservabilityPipelineOcsfMapperProcessorMappingMapping + required: + - include + - mapping + type: object + ObservabilityPipelineOcsfMapperProcessorType: + default: ocsf_mapper + description: The processor type. The value should always be `ocsf_mapper`. + enum: + - ocsf_mapper + example: ocsf_mapper + type: string + x-enum-varnames: + - OCSF_MAPPER + ObservabilityPipelineAddEnvVarsProcessorType: + default: add_env_vars + description: The processor type. The value should always be `add_env_vars`. + enum: + - add_env_vars + example: add_env_vars + type: string + x-enum-varnames: + - ADD_ENV_VARS + ObservabilityPipelineAddEnvVarsProcessorVariable: + description: Defines a mapping between an environment variable and a log field. + properties: + field: + description: The target field in the log event. + example: log.environment.region + type: string + name: + description: The name of the environment variable to read. + example: AWS_REGION + type: string + required: + - field + - name + type: object + ObservabilityPipelineDedupeProcessorMode: + description: The deduplication mode to apply to the fields. + enum: + - match + - ignore + example: match + type: string + x-enum-varnames: + - MATCH + - IGNORE + ObservabilityPipelineDedupeProcessorType: + default: dedupe + description: The processor type. The value should always be `dedupe`. + enum: + - dedupe + example: dedupe + type: string + x-enum-varnames: + - DEDUPE + ObservabilityPipelineEnrichmentTableFile: + description: Defines a static enrichment table loaded from a CSV file. + properties: + encoding: + $ref: >- + #/components/schemas/ObservabilityPipelineEnrichmentTableFileEncoding + key: + description: Key fields used to look up enrichment values. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineEnrichmentTableFileKeyItems + type: array + path: + description: Path to the CSV file. + example: /etc/enrichment/lookup.csv + type: string + schema: + description: Schema defining column names and their types. + items: + $ref: >- + #/components/schemas/ObservabilityPipelineEnrichmentTableFileSchemaItems + type: array + required: + - encoding + - key + - path + - schema + type: object + ObservabilityPipelineEnrichmentTableGeoIp: + description: Uses a GeoIP database to enrich logs based on an IP field. + properties: + key_field: + description: Path to the IP field in the log. + example: log.source.ip + type: string + locale: + description: Locale used to resolve geographical names. + example: en + type: string + path: + description: Path to the GeoIP database file. + example: /etc/geoip/GeoLite2-City.mmdb + type: string + required: + - key_field + - locale + - path + type: object + ObservabilityPipelineEnrichmentTableProcessorType: + default: enrichment_table + description: The processor type. The value should always be `enrichment_table`. + enum: + - enrichment_table + example: enrichment_table + type: string + x-enum-varnames: + - ENRICHMENT_TABLE + ObservabilityPipelineReduceProcessorMergeStrategy: + description: Defines how a specific field should be merged across grouped events. + properties: + path: + description: The field path in the log event. + example: log.user.roles + type: string + strategy: + $ref: >- + #/components/schemas/ObservabilityPipelineReduceProcessorMergeStrategyStrategy + required: + - path + - strategy + type: object + ObservabilityPipelineReduceProcessorType: + default: reduce + description: The processor type. The value should always be `reduce`. + enum: + - reduce + example: reduce + type: string + x-enum-varnames: + - REDUCE + ObservabilityPipelineThrottleProcessorType: + default: throttle + description: The processor type. The value should always be `throttle`. + enum: + - throttle + example: throttle + type: string + x-enum-varnames: + - THROTTLE + ObservabilityPipelineCustomProcessorRemap: + description: >- + Defines a single VRL remap rule with its own filtering and + transformation logic. + properties: + drop_on_error: + description: Whether to drop events that caused errors during processing. + example: false + type: boolean + enabled: + description: Whether this remap rule is enabled. + example: true + type: boolean + include: + description: >- + A Datadog search query used to filter events for this specific remap + rule. + example: service:web + type: string + name: + description: A descriptive name for this remap rule. + example: Parse JSON from message field + type: string + source: + description: The VRL script source code that defines the processing logic. + example: . = parse_json!(.message) + type: string + required: + - include + - name + - source + - enabled + - drop_on_error + type: object + ObservabilityPipelineCustomProcessorType: + default: custom_processor + description: The processor type. The value should always be `custom_processor`. + enum: + - custom_processor + example: custom_processor + type: string + x-enum-varnames: + - CUSTOM_PROCESSOR + ObservabilityPipelineDatadogTagsProcessorAction: + description: The action to take on tags with matching keys. + enum: + - include + - exclude + example: include + type: string + x-enum-varnames: + - INCLUDE + - EXCLUDE + ObservabilityPipelineDatadogTagsProcessorMode: + description: The processing mode. + enum: + - filter + example: filter + type: string + x-enum-varnames: + - FILTER + ObservabilityPipelineDatadogTagsProcessorType: + default: datadog_tags + description: The processor type. The value should always be `datadog_tags`. + enum: + - datadog_tags + example: datadog_tags + type: string + x-enum-varnames: + - DATADOG_TAGS + ObservabilityPipelineKafkaSourceLibrdkafkaOption: + description: >- + Represents a key-value pair used to configure low-level `librdkafka` + client options for Kafka sources, such as timeouts, buffer sizes, and + security settings. + properties: + name: + description: The name of the `librdkafka` configuration option to set. + example: fetch.message.max.bytes + type: string + value: + description: >- + The value assigned to the specified `librdkafka` configuration + option. + example: '1048576' + type: string + required: + - name + - value + type: object + ObservabilityPipelineKafkaSourceSasl: + description: Specifies the SASL mechanism for authenticating with a Kafka cluster. + properties: + mechanism: + $ref: >- + #/components/schemas/ObservabilityPipelinePipelineKafkaSourceSaslMechanism + type: object + ObservabilityPipelineKafkaSourceType: + default: kafka + description: The source type. The value should always be `kafka`. + enum: + - kafka + example: kafka + type: string + x-enum-varnames: + - KAFKA + ObservabilityPipelineDatadogAgentSourceType: + default: datadog_agent + description: The source type. The value should always be `datadog_agent`. + enum: + - datadog_agent + example: datadog_agent + type: string + x-enum-varnames: + - DATADOG_AGENT + ObservabilityPipelineSplunkTcpSourceType: + default: splunk_tcp + description: The source type. Always `splunk_tcp`. + enum: + - splunk_tcp + example: splunk_tcp + type: string + x-enum-varnames: + - SPLUNK_TCP + ObservabilityPipelineSplunkHecSourceType: + default: splunk_hec + description: The source type. Always `splunk_hec`. + enum: + - splunk_hec + example: splunk_hec + type: string + x-enum-varnames: + - SPLUNK_HEC + ObservabilityPipelineAmazonS3SourceType: + default: amazon_s3 + description: The source type. Always `amazon_s3`. + enum: + - amazon_s3 + example: amazon_s3 + type: string + x-enum-varnames: + - AMAZON_S3 + ObservabilityPipelineFluentdSourceType: + default: fluentd + description: The source type. The value should always be `fluentd. + enum: + - fluentd + example: fluentd + type: string + x-enum-varnames: + - FLUENTD + ObservabilityPipelineFluentBitSourceType: + default: fluent_bit + description: The source type. The value should always be `fluent_bit`. + enum: + - fluent_bit + example: fluent_bit + type: string + x-enum-varnames: + - FLUENT_BIT + ObservabilityPipelineHttpServerSourceAuthStrategy: + description: HTTP authentication method. + enum: + - none + - plain + example: plain + type: string + x-enum-varnames: + - NONE + - PLAIN + ObservabilityPipelineDecoding: + description: The decoding format used to interpret incoming logs. + enum: + - bytes + - gelf + - json + - syslog + example: json + type: string + x-enum-varnames: + - DECODE_BYTES + - DECODE_GELF + - DECODE_JSON + - DECODE_SYSLOG + ObservabilityPipelineHttpServerSourceType: + default: http_server + description: The source type. The value should always be `http_server`. + enum: + - http_server + example: http_server + type: string + x-enum-varnames: + - HTTP_SERVER + ObservabilityPipelineSumoLogicSourceType: + default: sumo_logic + description: The source type. The value should always be `sumo_logic`. + enum: + - sumo_logic + example: sumo_logic + type: string + x-enum-varnames: + - SUMO_LOGIC + ObservabilityPipelineSyslogSourceMode: + description: Protocol used by the syslog source to receive messages. + enum: + - tcp + - udp + example: tcp + type: string + x-enum-varnames: + - TCP + - UDP + ObservabilityPipelineRsyslogSourceType: + default: rsyslog + description: The source type. The value should always be `rsyslog`. + enum: + - rsyslog + example: rsyslog + type: string + x-enum-varnames: + - RSYSLOG + ObservabilityPipelineSyslogNgSourceType: + default: syslog_ng + description: The source type. The value should always be `syslog_ng`. + enum: + - syslog_ng + example: syslog_ng + type: string + x-enum-varnames: + - SYSLOG_NG + ObservabilityPipelineAmazonDataFirehoseSourceType: + default: amazon_data_firehose + description: The source type. The value should always be `amazon_data_firehose`. + enum: + - amazon_data_firehose + example: amazon_data_firehose + type: string + x-enum-varnames: + - AMAZON_DATA_FIREHOSE + ObservabilityPipelineGooglePubSubSourceType: + default: google_pubsub + description: The source type. The value should always be `google_pubsub`. + enum: + - google_pubsub + example: google_pubsub + type: string + x-enum-varnames: + - GOOGLE_PUBSUB + ObservabilityPipelineHttpClientSourceAuthStrategy: + description: Optional authentication strategy for HTTP requests. + enum: + - basic + - bearer + example: basic + type: string + x-enum-varnames: + - BASIC + - BEARER + ObservabilityPipelineHttpClientSourceType: + default: http_client + description: The source type. The value should always be `http_client`. + enum: + - http_client + example: http_client + type: string + x-enum-varnames: + - HTTP_CLIENT + ObservabilityPipelineLogstashSourceType: + default: logstash + description: The source type. The value should always be `logstash`. + enum: + - logstash + example: logstash + type: string + x-enum-varnames: + - LOGSTASH + ObservabilityPipelineSocketSourceFraming: + description: Framing method configuration for the socket source. + oneOf: + - $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingNewlineDelimited + - $ref: '#/components/schemas/ObservabilityPipelineSocketSourceFramingBytes' + - $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingCharacterDelimited + - $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingOctetCounting + - $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingChunkedGelf + ObservabilityPipelineSocketSourceMode: + description: Protocol used to receive logs. + enum: + - tcp + - udp + example: tcp + type: string + x-enum-varnames: + - TCP + - UDP + ObservabilityPipelineSocketSourceType: + default: socket + description: The source type. The value should always be `socket`. + enum: + - socket + example: socket + type: string + x-enum-varnames: + - SOCKET + ObservabilityPipelineAmazonOpenSearchDestinationAuthStrategy: + description: The authentication strategy to use. + enum: + - basic + - aws + example: aws + type: string + x-enum-varnames: + - BASIC + - AWS + ObservabilityPipelineSocketDestinationFramingNewlineDelimited: + description: Each log event is delimited by a newline character. + properties: + method: + $ref: >- + #/components/schemas/ObservabilityPipelineSocketDestinationFramingNewlineDelimitedMethod + required: + - method + type: object + ObservabilityPipelineSocketDestinationFramingBytes: + description: Event data is not delimited at all. + properties: + method: + $ref: >- + #/components/schemas/ObservabilityPipelineSocketDestinationFramingBytesMethod + required: + - method + type: object + ObservabilityPipelineSocketDestinationFramingCharacterDelimited: + description: Each log event is separated using the specified delimiter character. + properties: + delimiter: + description: A single ASCII character used as a delimiter. + example: '|' + maxLength: 1 + minLength: 1 + type: string + method: + $ref: >- + #/components/schemas/ObservabilityPipelineSocketDestinationFramingCharacterDelimitedMethod + required: + - method + - delimiter + type: object + ObservabilityPipelineCrowdStrikeNextGenSiemDestinationCompressionAlgorithm: + description: Compression algorithm for log events. + enum: + - gzip + - zlib + example: gzip + type: string + x-enum-varnames: + - GZIP + - ZLIB + ObservabilityPipelineQuotaProcessorLimitEnforceType: + description: Unit for quota enforcement in bytes for data size or events for count. + enum: + - bytes + - events + example: bytes + type: string + x-enum-varnames: + - BYTES + - EVENTS + ObservabilityPipelineGeneratedMetricMetricType: + description: Type of metric to create. + enum: + - count + - gauge + - distribution + example: count + type: string + x-enum-varnames: + - COUNT + - GAUGE + - DISTRIBUTION + ObservabilityPipelineMetricValue: + description: Specifies how the value of the generated metric is computed. + oneOf: + - $ref: >- + #/components/schemas/ObservabilityPipelineGeneratedMetricIncrementByOne + - $ref: >- + #/components/schemas/ObservabilityPipelineGeneratedMetricIncrementByField + ObservabilityPipelineParseGrokProcessorRuleMatchRule: + description: > + Defines a Grok parsing rule, which extracts structured fields from log + content using named Grok patterns. + + Each rule must have a unique name and a valid Datadog Grok pattern that + will be applied to the source field. + properties: + name: + description: The name of the rule. + example: MyParsingRule + type: string + rule: + description: The definition of the Grok rule. + example: '%{word:user} connected on %{date("MM/dd/yyyy"):date}' + type: string + required: + - name + - rule + type: object + ObservabilityPipelineParseGrokProcessorRuleSupportRule: + description: The Grok helper rule referenced in the parsing rules. + properties: + name: + description: The name of the Grok helper rule. + example: user + type: string + rule: + description: The definition of the Grok helper rule. + example: ' %{word:user.name}' + type: string + required: + - name + - rule + type: object + ObservabilityPipelineSensitiveDataScannerProcessorKeywordOptions: + description: >- + Configuration for keywords used to reinforce sensitive data pattern + detection. + properties: + keywords: + description: A list of keywords to match near the sensitive pattern. + example: + - ssn + - card + - account + items: + type: string + type: array + proximity: + description: >- + Maximum number of tokens between a keyword and a sensitive value + match. + example: 5 + format: int64 + type: integer + required: + - keywords + - proximity + type: object + ObservabilityPipelineSensitiveDataScannerProcessorAction: + description: Defines what action to take when sensitive data is matched. + oneOf: + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionRedact + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionHash + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedact + ObservabilityPipelineSensitiveDataScannerProcessorPattern: + description: >- + Pattern detection configuration for identifying sensitive data using + either a custom regex or a library reference. + oneOf: + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorCustomPattern + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorLibraryPattern + ObservabilityPipelineSensitiveDataScannerProcessorScope: + description: >- + Determines which parts of the log the pattern-matching rule should be + applied to. + oneOf: + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScopeInclude + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScopeExclude + - $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScopeAll + ObservabilityPipelineOcsfMapperProcessorMappingMapping: + description: >- + Defines a single mapping rule for transforming logs into the OCSF + schema. + oneOf: + - $ref: '#/components/schemas/ObservabilityPipelineOcsfMappingLibrary' + ObservabilityPipelineEnrichmentTableFileEncoding: + description: File encoding format. + properties: + delimiter: + description: The `encoding` `delimiter`. + example: ',' + type: string + includes_headers: + description: The `encoding` `includes_headers`. + example: true + type: boolean + type: + $ref: >- + #/components/schemas/ObservabilityPipelineEnrichmentTableFileEncodingType + required: + - type + - delimiter + - includes_headers + type: object + ObservabilityPipelineEnrichmentTableFileKeyItems: + description: >- + Defines how to map log fields to enrichment table columns during + lookups. + properties: + column: + description: The `items` `column`. + example: user_id + type: string + comparison: + $ref: >- + #/components/schemas/ObservabilityPipelineEnrichmentTableFileKeyItemsComparison + field: + description: The `items` `field`. + example: log.user.id + type: string + required: + - column + - comparison + - field + type: object + ObservabilityPipelineEnrichmentTableFileSchemaItems: + description: Describes a single column and its type in an enrichment table schema. + properties: + column: + description: The `items` `column`. + example: region + type: string + type: + $ref: >- + #/components/schemas/ObservabilityPipelineEnrichmentTableFileSchemaItemsType + required: + - column + - type + type: object + ObservabilityPipelineReduceProcessorMergeStrategyStrategy: + description: The merge strategy to apply. + enum: + - discard + - retain + - sum + - max + - min + - array + - concat + - concat_newline + - concat_raw + - shortest_array + - longest_array + - flat_unique + example: flat_unique + type: string + x-enum-varnames: + - DISCARD + - RETAIN + - SUM + - MAX + - MIN + - ARRAY + - CONCAT + - CONCAT_NEWLINE + - CONCAT_RAW + - SHORTEST_ARRAY + - LONGEST_ARRAY + - FLAT_UNIQUE + ObservabilityPipelinePipelineKafkaSourceSaslMechanism: + description: SASL mechanism used for Kafka authentication. + enum: + - PLAIN + - SCRAM-SHA-256 + - SCRAM-SHA-512 + type: string + x-enum-varnames: + - PLAIN + - SCRAMNOT_SHANOT_256 + - SCRAMNOT_SHANOT_512 + ObservabilityPipelineSocketSourceFramingNewlineDelimited: + description: Byte frames which are delimited by a newline character. + properties: + method: + $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingNewlineDelimitedMethod + required: + - method + type: object + ObservabilityPipelineSocketSourceFramingBytes: + description: >- + Byte frames are passed through as-is according to the underlying I/O + boundaries (for example, split between messages or stream segments). + properties: + method: + $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingBytesMethod + required: + - method + type: object + ObservabilityPipelineSocketSourceFramingCharacterDelimited: + description: Byte frames which are delimited by a chosen character. + properties: + delimiter: + description: A single ASCII character used to delimit events. + example: '|' + maxLength: 1 + minLength: 1 + type: string + method: + $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingCharacterDelimitedMethod + required: + - method + - delimiter + type: object + ObservabilityPipelineSocketSourceFramingOctetCounting: + description: Byte frames according to the octet counting format as per RFC6587. + properties: + method: + $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingOctetCountingMethod + required: + - method + type: object + ObservabilityPipelineSocketSourceFramingChunkedGelf: + description: Byte frames which are chunked GELF messages. + properties: + method: + $ref: >- + #/components/schemas/ObservabilityPipelineSocketSourceFramingChunkedGelfMethod + required: + - method + type: object + ObservabilityPipelineSocketDestinationFramingNewlineDelimitedMethod: + description: >- + The definition of + `ObservabilityPipelineSocketDestinationFramingNewlineDelimitedMethod` + object. + enum: + - newline_delimited + example: newline_delimited + type: string + x-enum-varnames: + - NEWLINE_DELIMITED + ObservabilityPipelineSocketDestinationFramingBytesMethod: + description: >- + The definition of + `ObservabilityPipelineSocketDestinationFramingBytesMethod` object. + enum: + - bytes + example: bytes + type: string + x-enum-varnames: + - BYTES + ObservabilityPipelineSocketDestinationFramingCharacterDelimitedMethod: + description: >- + The definition of + `ObservabilityPipelineSocketDestinationFramingCharacterDelimitedMethod` + object. + enum: + - character_delimited + example: character_delimited + type: string + x-enum-varnames: + - CHARACTER_DELIMITED + ObservabilityPipelineGeneratedMetricIncrementByOne: + description: >- + Strategy that increments a generated metric by one for each matching + event. + properties: + strategy: + $ref: >- + #/components/schemas/ObservabilityPipelineGeneratedMetricIncrementByOneStrategy + required: + - strategy + type: object + ObservabilityPipelineGeneratedMetricIncrementByField: + description: >- + Strategy that increments a generated metric based on the value of a log + field. + properties: + field: + description: >- + Name of the log field containing the numeric value to increment the + metric by. + example: errors + type: string + strategy: + $ref: >- + #/components/schemas/ObservabilityPipelineGeneratedMetricIncrementByFieldStrategy + required: + - strategy + - field + type: object + ObservabilityPipelineSensitiveDataScannerProcessorActionRedact: + description: Configuration for completely redacting matched sensitive data. + properties: + action: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionRedactAction + options: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionRedactOptions + required: + - action + - options + type: object + ObservabilityPipelineSensitiveDataScannerProcessorActionHash: + description: Configuration for hashing matched sensitive values. + properties: + action: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionHashAction + options: + description: >- + The `ObservabilityPipelineSensitiveDataScannerProcessorActionHash` + `options`. + type: object + required: + - action + type: object + ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedact: + description: Configuration for partially redacting matched sensitive data. + properties: + action: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedactAction + options: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedactOptions + required: + - action + - options + type: object + ObservabilityPipelineSensitiveDataScannerProcessorCustomPattern: + description: >- + Defines a custom regex-based pattern for identifying sensitive data in + logs. + properties: + options: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorCustomPatternOptions + type: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorCustomPatternType + required: + - type + - options + type: object + ObservabilityPipelineSensitiveDataScannerProcessorLibraryPattern: + description: >- + Specifies a pattern from Datadog’s sensitive data detection library to + match known sensitive data types. + properties: + options: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorLibraryPatternOptions + type: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorLibraryPatternType + required: + - type + - options + type: object + ObservabilityPipelineSensitiveDataScannerProcessorScopeInclude: + description: Includes only specific fields for sensitive data scanning. + properties: + options: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScopeOptions + target: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScopeIncludeTarget + required: + - target + - options + type: object + ObservabilityPipelineSensitiveDataScannerProcessorScopeExclude: + description: Excludes specific fields from sensitive data scanning. + properties: + options: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScopeOptions + target: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScopeExcludeTarget + required: + - target + - options + type: object + ObservabilityPipelineSensitiveDataScannerProcessorScopeAll: + description: Applies scanning across all available fields. + properties: + target: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorScopeAllTarget + required: + - target + type: object + ObservabilityPipelineOcsfMappingLibrary: + description: Predefined library mappings for common log formats. + enum: + - CloudTrail Account Change + - GCP Cloud Audit CreateBucket + - GCP Cloud Audit CreateSink + - GCP Cloud Audit SetIamPolicy + - GCP Cloud Audit UpdateSink + - Github Audit Log API Activity + - Google Workspace Admin Audit addPrivilege + - Microsoft 365 Defender Incident + - Microsoft 365 Defender UserLoggedIn + - Okta System Log Authentication + - Palo Alto Networks Firewall Traffic + example: CloudTrail Account Change + type: string + x-enum-varnames: + - CLOUDTRAIL_ACCOUNT_CHANGE + - GCP_CLOUD_AUDIT_CREATEBUCKET + - GCP_CLOUD_AUDIT_CREATESINK + - GCP_CLOUD_AUDIT_SETIAMPOLICY + - GCP_CLOUD_AUDIT_UPDATESINK + - GITHUB_AUDIT_LOG_API_ACTIVITY + - GOOGLE_WORKSPACE_ADMIN_AUDIT_ADDPRIVILEGE + - MICROSOFT_365_DEFENDER_INCIDENT + - MICROSOFT_365_DEFENDER_USERLOGGEDIN + - OKTA_SYSTEM_LOG_AUTHENTICATION + - PALO_ALTO_NETWORKS_FIREWALL_TRAFFIC + ObservabilityPipelineEnrichmentTableFileEncodingType: + description: Specifies the encoding format (e.g., CSV) used for enrichment tables. + enum: + - csv + example: csv + type: string + x-enum-varnames: + - CSV + ObservabilityPipelineEnrichmentTableFileKeyItemsComparison: + description: Defines how to compare key fields for enrichment table lookups. + enum: + - equals + example: equals + type: string + x-enum-varnames: + - EQUALS + ObservabilityPipelineEnrichmentTableFileSchemaItemsType: + description: Declares allowed data types for enrichment table columns. + enum: + - string + - boolean + - integer + - float + - date + - timestamp + example: string + type: string + x-enum-varnames: + - STRING + - BOOLEAN + - INTEGER + - FLOAT + - DATE + - TIMESTAMP + ObservabilityPipelineSocketSourceFramingNewlineDelimitedMethod: + description: Byte frames which are delimited by a newline character. + enum: + - newline_delimited + example: newline_delimited + type: string + x-enum-varnames: + - NEWLINE_DELIMITED + ObservabilityPipelineSocketSourceFramingBytesMethod: + description: >- + Byte frames are passed through as-is according to the underlying I/O + boundaries (for example, split between messages or stream segments). + enum: + - bytes + example: bytes + type: string + x-enum-varnames: + - BYTES + ObservabilityPipelineSocketSourceFramingCharacterDelimitedMethod: + description: Byte frames which are delimited by a chosen character. + enum: + - character_delimited + example: character_delimited + type: string + x-enum-varnames: + - CHARACTER_DELIMITED + ObservabilityPipelineSocketSourceFramingOctetCountingMethod: + description: Byte frames according to the octet counting format as per RFC6587. + enum: + - octet_counting + example: octet_counting + type: string + x-enum-varnames: + - OCTET_COUNTING + ObservabilityPipelineSocketSourceFramingChunkedGelfMethod: + description: Byte frames which are chunked GELF messages. + enum: + - chunked_gelf + example: chunked_gelf + type: string + x-enum-varnames: + - CHUNKED_GELF + ObservabilityPipelineGeneratedMetricIncrementByOneStrategy: + description: Increments the metric by 1 for each matching event. + enum: + - increment_by_one + example: increment_by_one + type: string + x-enum-varnames: + - INCREMENT_BY_ONE + ObservabilityPipelineGeneratedMetricIncrementByFieldStrategy: + description: Uses a numeric field in the log event as the metric increment. + enum: + - increment_by_field + example: increment_by_field + type: string + x-enum-varnames: + - INCREMENT_BY_FIELD + ObservabilityPipelineSensitiveDataScannerProcessorActionRedactAction: + description: >- + Action type that completely replaces the matched sensitive data with a + fixed replacement string to remove all visibility. + enum: + - redact + example: redact + type: string + x-enum-varnames: + - REDACT + ObservabilityPipelineSensitiveDataScannerProcessorActionRedactOptions: + description: Configuration for fully redacting sensitive data. + properties: + replace: + description: >- + The + `ObservabilityPipelineSensitiveDataScannerProcessorActionRedactOptions` + `replace`. + example: '***' + type: string + required: + - replace + type: object + ObservabilityPipelineSensitiveDataScannerProcessorActionHashAction: + description: >- + Action type that replaces the matched sensitive data with a hashed + representation, preserving structure while securing content. + enum: + - hash + example: hash + type: string + x-enum-varnames: + - HASH + ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedactAction: + description: >- + Action type that redacts part of the sensitive data while preserving a + configurable number of characters, typically used for masking purposes + (e.g., show last 4 digits of a credit card). + enum: + - partial_redact + example: partial_redact + type: string + x-enum-varnames: + - PARTIAL_REDACT + ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedactOptions: + description: >- + Controls how partial redaction is applied, including character count and + direction. + properties: + characters: + description: >- + The + `ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedactOptions` + `characters`. + example: 4 + format: int64 + type: integer + direction: + $ref: >- + #/components/schemas/ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedactOptionsDirection + required: + - characters + - direction + type: object + ObservabilityPipelineSensitiveDataScannerProcessorCustomPatternOptions: + description: Options for defining a custom regex pattern. + properties: + rule: + description: >- + A regular expression used to detect sensitive values. Must be a + valid regex. + example: \b\d{16}\b + type: string + required: + - rule + type: object + ObservabilityPipelineSensitiveDataScannerProcessorCustomPatternType: + description: Indicates a custom regular expression is used for matching. + enum: + - custom + example: custom + type: string + x-enum-varnames: + - CUSTOM + ObservabilityPipelineSensitiveDataScannerProcessorLibraryPatternOptions: + description: >- + Options for selecting a predefined library pattern and enabling keyword + support. + properties: + id: + description: >- + Identifier for a predefined pattern from the sensitive data scanner + pattern library. + example: credit_card + type: string + use_recommended_keywords: + description: Whether to augment the pattern with recommended keywords (optional). + type: boolean + required: + - id + type: object + ObservabilityPipelineSensitiveDataScannerProcessorLibraryPatternType: + description: Indicates that a predefined library pattern is used. + enum: + - library + example: library + type: string + x-enum-varnames: + - LIBRARY + ObservabilityPipelineSensitiveDataScannerProcessorScopeOptions: + description: Fields to which the scope rule applies. + properties: + fields: + description: >- + The `ObservabilityPipelineSensitiveDataScannerProcessorScopeOptions` + `fields`. + example: + - '' + items: + type: string + type: array + required: + - fields + type: object + ObservabilityPipelineSensitiveDataScannerProcessorScopeIncludeTarget: + description: Applies the rule only to included fields. + enum: + - include + example: include + type: string + x-enum-varnames: + - INCLUDE + ObservabilityPipelineSensitiveDataScannerProcessorScopeExcludeTarget: + description: Excludes specific fields from processing. + enum: + - exclude + example: exclude + type: string + x-enum-varnames: + - EXCLUDE + ObservabilityPipelineSensitiveDataScannerProcessorScopeAllTarget: + description: Applies the rule to all fields. + enum: + - all + example: all + type: string + x-enum-varnames: + - ALL + ObservabilityPipelineSensitiveDataScannerProcessorActionPartialRedactOptionsDirection: + description: >- + Indicates whether to redact characters from the first or last part of + the matched value. + enum: + - first + - last + example: last + type: string + x-enum-varnames: + - FIRST + - LAST + responses: + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + ConcurrentModificationResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Concurrent Modification + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + ConflictResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + parameters: + ApplicationSecurityWafCustomRuleIDParam: + description: The ID of the custom rule. + example: 3b5-v82-ns6 + in: path + name: custom_rule_id + required: true + schema: + type: string + ApplicationSecurityWafExclusionFilterID: + description: The identifier of the WAF exclusion filter. + example: 3b5-v82-ns6 + in: path + name: exclusion_filter_id + required: true + schema: + type: string + CloudWorkloadSecurityQueryAgentPolicyID: + description: The ID of the Agent policy + example: 6517fcc1-cec7-4394-a655-8d6e9d085255 + in: query + name: policy_id + required: false + schema: + type: string + CloudWorkloadSecurityAgentRuleID: + description: The ID of the Agent rule + example: 3b5-v82-ns6 + in: path + name: agent_rule_id + required: true + schema: + type: string + CloudWorkloadSecurityPathAgentPolicyID: + description: The ID of the Agent policy + example: 6517fcc1-cec7-4394-a655-8d6e9d085255 + in: path + name: policy_id + required: true + schema: + type: string + PageSize: + description: Size for a given page. The maximum allowed value is 100. + in: query + name: page[size] + required: false + schema: + default: 10 + example: 10 + format: int64 + type: integer + PageNumber: + description: Specific page number to return. + in: query + name: page[number] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + x-stackQL-resources: + waf_custom_rules: + id: datadog.remote_config.waf_custom_rules + name: waf_custom_rules + title: Waf Custom Rules + methods: + list_application_security_wafcustom_rules: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1custom_rules/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_application_security_waf_custom_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1custom_rules/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_application_security_waf_custom_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1custom_rules~1{custom_rule_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_application_security_waf_custom_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1custom_rules~1{custom_rule_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_application_security_waf_custom_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1custom_rules~1{custom_rule_id}/put + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/waf_custom_rules/methods/get_application_security_waf_custom_rule + - $ref: >- + #/components/x-stackQL-resources/waf_custom_rules/methods/list_application_security_wafcustom_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/waf_custom_rules/methods/create_application_security_waf_custom_rule + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/waf_custom_rules/methods/delete_application_security_waf_custom_rule + replace: + - $ref: >- + #/components/x-stackQL-resources/waf_custom_rules/methods/update_application_security_waf_custom_rule + waf_exclusion_filters: + id: datadog.remote_config.waf_exclusion_filters + name: waf_exclusion_filters + title: Waf Exclusion Filters + methods: + list_application_security_waf_exclusion_filters: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1exclusion_filters/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_application_security_waf_exclusion_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1exclusion_filters/post + response: + mediaType: application/json + openAPIDocKey: '200' + delete_application_security_waf_exclusion_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1exclusion_filters~1{exclusion_filter_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_application_security_waf_exclusion_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1exclusion_filters~1{exclusion_filter_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_application_security_waf_exclusion_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1asm~1waf~1exclusion_filters~1{exclusion_filter_id}/put + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/waf_exclusion_filters/methods/get_application_security_waf_exclusion_filter + - $ref: >- + #/components/x-stackQL-resources/waf_exclusion_filters/methods/list_application_security_waf_exclusion_filters + insert: + - $ref: >- + #/components/x-stackQL-resources/waf_exclusion_filters/methods/create_application_security_waf_exclusion_filter + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/waf_exclusion_filters/methods/delete_application_security_waf_exclusion_filter + replace: + - $ref: >- + #/components/x-stackQL-resources/waf_exclusion_filters/methods/update_application_security_waf_exclusion_filter + csm_threats_agent_rules: + id: datadog.remote_config.csm_threats_agent_rules + name: csm_threats_agent_rules + title: Csm Threats Agent Rules + methods: + list_csmthreats_agent_rules: + operation: + $ref: '#/paths/~1api~1v2~1remote_config~1products~1cws~1agent_rules/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_csmthreats_agent_rule: + operation: + $ref: '#/paths/~1api~1v2~1remote_config~1products~1cws~1agent_rules/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_csmthreats_agent_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1cws~1agent_rules~1{agent_rule_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_csmthreats_agent_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1cws~1agent_rules~1{agent_rule_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_csmthreats_agent_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1cws~1agent_rules~1{agent_rule_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_rules/methods/get_csmthreats_agent_rule + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_rules/methods/list_csmthreats_agent_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_rules/methods/create_csmthreats_agent_rule + update: + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_rules/methods/update_csmthreats_agent_rule + delete: + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_rules/methods/delete_csmthreats_agent_rule + replace: [] + csm_threats_agent_policies: + id: datadog.remote_config.csm_threats_agent_policies + name: csm_threats_agent_policies + title: Csm Threats Agent Policies + methods: + list_csmthreats_agent_policies: + operation: + $ref: '#/paths/~1api~1v2~1remote_config~1products~1cws~1policy/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_csmthreats_agent_policy: + operation: + $ref: '#/paths/~1api~1v2~1remote_config~1products~1cws~1policy/post' + response: + mediaType: application/json + openAPIDocKey: '200' + download_csmthreats_policy: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1cws~1policy~1download/get + response: + mediaType: application/zip + openAPIDocKey: '200' + delete_csmthreats_agent_policy: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1cws~1policy~1{policy_id}/delete + response: + mediaType: application/json + openAPIDocKey: '202' + get_csmthreats_agent_policy: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1cws~1policy~1{policy_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_csmthreats_agent_policy: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1cws~1policy~1{policy_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_policies/methods/get_csmthreats_agent_policy + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_policies/methods/list_csmthreats_agent_policies + insert: + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_policies/methods/create_csmthreats_agent_policy + update: + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_policies/methods/update_csmthreats_agent_policy + delete: + - $ref: >- + #/components/x-stackQL-resources/csm_threats_agent_policies/methods/delete_csmthreats_agent_policy + replace: [] + observability_pipelines: + id: datadog.remote_config.observability_pipelines + name: observability_pipelines + title: Observability Pipelines + methods: + list_pipelines: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1obs_pipelines~1pipelines/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_pipeline: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1obs_pipelines~1pipelines/post + response: + mediaType: application/json + openAPIDocKey: '201' + validate_pipeline: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1obs_pipelines~1pipelines~1validate/post + response: + mediaType: application/json + openAPIDocKey: '200' + delete_pipeline: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1obs_pipelines~1pipelines~1{pipeline_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_pipeline: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1obs_pipelines~1pipelines~1{pipeline_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_pipeline: + operation: + $ref: >- + #/paths/~1api~1v2~1remote_config~1products~1obs_pipelines~1pipelines~1{pipeline_id}/put + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/observability_pipelines/methods/get_pipeline + - $ref: >- + #/components/x-stackQL-resources/observability_pipelines/methods/list_pipelines + insert: + - $ref: >- + #/components/x-stackQL-resources/observability_pipelines/methods/create_pipeline + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/observability_pipelines/methods/delete_pipeline + replace: + - $ref: >- + #/components/x-stackQL-resources/observability_pipelines/methods/update_pipeline +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/restriction_policies.yaml b/providers/src/datadog/v00.00.00000/services/restriction_policies.yaml deleted file mode 100644 index c8493047..00000000 --- a/providers/src/datadog/v00.00.00000/services/restriction_policies.yaml +++ /dev/null @@ -1,1098 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - restriction_policies - description: Restriction_Policies -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - RestrictionPolicyResponse: - description: Response containing information about a single restriction policy. - properties: - data: - $ref: '#/components/schemas/RestrictionPolicy' - required: - - data - type: object - RestrictionPolicy: - description: Restriction policy object. - properties: - attributes: - $ref: '#/components/schemas/RestrictionPolicyAttributes' - id: - description: 'The identifier, always equivalent to the value specified in the `resource_id` path parameter.' - example: 'dashboard:abc-def-ghi' - type: string - type: - $ref: '#/components/schemas/RestrictionPolicyType' - required: - - type - - id - - attributes - type: object - RestrictionPolicyAttributes: - description: Restriction policy attributes. - example: - bindings: [] - properties: - bindings: - description: An array of bindings. - items: - $ref: '#/components/schemas/RestrictionPolicyBinding' - type: array - required: - - bindings - type: object - RestrictionPolicyType: - default: restriction_policy - description: Restriction policy type. - enum: - - restriction_policy - example: restriction_policy - type: string - x-enum-varnames: - - RESTRICTION_POLICY - RestrictionPolicyBinding: - description: Specifies which principals are associated with a relation. - properties: - principals: - description: |- - An array of principals. A principal is a subject or group of subjects. - Each principal is formatted as `type:id`. Supported types: `role`, `team`, `user`, and `org`. - The org ID can be obtained through the api/v2/current_user API. - The user principal type accepts service account IDs. - example: - - 'role:00000000-0000-1111-0000-000000000000' - items: - description: |- - Subject or group of subjects. Each principal is formatted as `type:id`. - Supported types: `role`, `team`, `user`, and `org`. - The org ID can be obtained through the api/v2/current_user API. - The user principal type accepts service account IDs. - type: string - type: array - relation: - description: The role/level of access. - example: editor - type: string - required: - - relation - - principals - type: object - RestrictionPolicyUpdateRequest: - description: Update request for a restriction policy. - properties: - data: - $ref: '#/components/schemas/RestrictionPolicy' - required: - - data - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - restriction_policies: - id: datadog.restriction_policies.restriction_policies - name: restriction_policies - title: Restriction Policies - methods: - delete_restriction_policy: - operation: - $ref: '#/paths/~1api~1v2~1restriction_policy~1{resource_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_restriction_policy: - operation: - $ref: '#/paths/~1api~1v2~1restriction_policy~1{resource_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_restriction_policy: - operation: - $ref: '#/paths/~1api~1v2~1restriction_policy~1{resource_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_restriction_policy: - operation: - $ref: '#/paths/~1api~1v2~1restriction_policy~1{resource_id}/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/restriction_policies/methods/get_restriction_policy' - insert: [] - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/restriction_policies/methods/delete_restriction_policy' -paths: - '/api/v2/restriction_policy/{resource_id}': - delete: - description: Deletes the restriction policy associated with a specified resource. - operationId: DeleteRestrictionPolicy - parameters: - - $ref: '#/components/parameters/ResourceID' - responses: - '204': - description: No Content - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - summary: Delete a restriction policy - tags: - - Restriction Policies - get: - description: Retrieves the restriction policy associated with a specified resource. - operationId: GetRestrictionPolicy - parameters: - - $ref: '#/components/parameters/ResourceID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RestrictionPolicyResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - summary: Get a restriction policy - tags: - - Restriction Policies - post: - description: |- - Updates the restriction policy associated with a resource. - - #### Supported resources - Restriction policies can be applied to the following resources: - - Connections: `connection` - - Dashboards: `dashboard` - - Notebooks: `notebook` - - Security Rules: `security-rule` - - Service Level Objectives: `slo` - - #### Supported relations for resources - Resource Type | Supported Relations - -------------------------|-------------------------- - Connections | `viewer`, `editor`, `resolver` - Dashboards | `viewer`, `editor` - Notebooks | `viewer`, `editor` - Security Rules | `viewer`, `editor` - Service Level Objectives | `viewer`, `editor` - operationId: UpdateRestrictionPolicy - parameters: - - $ref: '#/components/parameters/ResourceID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RestrictionPolicyUpdateRequest' - description: Restriction policy payload - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RestrictionPolicyResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - summary: Update a restriction policy - tags: - - Restriction Policies - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/roles.yaml b/providers/src/datadog/v00.00.00000/services/roles.yaml deleted file mode 100644 index 20bdb34f..00000000 --- a/providers/src/datadog/v00.00.00000/services/roles.yaml +++ /dev/null @@ -1,2201 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - roles - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - PermissionsResponse: - description: Payload with API-returned permissions. - properties: - data: - description: Array of permissions. - items: - $ref: '#/components/schemas/Permission' - type: array - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - Permission: - description: Permission object. - properties: - attributes: - $ref: '#/components/schemas/PermissionAttributes' - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - required: - - type - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - PermissionAttributes: - description: Attributes of a permission. - properties: - created: - description: Creation time of the permission. - format: date-time - type: string - description: - description: Description of the permission. - type: string - display_name: - description: Displayed name for the permission. - type: string - display_type: - description: Display type. - type: string - group_name: - description: Name of the permission group. - type: string - name: - description: Name of the permission. - type: string - restricted: - description: Whether or not the permission is restricted. - type: boolean - type: object - PermissionsType: - default: permissions - description: Permissions resource type. - enum: - - permissions - example: permissions - type: string - x-enum-varnames: - - PERMISSIONS - RolesSort: - default: name - description: Sorting options for roles. - enum: - - name - - '-name' - - modified_at - - '-modified_at' - - user_count - - '-user_count' - type: string - x-enum-varnames: - - NAME_ASCENDING - - NAME_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - USER_COUNT_ASCENDING - - USER_COUNT_DESCENDING - RolesResponse: - description: Response containing information about multiple roles. - properties: - data: - description: Array of returned roles. - items: - $ref: '#/components/schemas/Role' - type: array - meta: - $ref: '#/components/schemas/ResponseMetaAttributes' - type: object - Role: - description: Role object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/RoleAttributes' - id: - description: The unique identifier of the role. - type: string - relationships: - $ref: '#/components/schemas/RoleResponseRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - type: object - ResponseMetaAttributes: - description: Object describing meta attributes of response. - properties: - page: - $ref: '#/components/schemas/Pagination' - type: object - RoleAttributes: - description: Attributes of the role. - properties: - created_at: - description: Creation time of the role. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last role modification. - format: date-time - readOnly: true - type: string - name: - description: The name of the role. The name is neither unique nor a stable identifier of the role. - type: string - user_count: - description: Number of users with that role. - format: int64 - readOnly: true - type: integer - type: object - RoleResponseRelationships: - description: Relationships of the role object returned by the API. - properties: - permissions: - $ref: '#/components/schemas/RelationshipToPermissions' - type: object - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - Pagination: - description: Pagination object. - properties: - total_count: - description: Total count. - format: int64 - type: integer - total_filtered_count: - description: Total count of elements matched by the filter. - format: int64 - type: integer - type: object - RelationshipToPermissions: - description: Relationship to multiple permissions objects. - properties: - data: - description: Relationships to permission objects. - items: - $ref: '#/components/schemas/RelationshipToPermissionData' - type: array - type: object - RelationshipToPermissionData: - description: Relationship to permission object. - properties: - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - type: object - RoleCreateRequest: - description: Create a role. - properties: - data: - $ref: '#/components/schemas/RoleCreateData' - required: - - data - type: object - RoleCreateResponse: - description: Response containing information about a created role. - properties: - data: - $ref: '#/components/schemas/RoleCreateResponseData' - type: object - RoleCreateData: - description: Data related to the creation of a role. - properties: - attributes: - $ref: '#/components/schemas/RoleCreateAttributes' - relationships: - $ref: '#/components/schemas/RoleRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - attributes - type: object - RoleCreateResponseData: - description: Role object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/RoleCreateAttributes' - id: - description: The unique identifier of the role. - type: string - relationships: - $ref: '#/components/schemas/RoleResponseRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - type: object - RoleCreateAttributes: - description: Attributes of the created role. - properties: - created_at: - description: Creation time of the role. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last role modification. - format: date-time - readOnly: true - type: string - name: - description: Name of the role. - example: developers - type: string - required: - - name - type: object - RoleRelationships: - description: Relationships of the role object. - properties: - permissions: - $ref: '#/components/schemas/RelationshipToPermissions' - users: - $ref: '#/components/schemas/RelationshipToUsers' - type: object - RelationshipToUsers: - description: Relationship to users. - properties: - data: - description: Relationships to user objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToUserData' - type: array - required: - - data - type: object - RelationshipToUserData: - description: Relationship to user object. - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - UsersType: - default: users - description: Users resource type. - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - RoleResponse: - description: Response containing information about a single role. - properties: - data: - $ref: '#/components/schemas/Role' - type: object - RoleUpdateRequest: - description: Update a role. - properties: - data: - $ref: '#/components/schemas/RoleUpdateData' - required: - - data - type: object - RoleUpdateResponse: - description: Response containing information about an updated role. - properties: - data: - $ref: '#/components/schemas/RoleUpdateResponseData' - type: object - RoleUpdateData: - description: Data related to the update of a role. - properties: - attributes: - $ref: '#/components/schemas/RoleUpdateAttributes' - id: - description: The unique identifier of the role. - example: 00000000-0000-1111-0000-000000000000 - type: string - relationships: - $ref: '#/components/schemas/RoleRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - attributes - - type - - id - type: object - RoleUpdateResponseData: - description: Role object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/RoleUpdateAttributes' - id: - description: The unique identifier of the role. - type: string - relationships: - $ref: '#/components/schemas/RoleResponseRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - type: object - RoleUpdateAttributes: - description: Attributes of the role. - properties: - created_at: - description: Creation time of the role. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last role modification. - format: date-time - readOnly: true - type: string - name: - description: Name of the role. - type: string - type: object - RoleCloneRequest: - description: Request to create a role by cloning an existing role. - properties: - data: - $ref: '#/components/schemas/RoleClone' - required: - - data - type: object - RoleClone: - description: Data for the clone role request. - properties: - attributes: - $ref: '#/components/schemas/RoleCloneAttributes' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - - attributes - type: object - RoleCloneAttributes: - description: Attributes required to create a new role by cloning an existing one. - properties: - name: - description: Name of the new role that is cloned. - example: cloned-role - type: string - required: - - name - type: object - RelationshipToPermission: - description: Relationship to a permissions object. - properties: - data: - $ref: '#/components/schemas/RelationshipToPermissionData' - type: object - RelationshipToUser: - description: Relationship to user. - properties: - data: - $ref: '#/components/schemas/RelationshipToUserData' - required: - - data - type: object - UsersResponse: - description: Response containing information about multiple users. - properties: - data: - description: Array of returned users. - items: - $ref: '#/components/schemas/User' - type: array - included: - description: Array of objects related to the users. - items: - $ref: '#/components/schemas/UserResponseIncludedItem' - type: array - meta: - $ref: '#/components/schemas/ResponseMetaAttributes' - readOnly: true - type: object - User: - description: User object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserAttributes' - id: - description: ID of the user. - type: string - relationships: - $ref: '#/components/schemas/UserResponseRelationships' - type: - $ref: '#/components/schemas/UsersType' - type: object - UserResponseIncludedItem: - description: An object related to a user. - oneOf: - - $ref: '#/components/schemas/Organization' - - $ref: '#/components/schemas/Permission' - - $ref: '#/components/schemas/Role' - UserAttributes: - description: Attributes of user object returned by the API. - properties: - created_at: - description: Creation time of the user. - format: date-time - type: string - disabled: - description: Whether the user is disabled. - type: boolean - email: - description: Email of the user. - type: string - handle: - description: Handle of the user. - type: string - icon: - description: URL of the user's icon. - type: string - modified_at: - description: Time that the user was last modified. - format: date-time - type: string - name: - description: Name of the user. - nullable: true - type: string - service_account: - description: Whether the user is a service account. - type: boolean - status: - description: Status of the user. - type: string - title: - description: Title of the user. - nullable: true - type: string - verified: - description: Whether the user is verified. - type: boolean - type: object - UserResponseRelationships: - description: Relationships of the user object returned by the API. - properties: - org: - $ref: '#/components/schemas/RelationshipToOrganization' - other_orgs: - $ref: '#/components/schemas/RelationshipToOrganizations' - other_users: - $ref: '#/components/schemas/RelationshipToUsers' - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - Organization: - description: Organization object. - properties: - attributes: - $ref: '#/components/schemas/OrganizationAttributes' - id: - description: ID of the organization. - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - type - type: object - RelationshipToOrganization: - description: Relationship to an organization. - properties: - data: - $ref: '#/components/schemas/RelationshipToOrganizationData' - required: - - data - type: object - RelationshipToOrganizations: - description: Relationship to organizations. - properties: - data: - description: Relationships to organization objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToOrganizationData' - type: array - required: - - data - type: object - RelationshipToRoles: - description: Relationship to roles. - properties: - data: - description: An array containing type and the unique identifier of a role. - items: - $ref: '#/components/schemas/RelationshipToRoleData' - type: array - type: object - OrganizationAttributes: - description: Attributes of the organization. - properties: - created_at: - description: Creation time of the organization. - format: date-time - type: string - description: - description: Description of the organization. - type: string - disabled: - description: Whether or not the organization is disabled. - type: boolean - modified_at: - description: Time of last organization modification. - format: date-time - type: string - name: - description: Name of the organization. - type: string - public_id: - description: Public ID of the organization. - type: string - sharing: - description: Sharing type of the organization. - type: string - url: - description: URL of the site that this organization exists at. - type: string - type: object - OrganizationsType: - default: orgs - description: Organizations resource type. - enum: - - orgs - example: orgs - type: string - x-enum-varnames: - - ORGS - RelationshipToOrganizationData: - description: Relationship to organization object. - properties: - id: - description: ID of the organization. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - id - - type - type: object - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - permissions: - id: datadog.roles.permissions - name: permissions - title: Permissions - methods: - list_permissions: - operation: - $ref: '#/paths/~1api~1v2~1permissions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_permissions: - operation: - $ref: '#/paths/~1api~1v2~1permissions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/permissions/methods/list_permissions' - insert: [] - update: [] - delete: [] - roles: - id: datadog.roles.roles - name: roles - title: Roles - methods: - list_roles: - operation: - $ref: '#/paths/~1api~1v2~1roles/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_roles: - operation: - $ref: '#/paths/~1api~1v2~1roles/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_role: - operation: - $ref: '#/paths/~1api~1v2~1roles/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - clone_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1clone/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/roles/methods/get_role' - - $ref: '#/components/x-stackQL-resources/roles/methods/list_roles' - insert: - - $ref: '#/components/x-stackQL-resources/roles/methods/create_role' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/roles/methods/delete_role' - role_permissions: - id: datadog.roles.role_permissions - name: role_permissions - title: Role Permissions - methods: - remove_permission_from_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1permissions/delete' - response: - mediaType: application/json - openAPIDocKey: '200' - list_role_permissions: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1permissions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_role_permissions: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1permissions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - add_permission_to_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1permissions/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/role_permissions/methods/list_role_permissions' - insert: [] - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/role_permissions/methods/remove_permission_from_role' - role_users: - id: datadog.roles.role_users - name: role_users - title: Role Users - methods: - remove_user_from_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1users/delete' - response: - mediaType: application/json - openAPIDocKey: '200' - list_role_users: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1users/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_role_users: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1users/get' - response: - mediaType: application/json - openAPIDocKey: '200' - add_user_to_role: - operation: - $ref: '#/paths/~1api~1v2~1roles~1{role_id}~1users/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/role_users/methods/list_role_users' - insert: [] - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/role_users/methods/remove_user_from_role' -paths: - /api/v2/permissions: - get: - description: 'Returns a list of all permissions, including name, description, and ID.' - operationId: ListPermissions - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PermissionsResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_read - summary: List permissions - tags: - - Roles - /api/v2/roles: - get: - description: 'Returns all roles, including their names and their unique identifiers.' - operationId: ListRoles - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - description: |- - Sort roles depending on the given field. Sort order is **ascending** by default. - Sort order is **descending** if the field is prefixed by a negative sign, for example: - `sort=-name`. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/RolesSort' - - description: Filter all roles by the given string. - in: query - name: filter - required: false - schema: - type: string - - description: Filter all roles by the given list of role IDs. - in: query - name: 'filter[id]' - required: false - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RolesResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_read - summary: List roles - tags: - - Roles - post: - description: Create a new role for your organization. - operationId: CreateRole - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RoleCreateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RoleCreateResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Create role - tags: - - Roles - x-codegen-request-body-name: body - '/api/v2/roles/{role_id}': - delete: - description: Disables a role. - operationId: DeleteRole - parameters: - - $ref: '#/components/parameters/RoleID' - responses: - '204': - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Delete role - tags: - - Roles - x-codegen-request-body-name: body - get: - description: Get a role in the organization specified by the role’s `role_id`. - operationId: GetRole - parameters: - - $ref: '#/components/parameters/RoleID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RoleResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_read - summary: Get a role - tags: - - Roles - x-codegen-request-body-name: body - patch: - description: Edit a role. Can only be used with application keys belonging to administrators. - operationId: UpdateRole - parameters: - - $ref: '#/components/parameters/RoleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RoleUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RoleUpdateResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unprocessable Entity - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Update a role - tags: - - Roles - x-codegen-request-body-name: body - '/api/v2/roles/{role_id}/clone': - post: - description: Clone an existing role - operationId: CloneRole - parameters: - - $ref: '#/components/parameters/RoleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RoleCloneRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RoleResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '409': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Create a new role by cloning an existing role - tags: - - Roles - x-codegen-request-body-name: body - x-permission: OR(USER_ACCESS_MANAGE) - '/api/v2/roles/{role_id}/permissions': - delete: - description: Removes a permission from a role. - operationId: RemovePermissionFromRole - parameters: - - $ref: '#/components/parameters/RoleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RelationshipToPermission' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PermissionsResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Revoke permission - tags: - - Roles - x-codegen-request-body-name: body - get: - description: Returns a list of all permissions for a single role. - operationId: ListRolePermissions - parameters: - - $ref: '#/components/parameters/RoleID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PermissionsResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_read - summary: List permissions for a role - tags: - - Roles - x-codegen-request-body-name: body - post: - description: Adds a permission to a role. - operationId: AddPermissionToRole - parameters: - - $ref: '#/components/parameters/RoleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RelationshipToPermission' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PermissionsResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Grant permission to a role - tags: - - Roles - x-codegen-request-body-name: body - '/api/v2/roles/{role_id}/users': - delete: - description: Removes a user from a role. - operationId: RemoveUserFromRole - parameters: - - $ref: '#/components/parameters/RoleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RelationshipToUser' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UsersResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Remove a user from a role - tags: - - Roles - x-codegen-request-body-name: body - get: - description: Gets all users of a role. - operationId: ListRoleUsers - parameters: - - $ref: '#/components/parameters/RoleID' - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - description: |- - User attribute to order results by. Sort order is **ascending** by default. - Sort order is **descending** if the field is prefixed by a negative sign, - for example `sort=-name`. Options: `name`, `email`, `status`. - in: query - name: sort - required: false - schema: - default: name - type: string - - description: Filter all users by the given string. Defaults to no filtering. - in: query - name: filter - required: false - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UsersResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_read - summary: Get all users of a role - tags: - - Roles - post: - description: Adds a user to a role. - operationId: AddUserToRole - parameters: - - $ref: '#/components/parameters/RoleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RelationshipToUser' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UsersResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Add a user to a role - tags: - - Roles - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/rum.yaml b/providers/src/datadog/v00.00.00000/services/rum.yaml deleted file mode 100644 index 0cb447f0..00000000 --- a/providers/src/datadog/v00.00.00000/services/rum.yaml +++ /dev/null @@ -1,2004 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - rum - description: Search or aggregate your RUM events over HTTP. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - RUMAggregateRequest: - description: The object sent with the request to retrieve aggregation buckets of RUM events from your organization. - properties: - compute: - description: The list of metrics or timeseries to compute for the retrieved buckets. - items: - $ref: '#/components/schemas/RUMCompute' - type: array - filter: - $ref: '#/components/schemas/RUMQueryFilter' - group_by: - description: The rules for the group by. - items: - $ref: '#/components/schemas/RUMGroupBy' - type: array - options: - $ref: '#/components/schemas/RUMQueryOptions' - page: - $ref: '#/components/schemas/RUMQueryPageOptions' - type: object - RUMAnalyticsAggregateResponse: - description: The response object for the RUM events aggregate API endpoint. - properties: - data: - $ref: '#/components/schemas/RUMAggregationBucketsResponse' - links: - $ref: '#/components/schemas/RUMResponseLinks' - meta: - $ref: '#/components/schemas/RUMResponseMetadata' - type: object - RUMCompute: - description: A compute rule to compute metrics or timeseries. - properties: - aggregation: - $ref: '#/components/schemas/RUMAggregationFunction' - interval: - description: |- - The time buckets' size (only used for type=timeseries) - Defaults to a resolution of 150 points. - example: 5m - type: string - metric: - description: The metric to use. - example: '@duration' - type: string - type: - $ref: '#/components/schemas/RUMComputeType' - required: - - aggregation - type: object - RUMQueryFilter: - description: The search and filter query settings. - properties: - from: - default: now-15m - description: 'The minimum time for the requested events; supports date (in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format with full date, hours, minutes, and the `Z` UTC indicator - seconds and fractional seconds are optional), math, and regular timestamps (in milliseconds).' - example: now-15m - type: string - query: - default: '*' - description: The search query following the RUM search syntax. - example: '@type:session AND @session.type:user' - type: string - to: - default: now - description: 'The maximum time for the requested events; supports date (in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format with full date, hours, minutes, and the `Z` UTC indicator - seconds and fractional seconds are optional), math, and regular timestamps (in milliseconds).' - example: now - type: string - type: object - RUMGroupBy: - description: A group-by rule. - properties: - facet: - description: The name of the facet to use (required). - example: '@view.time_spent' - type: string - histogram: - $ref: '#/components/schemas/RUMGroupByHistogram' - limit: - default: 10 - description: The maximum buckets to return for this group-by. - format: int64 - type: integer - missing: - $ref: '#/components/schemas/RUMGroupByMissing' - sort: - $ref: '#/components/schemas/RUMAggregateSort' - total: - $ref: '#/components/schemas/RUMGroupByTotal' - required: - - facet - type: object - RUMQueryOptions: - description: |- - Global query options that are used during the query. - Note: Only supply timezone or time offset, not both. Otherwise, the query fails. - properties: - time_offset: - description: The time offset (in seconds) to apply to the query. - format: int64 - type: integer - timezone: - default: UTC - description: 'The timezone can be specified as GMT, UTC, an offset from UTC (like UTC+1), or as a Timezone Database identifier (like America/New_York).' - example: GMT - type: string - type: object - RUMQueryPageOptions: - description: Paging attributes for listing events. - properties: - cursor: - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - limit: - default: 10 - description: Maximum number of events in the response. - example: 25 - format: int32 - maximum: 1000 - type: integer - type: object - RUMAggregationBucketsResponse: - description: The query results. - properties: - buckets: - description: 'The list of matching buckets, one item per bucket.' - items: - $ref: '#/components/schemas/RUMBucketResponse' - type: array - type: object - RUMResponseLinks: - description: Links attributes. - properties: - next: - description: |- - Link for the next set of results. Note that the request can also be made using the - POST endpoint. - example: 'https://app.datadoghq.com/api/v2/rum/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==' - type: string - type: object - RUMResponseMetadata: - description: The metadata associated with a request. - properties: - elapsed: - description: The time elapsed in milliseconds. - example: 132 - format: int64 - type: integer - page: - $ref: '#/components/schemas/RUMResponsePage' - request_id: - description: The identifier of the request. - example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR - type: string - status: - $ref: '#/components/schemas/RUMResponseStatus' - warnings: - description: |- - A list of warnings (non-fatal errors) encountered. Partial results may return if - warnings are present in the response. - items: - $ref: '#/components/schemas/RUMWarning' - type: array - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - RUMAggregationFunction: - description: An aggregation function. - enum: - - count - - cardinality - - pc75 - - pc90 - - pc95 - - pc98 - - pc99 - - sum - - min - - max - - avg - - median - example: pc90 - type: string - x-enum-varnames: - - COUNT - - CARDINALITY - - PERCENTILE_75 - - PERCENTILE_90 - - PERCENTILE_95 - - PERCENTILE_98 - - PERCENTILE_99 - - SUM - - MIN - - MAX - - AVG - - MEDIAN - RUMComputeType: - default: total - description: The type of compute. - enum: - - timeseries - - total - type: string - x-enum-varnames: - - TIMESERIES - - TOTAL - RUMGroupByHistogram: - description: |- - Used to perform a histogram computation (only for measure facets). - Note: At most 100 buckets are allowed, the number of buckets is (max - min)/interval. - properties: - interval: - description: The bin size of the histogram buckets. - example: 10 - format: double - type: number - max: - description: |- - The maximum value for the measure used in the histogram - (values greater than this one are filtered out). - example: 100 - format: double - type: number - min: - description: |- - The minimum value for the measure used in the histogram - (values smaller than this one are filtered out). - example: 50 - format: double - type: number - required: - - interval - - min - - max - type: object - RUMGroupByMissing: - description: The value to use for logs that don't have the facet used to group by. - oneOf: - - $ref: '#/components/schemas/RUMGroupByMissingString' - - $ref: '#/components/schemas/RUMGroupByMissingNumber' - RUMAggregateSort: - description: A sort rule. - example: - aggregation: count - order: asc - properties: - aggregation: - $ref: '#/components/schemas/RUMAggregationFunction' - metric: - description: The metric to sort by (only used for `type=measure`). - example: '@duration' - type: string - order: - $ref: '#/components/schemas/RUMSortOrder' - type: - $ref: '#/components/schemas/RUMAggregateSortType' - type: object - RUMGroupByTotal: - default: false - description: A resulting object to put the given computes in over all the matching records. - oneOf: - - $ref: '#/components/schemas/RUMGroupByTotalBoolean' - - $ref: '#/components/schemas/RUMGroupByTotalString' - - $ref: '#/components/schemas/RUMGroupByTotalNumber' - RUMBucketResponse: - description: Bucket values. - properties: - by: - additionalProperties: - description: The values for each group-by. - type: string - description: The key-value pairs for each group-by. - example: - '@session.type': user - '@type': view - type: object - computes: - additionalProperties: - $ref: '#/components/schemas/RUMAggregateBucketValue' - description: 'A map of the metric name to value for regular compute, or a list of values for a timeseries.' - type: object - type: object - RUMResponsePage: - description: Paging attributes. - properties: - after: - description: 'The cursor to use to get the next results, if any. To make the next request, use the same parameters with the addition of `page[cursor]`.' - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - type: object - RUMResponseStatus: - description: The status of the response. - enum: - - done - - timeout - example: done - type: string - x-enum-varnames: - - DONE - - TIMEOUT - RUMWarning: - description: A warning message indicating something that went wrong with the query. - properties: - code: - description: A unique code for this type of warning. - example: unknown_index - type: string - detail: - description: A detailed explanation of this specific warning. - example: 'indexes: foo, bar' - type: string - title: - description: A short human-readable summary of the warning. - example: 'One or several indexes are missing or invalid, results hold data from the other indexes' - type: string - type: object - RUMGroupByMissingString: - description: The missing value to use if there is string valued facet. - type: string - RUMGroupByMissingNumber: - description: The missing value to use if there is a number valued facet. - format: double - type: number - RUMSortOrder: - description: 'The order to use, ascending or descending.' - enum: - - asc - - desc - example: asc - type: string - x-enum-varnames: - - ASCENDING - - DESCENDING - RUMAggregateSortType: - default: alphabetical - description: The type of sorting algorithm. - enum: - - alphabetical - - measure - type: string - x-enum-varnames: - - ALPHABETICAL - - MEASURE - RUMGroupByTotalBoolean: - description: 'If set to true, creates an additional bucket labeled "$facet_total".' - type: boolean - RUMGroupByTotalString: - description: A string to use as the key value for the total bucket. - type: string - RUMGroupByTotalNumber: - description: A number to use as the key value for the total bucket. - format: double - type: number - RUMAggregateBucketValue: - description: 'A bucket value, can be either a timeseries or a single value.' - oneOf: - - $ref: '#/components/schemas/RUMAggregateBucketValueSingleString' - - $ref: '#/components/schemas/RUMAggregateBucketValueSingleNumber' - - $ref: '#/components/schemas/RUMAggregateBucketValueTimeseries' - RUMAggregateBucketValueSingleString: - description: A single string value. - type: string - RUMAggregateBucketValueSingleNumber: - description: A single number value. - format: double - type: number - RUMAggregateBucketValueTimeseries: - description: A timeseries array. - items: - $ref: '#/components/schemas/RUMAggregateBucketValueTimeseriesPoint' - type: array - x-generate-alias-as-model: true - RUMAggregateBucketValueTimeseriesPoint: - description: A timeseries point. - properties: - time: - description: The time value for this point. - example: '2020-06-08T11:55:00.123Z' - format: date-time - type: string - value: - description: The value for this point. - example: 19 - format: double - type: number - type: object - RUMApplicationsResponse: - description: RUM applications response. - properties: - data: - description: RUM applications array response. - items: - $ref: '#/components/schemas/RUMApplicationList' - type: array - type: object - RUMApplicationList: - description: RUM application list. - properties: - attributes: - $ref: '#/components/schemas/RUMApplicationListAttributes' - id: - description: RUM application ID. - example: abcd1234-0000-0000-abcd-1234abcd5678 - type: string - type: - $ref: '#/components/schemas/RUMApplicationListType' - required: - - attributes - - type - type: object - RUMApplicationListAttributes: - description: RUM application list attributes. - properties: - application_id: - description: ID of the RUM application. - example: abcd1234-0000-0000-abcd-1234abcd5678 - type: string - created_at: - description: Timestamp in ms of the creation date. - example: 1659479836169 - format: int64 - type: integer - created_by_handle: - description: Handle of the creator user. - example: john.doe - type: string - hash: - description: Hash of the RUM application. Optional. - type: string - is_active: - description: Indicates if the RUM application is active. - example: true - type: boolean - name: - description: Name of the RUM application. - example: my_rum_application - type: string - org_id: - description: Org ID of the RUM application. - example: 999 - format: int32 - maximum: 2147483647 - type: integer - type: - description: 'Type of the RUM application. Supported values are `browser`, `ios`, `android`, `react-native`, `flutter`.' - example: browser - type: string - updated_at: - description: Timestamp in ms of the last update date. - example: 1659479836169 - format: int64 - type: integer - updated_by_handle: - description: Handle of the updater user. - example: jane.doe - type: string - required: - - application_id - - created_at - - created_by_handle - - name - - org_id - - type - - updated_at - - updated_by_handle - type: object - RUMApplicationListType: - default: rum_application - description: RUM application list type. - enum: - - rum_application - example: rum_application - type: string - x-enum-varnames: - - RUM_APPLICATION - RUMApplicationCreateRequest: - description: RUM application creation request attributes. - properties: - data: - $ref: '#/components/schemas/RUMApplicationCreate' - required: - - data - type: object - RUMApplicationResponse: - description: RUM application response. - properties: - data: - $ref: '#/components/schemas/RUMApplication' - type: object - RUMApplicationCreate: - description: RUM application creation. - properties: - attributes: - $ref: '#/components/schemas/RUMApplicationCreateAttributes' - type: - $ref: '#/components/schemas/RUMApplicationCreateType' - required: - - attributes - - type - type: object - RUMApplication: - description: RUM application. - properties: - attributes: - $ref: '#/components/schemas/RUMApplicationAttributes' - id: - description: RUM application ID. - example: abcd1234-0000-0000-abcd-1234abcd5678 - type: string - type: - $ref: '#/components/schemas/RUMApplicationType' - required: - - attributes - - id - - type - type: object - RUMApplicationCreateAttributes: - description: RUM application creation attributes. - properties: - name: - description: Name of the RUM application. - example: my_new_rum_application - type: string - type: - description: 'Type of the RUM application. Supported values are `browser`, `ios`, `android`, `react-native`, `flutter`.' - example: browser - type: string - required: - - name - type: object - RUMApplicationCreateType: - default: rum_application_create - description: RUM application creation type. - enum: - - rum_application_create - example: rum_application_create - type: string - x-enum-varnames: - - RUM_APPLICATION_CREATE - RUMApplicationAttributes: - description: RUM application attributes. - properties: - application_id: - description: ID of the RUM application. - example: abcd1234-0000-0000-abcd-1234abcd5678 - type: string - client_token: - description: Client token of the RUM application. - example: abcd1234efgh5678ijkl90abcd1234efgh0 - type: string - created_at: - description: Timestamp in ms of the creation date. - example: 1659479836169 - format: int64 - type: integer - created_by_handle: - description: Handle of the creator user. - example: john.doe - type: string - hash: - description: Hash of the RUM application. Optional. - type: string - is_active: - description: Indicates if the RUM application is active. - example: true - type: boolean - name: - description: Name of the RUM application. - example: my_rum_application - type: string - org_id: - description: Org ID of the RUM application. - example: 999 - format: int32 - maximum: 2147483647 - type: integer - type: - description: 'Type of the RUM application. Supported values are `browser`, `ios`, `android`, `react-native`, `flutter`.' - example: browser - type: string - updated_at: - description: Timestamp in ms of the last update date. - example: 1659479836169 - format: int64 - type: integer - updated_by_handle: - description: Handle of the updater user. - example: jane.doe - type: string - required: - - application_id - - client_token - - created_at - - created_by_handle - - name - - org_id - - type - - updated_at - - updated_by_handle - type: object - RUMApplicationType: - default: rum_application - description: RUM application response type. - enum: - - rum_application - example: rum_application - type: string - x-enum-varnames: - - RUM_APPLICATION - RUMApplicationUpdateRequest: - description: RUM application update request. - properties: - data: - $ref: '#/components/schemas/RUMApplicationUpdate' - required: - - data - type: object - RUMApplicationUpdate: - description: RUM application update. - properties: - attributes: - $ref: '#/components/schemas/RUMApplicationUpdateAttributes' - id: - description: RUM application ID. - example: abcd1234-0000-0000-abcd-1234abcd5678 - type: string - type: - $ref: '#/components/schemas/RUMApplicationUpdateType' - required: - - id - - type - type: object - RUMApplicationUpdateAttributes: - description: RUM application update attributes. - properties: - name: - description: Name of the RUM application. - example: updated_name_for_my_existing_rum_application - type: string - type: - description: 'Type of the RUM application. Supported values are `browser`, `ios`, `android`, `react-native`, `flutter`.' - example: browser - type: string - type: object - RUMApplicationUpdateType: - default: rum_application_update - description: RUM application update type. - enum: - - rum_application_update - example: rum_application_update - type: string - x-enum-varnames: - - RUM_APPLICATION_UPDATE - RUMSort: - description: Sort parameters when querying events. - enum: - - timestamp - - '-timestamp' - type: string - x-enum-varnames: - - TIMESTAMP_ASCENDING - - TIMESTAMP_DESCENDING - RUMEventsResponse: - description: Response object with all events matching the request and pagination information. - properties: - data: - description: Array of events matching the request. - items: - $ref: '#/components/schemas/RUMEvent' - type: array - links: - $ref: '#/components/schemas/RUMResponseLinks' - meta: - $ref: '#/components/schemas/RUMResponseMetadata' - type: object - RUMEvent: - description: Object description of a RUM event after being processed and stored by Datadog. - properties: - attributes: - $ref: '#/components/schemas/RUMEventAttributes' - id: - description: Unique ID of the event. - example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA - type: string - type: - $ref: '#/components/schemas/RUMEventType' - type: object - RUMEventAttributes: - description: JSON object containing all event attributes and their associated values. - properties: - attributes: - additionalProperties: {} - description: JSON object of attributes from RUM events. - example: - customAttribute: 123 - duration: 2345 - type: object - service: - description: |- - The name of the application or service generating RUM events. - It is used to switch from RUM to APM, so make sure you define the same - value when you use both products. - example: web-app - type: string - tags: - description: Array of tags associated with your event. - example: - - 'team:A' - items: - description: Tag associated with your event. - type: string - type: array - timestamp: - description: Timestamp of your event. - example: '2019-01-02T09:42:36.320Z' - format: date-time - type: string - type: object - RUMEventType: - default: rum - description: Type of the event. - enum: - - rum - example: rum - type: string - x-enum-varnames: - - RUM - RUMSearchEventsRequest: - description: The request for a RUM events list. - properties: - filter: - $ref: '#/components/schemas/RUMQueryFilter' - options: - $ref: '#/components/schemas/RUMQueryOptions' - page: - $ref: '#/components/schemas/RUMQueryPageOptions' - sort: - $ref: '#/components/schemas/RUMSort' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - events: - id: datadog.rum.events - name: events - title: Events - methods: - aggregate_rum_events: - operation: - $ref: '#/paths/~1api~1v2~1rum~1analytics~1aggregate/post' - response: - mediaType: application/json - openAPIDocKey: '200' - list_rum_events: - operation: - $ref: '#/paths/~1api~1v2~1rum~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_rum_events: - operation: - $ref: '#/paths/~1api~1v2~1rum~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - search_rum_events: - operation: - $ref: '#/paths/~1api~1v2~1rum~1events~1search/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/events/methods/list_rum_events' - insert: [] - update: [] - delete: [] - applications: - id: datadog.rum.applications - name: applications - title: Applications - methods: - get_rum_applications: - operation: - $ref: '#/paths/~1api~1v2~1rum~1applications/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_rum_applications: - operation: - $ref: '#/paths/~1api~1v2~1rum~1applications/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_rum_application: - operation: - $ref: '#/paths/~1api~1v2~1rum~1applications/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_rum_application: - operation: - $ref: '#/paths/~1api~1v2~1rum~1applications~1{id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_rum_application: - operation: - $ref: '#/paths/~1api~1v2~1rum~1applications~1{id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_rum_application: - operation: - $ref: '#/paths/~1api~1v2~1rum~1applications~1{id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_rum_application: - operation: - $ref: '#/paths/~1api~1v2~1rum~1applications~1{id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/applications/methods/get_rum_application' - - $ref: '#/components/x-stackQL-resources/applications/methods/get_rum_applications' - insert: - - $ref: '#/components/x-stackQL-resources/applications/methods/create_rum_application' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/applications/methods/delete_rum_application' -paths: - /api/v2/rum/analytics/aggregate: - post: - description: The API endpoint to aggregate RUM events into buckets of computed metrics and timeseries. - operationId: AggregateRUMEvents - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RUMAggregateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RUMAnalyticsAggregateResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Aggregate RUM events - tags: - - RUM - x-codegen-request-body-name: body - /api/v2/rum/applications: - get: - description: List all the RUM applications in your organization. - operationId: GetRUMApplications - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RUMApplicationsResponse' - description: OK - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List all the RUM applications - tags: - - RUM - post: - description: Create a new RUM application in your organization. - operationId: CreateRUMApplication - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RUMApplicationCreateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RUMApplicationResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a new RUM application - tags: - - RUM - x-codegen-request-body-name: body - '/api/v2/rum/applications/{id}': - delete: - description: Delete an existing RUM application in your organization. - operationId: DeleteRUMApplication - parameters: - - description: RUM application ID. - in: path - name: id - required: true - schema: - type: string - responses: - '204': - description: No Content - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete a RUM application - tags: - - RUM - get: - description: Get the RUM application with given ID in your organization. - operationId: GetRUMApplication - parameters: - - description: RUM application ID. - in: path - name: id - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RUMApplicationResponse' - description: OK - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get a RUM application - tags: - - RUM - patch: - description: Update the RUM application with given ID in your organization. - operationId: UpdateRUMApplication - parameters: - - description: RUM application ID. - in: path - name: id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RUMApplicationUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RUMApplicationResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unprocessable Entity. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update a RUM application - tags: - - RUM - x-codegen-request-body-name: body - /api/v2/rum/events: - get: - description: |- - List endpoint returns events that match a RUM search query. - [Results are paginated][1]. - - Use this endpoint to see your latest RUM events. - - [1]: https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination - operationId: ListRUMEvents - parameters: - - description: Search query following RUM syntax. - example: '@type:session @application_id:xxxx' - in: query - name: 'filter[query]' - required: false - schema: - type: string - - description: Minimum timestamp for requested events. - example: '2019-01-02T09:42:36.320Z' - in: query - name: 'filter[from]' - required: false - schema: - format: date-time - type: string - - description: Maximum timestamp for requested events. - example: '2019-01-03T09:42:36.320Z' - in: query - name: 'filter[to]' - required: false - schema: - format: date-time - type: string - - description: Order of events in results. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/RUMSort' - - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - in: query - name: 'page[cursor]' - required: false - schema: - type: string - - description: Maximum number of events in the response. - example: 25 - in: query - name: 'page[limit]' - required: false - schema: - default: 10 - format: int32 - maximum: 1000 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RUMEventsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get a list of RUM events - tags: - - RUM - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data - /api/v2/rum/events/search: - post: - description: |- - List endpoint returns RUM events that match a RUM search query. - [Results are paginated][1]. - - Use this endpoint to build complex RUM events filtering and search. - - [1]: https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination - operationId: SearchRUMEvents - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/RUMSearchEventsRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/RUMEventsResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Search RUM events - tags: - - RUM - x-codegen-request-body-name: body - x-pagination: - cursorParam: body.page.cursor - cursorPath: meta.page.after - limitParam: body.page.limit - resultsPath: data diff --git a/providers/src/datadog/v00.00.00000/services/security.yaml b/providers/src/datadog/v00.00.00000/services/security.yaml new file mode 100644 index 00000000..016f1257 --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/security.yaml @@ -0,0 +1,12753 @@ +openapi: 3.0.0 +info: + title: security API + description: datadog security API + version: '1.0' +paths: + /api/v2/agentless_scanning/accounts/aws: + get: + description: Fetches the scan options configured for AWS accounts. + operationId: ListAwsScanOptions + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsScanOptionsListResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List AWS Scan Options + tags: + - Agentless Scanning + post: + description: Activate Agentless scan options for an AWS account. + operationId: CreateAwsScanOptions + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AwsScanOptionsCreateRequest' + description: The definition of the new scan options. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsScanOptionsResponse' + description: Agentless scan options enabled successfully. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Post AWS Scan Options + tags: + - Agentless Scanning + x-codegen-request-body-name: body + /api/v2/agentless_scanning/accounts/aws/{account_id}: + delete: + description: Delete Agentless scan options for an AWS account. + operationId: DeleteAwsScanOptions + parameters: + - $ref: '#/components/parameters/AwsAccountId' + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete AWS Scan Options + tags: + - Agentless Scanning + get: + description: Fetches the Agentless scan options for an activated account. + operationId: GetAwsScanOptions + parameters: + - $ref: '#/components/parameters/AwsAccountId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsScanOptionsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get AWS scan options + tags: + - Agentless Scanning + patch: + description: Update the Agentless scan options for an activated account. + operationId: UpdateAwsScanOptions + parameters: + - $ref: '#/components/parameters/AwsAccountId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AwsScanOptionsUpdateRequest' + description: New definition of the scan options. + required: true + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Patch AWS Scan Options + tags: + - Agentless Scanning + x-codegen-request-body-name: body + /api/v2/agentless_scanning/ondemand/aws: + get: + description: Fetches the most recent 1000 AWS on demand tasks. + operationId: ListAwsOnDemandTasks + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsOnDemandListResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get AWS On Demand tasks + tags: + - Agentless Scanning + x-permission: + operator: OR + permissions: + - security_monitoring_findings_read + post: + description: >- + Trigger the scan of an AWS resource with a high priority. Agentless + scanning must be activated for the AWS account containing the resource + to scan. + operationId: CreateAwsOnDemandTask + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AwsOnDemandCreateRequest' + description: The definition of the on demand task. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsOnDemandResponse' + description: AWS on demand task created successfully. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Post an AWS on demand task + tags: + - Agentless Scanning + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_findings_write + /api/v2/agentless_scanning/ondemand/aws/{task_id}: + get: + description: Fetch the data of a specific on demand task. + operationId: GetAwsOnDemandTask + parameters: + - $ref: '#/components/parameters/OnDemandTaskId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/AwsOnDemandResponse' + description: OK. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get AWS On Demand task by id + tags: + - Agentless Scanning + x-permission: + operator: OR + permissions: + - security_monitoring_findings_read + /api/v2/cloud_security_management/custom_frameworks: + post: + description: Create a custom framework. + operationId: CreateCustomFramework + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateCustomFrameworkRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CreateCustomFrameworkResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + '500': + $ref: '#/components/responses/BadRequestResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_read + - security_monitoring_rules_write + summary: Create a custom framework + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - security_monitoring_rules_read + - security_monitoring_rules_write + /api/v2/cloud_security_management/custom_frameworks/{handle}/{version}: + delete: + description: Delete a custom framework. + operationId: DeleteCustomFramework + parameters: + - $ref: '#/components/parameters/CustomFrameworkHandle' + - $ref: '#/components/parameters/CustomFrameworkVersion' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DeleteCustomFrameworkResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + '500': + $ref: '#/components/responses/BadRequestResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_read + - security_monitoring_rules_write + summary: Delete a custom framework + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - security_monitoring_rules_read + - security_monitoring_rules_write + get: + description: Get a custom framework. + operationId: GetCustomFramework + parameters: + - $ref: '#/components/parameters/CustomFrameworkHandle' + - $ref: '#/components/parameters/CustomFrameworkVersion' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetCustomFrameworkResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + '500': + $ref: '#/components/responses/BadRequestResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_read + summary: Get a custom framework + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_rules_read + put: + description: Update a custom framework. + operationId: UpdateCustomFramework + parameters: + - $ref: '#/components/parameters/CustomFrameworkHandle' + - $ref: '#/components/parameters/CustomFrameworkVersion' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateCustomFrameworkRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateCustomFrameworkResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + '500': + $ref: '#/components/responses/BadRequestResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_read + - security_monitoring_rules_write + summary: Update a custom framework + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - security_monitoring_rules_read + - security_monitoring_rules_write + /api/v2/cloud_security_management/resource_filters: + get: + description: List resource filters. + operationId: GetResourceEvaluationFilters + parameters: + - $ref: '#/components/parameters/ResourceFilterProvider' + - $ref: '#/components/parameters/ResourceFilterAccountID' + - $ref: '#/components/parameters/SkipCache' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetResourceEvaluationFiltersResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_filters_read + summary: List resource filters + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_filters_read + put: + description: Update resource filters. + operationId: UpdateResourceEvaluationFilters + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateResourceEvaluationFiltersRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateResourceEvaluationFiltersResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_filters_write + summary: Update resource filters + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_filters_write + /api/v2/csm/onboarding/agents: + get: + description: Get the list of all CSM Agents running on your hosts and containers. + operationId: ListAllCSMAgents + parameters: + - description: The page index for pagination (zero-based). + in: query + name: page + required: false + schema: + example: 2 + format: int32 + maximum: 1000000 + minimum: 0 + type: integer + - description: The number of items to include in a single page. + in: query + name: size + required: false + schema: + example: 12 + format: int32 + maximum: 100 + minimum: 0 + type: integer + - description: >- + A search query string to filter results (for example, + `hostname:COMP-T2H4J27423`). + in: query + name: query + required: false + schema: + example: hostname:COMP-T2H4J27423 + type: string + - description: >- + The sort direction for results. Use `asc` for ascending or `desc` + for descending. + in: query + name: order_direction + required: false + schema: + $ref: '#/components/schemas/OrderDirection' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CsmAgentsResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all CSM Agents + tags: + - CSM Agents + /api/v2/csm/onboarding/coverage_analysis/cloud_accounts: + get: + description: |- + Get the CSM Coverage Analysis of your Cloud Accounts. + This is calculated based on the number of your Cloud Accounts that are + scanned for security issues. + operationId: GetCSMCloudAccountsCoverageAnalysis + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CsmCloudAccountsCoverageAnalysisResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get the CSM Cloud Accounts Coverage Analysis + tags: + - CSM Coverage Analysis + /api/v2/csm/onboarding/coverage_analysis/hosts_and_containers: + get: + description: |- + Get the CSM Coverage Analysis of your Hosts and Containers. + This is calculated based on the number of agents running on your Hosts + and Containers with CSM feature(s) enabled. + operationId: GetCSMHostsAndContainersCoverageAnalysis + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/CsmHostsAndContainersCoverageAnalysisResponse + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get the CSM Hosts and Containers Coverage Analysis + tags: + - CSM Coverage Analysis + /api/v2/csm/onboarding/coverage_analysis/serverless: + get: + description: >- + Get the CSM Coverage Analysis of your Serverless Resources. + + This is calculated based on the number of agents running on your + Serverless + + Resources with CSM feature(s) enabled. + operationId: GetCSMServerlessCoverageAnalysis + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CsmServerlessCoverageAnalysisResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get the CSM Serverless Coverage Analysis + tags: + - CSM Coverage Analysis + /api/v2/csm/onboarding/serverless/agents: + get: + description: >- + Get the list of all CSM Serverless Agents running on your hosts and + containers. + operationId: ListAllCSMServerlessAgents + parameters: + - description: The page index for pagination (zero-based). + in: query + name: page + required: false + schema: + example: 2 + format: int32 + maximum: 1000000 + minimum: 0 + type: integer + - description: The number of items to include in a single page. + in: query + name: size + required: false + schema: + example: 12 + format: int32 + maximum: 100 + minimum: 0 + type: integer + - description: >- + A search query string to filter results (for example, + `hostname:COMP-T2H4J27423`). + in: query + name: query + required: false + schema: + example: hostname:COMP-T2H4J27423 + type: string + - description: >- + The sort direction for results. Use `asc` for ascending or `desc` + for descending. + in: query + name: order_direction + required: false + schema: + $ref: '#/components/schemas/OrderDirection' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CsmAgentsResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all CSM Serverless Agents + tags: + - CSM Agents + /api/v2/posture_management/findings: + get: + description: > + Get a list of findings. These include both misconfigurations and + identity risks. + + + **Note**: To filter and return only identity risks, add the following + query parameter: `?filter[tags]=dd_rule_type:ciem` + + + ### Filtering + + + Filters can be applied by appending query parameters to the URL. + + - Using a single filter: `?filter[attribute_key]=attribute_value` + - Chaining filters: `?filter[attribute_key]=attribute_value&filter[attribute_key]=attribute_value...` + - Filtering on tags: `?filter[tags]=tag_key:tag_value&filter[tags]=tag_key_2:tag_value_2` + + Here, `attribute_key` can be any of the filter keys described further + below. + + + Query parameters of type `integer` support comparison operators (`>`, + `>=`, `<`, `<=`). This is particularly useful when filtering by + `evaluation_changed_at` or `resource_discovery_timestamp`. For example: + `?filter[evaluation_changed_at]=>20123123121`. + + + You can also use the negation operator on strings. For example, use + `filter[resource_type]=-aws*` to filter for any non-AWS resources. + + + The operator must come after the equal sign. For example, to filter with + the `>=` operator, add the operator after the equal sign: + `filter[evaluation_changed_at]=>=1678809373257`. + + + Query parameters must be only among the documented ones and with values + of correct types. Duplicated query parameters (e.g. + `filter[status]=low&filter[status]=info`) are not allowed. + + + ### Additional extension fields + + + Additional extension fields are available for some findings. + + + The data is available when you include the query parameter + `?detailed_findings=true` in the request. + + + The following fields are available for findings: + + - `external_id`: The resource external ID related to the finding. + + - `description`: The description and remediation steps for the finding. + + - `datadog_link`: The Datadog relative link for the finding. + + - `ip_addresses`: The list of private IP addresses for the resource + related to the finding. + + + ### Response + + + The response includes an array of finding objects, pagination metadata, + and a count of items that match the query. + + + Each finding object contains the following: + + + - The finding ID that can be used in a `GetFinding` request to retrieve + the full finding details. + + - Core attributes, including status, evaluation, high-level resource + details, muted state, and rule details. + + - `evaluation_changed_at` and `resource_discovery_date` time stamps. + + - An array of associated tags. + operationId: ListFindings + parameters: + - description: Limit the number of findings returned. Must be <= 1000. + example: 50 + in: query + name: page[limit] + required: false + schema: + default: 100 + format: int64 + maximum: 1000 + minimum: 1 + type: integer + - description: Return findings for a given snapshot of time (Unix ms). + example: 1678721573794 + in: query + name: snapshot_timestamp + required: false + schema: + format: int64 + minimum: 1 + type: integer + - description: Return the next page of findings pointed to by the cursor. + example: >- + eyJhZnRlciI6IkFRQUFBWWJiaEJXQS1OY1dqUUFBQUFCQldXSmlhRUpYUVVGQlJFSktkbTlDTUdaWFRVbDNRVUUiLCJ2YWx1ZXMiOlsiY3JpdGljYWwiXX0= + in: query + name: page[cursor] + required: false + schema: + type: string + - description: Return findings that have these associated tags (repeatable). + example: >- + filter[tags]=cloud_provider:aws&filter[tags]=aws_account:999999999999 + in: query + name: filter[tags] + required: false + schema: + type: string + - description: >- + Return findings that have changed from pass to fail or vice versa on + a specified date (Unix ms) or date range (using comparison + operators). + example: '>=1678721573794' + in: query + name: filter[evaluation_changed_at] + required: false + schema: + type: string + - description: >- + Set to `true` to return findings that are muted. Set to `false` to + return unmuted findings. + in: query + name: filter[muted] + required: false + schema: + type: boolean + - description: Return findings for the specified rule ID. + in: query + name: filter[rule_id] + required: false + schema: + type: string + - description: Return findings for the specified rule. + in: query + name: filter[rule_name] + required: false + schema: + type: string + - description: Return only findings for the specified resource type. + in: query + name: filter[resource_type] + required: false + schema: + type: string + - description: Return only findings for the specified resource id. + in: query + name: filter[@resource_id] + required: false + schema: + type: string + - description: >- + Return findings that were found on a specified date (Unix ms) or + date range (using comparison operators). + example: '>=1678721573794' + in: query + name: filter[discovery_timestamp] + required: false + schema: + type: string + - description: Return only `pass` or `fail` findings. + example: pass + in: query + name: filter[evaluation] + required: false + schema: + $ref: '#/components/schemas/FindingEvaluation' + - description: Return only findings with the specified status. + example: critical + in: query + name: filter[status] + required: false + schema: + $ref: '#/components/schemas/FindingStatus' + - description: >- + Return findings that match the selected vulnerability types + (repeatable). + example: + - misconfiguration + explode: true + in: query + name: filter[vulnerability_type] + required: false + schema: + items: + $ref: '#/components/schemas/FindingVulnerabilityType' + type: array + - description: Return additional fields for some findings. + example: + - true + in: query + name: detailed_findings + required: false + schema: + type: boolean + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListFindingsResponse' + description: OK + '400': + $ref: '#/components/responses/FindingsBadRequestResponse' + '403': + $ref: '#/components/responses/FindingsForbiddenResponse' + '404': + $ref: '#/components/responses/FindingsNotFoundResponse' + '429': + $ref: '#/components/responses/FindingsTooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_findings_read + summary: List findings + tags: + - Security Monitoring + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.cursor + limitParam: page[limit] + resultsPath: data + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + patch: + description: Mute or unmute findings. + operationId: MuteFindings + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/BulkMuteFindingsRequest' + description: > + ### Attributes + + + All findings are updated with the same attributes. The request body + must include at least two attributes: `muted` and `reason`. + + The allowed reasons depend on whether the finding is being muted or + unmuted: + - To mute a finding: `PENDING_FIX`, `FALSE_POSITIVE`, `ACCEPTED_RISK`, `OTHER`. + - To unmute a finding : `NO_PENDING_FIX`, `HUMAN_ERROR`, `NO_LONGER_ACCEPTED_RISK`, `OTHER`. + + ### Meta + + + The request body must include a list of the finding IDs to be updated. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/BulkMuteFindingsResponse' + description: OK + '400': + $ref: '#/components/responses/FindingsBadRequestResponse' + '403': + $ref: '#/components/responses/FindingsForbiddenResponse' + '404': + $ref: '#/components/responses/FindingsNotFoundResponse' + '422': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: >- + Invalid Request: The server understands the request syntax but + cannot process it due to invalid data. + '429': + $ref: '#/components/responses/FindingsTooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Mute or unmute a batch of findings + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/posture_management/findings/{finding_id}: + get: + description: Returns a single finding with message and resource configuration. + operationId: GetFinding + parameters: + - description: The ID of the finding. + in: path + name: finding_id + required: true + schema: + type: string + - description: Return the finding for a given snapshot of time (Unix ms). + example: 1678721573794 + in: query + name: snapshot_timestamp + required: false + schema: + format: int64 + minimum: 1 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetFindingResponse' + description: OK + '400': + $ref: '#/components/responses/FindingsBadRequestResponse' + '403': + $ref: '#/components/responses/FindingsForbiddenResponse' + '404': + $ref: '#/components/responses/FindingsNotFoundResponse' + '429': + $ref: '#/components/responses/FindingsTooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_findings_read + summary: Get a finding + tags: + - Security Monitoring + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/security/assets: + get: + description: > + Get a list of vulnerable assets. + + + ### Pagination + + + Please review the [Pagination section for the "List + Vulnerabilities"] endpoint. + + + ### Filtering + + + Please review the [Filtering section for the "List + Vulnerabilities"] endpoint. + + + ### Metadata + + + Please review the [Metadata section for the "List + Vulnerabilities"] endpoint. + operationId: ListVulnerableAssets + parameters: + - description: >- + Its value must come from the `links` section of the response of the + first request. Do not manually edit it. + example: >- + b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4 + in: query + name: page[token] + required: false + schema: + type: string + - description: >- + The page number to be retrieved. It should be equal or greater than + `1` + example: 1 + in: query + name: page[number] + required: false + schema: + format: int64 + minimum: 1 + type: integer + - description: Filter by name. + example: datadog-agent + in: query + name: filter[name] + required: false + schema: + type: string + - description: Filter by type. + example: Host + in: query + name: filter[type] + required: false + schema: + $ref: '#/components/schemas/AssetType' + - description: >- + Filter by the first version of the asset since it has been + vulnerable. + example: v1.15.1 + in: query + name: filter[version.first] + required: false + schema: + type: string + - description: Filter by the last detected version of the asset. + example: v1.15.1 + in: query + name: filter[version.last] + required: false + schema: + type: string + - description: Filter by the repository url associated to the asset. + example: github.com/DataDog/datadog-agent.git + in: query + name: filter[repository_url] + required: false + schema: + type: string + - description: Filter whether the asset is in production or not. + example: false + in: query + name: filter[risks.in_production] + required: false + schema: + type: boolean + - description: Filter whether the asset (Service) is under attack or not. + example: false + in: query + name: filter[risks.under_attack] + required: false + schema: + type: boolean + - description: Filter whether the asset (Host) is publicly accessible or not. + example: false + in: query + name: filter[risks.is_publicly_accessible] + required: false + schema: + type: boolean + - description: Filter whether the asset (Host) has privileged access or not. + example: false + in: query + name: filter[risks.has_privileged_access] + required: false + schema: + type: boolean + - description: >- + Filter whether the asset (Host) has access to sensitive data or + not. + example: false + in: query + name: filter[risks.has_access_to_sensitive_data] + required: false + schema: + type: boolean + - description: Filter by environment. + example: staging + in: query + name: filter[environments] + required: false + schema: + type: string + - description: Filter by teams. + example: compute + in: query + name: filter[teams] + required: false + schema: + type: string + - description: Filter by architecture. + example: arm64 + in: query + name: filter[arch] + required: false + schema: + type: string + - description: Filter by operating system name. + example: ubuntu + in: query + name: filter[operating_system.name] + required: false + schema: + type: string + - description: Filter by operating system version. + example: '24.04' + in: query + name: filter[operating_system.version] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListVulnerableAssetsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: >- + Bad request: The server cannot process the request due to invalid + syntax in the request. + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Forbidden: Access denied' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Not found: There is no request associated with the provided token.' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: List vulnerable assets + tags: + - Security Monitoring + x-unstable: >- + **Note**: This endpoint is a private preview. + + If you are interested in accessing this API, [fill out this + form](https://forms.gle/kMYC1sDr6WDUBDsx9). + /api/v2/security/cloud_workload/policy/download: + get: + description: >- + The download endpoint generates a Workload Protection policy file from + your currently active + + Workload Protection agent rules, and downloads them as a `.policy` file. + This file can then be deployed to + + your agents to update the policy running in your environment. + + + **Note**: This endpoint should only be used for the Government (US1-FED) + site. + operationId: DownloadCloudWorkloadPolicyFile + responses: + '200': + content: + application/yaml: + schema: + format: binary + type: string + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Download the Workload Protection policy (US1-FED) + tags: + - CSM Threats + x-permission: + operator: OR + permissions: + - security_monitoring_cws_agent_rules_read + /api/v2/security/sboms: + get: + description: >- + Get a list of assets SBOMs for an organization. + + + ### Pagination + + + Please review the [Pagination section] for the "List + Vulnerabilities" endpoint. + + + ### Filtering + + + Please review the [Filtering section] for the "List + Vulnerabilities" endpoint. + + + ### Metadata + + + Please review the [Metadata section] for the "List + Vulnerabilities" endpoint. + operationId: ListAssetsSBOMs + parameters: + - description: >- + Its value must come from the `links` section of the response of the + first request. Do not manually edit it. + example: >- + b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4 + in: query + name: page[token] + required: false + schema: + type: string + - description: >- + The page number to be retrieved. It should be equal to or greater + than 1. + example: 1 + in: query + name: page[number] + required: false + schema: + format: int64 + minimum: 1 + type: integer + - description: The type of the assets for the SBOM request. + example: Repository + in: query + name: filter[asset_type] + required: false + schema: + $ref: '#/components/schemas/AssetType' + - description: The name of the asset for the SBOM request. + example: github.com/datadog/datadog-agent + in: query + name: filter[asset_name] + required: false + schema: + type: string + - description: The name of the component that is a dependency of an asset. + example: opentelemetry-api + in: query + name: filter[package_name] + required: false + schema: + type: string + - description: The version of the component that is a dependency of an asset. + example: 1.33.1 + in: query + name: filter[package_version] + required: false + schema: + type: string + - description: >- + The software license name of the component that is a dependency of + an asset. + example: Apache-2.0 + in: query + name: filter[license_name] + required: false + schema: + type: string + - description: >- + The software license type of the component that is a dependency of + an asset. + example: network_strong_copyleft + in: query + name: filter[license_type] + required: false + schema: + $ref: '#/components/schemas/SBOMComponentLicenseType' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListAssetsSBOMsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: >- + Bad request: The server cannot process the request due to invalid + syntax in the request. + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Forbidden: Access denied' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Not found: asset not found' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: List assets SBOMs + tags: + - Security Monitoring + x-unstable: >- + **Note**: This endpoint is a private preview. + + If you are interested in accessing this API, [fill out this + form](https://forms.gle/kMYC1sDr6WDUBDsx9). + /api/v2/security/sboms/{asset_type}: + get: + description: | + Get a single SBOM related to an asset by its type and name. + operationId: GetSBOM + parameters: + - description: The type of the asset for the SBOM request. + example: Repository + in: path + name: asset_type + required: true + schema: + $ref: '#/components/schemas/AssetType' + - description: The name of the asset for the SBOM request. + example: github.com/datadog/datadog-agent + in: query + name: filter[asset_name] + required: true + schema: + type: string + - description: >- + The container image `repo_digest` for the SBOM request. When the + requested asset type is 'Image', this filter is mandatory. + example: >- + sha256:0ae7da091191787229d321e3638e39c319a97d6e20f927d465b519d699215bf7 + in: query + name: filter[repo_digest] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetSBOMResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: >- + Bad request: The server cannot process the request due to invalid + syntax in the request. + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Forbidden: Access denied' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Not found: asset not found' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Get SBOM + tags: + - Security Monitoring + x-unstable: >- + **Note**: This endpoint is a private preview. + + If you are interested in accessing this API, [fill out this + form](https://forms.gle/kMYC1sDr6WDUBDsx9). + /api/v2/security/signals/notification_rules: + get: + description: Returns the list of notification rules for security signals. + operationId: GetSignalNotificationRules + responses: + '200': + $ref: '#/components/responses/NotificationRulesList' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Get the list of signal-based notification rules + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_read + post: + description: >- + Create a new notification rule for security signals and return the + created rule. + operationId: CreateSignalNotificationRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateNotificationRuleParameters' + description: > + The body of the create notification rule request is composed of the + rule type and the rule attributes: + + the rule name, the selectors, the notification targets, and the rule + enabled status. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/NotificationRuleResponse' + description: Successfully created the notification rule. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Create a new signal-based notification rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_write + /api/v2/security/signals/notification_rules/{id}: + delete: + description: Delete a notification rule for security signals. + operationId: DeleteSignalNotificationRule + parameters: + - description: ID of the notification rule. + in: path + name: id + required: true + schema: + type: string + responses: + '204': + description: Rule successfully deleted. + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Delete a signal-based notification rule + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_write + get: + description: Get the details of a notification rule for security signals. + operationId: GetSignalNotificationRule + parameters: + - description: ID of the notification rule. + in: path + name: id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/NotificationRuleResponse' + description: Notification rule details. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Get details of a signal-based notification rule + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_read + patch: + description: >- + Partially update the notification rule. All fields are optional; if a + field is not provided, it is not updated. + operationId: PatchSignalNotificationRule + parameters: + - description: ID of the notification rule. + in: path + name: id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/PatchNotificationRuleParameters' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/NotificationRuleResponse' + description: Notification rule successfully patched. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '422': + $ref: '#/components/responses/UnprocessableEntityResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Patch a signal-based notification rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_write + /api/v2/security/vulnerabilities: + get: + description: > + Get a list of vulnerabilities. + + + ### Pagination + + + Pagination is enabled by default in both `vulnerabilities` and `assets`. + The size of the page varies depending on the endpoint and cannot be + modified. To automate the request of the next page, you can use the + links section in the response. + + + This endpoint will return paginated responses. The pages are stored in + the links section of the response: + + + ```JSON + + { + "data": [...], + "meta": {...}, + "links": { + "self": "https://.../api/v2/security/vulnerabilities", + "first": "https://.../api/v2/security/vulnerabilities?page[number]=1&page[token]=abc", + "last": "https://.../api/v2/security/vulnerabilities?page[number]=43&page[token]=abc", + "next": "https://.../api/v2/security/vulnerabilities?page[number]=2&page[token]=abc" + } + } + + ``` + + + + - `links.previous` is empty if the first page is requested. + + - `links.next` is empty if the last page is requested. + + + #### Token + + + Vulnerabilities can be created, updated or deleted at any point in time. + + + Upon the first request, a token is created to ensure consistency across + subsequent paginated requests. + + + A token is valid only for 24 hours. + + + #### First request + + + We consider a request to be the first request when there is no + `page[token]` parameter. + + + The response of this first request contains the newly created token in + the `links` section. + + + This token can then be used in the subsequent paginated requests. + + + #### Subsequent requests + + + Any request containing valid `page[token]` and `page[number]` parameters + will be considered a subsequent request. + + + If the `token` is invalid, a `404` response will be returned. + + + If the page `number` is invalid, a `400` response will be returned. + + + ### Filtering + + + The request can include some filter parameters to filter the data to be + retrieved. The format of the filter parameters follows the [JSON:API + format](https://jsonapi.org/format/#fetching-filtering): + `filter[$prop_name]`, where `prop_name` is the property name in the + entity being filtered by. + + + All filters can include multiple values, where data will be filtered + with an OR clause: `filter[title]=Title1,Title2` will filter all + vulnerabilities where title is equal to `Title1` OR `Title2`. + + + String filters are case sensitive. + + + Boolean filters accept `true` or `false` as values. + + + Number filters must include an operator as a second filter input: + `filter[$prop_name][$operator]`. For example, for the vulnerabilities + endpoint: `filter[cvss.base.score][lte]=8`. + + + Available operators are: `eq` (==), `lt` (<), `lte` (<=), `gt` (>) and + `gte` (>=). + + + ### Metadata + + + Following [JSON:API format](https://jsonapi.org/format/#document-meta), + object including non-standard meta-information. + + + This endpoint includes the meta member in the response. For more details + on each of the properties included in this section, check the endpoints + response tables. + + + ```JSON + + { + "data": [...], + "meta": { + "total": 1500, + "count": 18732, + "token": "some_token" + }, + "links": {...} + } + + ``` + operationId: ListVulnerabilities + parameters: + - description: >- + Its value must come from the `links` section of the response of the + first request. Do not manually edit it. + example: >- + b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4 + in: query + name: page[token] + required: false + schema: + type: string + - description: >- + The page number to be retrieved. It should be equal or greater than + `1` + example: 1 + in: query + name: page[number] + required: false + schema: + format: int64 + minimum: 1 + type: integer + - description: Filter by vulnerability type. + example: WeakCipher + in: query + name: filter[type] + required: false + schema: + $ref: '#/components/schemas/VulnerabilityType' + - description: >- + Filter by vulnerability base (i.e. from the original advisory) + severity score. + example: 5.5 + in: query + name: filter[cvss.base.score][`$op`] + required: false + schema: + format: double + maximum: 10 + minimum: 0 + type: number + - description: Filter by vulnerability base severity. + example: Medium + in: query + name: filter[cvss.base.severity] + required: false + schema: + $ref: '#/components/schemas/VulnerabilitySeverity' + - description: Filter by vulnerability base CVSS vector. + example: CVSS:3.0/AV:L/AC:L/PR:L/UI:N/S:U/C:N/I:N/A:H + in: query + name: filter[cvss.base.vector] + required: false + schema: + type: string + - description: Filter by vulnerability Datadog severity score. + example: 4.3 + in: query + name: filter[cvss.datadog.score][`$op`] + required: false + schema: + format: double + maximum: 10 + minimum: 0 + type: number + - description: Filter by vulnerability Datadog severity. + example: Medium + in: query + name: filter[cvss.datadog.severity] + required: false + schema: + $ref: '#/components/schemas/VulnerabilitySeverity' + - description: Filter by vulnerability Datadog CVSS vector. + example: >- + CVSS:3.1/AV:L/AC:L/PR:L/UI:N/S:U/C:N/I:N/A:H/E:U/RL:X/RC:X/CR:X/IR:X/AR:X/MAV:L/MAC:H/MPR:L/MUI:N/MS:U/MC:N/MI:N/MA:H + in: query + name: filter[cvss.datadog.vector] + required: false + schema: + type: string + - description: Filter by the status of the vulnerability. + example: Open + in: query + name: filter[status] + required: false + schema: + $ref: '#/components/schemas/VulnerabilityStatus' + - description: Filter by the tool of the vulnerability. + example: SCA + in: query + name: filter[tool] + required: false + schema: + $ref: '#/components/schemas/VulnerabilityTool' + - description: Filter by library name. + example: linux-aws-5.15 + in: query + name: filter[library.name] + required: false + schema: + type: string + - description: Filter by library version. + example: 5.15.0 + in: query + name: filter[library.version] + required: false + schema: + type: string + - description: Filter by advisory ID. + example: TRIVY-CVE-2023-0615 + in: query + name: filter[advisory_id] + required: false + schema: + type: string + - description: Filter by exploitation probability. + example: false + in: query + name: filter[risks.exploitation_probability] + required: false + schema: + type: boolean + - description: Filter by POC exploit availability. + example: false + in: query + name: filter[risks.poc_exploit_available] + required: false + schema: + type: boolean + - description: Filter by public exploit availability. + example: false + in: query + name: filter[risks.exploit_available] + required: false + schema: + type: boolean + - description: >- + Filter by vulnerability [EPSS](https://www.first.org/epss/) severity + score. + example: 0.00042 + in: query + name: filter[risks.epss.score][`$op`] + required: false + schema: + format: double + maximum: 1 + minimum: 0 + type: number + - description: >- + Filter by vulnerability [EPSS](https://www.first.org/epss/) + severity. + example: Low + in: query + name: filter[risks.epss.severity] + required: false + schema: + $ref: '#/components/schemas/VulnerabilitySeverity' + - description: Filter by language. + example: ubuntu + in: query + name: filter[language] + required: false + schema: + type: string + - description: Filter by ecosystem. + example: Deb + in: query + name: filter[ecosystem] + required: false + schema: + $ref: '#/components/schemas/VulnerabilityEcosystem' + - description: Filter by vulnerability location. + example: com.example.Class:100 + in: query + name: filter[code_location.location] + required: false + schema: + type: string + - description: Filter by vulnerability file path. + example: src/Class.java:100 + in: query + name: filter[code_location.file_path] + required: false + schema: + type: string + - description: Filter by method. + example: FooBar + in: query + name: filter[code_location.method] + required: false + schema: + type: string + - description: Filter by fix availability. + example: false + in: query + name: filter[fix_available] + required: false + schema: + type: boolean + - description: >- + Filter by vulnerability `repo_digest` (when the vulnerability is + related to `Image` asset). + example: >- + sha256:0ae7da091191787229d321e3638e39c319a97d6e20f927d465b519d699215bf7 + in: query + name: filter[repo_digests] + required: false + schema: + type: string + - description: Filter by origin. + example: agentless-scanner + in: query + name: filter[origin] + required: false + schema: + type: string + - description: Filter by asset name. + example: datadog-agent + in: query + name: filter[asset.name] + required: false + schema: + type: string + - description: Filter by asset type. + example: Host + in: query + name: filter[asset.type] + required: false + schema: + $ref: '#/components/schemas/AssetType' + - description: >- + Filter by the first version of the asset this vulnerability has been + detected on. + example: v1.15.1 + in: query + name: filter[asset.version.first] + required: false + schema: + type: string + - description: >- + Filter by the last version of the asset this vulnerability has been + detected on. + example: v1.15.1 + in: query + name: filter[asset.version.last] + required: false + schema: + type: string + - description: Filter by the repository url associated to the asset. + example: github.com/DataDog/datadog-agent.git + in: query + name: filter[asset.repository_url] + required: false + schema: + type: string + - description: Filter whether the asset is in production or not. + example: false + in: query + name: filter[asset.risks.in_production] + required: false + schema: + type: boolean + - description: Filter whether the asset is under attack or not. + example: false + in: query + name: filter[asset.risks.under_attack] + required: false + schema: + type: boolean + - description: Filter whether the asset is publicly accessible or not. + example: false + in: query + name: filter[asset.risks.is_publicly_accessible] + required: false + schema: + type: boolean + - description: Filter whether the asset is publicly accessible or not. + example: false + in: query + name: filter[asset.risks.has_privileged_access] + required: false + schema: + type: boolean + - description: Filter whether the asset has access to sensitive data or not. + example: false + in: query + name: filter[asset.risks.has_access_to_sensitive_data] + required: false + schema: + type: boolean + - description: Filter by asset environments. + example: staging + in: query + name: filter[asset.environments] + required: false + schema: + type: string + - description: Filter by asset teams. + example: compute + in: query + name: filter[asset.teams] + required: false + schema: + type: string + - description: Filter by asset architecture. + example: arm64 + in: query + name: filter[asset.arch] + required: false + schema: + type: string + - description: Filter by asset operating system name. + example: ubuntu + in: query + name: filter[asset.operating_system.name] + required: false + schema: + type: string + - description: Filter by asset operating system version. + example: '24.04' + in: query + name: filter[asset.operating_system.version] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListVulnerabilitiesResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: >- + Bad request: The server cannot process the request due to invalid + syntax in the request. + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Forbidden: Access denied' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Not found: There is no request associated with the provided token.' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: List vulnerabilities + tags: + - Security Monitoring + x-unstable: >- + **Note**: This endpoint is a private preview. + + If you are interested in accessing this API, [fill out this + form](https://forms.gle/kMYC1sDr6WDUBDsx9). + /api/v2/security/vulnerabilities/notification_rules: + get: + description: Returns the list of notification rules for security vulnerabilities. + operationId: GetVulnerabilityNotificationRules + responses: + '200': + $ref: '#/components/responses/NotificationRulesList' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Get the list of vulnerability notification rules + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_read + post: + description: >- + Create a new notification rule for security vulnerabilities and return + the created rule. + operationId: CreateVulnerabilityNotificationRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateNotificationRuleParameters' + description: > + The body of the create notification rule request is composed of the + rule type and the rule attributes: + + the rule name, the selectors, the notification targets, and the rule + enabled status. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/NotificationRuleResponse' + description: Successfully created the notification rule. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Create a new vulnerability-based notification rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_write + /api/v2/security/vulnerabilities/notification_rules/{id}: + delete: + description: Delete a notification rule for security vulnerabilities. + operationId: DeleteVulnerabilityNotificationRule + parameters: + - description: ID of the notification rule. + in: path + name: id + required: true + schema: + type: string + responses: + '204': + description: Rule successfully deleted. + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Delete a vulnerability-based notification rule + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_write + get: + description: Get the details of a notification rule for security vulnerabilities. + operationId: GetVulnerabilityNotificationRule + parameters: + - description: ID of the notification rule. + in: path + name: id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/NotificationRuleResponse' + description: Notification rule details. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Get details of a vulnerability notification rule + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_read + patch: + description: >- + Partially update the notification rule. All fields are optional; if a + field is not provided, it is not updated. + operationId: PatchVulnerabilityNotificationRule + parameters: + - description: ID of the notification rule. + in: path + name: id + required: true + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/PatchNotificationRuleParameters' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/NotificationRuleResponse' + description: Notification rule successfully patched. + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '422': + $ref: '#/components/responses/UnprocessableEntityResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Patch a vulnerability-based notification rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_notification_profiles_write + /api/v2/security_monitoring/cloud_workload_security/agent_rules: + get: + description: >- + Get the list of agent rules. + + + **Note**: This endpoint should only be used for the Government (US1-FED) + site. + operationId: ListCloudWorkloadSecurityAgentRules + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/CloudWorkloadSecurityAgentRulesListResponse + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get all Workload Protection agent rules (US1-FED) + tags: + - CSM Threats + x-permission: + operator: OR + permissions: + - security_monitoring_cws_agent_rules_read + post: + description: >- + Create a new agent rule with the given parameters. + + + **Note**: This endpoint should only be used for the Government (US1-FED) + site. + operationId: CreateCloudWorkloadSecurityAgentRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateRequest' + description: The definition of the new agent rule + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create a Workload Protection agent rule (US1-FED) + tags: + - CSM Threats + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_cws_agent_rules_write + /api/v2/security_monitoring/cloud_workload_security/agent_rules/{agent_rule_id}: + delete: + description: >- + Delete a specific agent rule. + + + **Note**: This endpoint should only be used for the Government (US1-FED) + site. + operationId: DeleteCloudWorkloadSecurityAgentRule + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' + responses: + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete a Workload Protection agent rule (US1-FED) + tags: + - CSM Threats + x-permission: + operator: OR + permissions: + - security_monitoring_cws_agent_rules_write + get: + description: >- + Get the details of a specific agent rule. + + + **Note**: This endpoint should only be used for the Government (US1-FED) + site. + operationId: GetCloudWorkloadSecurityAgentRule + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a Workload Protection agent rule (US1-FED) + tags: + - CSM Threats + x-permission: + operator: OR + permissions: + - security_monitoring_cws_agent_rules_read + patch: + description: >- + Update a specific agent rule. + + Returns the agent rule object when the request is successful. + + + **Note**: This endpoint should only be used for the Government (US1-FED) + site. + operationId: UpdateCloudWorkloadSecurityAgentRule + parameters: + - $ref: '#/components/parameters/CloudWorkloadSecurityAgentRuleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateRequest' + description: New definition of the agent rule + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update a Workload Protection agent rule (US1-FED) + tags: + - CSM Threats + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_cws_agent_rules_write + /api/v2/security_monitoring/configuration/security_filters: + get: + description: Get the list of configured security filters with their definitions. + operationId: ListSecurityFilters + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityFiltersResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_filters_read + summary: Get all security filters + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_filters_read + post: + description: >- + Create a security filter. + + + See the [security filter + guide](https://docs.datadoghq.com/security_platform/guide/how-to-setup-security-filters-using-security-monitoring-api/) + + for more examples. + operationId: CreateSecurityFilter + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityFilterCreateRequest' + description: The definition of the new security filter. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityFilterResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_filters_write + summary: Create a security filter + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_filters_write + /api/v2/security_monitoring/configuration/security_filters/{security_filter_id}: + delete: + description: Delete a specific security filter. + operationId: DeleteSecurityFilter + parameters: + - $ref: '#/components/parameters/SecurityFilterID' + responses: + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_filters_write + summary: Delete a security filter + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_filters_write + get: + description: >- + Get the details of a specific security filter. + + + See the [security filter + guide](https://docs.datadoghq.com/security_platform/guide/how-to-setup-security-filters-using-security-monitoring-api/) + + for more examples. + operationId: GetSecurityFilter + parameters: + - $ref: '#/components/parameters/SecurityFilterID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityFilterResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_filters_read + summary: Get a security filter + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_filters_read + patch: + description: |- + Update a specific security filter. + Returns the security filter object when the request is successful. + operationId: UpdateSecurityFilter + parameters: + - $ref: '#/components/parameters/SecurityFilterID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityFilterUpdateRequest' + description: New definition of the security filter. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityFilterResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_filters_write + summary: Update a security filter + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_filters_write + /api/v2/security_monitoring/configuration/suppressions: + get: + description: Get the list of all suppression rules. + operationId: ListSecurityMonitoringSuppressions + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionsResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_suppressions_read + summary: Get all suppression rules + tags: + - Security Monitoring + post: + description: Create a new suppression rule. + operationId: CreateSecurityMonitoringSuppression + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionCreateRequest' + description: The definition of the new suppression rule. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_suppressions_write + summary: Create a suppression rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + /api/v2/security_monitoring/configuration/suppressions/rules: + post: + description: Get the list of suppressions that would affect a rule. + operationId: GetSuppressionsAffectingFutureRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleCreatePayload' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_suppressions_read + summary: Get suppressions affecting future rule + tags: + - Security Monitoring + /api/v2/security_monitoring/configuration/suppressions/rules/{rule_id}: + get: + description: >- + Get the list of suppressions that affect a specific existing rule by its + ID. + operationId: GetSuppressionsAffectingRule + parameters: + - $ref: '#/components/parameters/SecurityMonitoringRuleID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionsResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_suppressions_read + summary: Get suppressions affecting a specific rule + tags: + - Security Monitoring + /api/v2/security_monitoring/configuration/suppressions/validation: + post: + description: Validate a suppression rule. + operationId: ValidateSecurityMonitoringSuppression + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionCreateRequest' + required: true + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_suppressions_write + summary: Validate a suppression rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_suppressions_write + /api/v2/security_monitoring/configuration/suppressions/{suppression_id}: + delete: + description: Delete a specific suppression rule. + operationId: DeleteSecurityMonitoringSuppression + parameters: + - $ref: '#/components/parameters/SecurityMonitoringSuppressionID' + responses: + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_suppressions_write + summary: Delete a suppression rule + tags: + - Security Monitoring + get: + description: Get the details of a specific suppression rule. + operationId: GetSecurityMonitoringSuppression + parameters: + - $ref: '#/components/parameters/SecurityMonitoringSuppressionID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionResponse' + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_suppressions_read + summary: Get a suppression rule + tags: + - Security Monitoring + patch: + description: Update a specific suppression rule. + operationId: UpdateSecurityMonitoringSuppression + parameters: + - $ref: '#/components/parameters/SecurityMonitoringSuppressionID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionUpdateRequest' + description: New definition of the suppression rule. Supports partial updates. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSuppressionResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConcurrentModificationResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_suppressions_write + summary: Update a suppression rule + tags: + - Security Monitoring + /api/v2/security_monitoring/rules: + get: + description: List rules. + operationId: ListSecurityMonitoringRules + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringListRulesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_read + summary: List rules + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_rules_read + post: + description: Create a detection rule. + operationId: CreateSecurityMonitoringRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleCreatePayload' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Create a detection rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + /api/v2/security_monitoring/rules/convert: + post: + description: >- + Convert a rule that doesn't (yet) exist from JSON to Terraform for + datadog provider + + resource datadog_security_monitoring_rule. + operationId: ConvertSecurityMonitoringRuleFromJSONToTerraform + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleConvertPayload' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleConvertResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/ConcurrentModificationResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Convert a rule from JSON to Terraform + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + /api/v2/security_monitoring/rules/test: + post: + description: Test a rule. + operationId: TestSecurityMonitoringRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleTestRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleTestResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/ConcurrentModificationResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Test a rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + /api/v2/security_monitoring/rules/validation: + post: + description: Validate a detection rule. + operationId: ValidateSecurityMonitoringRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleValidatePayload' + required: true + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Validate a detection rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + /api/v2/security_monitoring/rules/{rule_id}: + delete: + description: Delete an existing rule. Default rules cannot be deleted. + operationId: DeleteSecurityMonitoringRule + parameters: + - $ref: '#/components/parameters/SecurityMonitoringRuleID' + responses: + '204': + description: OK + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Delete an existing rule + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + get: + description: Get a rule's details. + operationId: GetSecurityMonitoringRule + parameters: + - $ref: '#/components/parameters/SecurityMonitoringRuleID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleResponse' + description: OK + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_read + summary: Get a rule's details + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_rules_read + put: + description: >- + Update an existing rule. When updating `cases`, `queries` or `options`, + the whole field + + must be included. For example, when modifying a query all queries must + be included. + + Default rules can only be updated to be enabled, to change + notifications, or to update + + the tags (default tags cannot be removed). + operationId: UpdateSecurityMonitoringRule + parameters: + - $ref: '#/components/parameters/SecurityMonitoringRuleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleUpdatePayload' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/ConcurrentModificationResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Update an existing rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + /api/v2/security_monitoring/rules/{rule_id}/convert: + get: + description: |- + Convert an existing rule from JSON to Terraform for datadog provider + resource datadog_security_monitoring_rule. + operationId: ConvertExistingSecurityMonitoringRule + parameters: + - $ref: '#/components/parameters/SecurityMonitoringRuleID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleConvertResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_read + summary: Convert an existing rule from JSON to Terraform + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_rules_read + /api/v2/security_monitoring/rules/{rule_id}/test: + post: + description: Test an existing rule. + operationId: TestExistingSecurityMonitoringRule + parameters: + - $ref: '#/components/parameters/SecurityMonitoringRuleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleTestRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringRuleTestResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/ConcurrentModificationResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Test an existing rule + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + /api/v2/security_monitoring/rules/{rule_id}/version_history: + get: + description: Get a rule's version history. + operationId: GetRuleVersionHistory + parameters: + - $ref: '#/components/parameters/SecurityMonitoringRuleID' + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetRuleVersionHistoryResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a rule's version history + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_rules_read + x-unstable: '**Note**: This endpoint is in beta and may be subject to changes.' + /api/v2/security_monitoring/signals: + get: + description: >- + The list endpoint returns security signals that match a search query. + + Both this endpoint and the POST endpoint can be used interchangeably + when listing + + security signals. + operationId: ListSecurityMonitoringSignals + parameters: + - $ref: '#/components/parameters/QueryFilterSearch' + - $ref: '#/components/parameters/QueryFilterFrom' + - $ref: '#/components/parameters/QueryFilterTo' + - $ref: '#/components/parameters/QuerySort' + - $ref: '#/components/parameters/QueryPageCursor' + - $ref: '#/components/parameters/QueryPageLimit' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_signals_read + summary: Get a quick list of security signals + tags: + - Security Monitoring + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + x-permission: + operator: OR + permissions: + - security_monitoring_signals_read + /api/v2/security_monitoring/signals/search: + post: + description: >- + Returns security signals that match a search query. + + Both this endpoint and the GET endpoint can be used interchangeably for + listing + + security signals. + operationId: SearchSecurityMonitoringSignals + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalListRequest' + required: false + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_signals_read + summary: Get a list of security signals + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-pagination: + cursorParam: body.page.cursor + cursorPath: meta.page.after + limitParam: body.page.limit + resultsPath: data + x-permission: + operator: OR + permissions: + - security_monitoring_signals_read + /api/v2/security_monitoring/signals/{signal_id}: + get: + description: Get a signal's details. + operationId: GetSecurityMonitoringSignal + parameters: + - $ref: '#/components/parameters/SignalID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalResponse' + description: OK + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_signals_read + summary: Get a signal's details + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_signals_read + /api/v2/security_monitoring/signals/{signal_id}/assignee: + patch: + description: Modify the triage assignee of a security signal. + operationId: EditSecurityMonitoringSignalAssignee + parameters: + - $ref: '#/components/parameters/SignalID' + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/SecurityMonitoringSignalAssigneeUpdateRequest + description: Attributes describing the signal update. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/SecurityMonitoringSignalTriageUpdateResponse + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Modify the triage assignee of a security signal + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_signals_write + /api/v2/security_monitoring/signals/{signal_id}/incidents: + patch: + description: Change the related incidents for a security signal. + operationId: EditSecurityMonitoringSignalIncidents + parameters: + - $ref: '#/components/parameters/SignalID' + requestBody: + content: + application/json: + schema: + $ref: >- + #/components/schemas/SecurityMonitoringSignalIncidentsUpdateRequest + description: Attributes describing the signal update. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/SecurityMonitoringSignalTriageUpdateResponse + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Change the related incidents of a security signal + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_signals_write + /api/v2/security_monitoring/signals/{signal_id}/state: + patch: + description: Change the triage state of a security signal. + operationId: EditSecurityMonitoringSignalState + parameters: + - $ref: '#/components/parameters/SignalID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateRequest' + description: Attributes describing the signal update. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/SecurityMonitoringSignalTriageUpdateResponse + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Change the triage state of a security signal + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_signals_write + /api/v2/sensitive-data-scanner/config: + get: + description: List all the Scanning groups in your organization. + operationId: ListScanningGroups + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerGetConfigResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List Scanning Groups + tags: + - Sensitive Data Scanner + x-permission: + operator: OR + permissions: + - data_scanner_read + patch: + description: Reorder the list of groups. + operationId: ReorderScanningGroups + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerConfigRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerReorderGroupsResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Reorder Groups + tags: + - Sensitive Data Scanner + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - data_scanner_write + /api/v2/sensitive-data-scanner/config/groups: + post: + description: >- + Create a scanning group. + + The request MAY include a configuration relationship. + + A rules relationship can be omitted entirely, but if it is included it + MUST be + + null or an empty array (rules cannot be created at the same time). + + The new group will be ordered last within the configuration. + operationId: CreateScanningGroup + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerGroupCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerCreateGroupResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create Scanning Group + tags: + - Sensitive Data Scanner + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - data_scanner_write + /api/v2/sensitive-data-scanner/config/groups/{group_id}: + delete: + description: Delete a given group. + operationId: DeleteScanningGroup + parameters: + - $ref: '#/components/parameters/SensitiveDataScannerGroupID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerGroupDeleteRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerGroupDeleteResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Scanning Group + tags: + - Sensitive Data Scanner + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - data_scanner_write + patch: + description: >- + Update a group, including the order of the rules. + + Rules within the group are reordered by including a rules relationship. + If the rules + + relationship is present, its data section MUST contain linkages for all + of the rules + + currently in the group, and MUST NOT contain any others. + operationId: UpdateScanningGroup + parameters: + - $ref: '#/components/parameters/SensitiveDataScannerGroupID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerGroupUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerGroupUpdateResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update Scanning Group + tags: + - Sensitive Data Scanner + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - data_scanner_write + /api/v2/sensitive-data-scanner/config/rules: + post: + description: >- + Create a scanning rule in a sensitive data scanner group, ordered last. + + The posted rule MUST include a group relationship. + + It MUST include either a standard_pattern relationship or a regex + attribute, but not both. + + If included_attributes is empty or missing, we will scan all attributes + except + + excluded_attributes. If both are missing, we will scan the whole event. + operationId: CreateScanningRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerRuleCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerCreateRuleResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create Scanning Rule + tags: + - Sensitive Data Scanner + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - data_scanner_write + /api/v2/sensitive-data-scanner/config/rules/{rule_id}: + delete: + description: Delete a given rule. + operationId: DeleteScanningRule + parameters: + - $ref: '#/components/parameters/SensitiveDataScannerRuleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerRuleDeleteRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerRuleDeleteResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Delete Scanning Rule + tags: + - Sensitive Data Scanner + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - data_scanner_write + patch: + description: >- + Update a scanning rule. + + The request body MUST NOT include a standard_pattern relationship, as + that relationship + + is non-editable. Trying to edit the regex attribute of a rule with a + standard_pattern + + relationship will also result in an error. + operationId: UpdateScanningRule + parameters: + - $ref: '#/components/parameters/SensitiveDataScannerRuleID' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerRuleUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SensitiveDataScannerRuleUpdateResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Update Scanning Rule + tags: + - Sensitive Data Scanner + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - data_scanner_write + /api/v2/sensitive-data-scanner/config/standard-patterns: + get: + description: Returns all standard patterns. + operationId: ListStandardPatterns + responses: + '200': + content: + application/json: + schema: + $ref: >- + #/components/schemas/SensitiveDataScannerStandardPatternsResponseData + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Authentication Error + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: List standard patterns + tags: + - Sensitive Data Scanner + x-permission: + operator: OR + permissions: + - data_scanner_read + /api/v2/siem-historical-detections/histsignals: + get: + description: List hist signals. + operationId: ListSecurityMonitoringHistsignals + parameters: + - $ref: '#/components/parameters/QueryFilterSearch' + - $ref: '#/components/parameters/QueryFilterFrom' + - $ref: '#/components/parameters/QueryFilterTo' + - $ref: '#/components/parameters/QuerySort' + - $ref: '#/components/parameters/QueryPageCursor' + - $ref: '#/components/parameters/QueryPageLimit' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_signals_read + summary: List hist signals + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_signals_read + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + /api/v2/siem-historical-detections/histsignals/search: + get: + description: Search hist signals. + operationId: SearchSecurityMonitoringHistsignals + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalListRequest' + required: false + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_signals_read + summary: Search hist signals + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_signals_read + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + /api/v2/siem-historical-detections/histsignals/{histsignal_id}: + get: + description: Get a hist signal's details. + operationId: GetSecurityMonitoringHistsignal + parameters: + - $ref: '#/components/parameters/HistoricalSignalID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_signals_read + summary: Get a hist signal's details + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_signals_read + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + /api/v2/siem-historical-detections/jobs: + get: + description: List historical jobs. + operationId: ListHistoricalJobs + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - description: The order of the jobs in results. + example: status + in: query + name: sort + required: false + schema: + type: string + - description: Query used to filter items from the fetched list. + example: security:attack status:high + in: query + name: filter[query] + required: false + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListHistoricalJobsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: List historical jobs + tags: + - Security Monitoring + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + post: + description: Run a historical job. + operationId: RunHistoricalJob + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/RunHistoricalJobRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/JobCreateResponse' + description: Status created + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/ConcurrentModificationResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Run a historical job + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + /api/v2/siem-historical-detections/jobs/signal_convert: + post: + description: Convert a job result to a signal. + operationId: ConvertJobResultToSignal + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ConvertJobResultsToSignalsRequest' + required: true + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/ConcurrentModificationResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Convert a job result to a signal + tags: + - Security Monitoring + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - security_monitoring_signals_write + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + /api/v2/siem-historical-detections/jobs/{job_id}: + delete: + description: Delete an existing job. + operationId: DeleteHistoricalJob + parameters: + - $ref: '#/components/parameters/HistoricalJobID' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/ConcurrentModificationResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Delete an existing job + tags: + - Security Monitoring + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + get: + description: Get a job's details. + operationId: GetHistoricalJob + parameters: + - $ref: '#/components/parameters/HistoricalJobID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/HistoricalJobResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_read + summary: Get a job's details + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_rules_read + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + /api/v2/siem-historical-detections/jobs/{job_id}/cancel: + patch: + description: Cancel a historical job. + operationId: CancelHistoricalJob + parameters: + - $ref: '#/components/parameters/HistoricalJobID' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/ConcurrentModificationResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_rules_write + summary: Cancel a historical job + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_rules_write + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. + /api/v2/siem-historical-detections/jobs/{job_id}/histsignals: + get: + description: Get a job's hist signals. + operationId: GetSecurityMonitoringHistsignalsByJobId + parameters: + - $ref: '#/components/parameters/HistoricalJobID' + - $ref: '#/components/parameters/QueryFilterSearch' + - $ref: '#/components/parameters/QueryFilterFrom' + - $ref: '#/components/parameters/QueryFilterTo' + - $ref: '#/components/parameters/QuerySort' + - $ref: '#/components/parameters/QueryPageCursor' + - $ref: '#/components/parameters/QueryPageLimit' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - security_monitoring_signals_read + summary: Get a job's hist signals + tags: + - Security Monitoring + x-permission: + operator: OR + permissions: + - security_monitoring_signals_read + x-unstable: |- + **Note**: This endpoint is in beta and may be subject to changes. + Please check the documentation regularly for updates. +components: + schemas: + AwsScanOptionsListResponse: + description: Response object that includes a list of AWS scan options. + properties: + data: + description: A list of AWS scan options. + items: + $ref: '#/components/schemas/AwsScanOptionsData' + type: array + type: object + AwsScanOptionsCreateRequest: + description: Request object that includes the scan options to create. + properties: + data: + $ref: '#/components/schemas/AwsScanOptionsCreateData' + required: + - data + type: object + AwsScanOptionsResponse: + description: Response object that includes the scan options of an AWS account. + properties: + data: + $ref: '#/components/schemas/AwsScanOptionsData' + type: object + AwsScanOptionsUpdateRequest: + description: Request object that includes the scan options to update. + properties: + data: + $ref: '#/components/schemas/AwsScanOptionsUpdateData' + required: + - data + type: object + AwsOnDemandListResponse: + description: Response object that includes a list of AWS on demand tasks. + properties: + data: + description: A list of on demand tasks. + items: + $ref: '#/components/schemas/AwsOnDemandData' + type: array + type: object + AwsOnDemandCreateRequest: + description: Request object that includes the on demand task to submit. + properties: + data: + $ref: '#/components/schemas/AwsOnDemandCreateData' + required: + - data + type: object + AwsOnDemandResponse: + description: Response object that includes an AWS on demand task. + properties: + data: + $ref: '#/components/schemas/AwsOnDemandData' + type: object + CreateCustomFrameworkRequest: + description: Request object to create a custom framework. + properties: + data: + $ref: '#/components/schemas/CustomFrameworkData' + required: + - data + type: object + CreateCustomFrameworkResponse: + description: Response object to create a custom framework. + properties: + data: + $ref: '#/components/schemas/FrameworkHandleAndVersionResponseData' + required: + - data + type: object + DeleteCustomFrameworkResponse: + description: Response object to delete a custom framework. + properties: + data: + $ref: '#/components/schemas/CustomFrameworkMetadata' + required: + - data + type: object + GetCustomFrameworkResponse: + description: Response object to get a custom framework. + properties: + data: + $ref: '#/components/schemas/FullCustomFrameworkData' + required: + - data + type: object + UpdateCustomFrameworkRequest: + description: Request object to update a custom framework. + properties: + data: + $ref: '#/components/schemas/CustomFrameworkData' + required: + - data + type: object + UpdateCustomFrameworkResponse: + description: Response object to update a custom framework. + properties: + data: + $ref: '#/components/schemas/FrameworkHandleAndVersionResponseData' + required: + - data + type: object + GetResourceEvaluationFiltersResponse: + description: The definition of `GetResourceEvaluationFiltersResponse` object. + properties: + data: + $ref: '#/components/schemas/GetResourceEvaluationFiltersResponseData' + required: + - data + type: object + UpdateResourceEvaluationFiltersRequest: + description: Request object to update a resource filter. + properties: + data: + $ref: '#/components/schemas/UpdateResourceEvaluationFiltersRequestData' + required: + - data + type: object + UpdateResourceEvaluationFiltersResponse: + description: The definition of `UpdateResourceEvaluationFiltersResponse` object. + properties: + data: + $ref: '#/components/schemas/UpdateResourceEvaluationFiltersResponseData' + required: + - data + type: object + OrderDirection: + description: The sort direction for results. + enum: + - asc + - desc + example: asc + type: string + x-enum-varnames: + - ASC + - DESC + CsmAgentsResponse: + description: Response object that includes a list of CSM Agents. + properties: + data: + description: A list of Agents. + items: + $ref: '#/components/schemas/CsmAgentData' + type: array + meta: + $ref: '#/components/schemas/CSMAgentsMetadata' + type: object + CsmCloudAccountsCoverageAnalysisResponse: + description: CSM Cloud Accounts Coverage Analysis response. + properties: + data: + $ref: '#/components/schemas/CsmCloudAccountsCoverageAnalysisData' + type: object + CsmHostsAndContainersCoverageAnalysisResponse: + description: CSM Hosts and Containers Coverage Analysis response. + properties: + data: + $ref: '#/components/schemas/CsmHostsAndContainersCoverageAnalysisData' + type: object + CsmServerlessCoverageAnalysisResponse: + description: CSM Serverless Resources Coverage Analysis response. + properties: + data: + $ref: '#/components/schemas/CsmServerlessCoverageAnalysisData' + type: object + FindingEvaluation: + description: The evaluation of the finding. + enum: + - pass + - fail + example: pass + type: string + x-enum-varnames: + - PASS + - FAIL + FindingStatus: + description: The status of the finding. + enum: + - critical + - high + - medium + - low + - info + example: critical + type: string + x-enum-varnames: + - CRITICAL + - HIGH + - MEDIUM + - LOW + - INFO + FindingVulnerabilityType: + description: The vulnerability type of the finding. + enum: + - misconfiguration + - attack_path + - identity_risk + - api_security + example: misconfiguration + type: string + x-enum-varnames: + - MISCONFIGURATION + - ATTACK_PATH + - IDENTITY_RISK + - API_SECURITY + ListFindingsResponse: + description: The expected response schema when listing findings. + properties: + data: + $ref: '#/components/schemas/ListFindingsData' + meta: + $ref: '#/components/schemas/ListFindingsMeta' + required: + - data + - meta + type: object + BulkMuteFindingsRequest: + description: The new bulk mute finding request. + properties: + data: + $ref: '#/components/schemas/BulkMuteFindingsRequestData' + required: + - data + type: object + BulkMuteFindingsResponse: + description: The expected response schema. + properties: + data: + $ref: '#/components/schemas/BulkMuteFindingsResponseData' + required: + - data + type: object + JSONAPIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + items: + $ref: '#/components/schemas/JSONAPIErrorItem' + type: array + required: + - errors + type: object + GetFindingResponse: + description: The expected response schema when getting a finding. + properties: + data: + $ref: '#/components/schemas/DetailedFinding' + required: + - data + type: object + AssetType: + description: The asset type + enum: + - Repository + - Service + - Host + - HostImage + - Image + example: Repository + type: string + x-enum-varnames: + - REPOSITORY + - SERVICE + - HOST + - HOSTIMAGE + - IMAGE + ListVulnerableAssetsResponse: + description: The expected response schema when listing vulnerable assets. + properties: + data: + description: List of vulnerable assets. + items: + $ref: '#/components/schemas/Asset' + type: array + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Metadata' + required: + - data + type: object + SBOMComponentLicenseType: + description: The SBOM component license type. + enum: + - network_strong_copyleft + - non_standard_copyleft + - other_non_free + - other_non_standard + - permissive + - public_domain + - strong_copyleft + - weak_copyleft + example: application + type: string + x-enum-varnames: + - NETWORK_STRONG_COPYLEFT + - NON_STANDARD_COPYLEFT + - OTHER_NON_FREE + - OTHER_NON_STANDARD + - PERMISSIVE + - PUBLIC_DOMAIN + - STRONG_COPYLEFT + - WEAK_COPYLEFT + ListAssetsSBOMsResponse: + description: The expected response schema when listing assets SBOMs. + properties: + data: + description: List of assets SBOMs. + items: + $ref: '#/components/schemas/SBOM' + type: array + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Metadata' + required: + - data + type: object + GetSBOMResponse: + description: The expected response schema when getting an SBOM. + properties: + data: + $ref: '#/components/schemas/SBOM' + required: + - data + type: object + CreateNotificationRuleParameters: + description: Body of the notification rule create request. + properties: + data: + $ref: '#/components/schemas/CreateNotificationRuleParametersData' + type: object + NotificationRuleResponse: + description: Response object which includes a notification rule. + properties: + data: + $ref: '#/components/schemas/NotificationRule' + type: object + PatchNotificationRuleParameters: + description: Body of the notification rule patch request. + properties: + data: + $ref: '#/components/schemas/PatchNotificationRuleParametersData' + type: object + VulnerabilityType: + description: The vulnerability type. + enum: + - AdminConsoleActive + - CodeInjection + - CommandInjection + - ComponentWithKnownVulnerability + - DangerousWorkflows + - DefaultAppDeployed + - DefaultHtmlEscapeInvalid + - DirectoryListingLeak + - EmailHtmlInjection + - EndOfLife + - HardcodedPassword + - HardcodedSecret + - HeaderInjection + - HstsHeaderMissing + - InsecureAuthProtocol + - InsecureCookie + - InsecureJspLayout + - LdapInjection + - MaliciousPackage + - MandatoryRemediation + - NoHttpOnlyCookie + - NoSameSiteCookie + - NoSqlMongoDbInjection + - PathTraversal + - ReflectionInjection + - RiskyLicense + - SessionRewriting + - SessionTimeout + - SqlInjection + - Ssrf + - StackTraceLeak + - TrustBoundaryViolation + - Unmaintained + - UntrustedDeserialization + - UnvalidatedRedirect + - VerbTampering + - WeakCipher + - WeakHash + - WeakRandomness + - XContentTypeHeaderMissing + - XPathInjection + - Xss + example: WeakCipher + type: string + x-enum-varnames: + - ADMIN_CONSOLE_ACTIVE + - CODE_INJECTION + - COMMAND_INJECTION + - COMPONENT_WITH_KNOWN_VULNERABILITY + - DANGEROUS_WORKFLOWS + - DEFAULT_APP_DEPLOYED + - DEFAULT_HTML_ESCAPE_INVALID + - DIRECTORY_LISTING_LEAK + - EMAIL_HTML_INJECTION + - END_OF_LIFE + - HARDCODED_PASSWORD + - HARDCODED_SECRET + - HEADER_INJECTION + - HSTS_HEADER_MISSING + - INSECURE_AUTH_PROTOCOL + - INSECURE_COOKIE + - INSECURE_JSP_LAYOUT + - LDAP_INJECTION + - MALICIOUS_PACKAGE + - MANDATORY_REMEDIATION + - NO_HTTP_ONLY_COOKIE + - NO_SAME_SITE_COOKIE + - NO_SQL_MONGO_DB_INJECTION + - PATH_TRAVERSAL + - REFLECTION_INJECTION + - RISKY_LICENSE + - SESSION_REWRITING + - SESSION_TIMEOUT + - SQL_INJECTION + - SSRF + - STACK_TRACE_LEAK + - TRUST_BOUNDARY_VIOLATION + - UNMAINTAINED + - UNTRUSTED_DESERIALIZATION + - UNVALIDATED_REDIRECT + - VERB_TAMPERING + - WEAK_CIPHER + - WEAK_HASH + - WEAK_RANDOMNESS + - X_CONTENT_TYPE_HEADER_MISSING + - X_PATH_INJECTION + - XSS + VulnerabilitySeverity: + description: The vulnerability severity. + enum: + - Unknown + - None + - Low + - Medium + - High + - Critical + example: Medium + type: string + x-enum-varnames: + - UNKNOWN + - NONE + - LOW + - MEDIUM + - HIGH + - CRITICAL + VulnerabilityStatus: + description: The vulnerability status. + enum: + - Open + - Muted + - Remediated + - InProgress + - AutoClosed + example: Open + type: string + x-enum-varnames: + - OPEN + - MUTED + - REMEDIATED + - INPROGRESS + - AUTOCLOSED + VulnerabilityTool: + description: The vulnerability tool. + enum: + - IAST + - SCA + - Infra + example: SCA + type: string + x-enum-varnames: + - IAST + - SCA + - INFRA + VulnerabilityEcosystem: + description: The related vulnerability asset ecosystem. + enum: + - PyPI + - Maven + - NuGet + - Npm + - RubyGems + - Go + - Packagist + - Ddeb + - Rpm + - Apk + - Windows + type: string + x-enum-varnames: + - PYPI + - MAVEN + - NUGET + - NPM + - RUBY_GEMS + - GO + - PACKAGIST + - D_DEB + - RPM + - APK + - WINDOWS + ListVulnerabilitiesResponse: + description: The expected response schema when listing vulnerabilities. + properties: + data: + description: List of vulnerabilities. + items: + $ref: '#/components/schemas/Vulnerability' + type: array + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Metadata' + required: + - data + type: object + CloudWorkloadSecurityAgentRulesListResponse: + description: Response object that includes a list of Agent rule + properties: + data: + description: A list of Agent rules objects + items: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleData' + type: array + type: object + CloudWorkloadSecurityAgentRuleCreateRequest: + description: Request object that includes the Agent rule to create + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateData' + required: + - data + type: object + CloudWorkloadSecurityAgentRuleResponse: + description: Response object that includes an Agent rule + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleData' + type: object + CloudWorkloadSecurityAgentRuleUpdateRequest: + description: >- + Request object that includes the Agent rule with the attributes to + update + properties: + data: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateData' + required: + - data + type: object + SecurityFiltersResponse: + description: All the available security filters objects. + properties: + data: + description: A list of security filters objects. + items: + $ref: '#/components/schemas/SecurityFilter' + type: array + meta: + $ref: '#/components/schemas/SecurityFilterMeta' + type: object + SecurityFilterCreateRequest: + description: >- + Request object that includes the security filter that you would like to + create. + properties: + data: + $ref: '#/components/schemas/SecurityFilterCreateData' + required: + - data + type: object + SecurityFilterResponse: + description: Response object which includes a single security filter. + properties: + data: + $ref: '#/components/schemas/SecurityFilter' + meta: + $ref: '#/components/schemas/SecurityFilterMeta' + type: object + SecurityFilterUpdateRequest: + description: The new security filter body. + properties: + data: + $ref: '#/components/schemas/SecurityFilterUpdateData' + required: + - data + type: object + SecurityMonitoringSuppressionsResponse: + description: Response object containing the available suppression rules. + properties: + data: + description: A list of suppressions objects. + items: + $ref: '#/components/schemas/SecurityMonitoringSuppression' + type: array + type: object + SecurityMonitoringSuppressionCreateRequest: + description: >- + Request object that includes the suppression rule that you would like to + create. + properties: + data: + $ref: '#/components/schemas/SecurityMonitoringSuppressionCreateData' + required: + - data + type: object + SecurityMonitoringSuppressionResponse: + description: Response object containing a single suppression rule. + properties: + data: + $ref: '#/components/schemas/SecurityMonitoringSuppression' + type: object + SecurityMonitoringRuleCreatePayload: + description: Create a new rule. + oneOf: + - $ref: '#/components/schemas/SecurityMonitoringStandardRuleCreatePayload' + - $ref: '#/components/schemas/SecurityMonitoringSignalRuleCreatePayload' + - $ref: '#/components/schemas/CloudConfigurationRuleCreatePayload' + SecurityMonitoringSuppressionUpdateRequest: + description: Request object containing the fields to update on the suppression rule. + properties: + data: + $ref: '#/components/schemas/SecurityMonitoringSuppressionUpdateData' + required: + - data + type: object + SecurityMonitoringListRulesResponse: + description: List of rules. + properties: + data: + description: Array containing the list of rules. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleResponse' + type: array + meta: + $ref: '#/components/schemas/ResponseMetaAttributes' + type: object + SecurityMonitoringRuleResponse: + description: Create a new rule. + oneOf: + - $ref: '#/components/schemas/SecurityMonitoringStandardRuleResponse' + - $ref: '#/components/schemas/SecurityMonitoringSignalRuleResponse' + SecurityMonitoringRuleConvertPayload: + description: Convert a rule from JSON to Terraform. + oneOf: + - $ref: '#/components/schemas/SecurityMonitoringStandardRulePayload' + - $ref: '#/components/schemas/SecurityMonitoringSignalRulePayload' + SecurityMonitoringRuleConvertResponse: + description: Result of the convert rule request containing Terraform content. + properties: + ruleId: + description: the ID of the rule. + type: string + terraformContent: + description: Terraform string as a result of converting the rule from JSON. + type: string + type: object + SecurityMonitoringRuleTestRequest: + description: >- + Test the rule queries of a rule (rule property is ignored when applied + to an existing rule) + properties: + rule: + $ref: '#/components/schemas/SecurityMonitoringRuleTestPayload' + ruleQueryPayloads: + description: Data payloads used to test rules query with the expected result. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleQueryPayload' + type: array + type: object + SecurityMonitoringRuleTestResponse: + description: Result of the test of the rule queries. + properties: + results: + description: >- + Assert results are returned in the same order as the rule query + payloads. + + For each payload, it returns True if the result matched the expected + result, + + False otherwise. + items: + type: boolean + type: array + type: object + SecurityMonitoringRuleValidatePayload: + description: Validate a rule. + oneOf: + - $ref: '#/components/schemas/SecurityMonitoringStandardRulePayload' + - $ref: '#/components/schemas/SecurityMonitoringSignalRulePayload' + - $ref: '#/components/schemas/CloudConfigurationRulePayload' + SecurityMonitoringRuleUpdatePayload: + description: Update an existing rule. + properties: + calculatedFields: + description: >- + Calculated fields. Only allowed for scheduled rules - in other + words, when schedulingOptions is also defined. + items: + $ref: '#/components/schemas/CalculatedField' + type: array + cases: + description: Cases for generating signals. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCase' + type: array + complianceSignalOptions: + $ref: '#/components/schemas/CloudConfigurationRuleComplianceSignalOptions' + customMessage: + description: >- + Custom/Overridden Message for generated signals (used in case of + Default rule update). + type: string + customName: + description: Custom/Overridden name (used in case of Default rule update). + type: string + filters: + description: >- + Additional queries to filter matched events before they are + processed. This field is deprecated for log detection, signal + correlation, and workload security rules. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + groupSignalsBy: + description: >- + Additional grouping to perform on top of the existing groups in the + query section. Must be a subset of the existing groups. + example: + - service + items: + description: Field to group by. + type: string + type: array + hasExtendedTitle: + description: >- + Whether the notifications include the triggering group-by values in + their title. + example: true + type: boolean + isEnabled: + description: Whether the rule is enabled. + type: boolean + message: + description: Message for generated signals. + type: string + name: + description: Name of the rule. + type: string + options: + $ref: '#/components/schemas/SecurityMonitoringRuleOptions' + queries: + description: Queries for selecting logs which are part of the rule. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleQuery' + type: array + referenceTables: + description: Reference tables for the rule. + items: + $ref: '#/components/schemas/SecurityMonitoringReferenceTable' + type: array + schedulingOptions: + $ref: '#/components/schemas/SecurityMonitoringSchedulingOptions' + tags: + description: Tags for generated signals. + items: + description: Tag. + type: string + type: array + thirdPartyCases: + description: >- + Cases for generating signals from third-party rules. Only available + for third-party rules. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCase' + type: array + version: + description: The version of the rule being updated. + example: 1 + format: int32 + maximum: 2147483647 + type: integer + type: object + GetRuleVersionHistoryResponse: + description: Response for getting the rule version history. + properties: + data: + $ref: '#/components/schemas/GetRuleVersionHistoryData' + type: object + SecurityMonitoringSignalsListResponse: + description: |- + The response object with all security signals matching the request + and pagination information. + properties: + data: + description: An array of security signals matching the request. + items: + $ref: '#/components/schemas/SecurityMonitoringSignal' + type: array + links: + $ref: '#/components/schemas/SecurityMonitoringSignalsListResponseLinks' + meta: + $ref: '#/components/schemas/SecurityMonitoringSignalsListResponseMeta' + type: object + SecurityMonitoringSignalListRequest: + description: The request for a security signal list. + properties: + filter: + $ref: '#/components/schemas/SecurityMonitoringSignalListRequestFilter' + page: + $ref: '#/components/schemas/SecurityMonitoringSignalListRequestPage' + sort: + $ref: '#/components/schemas/SecurityMonitoringSignalsSort' + type: object + SecurityMonitoringSignalResponse: + description: Security Signal response data object. + properties: + data: + $ref: '#/components/schemas/SecurityMonitoringSignal' + type: object + SecurityMonitoringSignalAssigneeUpdateRequest: + description: >- + Request body for changing the assignee of a given security monitoring + signal. + properties: + data: + $ref: '#/components/schemas/SecurityMonitoringSignalAssigneeUpdateData' + required: + - data + type: object + SecurityMonitoringSignalTriageUpdateResponse: + description: >- + The response returned after all triage operations, containing the + updated signal triage data. + properties: + data: + $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateData' + required: + - data + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + SecurityMonitoringSignalIncidentsUpdateRequest: + description: >- + Request body for changing the related incidents of a given security + monitoring signal. + properties: + data: + $ref: '#/components/schemas/SecurityMonitoringSignalIncidentsUpdateData' + required: + - data + type: object + SecurityMonitoringSignalStateUpdateRequest: + description: >- + Request body for changing the state of a given security monitoring + signal. + properties: + data: + $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateData' + required: + - data + type: object + SensitiveDataScannerGetConfigResponse: + description: Get all groups response. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerGetConfigResponseData' + included: + $ref: '#/components/schemas/SensitiveDataScannerGetConfigIncludedArray' + meta: + $ref: '#/components/schemas/SensitiveDataScannerMeta' + type: object + SensitiveDataScannerConfigRequest: + description: Group reorder request. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerReorderConfig' + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + required: + - data + - meta + type: object + SensitiveDataScannerReorderGroupsResponse: + description: Group reorder response. + properties: + meta: + $ref: '#/components/schemas/SensitiveDataScannerMeta' + type: object + SensitiveDataScannerGroupCreateRequest: + description: Create group request. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerGroupCreate' + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + type: object + SensitiveDataScannerCreateGroupResponse: + description: Create group response. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerGroupResponse' + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + type: object + SensitiveDataScannerGroupDeleteRequest: + description: Delete group request. + properties: + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + required: + - meta + type: object + SensitiveDataScannerGroupDeleteResponse: + description: Delete group response. + properties: + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + type: object + SensitiveDataScannerGroupUpdateRequest: + description: Update group request. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerGroupUpdate' + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + required: + - data + - meta + type: object + SensitiveDataScannerGroupUpdateResponse: + description: Update group response. + properties: + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + type: object + SensitiveDataScannerRuleCreateRequest: + description: Create rule request. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerRuleCreate' + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + required: + - data + - meta + type: object + SensitiveDataScannerCreateRuleResponse: + description: Create rule response. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerRuleResponse' + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + type: object + SensitiveDataScannerRuleDeleteRequest: + description: Delete rule request. + properties: + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + required: + - meta + type: object + SensitiveDataScannerRuleDeleteResponse: + description: Delete rule response. + properties: + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + type: object + SensitiveDataScannerRuleUpdateRequest: + description: Update rule request. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerRuleUpdate' + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + required: + - data + - meta + type: object + SensitiveDataScannerRuleUpdateResponse: + description: Update rule response. + properties: + meta: + $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' + type: object + SensitiveDataScannerStandardPatternsResponseData: + description: List Standard patterns response data. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerStandardPatternsResponse' + type: object + ListHistoricalJobsResponse: + description: List of historical jobs. + properties: + data: + description: Array containing the list of historical jobs. + items: + $ref: '#/components/schemas/HistoricalJobResponseData' + type: array + meta: + $ref: '#/components/schemas/HistoricalJobListMeta' + type: object + RunHistoricalJobRequest: + description: Run a historical job request. + properties: + data: + $ref: '#/components/schemas/RunHistoricalJobRequestData' + type: object + JobCreateResponse: + description: Run a historical job response. + properties: + data: + $ref: '#/components/schemas/JobCreateResponseData' + type: object + ConvertJobResultsToSignalsRequest: + description: Request for converting historical job results to signals. + properties: + data: + $ref: '#/components/schemas/ConvertJobResultsToSignalsData' + type: object + HistoricalJobResponse: + description: Historical job response. + properties: + data: + $ref: '#/components/schemas/HistoricalJobResponseData' + type: object + AwsScanOptionsData: + description: Single AWS Scan Options entry. + properties: + attributes: + $ref: '#/components/schemas/AwsScanOptionsAttributes' + id: + description: The ID of the AWS account. + example: '184366314700' + type: string + type: + $ref: '#/components/schemas/AwsScanOptionsType' + type: object + AwsScanOptionsCreateData: + description: Object for the scan options of a single AWS account. + properties: + attributes: + $ref: '#/components/schemas/AwsScanOptionsCreateAttributes' + id: + $ref: '#/components/schemas/AwsAccountId' + type: + $ref: '#/components/schemas/AwsScanOptionsType' + required: + - id + - type + - attributes + type: object + AwsScanOptionsUpdateData: + description: Object for the scan options of a single AWS account. + properties: + attributes: + $ref: '#/components/schemas/AwsScanOptionsUpdateAttributes' + id: + $ref: '#/components/schemas/AwsAccountId' + type: + $ref: '#/components/schemas/AwsScanOptionsType' + required: + - id + - type + - attributes + type: object + AwsOnDemandData: + description: Single AWS on demand task. + properties: + attributes: + $ref: '#/components/schemas/AwsOnDemandAttributes' + id: + description: The UUID of the task. + example: 6d09294c-9ad9-42fd-a759-a0c1599b4828 + type: string + type: + $ref: '#/components/schemas/AwsOnDemandType' + type: object + AwsOnDemandCreateData: + description: Object for a single AWS on demand task. + properties: + attributes: + $ref: '#/components/schemas/AwsOnDemandCreateAttributes' + type: + $ref: '#/components/schemas/AwsOnDemandType' + required: + - type + - attributes + type: object + CustomFrameworkData: + description: Contains type and attributes for custom frameworks. + properties: + attributes: + $ref: '#/components/schemas/CustomFrameworkDataAttributes' + type: + $ref: '#/components/schemas/CustomFrameworkType' + required: + - type + - attributes + type: object + FrameworkHandleAndVersionResponseData: + description: Contains type and attributes for custom frameworks. + properties: + attributes: + $ref: '#/components/schemas/CustomFrameworkDataHandleAndVersion' + id: + description: The ID of the custom framework. + example: handle-version + type: string + type: + $ref: '#/components/schemas/CustomFrameworkType' + required: + - id + - type + - attributes + type: object + CustomFrameworkMetadata: + description: Metadata for custom frameworks. + properties: + attributes: + $ref: '#/components/schemas/CustomFrameworkWithoutRequirements' + id: + description: The ID of the custom framework. + example: handle-version + type: string + type: + $ref: '#/components/schemas/CustomFrameworkType' + type: object + FullCustomFrameworkData: + description: Contains type and attributes for custom frameworks. + properties: + attributes: + $ref: '#/components/schemas/FullCustomFrameworkDataAttributes' + id: + description: The ID of the custom framework. + example: handle-version + type: string + type: + $ref: '#/components/schemas/CustomFrameworkType' + required: + - id + - type + - attributes + type: object + GetResourceEvaluationFiltersResponseData: + description: The definition of `GetResourceFilterResponseData` object. + properties: + attributes: + $ref: '#/components/schemas/ResourceFilterAttributes' + id: + description: The `data` `id`. + example: csm_resource_filter + type: string + type: + $ref: '#/components/schemas/ResourceFilterRequestType' + type: object + UpdateResourceEvaluationFiltersRequestData: + description: The definition of `UpdateResourceFilterRequestData` object. + properties: + attributes: + $ref: '#/components/schemas/ResourceFilterAttributes' + id: + description: The `UpdateResourceEvaluationFiltersRequestData` `id`. + example: csm_resource_filter + type: string + type: + $ref: '#/components/schemas/ResourceFilterRequestType' + required: + - attributes + - type + type: object + UpdateResourceEvaluationFiltersResponseData: + description: The definition of `UpdateResourceFilterResponseData` object. + properties: + attributes: + $ref: '#/components/schemas/ResourceFilterAttributes' + id: + description: The `data` `id`. + example: csm_resource_filter + type: string + type: + $ref: '#/components/schemas/ResourceFilterRequestType' + required: + - attributes + - type + type: object + CsmAgentData: + description: Single Agent Data. + properties: + attributes: + $ref: '#/components/schemas/CsmAgentsAttributes' + id: + description: The ID of the Agent. + example: fffffc5505f6a006fdf7cf5aae053653 + type: string + type: + $ref: '#/components/schemas/CSMAgentsType' + type: object + CSMAgentsMetadata: + description: Metadata related to the paginated response. + properties: + page_index: + description: The index of the current page in the paginated results. + example: 0 + format: int64 + type: integer + page_size: + description: The number of items per page in the paginated results. + example: 10 + format: int64 + type: integer + total_filtered: + description: Total number of items that match the filter criteria. + example: 128697 + format: int64 + type: integer + type: object + CsmCloudAccountsCoverageAnalysisData: + description: CSM Cloud Accounts Coverage Analysis data. + properties: + attributes: + $ref: '#/components/schemas/CsmCloudAccountsCoverageAnalysisAttributes' + id: + description: The ID of your organization. + example: 66b3c6b5-5c9a-457e-b1c3-f247ca23afa3 + type: string + type: + default: get_cloud_accounts_coverage_analysis_response_public_v0 + description: >- + The type of the resource. The value should always be + `get_cloud_accounts_coverage_analysis_response_public_v0`. + example: get_cloud_accounts_coverage_analysis_response_public_v0 + type: string + type: object + CsmHostsAndContainersCoverageAnalysisData: + description: CSM Hosts and Containers Coverage Analysis data. + properties: + attributes: + $ref: '#/components/schemas/CsmHostsAndContainersCoverageAnalysisAttributes' + id: + description: The ID of your organization. + example: 66b3c6b5-5c9a-457e-b1c3-f247ca23afa3 + type: string + type: + default: get_hosts_and_containers_coverage_analysis_response_public_v0 + description: >- + The type of the resource. The value should always be + `get_hosts_and_containers_coverage_analysis_response_public_v0`. + example: get_hosts_and_containers_coverage_analysis_response_public_v0 + type: string + type: object + CsmServerlessCoverageAnalysisData: + description: CSM Serverless Resources Coverage Analysis data. + properties: + attributes: + $ref: '#/components/schemas/CsmServerlessCoverageAnalysisAttributes' + id: + description: The ID of your organization. + example: 66b3c6b5-5c9a-457e-b1c3-f247ca23afa3 + type: string + type: + default: get_serverless_coverage_analysis_response_public_v0 + description: >- + The type of the resource. The value should always be + `get_serverless_coverage_analysis_response_public_v0`. + example: get_serverless_coverage_analysis_response_public_v0 + type: string + type: object + ListFindingsData: + description: Array of findings. + items: + $ref: '#/components/schemas/Finding' + type: array + ListFindingsMeta: + additionalProperties: false + description: Metadata for pagination. + properties: + page: + $ref: '#/components/schemas/ListFindingsPage' + snapshot_timestamp: + description: The point in time corresponding to the listed findings. + example: 1678721573794 + format: int64 + minimum: 1 + type: integer + type: object + BulkMuteFindingsRequestData: + description: Data object containing the new bulk mute properties of the finding. + properties: + attributes: + $ref: '#/components/schemas/BulkMuteFindingsRequestAttributes' + id: + description: UUID to identify the request + example: dbe5f567-192b-4404-b908-29b70e1c9f76 + type: string + meta: + $ref: '#/components/schemas/BulkMuteFindingsRequestMeta' + type: + $ref: '#/components/schemas/FindingType' + required: + - id + - type + - attributes + - meta + type: object + BulkMuteFindingsResponseData: + description: Data object containing the ID of the request that was updated. + properties: + id: + description: UUID used to identify the request + example: 93bfeb70-af47-424d-908a-948d3f08e37f + type: string + type: + $ref: '#/components/schemas/FindingType' + type: object + JSONAPIErrorItem: + description: API error response body + properties: + detail: + description: >- + A human-readable explanation specific to this occurrence of the + error. + example: Missing required attribute in body + type: string + meta: + additionalProperties: {} + description: Non-standard meta-information about the error + type: object + source: + $ref: '#/components/schemas/JSONAPIErrorItemSource' + status: + description: Status code of the response. + example: '400' + type: string + title: + description: Short human-readable summary of the error. + example: Bad Request + type: string + type: object + DetailedFinding: + description: A single finding with with message and resource configuration. + properties: + attributes: + $ref: '#/components/schemas/DetailedFindingAttributes' + id: + $ref: '#/components/schemas/FindingID' + type: + $ref: '#/components/schemas/DetailedFindingType' + type: object + Asset: + description: A single vulnerable asset + properties: + attributes: + $ref: '#/components/schemas/AssetAttributes' + id: + description: The unique ID for this asset. + example: Repository|github.com/DataDog/datadog-agent.git + type: string + type: + $ref: '#/components/schemas/AssetEntityType' + required: + - id + - type + - attributes + type: object + Links: + description: The JSON:API links related to pagination. + properties: + first: + description: First page link. + example: >- + https://api.datadoghq.com/api/v2/security/vulnerabilities?page%5Bnumber%5D=1&page%5Btoken%5D=b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4 + type: string + last: + description: Last page link. + example: >- + https://api.datadoghq.com/api/v2/security/vulnerabilities?page%5Bnumber%5D=15&page%5Btoken%5D=b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4 + type: string + next: + description: Next page link. + example: >- + https://api.datadoghq.com/api/v2/security/vulnerabilities?page%5Bnumber%5D=16&page%5Btoken%5D=b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4 + type: string + previous: + description: Previous page link. + example: >- + https://api.datadoghq.com/api/v2/security/vulnerabilities?page%5Bnumber%5D=14&page%5Btoken%5D=b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4 + type: string + self: + description: Request link. + example: >- + https://api.datadoghq.com/api/v2/security/vulnerabilities?filter%5Btool%5D=Infra + type: string + required: + - self + - first + - last + type: object + Metadata: + description: The metadata related to this request. + properties: + count: + description: Number of entities included in the response. + example: 150 + format: int64 + type: integer + token: + description: The token that identifies the request. + example: >- + b82cef018aab81ed1d4bb4xb35xxfc065da7efa685fbcecdbd338f3015e3afabbbfa3a911b4984_721ee28a-zecb-4e45-9960-c42065b574f4 + type: string + total: + description: Total number of entities across all pages. + example: 152431 + format: int64 + type: integer + required: + - count + - total + - token + type: object + SBOM: + description: A single SBOM + properties: + attributes: + $ref: '#/components/schemas/SBOMAttributes' + id: + description: >- + The unique ID for this SBOM (it is equivalent to the `asset_name` or + `asset_name@repo_digest` (Image) + example: github.com/datadog/datadog-agent + type: string + type: + $ref: '#/components/schemas/SBOMType' + type: object + NotificationRule: + description: > + Notification rules allow full control over notifications generated by + the various Datadog security products. + + They allow users to define the conditions under which a notification + should be generated (based on rule severities, + + rule types, rule tags, and so on), and the targets to notify. + + A notification rule is composed of a rule ID, a rule type, and the rule + attributes. All fields are required. + properties: + attributes: + $ref: '#/components/schemas/NotificationRuleAttributes' + id: + $ref: '#/components/schemas/ID' + type: + $ref: '#/components/schemas/NotificationRulesType' + required: + - attributes + - id + - type + type: object + CreateNotificationRuleParametersData: + description: >- + Data of the notification rule create request: the rule type, and the + rule attributes. All fields are required. + properties: + attributes: + $ref: '#/components/schemas/CreateNotificationRuleParametersDataAttributes' + type: + $ref: '#/components/schemas/NotificationRulesType' + required: + - attributes + - type + type: object + PatchNotificationRuleParametersData: + description: >- + Data of the notification rule patch request: the rule ID, the rule type, + and the rule attributes. All fields are required. + properties: + attributes: + $ref: '#/components/schemas/PatchNotificationRuleParametersDataAttributes' + id: + $ref: '#/components/schemas/ID' + type: + $ref: '#/components/schemas/NotificationRulesType' + required: + - attributes + - id + - type + type: object + Vulnerability: + description: A single vulnerability + properties: + attributes: + $ref: '#/components/schemas/VulnerabilityAttributes' + id: + description: The unique ID for this vulnerability. + example: 3ecdfea798f2ce8f6e964805a344945f + type: string + relationships: + $ref: '#/components/schemas/VulnerabilityRelationships' + type: + $ref: '#/components/schemas/VulnerabilitiesType' + required: + - id + - type + - attributes + - relationships + type: object + CloudWorkloadSecurityAgentRuleData: + description: Object for a single Agent rule + properties: + attributes: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleAttributes' + id: + description: The ID of the Agent rule + example: 3dd-0uc-h1s + type: string + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' + type: object + CloudWorkloadSecurityAgentRuleCreateData: + description: Object for a single Agent rule + properties: + attributes: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreateAttributes' + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' + required: + - attributes + - type + type: object + CloudWorkloadSecurityAgentRuleUpdateData: + description: Object for a single Agent rule + properties: + attributes: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdateAttributes' + id: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleID' + type: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleType' + required: + - attributes + - type + type: object + SecurityFilter: + description: The security filter's properties. + properties: + attributes: + $ref: '#/components/schemas/SecurityFilterAttributes' + id: + $ref: '#/components/schemas/SecurityFilterID' + type: + $ref: '#/components/schemas/SecurityFilterType' + type: object + SecurityFilterMeta: + description: Optional metadata associated to the response. + properties: + warning: + description: A warning message. + example: >- + All the security filters are disabled. As a result, no logs are + being analyzed. + type: string + type: object + SecurityFilterCreateData: + description: Object for a single security filter. + properties: + attributes: + $ref: '#/components/schemas/SecurityFilterCreateAttributes' + type: + $ref: '#/components/schemas/SecurityFilterType' + required: + - type + - attributes + type: object + SecurityFilterUpdateData: + description: The new security filter properties. + properties: + attributes: + $ref: '#/components/schemas/SecurityFilterUpdateAttributes' + type: + $ref: '#/components/schemas/SecurityFilterType' + required: + - type + - attributes + type: object + SecurityMonitoringSuppression: + description: The suppression rule's properties. + properties: + attributes: + $ref: '#/components/schemas/SecurityMonitoringSuppressionAttributes' + id: + $ref: '#/components/schemas/SecurityMonitoringSuppressionID' + type: + $ref: '#/components/schemas/SecurityMonitoringSuppressionType' + type: object + SecurityMonitoringSuppressionCreateData: + description: Object for a single suppression rule. + properties: + attributes: + $ref: '#/components/schemas/SecurityMonitoringSuppressionCreateAttributes' + type: + $ref: '#/components/schemas/SecurityMonitoringSuppressionType' + required: + - type + - attributes + type: object + SecurityMonitoringStandardRuleCreatePayload: + description: Create a new rule. + properties: + calculatedFields: + description: >- + Calculated fields. Only allowed for scheduled rules - in other + words, when schedulingOptions is also defined. + items: + $ref: '#/components/schemas/CalculatedField' + type: array + cases: + description: Cases for generating signals. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseCreate' + type: array + filters: + description: >- + Additional queries to filter matched events before they are + processed. This field is deprecated for log detection, signal + correlation, and workload security rules. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + groupSignalsBy: + description: >- + Additional grouping to perform on top of the existing groups in the + query section. Must be a subset of the existing groups. + example: + - service + items: + description: Field to group by. + type: string + type: array + hasExtendedTitle: + description: >- + Whether the notifications include the triggering group-by values in + their title. + example: true + type: boolean + isEnabled: + description: Whether the rule is enabled. + example: true + type: boolean + message: + description: Message for generated signals. + example: '' + type: string + name: + description: The name of the rule. + example: My security monitoring rule. + type: string + options: + $ref: '#/components/schemas/SecurityMonitoringRuleOptions' + queries: + description: Queries for selecting logs which are part of the rule. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringStandardRuleQuery' + type: array + referenceTables: + description: Reference tables for the rule. + items: + $ref: '#/components/schemas/SecurityMonitoringReferenceTable' + type: array + schedulingOptions: + $ref: '#/components/schemas/SecurityMonitoringSchedulingOptions' + tags: + description: Tags for generated signals. + example: + - env:prod + - team:security + items: + description: Tag. + type: string + type: array + thirdPartyCases: + description: >- + Cases for generating signals from third-party rules. Only available + for third-party rules. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCaseCreate' + type: array + type: + $ref: '#/components/schemas/SecurityMonitoringRuleTypeCreate' + required: + - name + - isEnabled + - queries + - options + - cases + - message + type: object + SecurityMonitoringSignalRuleCreatePayload: + description: Create a new signal correlation rule. + properties: + cases: + description: Cases for generating signals. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseCreate' + type: array + filters: + description: >- + Additional queries to filter matched events before they are + processed. This field is deprecated for log detection, signal + correlation, and workload security rules. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + hasExtendedTitle: + description: >- + Whether the notifications include the triggering group-by values in + their title. + example: true + type: boolean + isEnabled: + description: Whether the rule is enabled. + example: true + type: boolean + message: + description: Message for generated signals. + example: '' + type: string + name: + description: The name of the rule. + example: My security monitoring rule. + type: string + options: + $ref: '#/components/schemas/SecurityMonitoringRuleOptions' + queries: + description: Queries for selecting signals which are part of the rule. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringSignalRuleQuery' + type: array + tags: + description: Tags for generated signals. + example: + - env:prod + - team:security + items: + description: Tag. + type: string + type: array + type: + $ref: '#/components/schemas/SecurityMonitoringSignalRuleType' + required: + - name + - isEnabled + - queries + - options + - cases + - message + type: object + CloudConfigurationRuleCreatePayload: + description: Create a new cloud configuration rule. + properties: + cases: + description: > + Description of generated findings and signals (severity and channels + to be notified in case of a signal). Must contain exactly one item. + items: + $ref: '#/components/schemas/CloudConfigurationRuleCaseCreate' + type: array + complianceSignalOptions: + $ref: '#/components/schemas/CloudConfigurationRuleComplianceSignalOptions' + filters: + description: >- + Additional queries to filter matched events before they are + processed. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + isEnabled: + description: Whether the rule is enabled. + example: true + type: boolean + message: + description: Message in markdown format for generated findings and signals. + example: | + #Description + Explanation of the rule. + + #Remediation + How to fix the security issue. + type: string + name: + description: The name of the rule. + example: My security monitoring rule. + type: string + options: + $ref: '#/components/schemas/CloudConfigurationRuleOptions' + tags: + description: Tags for generated findings and signals. + example: + - env:prod + - team:security + items: + description: Tag. + type: string + type: array + type: + $ref: '#/components/schemas/CloudConfigurationRuleType' + required: + - name + - isEnabled + - options + - complianceSignalOptions + - cases + - message + type: object + SecurityMonitoringSuppressionUpdateData: + description: The new suppression properties; partial updates are supported. + properties: + attributes: + $ref: '#/components/schemas/SecurityMonitoringSuppressionUpdateAttributes' + type: + $ref: '#/components/schemas/SecurityMonitoringSuppressionType' + required: + - type + - attributes + type: object + ResponseMetaAttributes: + description: Object describing meta attributes of response. + properties: + page: + $ref: '#/components/schemas/Pagination' + type: object + SecurityMonitoringStandardRuleResponse: + description: Rule. + properties: + calculatedFields: + description: >- + Calculated fields. Only allowed for scheduled rules - in other + words, when schedulingOptions is also defined. + items: + $ref: '#/components/schemas/CalculatedField' + type: array + cases: + description: Cases for generating signals. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCase' + type: array + complianceSignalOptions: + $ref: '#/components/schemas/CloudConfigurationRuleComplianceSignalOptions' + createdAt: + description: When the rule was created, timestamp in milliseconds. + format: int64 + type: integer + creationAuthorId: + description: User ID of the user who created the rule. + format: int64 + type: integer + customMessage: + description: >- + Custom/Overridden message for generated signals (used in case of + Default rule update). + type: string + customName: + description: >- + Custom/Overridden name of the rule (used in case of Default rule + update). + type: string + defaultTags: + description: Default Tags for default rules (included in tags) + example: + - security:attacks + items: + description: Default Tag. + type: string + type: array + deprecationDate: + description: When the rule will be deprecated, timestamp in milliseconds. + format: int64 + type: integer + filters: + description: >- + Additional queries to filter matched events before they are + processed. This field is deprecated for log detection, signal + correlation, and workload security rules. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + groupSignalsBy: + description: >- + Additional grouping to perform on top of the existing groups in the + query section. Must be a subset of the existing groups. + example: + - service + items: + description: Field to group by. + type: string + type: array + hasExtendedTitle: + description: >- + Whether the notifications include the triggering group-by values in + their title. + type: boolean + id: + description: The ID of the rule. + type: string + isDefault: + description: Whether the rule is included by default. + type: boolean + isDeleted: + description: Whether the rule has been deleted. + type: boolean + isEnabled: + description: Whether the rule is enabled. + type: boolean + message: + description: Message for generated signals. + type: string + name: + description: The name of the rule. + type: string + options: + $ref: '#/components/schemas/SecurityMonitoringRuleOptions' + queries: + description: Queries for selecting logs which are part of the rule. + items: + $ref: '#/components/schemas/SecurityMonitoringStandardRuleQuery' + type: array + referenceTables: + description: Reference tables for the rule. + items: + $ref: '#/components/schemas/SecurityMonitoringReferenceTable' + type: array + schedulingOptions: + $ref: '#/components/schemas/SecurityMonitoringSchedulingOptions' + tags: + description: Tags for generated signals. + items: + description: Tag. + type: string + type: array + thirdPartyCases: + description: >- + Cases for generating signals from third-party rules. Only available + for third-party rules. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCase' + type: array + type: + $ref: '#/components/schemas/SecurityMonitoringRuleTypeRead' + updateAuthorId: + description: User ID of the user who updated the rule. + format: int64 + type: integer + updatedAt: + description: The date the rule was last updated, in milliseconds. + format: int64 + type: integer + version: + description: The version of the rule. + format: int64 + type: integer + type: object + SecurityMonitoringSignalRuleResponse: + description: Rule. + properties: + cases: + description: Cases for generating signals. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCase' + type: array + createdAt: + description: When the rule was created, timestamp in milliseconds. + format: int64 + type: integer + creationAuthorId: + description: User ID of the user who created the rule. + format: int64 + type: integer + customMessage: + description: >- + Custom/Overridden message for generated signals (used in case of + Default rule update). + type: string + customName: + description: >- + Custom/Overridden name of the rule (used in case of Default rule + update). + type: string + deprecationDate: + description: When the rule will be deprecated, timestamp in milliseconds. + format: int64 + type: integer + filters: + description: >- + Additional queries to filter matched events before they are + processed. This field is deprecated for log detection, signal + correlation, and workload security rules. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + hasExtendedTitle: + description: >- + Whether the notifications include the triggering group-by values in + their title. + type: boolean + id: + description: The ID of the rule. + type: string + isDefault: + description: Whether the rule is included by default. + type: boolean + isDeleted: + description: Whether the rule has been deleted. + type: boolean + isEnabled: + description: Whether the rule is enabled. + type: boolean + message: + description: Message for generated signals. + type: string + name: + description: The name of the rule. + type: string + options: + $ref: '#/components/schemas/SecurityMonitoringRuleOptions' + queries: + description: Queries for selecting logs which are part of the rule. + items: + $ref: '#/components/schemas/SecurityMonitoringSignalRuleResponseQuery' + type: array + tags: + description: Tags for generated signals. + items: + description: Tag. + type: string + type: array + type: + $ref: '#/components/schemas/SecurityMonitoringSignalRuleType' + updateAuthorId: + description: User ID of the user who updated the rule. + format: int64 + type: integer + version: + description: The version of the rule. + format: int64 + type: integer + type: object + SecurityMonitoringStandardRulePayload: + description: The payload of a rule. + properties: + calculatedFields: + description: >- + Calculated fields. Only allowed for scheduled rules - in other + words, when schedulingOptions is also defined. + items: + $ref: '#/components/schemas/CalculatedField' + type: array + cases: + description: Cases for generating signals. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseCreate' + type: array + customMessage: + description: >- + Custom/Overridden message for generated signals (used in case of + Default rule update). + type: string + customName: + description: >- + Custom/Overridden name of the rule (used in case of Default rule + update). + type: string + filters: + description: >- + Additional queries to filter matched events before they are + processed. This field is deprecated for log detection, signal + correlation, and workload security rules. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + groupSignalsBy: + description: >- + Additional grouping to perform on top of the existing groups in the + query section. Must be a subset of the existing groups. + example: + - service + items: + description: Field to group by. + type: string + type: array + hasExtendedTitle: + description: >- + Whether the notifications include the triggering group-by values in + their title. + example: true + type: boolean + isEnabled: + description: Whether the rule is enabled. + example: true + type: boolean + message: + description: Message for generated signals. + example: '' + type: string + name: + description: The name of the rule. + example: My security monitoring rule. + type: string + options: + $ref: '#/components/schemas/SecurityMonitoringRuleOptions' + queries: + description: Queries for selecting logs which are part of the rule. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringStandardRuleQuery' + type: array + referenceTables: + description: Reference tables for the rule. + items: + $ref: '#/components/schemas/SecurityMonitoringReferenceTable' + type: array + schedulingOptions: + $ref: '#/components/schemas/SecurityMonitoringSchedulingOptions' + tags: + description: Tags for generated signals. + example: + - env:prod + - team:security + items: + description: Tag. + type: string + type: array + thirdPartyCases: + description: >- + Cases for generating signals from third-party rules. Only available + for third-party rules. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCaseCreate' + type: array + type: + $ref: '#/components/schemas/SecurityMonitoringRuleTypeCreate' + required: + - name + - isEnabled + - queries + - options + - cases + - message + type: object + SecurityMonitoringSignalRulePayload: + description: The payload of a signal correlation rule. + properties: + cases: + description: Cases for generating signals. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseCreate' + type: array + customMessage: + description: >- + Custom/Overridden message for generated signals (used in case of + Default rule update). + type: string + customName: + description: >- + Custom/Overridden name of the rule (used in case of Default rule + update). + type: string + filters: + description: >- + Additional queries to filter matched events before they are + processed. This field is deprecated for log detection, signal + correlation, and workload security rules. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + hasExtendedTitle: + description: >- + Whether the notifications include the triggering group-by values in + their title. + example: true + type: boolean + isEnabled: + description: Whether the rule is enabled. + example: true + type: boolean + message: + description: Message for generated signals. + example: '' + type: string + name: + description: The name of the rule. + example: My security monitoring rule. + type: string + options: + $ref: '#/components/schemas/SecurityMonitoringRuleOptions' + queries: + description: Queries for selecting signals which are part of the rule. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringSignalRuleQuery' + type: array + tags: + description: Tags for generated signals. + example: + - env:prod + - team:security + items: + description: Tag. + type: string + type: array + type: + $ref: '#/components/schemas/SecurityMonitoringSignalRuleType' + required: + - name + - isEnabled + - queries + - options + - cases + - message + type: object + SecurityMonitoringRuleTestPayload: + description: Test a rule. + oneOf: + - $ref: '#/components/schemas/SecurityMonitoringStandardRuleTestPayload' + SecurityMonitoringRuleQueryPayload: + description: Payload to test a rule query with the expected result. + properties: + expectedResult: + description: Expected result of the test. + example: true + type: boolean + index: + description: Index of the query under test. + example: 0 + format: int64 + minimum: 0 + type: integer + payload: + $ref: '#/components/schemas/SecurityMonitoringRuleQueryPayloadData' + type: object + CloudConfigurationRulePayload: + description: The payload of a cloud configuration rule. + properties: + cases: + description: > + Description of generated findings and signals (severity and channels + to be notified in case of a signal). Must contain exactly one item. + items: + $ref: '#/components/schemas/CloudConfigurationRuleCaseCreate' + type: array + complianceSignalOptions: + $ref: '#/components/schemas/CloudConfigurationRuleComplianceSignalOptions' + customMessage: + description: >- + Custom/Overridden message for generated signals (used in case of + Default rule update). + type: string + customName: + description: >- + Custom/Overridden name of the rule (used in case of Default rule + update). + type: string + filters: + description: >- + Additional queries to filter matched events before they are + processed. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + isEnabled: + description: Whether the rule is enabled. + example: true + type: boolean + message: + description: Message in markdown format for generated findings and signals. + example: | + #Description + Explanation of the rule. + + #Remediation + How to fix the security issue. + type: string + name: + description: The name of the rule. + example: My security monitoring rule. + type: string + options: + $ref: '#/components/schemas/CloudConfigurationRuleOptions' + tags: + description: Tags for generated findings and signals. + example: + - env:prod + - team:security + items: + description: Tag. + type: string + type: array + type: + $ref: '#/components/schemas/CloudConfigurationRuleType' + required: + - name + - isEnabled + - options + - complianceSignalOptions + - cases + - message + type: object + CalculatedField: + description: Calculated field. + properties: + expression: + description: Expression. + example: '@request_end_timestamp - @request_start_timestamp' + type: string + name: + description: Field name. + example: response_time + type: string + required: + - name + - expression + type: object + SecurityMonitoringRuleCase: + description: Case when signal is generated. + properties: + actions: + description: Action to perform for each rule case. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseAction' + type: array + condition: + description: >- + A rule case contains logical operations (`>`,`>=`, `&&`, `||`) to + determine if a signal should be generated + + based on the event counts in the previously defined queries. + type: string + customStatus: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + name: + description: Name of the case. + type: string + notifications: + description: Notification targets for each rule case. + items: + description: Notification. + type: string + type: array + status: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + type: object + CloudConfigurationRuleComplianceSignalOptions: + description: >- + How to generate compliance signals. Useful for cloud_configuration rules + only. + properties: + defaultActivationStatus: + description: The default activation status. + nullable: true + type: boolean + defaultGroupByFields: + description: The default group by fields. + items: + type: string + nullable: true + type: array + userActivationStatus: + description: Whether signals will be sent. + nullable: true + type: boolean + userGroupByFields: + description: Fields to use to group findings by when sending signals. + items: + type: string + nullable: true + type: array + type: object + SecurityMonitoringFilter: + description: The rule's suppression filter. + properties: + action: + $ref: '#/components/schemas/SecurityMonitoringFilterAction' + query: + description: Query for selecting logs to apply the filtering action. + type: string + type: object + SecurityMonitoringRuleOptions: + description: Options. + properties: + complianceRuleOptions: + $ref: '#/components/schemas/CloudConfigurationComplianceRuleOptions' + decreaseCriticalityBasedOnEnv: + $ref: >- + #/components/schemas/SecurityMonitoringRuleDecreaseCriticalityBasedOnEnv + detectionMethod: + $ref: '#/components/schemas/SecurityMonitoringRuleDetectionMethod' + evaluationWindow: + $ref: '#/components/schemas/SecurityMonitoringRuleEvaluationWindow' + hardcodedEvaluatorType: + $ref: '#/components/schemas/SecurityMonitoringRuleHardcodedEvaluatorType' + impossibleTravelOptions: + $ref: '#/components/schemas/SecurityMonitoringRuleImpossibleTravelOptions' + keepAlive: + $ref: '#/components/schemas/SecurityMonitoringRuleKeepAlive' + maxSignalDuration: + $ref: '#/components/schemas/SecurityMonitoringRuleMaxSignalDuration' + newValueOptions: + $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptions' + thirdPartyRuleOptions: + $ref: '#/components/schemas/SecurityMonitoringRuleThirdPartyOptions' + type: object + SecurityMonitoringRuleQuery: + description: Query for matching rule. + oneOf: + - $ref: '#/components/schemas/SecurityMonitoringStandardRuleQuery' + - $ref: '#/components/schemas/SecurityMonitoringSignalRuleQuery' + SecurityMonitoringReferenceTable: + description: Reference tables used in the queries. + properties: + checkPresence: + description: Whether to include or exclude the matched values. + type: boolean + columnName: + description: The name of the column in the reference table. + type: string + logFieldPath: + description: The field in the log to match against the reference table. + type: string + ruleQueryName: + description: The name of the query to apply the reference table to. + type: string + tableName: + description: The name of the reference table. + type: string + type: object + SecurityMonitoringSchedulingOptions: + description: >- + Options for scheduled rules. When this field is present, the rule runs + based on the schedule. When absent, it runs real-time on ingested logs. + nullable: true + properties: + rrule: + description: >- + Schedule for the rule queries, written in RRULE syntax. See + [RFC](https://icalendar.org/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html) + for syntax reference. + example: FREQ=HOURLY;INTERVAL=1; + type: string + start: + description: Start date for the schedule, in ISO 8601 format without timezone. + example: '2025-07-14T12:00:00' + type: string + timezone: + description: >- + Time zone of the start date, in the [tz + database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) + format. + example: America/New_York + type: string + type: object + SecurityMonitoringThirdPartyRuleCase: + description: Case when signal is generated by a third party rule. + properties: + customStatus: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + name: + description: Name of the case. + type: string + notifications: + description: Notification targets for each rule case. + items: + description: Notification. + type: string + type: array + query: + description: A query to map a third party event to this case. + type: string + status: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + type: object + GetRuleVersionHistoryData: + description: Data for the rule version history. + properties: + attributes: + $ref: '#/components/schemas/RuleVersionHistory' + id: + description: ID of the rule. + type: string + type: + $ref: '#/components/schemas/GetRuleVersionHistoryDataType' + type: object + SecurityMonitoringSignalsSort: + description: The sort parameters used for querying security signals. + enum: + - timestamp + - '-timestamp' + type: string + x-enum-varnames: + - TIMESTAMP_ASCENDING + - TIMESTAMP_DESCENDING + SecurityMonitoringSignal: + description: Object description of a security signal. + properties: + attributes: + $ref: '#/components/schemas/SecurityMonitoringSignalAttributes' + id: + description: The unique ID of the security signal. + example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA + type: string + type: + $ref: '#/components/schemas/SecurityMonitoringSignalType' + type: object + SecurityMonitoringSignalsListResponseLinks: + description: Links attributes. + properties: + next: + description: >- + The link for the next set of results. **Note**: The request can also + be made using the + + POST endpoint. + example: >- + https://app.datadoghq.com/api/v2/security_monitoring/signals?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + SecurityMonitoringSignalsListResponseMeta: + description: Meta attributes. + properties: + page: + $ref: '#/components/schemas/SecurityMonitoringSignalsListResponseMetaPage' + type: object + SecurityMonitoringSignalListRequestFilter: + description: Search filters for listing security signals. + properties: + from: + description: The minimum timestamp for requested security signals. + example: '2019-01-02T09:42:36.320Z' + format: date-time + type: string + query: + description: Search query for listing security signals. + example: security:attack status:high + type: string + to: + description: The maximum timestamp for requested security signals. + example: '2019-01-03T09:42:36.320Z' + format: date-time + type: string + type: object + SecurityMonitoringSignalListRequestPage: + description: The paging attributes for listing security signals. + properties: + cursor: + description: A list of results using the cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + limit: + default: 10 + description: The maximum number of security signals in the response. + example: 25 + format: int32 + maximum: 1000 + type: integer + type: object + SecurityMonitoringSignalAssigneeUpdateData: + description: Data containing the patch for changing the assignee of a signal. + properties: + attributes: + $ref: >- + #/components/schemas/SecurityMonitoringSignalAssigneeUpdateAttributes + required: + - attributes + type: object + SecurityMonitoringSignalTriageUpdateData: + description: Data containing the updated triage attributes of the signal. + properties: + attributes: + $ref: '#/components/schemas/SecurityMonitoringSignalTriageAttributes' + id: + description: The unique ID of the security signal. + type: string + type: + $ref: '#/components/schemas/SecurityMonitoringSignalMetadataType' + type: object + SecurityMonitoringSignalIncidentsUpdateData: + description: >- + Data containing the patch for changing the related incidents of a + signal. + properties: + attributes: + $ref: >- + #/components/schemas/SecurityMonitoringSignalIncidentsUpdateAttributes + required: + - attributes + type: object + SecurityMonitoringSignalStateUpdateData: + description: Data containing the patch for changing the state of a signal. + properties: + attributes: + $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateAttributes' + id: + description: The unique ID of the security signal. + type: + $ref: '#/components/schemas/SecurityMonitoringSignalMetadataType' + required: + - attributes + type: object + SensitiveDataScannerGetConfigResponseData: + description: Response data related to the scanning groups. + properties: + attributes: + additionalProperties: {} + description: Attributes of the Sensitive Data configuration. + type: object + id: + description: ID of the configuration. + type: string + relationships: + $ref: '#/components/schemas/SensitiveDataScannerConfigurationRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerConfigurationType' + type: object + SensitiveDataScannerGetConfigIncludedArray: + description: Included objects from relationships. + items: + $ref: '#/components/schemas/SensitiveDataScannerGetConfigIncludedItem' + type: array + SensitiveDataScannerMeta: + description: Meta response containing information about the API. + properties: + count_limit: + description: Maximum number of scanning rules allowed for the org. + format: int64 + type: integer + group_count_limit: + description: Maximum number of scanning groups allowed for the org. + format: int64 + type: integer + has_highlight_enabled: + default: true + deprecated: true + description: >- + (Deprecated) Whether or not scanned events are highlighted in Logs + or RUM for the org. + type: boolean + has_multi_pass_enabled: + deprecated: true + description: (Deprecated) Whether or not scanned events have multi-pass enabled. + type: boolean + is_pci_compliant: + description: >- + Whether or not the org is compliant to the payment card industry + standard. + type: boolean + version: + description: Version of the API. + example: 0 + format: int64 + minimum: 0 + type: integer + type: object + SensitiveDataScannerReorderConfig: + description: Data related to the reordering of scanning groups. + properties: + id: + description: ID of the configuration. + type: string + relationships: + $ref: '#/components/schemas/SensitiveDataScannerConfigurationRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerConfigurationType' + type: object + SensitiveDataScannerMetaVersionOnly: + description: Meta payload containing information about the API. + properties: + version: + description: Version of the API (optional). + example: 0 + format: int64 + minimum: 0 + type: integer + type: object + SensitiveDataScannerGroupCreate: + description: Data related to the creation of a group. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerGroupAttributes' + relationships: + $ref: '#/components/schemas/SensitiveDataScannerGroupRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerGroupType' + required: + - type + - attributes + type: object + SensitiveDataScannerGroupResponse: + description: Response data related to the creation of a group. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerGroupAttributes' + id: + description: ID of the group. + type: string + relationships: + $ref: '#/components/schemas/SensitiveDataScannerGroupRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerGroupType' + type: object + SensitiveDataScannerGroupUpdate: + description: Data related to the update of a group. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerGroupAttributes' + id: + description: ID of the group. + type: string + relationships: + $ref: '#/components/schemas/SensitiveDataScannerGroupRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerGroupType' + type: object + SensitiveDataScannerRuleCreate: + description: Data related to the creation of a rule. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerRuleAttributes' + relationships: + $ref: '#/components/schemas/SensitiveDataScannerRuleRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerRuleType' + required: + - type + - attributes + - relationships + type: object + SensitiveDataScannerRuleResponse: + description: Response data related to the creation of a rule. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerRuleAttributes' + id: + description: ID of the rule. + type: string + relationships: + $ref: '#/components/schemas/SensitiveDataScannerRuleRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerRuleType' + type: object + SensitiveDataScannerRuleUpdate: + description: Data related to the update of a rule. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerRuleAttributes' + id: + description: ID of the rule. + type: string + relationships: + $ref: '#/components/schemas/SensitiveDataScannerRuleRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerRuleType' + type: object + SensitiveDataScannerStandardPatternsResponse: + description: List Standard patterns response. + items: + $ref: '#/components/schemas/SensitiveDataScannerStandardPatternsResponseItem' + type: array + HistoricalJobResponseData: + description: Historical job response data. + properties: + attributes: + $ref: '#/components/schemas/HistoricalJobResponseAttributes' + id: + description: ID of the job. + type: string + type: + $ref: '#/components/schemas/HistoricalJobDataType' + type: object + HistoricalJobListMeta: + description: Metadata about the list of jobs. + properties: + totalCount: + description: Number of jobs in the list. + format: int32 + maximum: 2147483647 + type: integer + type: object + RunHistoricalJobRequestData: + description: Data for running a historical job request. + properties: + attributes: + $ref: '#/components/schemas/RunHistoricalJobRequestAttributes' + type: + $ref: '#/components/schemas/RunHistoricalJobRequestDataType' + type: object + JobCreateResponseData: + description: The definition of `JobCreateResponseData` object. + properties: + id: + description: ID of the created job. + type: string + type: + $ref: '#/components/schemas/HistoricalJobDataType' + type: object + ConvertJobResultsToSignalsData: + description: Data for converting historical job results to signals. + properties: + attributes: + $ref: '#/components/schemas/ConvertJobResultsToSignalsAttributes' + type: + $ref: '#/components/schemas/ConvertJobResultsToSignalsDataType' + type: object + AwsScanOptionsAttributes: + description: Attributes for the AWS scan options. + properties: + lambda: + description: Indicates if scanning of Lambda functions is enabled. + example: true + type: boolean + sensitive_data: + description: Indicates if scanning for sensitive data is enabled. + example: false + type: boolean + vuln_containers_os: + description: Indicates if scanning for vulnerabilities in containers is enabled. + example: true + type: boolean + vuln_host_os: + description: Indicates if scanning for vulnerabilities in hosts is enabled. + example: true + type: boolean + type: object + AwsScanOptionsType: + default: aws_scan_options + description: The type of the resource. The value should always be `aws_scan_options`. + enum: + - aws_scan_options + example: aws_scan_options + type: string + x-enum-varnames: + - AWS_SCAN_OPTIONS + AwsScanOptionsCreateAttributes: + description: Attributes for the AWS scan options to create. + properties: + lambda: + description: Indicates if scanning of Lambda functions is enabled. + example: true + type: boolean + sensitive_data: + description: Indicates if scanning for sensitive data is enabled. + example: false + type: boolean + vuln_containers_os: + description: Indicates if scanning for vulnerabilities in containers is enabled. + example: true + type: boolean + vuln_host_os: + description: Indicates if scanning for vulnerabilities in hosts is enabled. + example: true + type: boolean + required: + - lambda + - sensitive_data + - vuln_containers_os + - vuln_host_os + type: object + AwsAccountId: + description: The ID of the AWS account. + example: '123456789012' + type: string + AwsScanOptionsUpdateAttributes: + description: Attributes for the AWS scan options to update. + properties: + lambda: + description: Indicates if scanning of Lambda functions is enabled. + example: true + type: boolean + sensitive_data: + description: Indicates if scanning for sensitive data is enabled. + example: false + type: boolean + vuln_containers_os: + description: Indicates if scanning for vulnerabilities in containers is enabled. + example: true + type: boolean + vuln_host_os: + description: Indicates if scanning for vulnerabilities in hosts is enabled. + example: true + type: boolean + type: object + AwsOnDemandAttributes: + description: Attributes for the AWS on demand task. + properties: + arn: + description: The arn of the resource to scan. + example: arn:aws:ec2:us-east-1:727000456123:instance/i-0eabb50529b67a1ba + type: string + assigned_at: + description: >- + Specifies the assignment timestamp if the task has been already + assigned to a scanner. + example: '2025-02-11T18:25:04.550564Z' + type: string + created_at: + description: The task submission timestamp. + example: '2025-02-11T18:13:24.576915Z' + type: string + status: + description: >- + Indicates the status of the task. + + QUEUED: the task has been submitted successfully and the resource + has not been assigned to a scanner yet. + + ASSIGNED: the task has been assigned. + + ABORTED: the scan has been aborted after a period of time due to + technical reasons, such as resource not found, insufficient + permissions, or the absence of a configured scanner. + example: QUEUED + type: string + type: object + AwsOnDemandType: + default: aws_resource + description: >- + The type of the on demand task. The value should always be + `aws_resource`. + enum: + - aws_resource + example: aws_resource + type: string + x-enum-varnames: + - AWS_RESOURCE + AwsOnDemandCreateAttributes: + description: Attributes for the AWS on demand task. + properties: + arn: + description: >- + The arn of the resource to scan. Agentless supports the scan of EC2 + instances, lambda functions, AMI, ECR, RDS and S3 buckets. + example: arn:aws:ec2:us-east-1:727000456123:instance/i-0eabb50529b67a1ba + type: string + required: + - arn + type: object + CustomFrameworkDataAttributes: + description: Framework Data Attributes. + properties: + description: + description: Framework Description + type: string + handle: + description: Framework Handle + example: sec2 + type: string + icon_url: + description: Framework Icon URL + type: string + name: + description: Framework Name + example: security-framework + type: string + requirements: + description: Framework Requirements + items: + $ref: '#/components/schemas/CustomFrameworkRequirement' + type: array + version: + description: Framework Version + example: '2' + type: string + required: + - handle + - version + - name + - requirements + type: object + CustomFrameworkType: + default: custom_framework + description: The type of the resource. The value must be `custom_framework`. + enum: + - custom_framework + example: custom_framework + type: string + x-enum-varnames: + - CUSTOM_FRAMEWORK + CustomFrameworkDataHandleAndVersion: + description: Framework Handle and Version. + properties: + handle: + description: Framework Handle + example: sec2 + type: string + version: + description: Framework Version + example: '2' + type: string + type: object + CustomFrameworkWithoutRequirements: + description: Framework without requirements. + properties: + description: + description: Framework Description + example: this is a security description + type: string + handle: + description: Framework Handle + example: sec2 + type: string + icon_url: + description: Framework Icon URL + example: https://example.com/icon.png + type: string + name: + description: Framework Name + example: security-framework + type: string + version: + description: Framework Version + example: '2' + type: string + required: + - handle + - version + - name + type: object + FullCustomFrameworkDataAttributes: + description: Full Framework Data Attributes. + properties: + handle: + description: Framework Handle + example: sec2 + type: string + icon_url: + description: Framework Icon URL + example: https://example.com/icon.png + type: string + name: + description: Framework Name + example: security-framework + type: string + requirements: + description: Framework Requirements + items: + $ref: '#/components/schemas/CustomFrameworkRequirement' + type: array + version: + description: Framework Version + example: '2' + type: string + required: + - handle + - version + - name + - requirements + type: object + ResourceFilterAttributes: + description: Attributes of a resource filter. + example: + aws: + '123456789': + - environment:production + - team:devops + azure: + sub-001: + - app:frontend + gcp: + project-abc: + - region:us-central1 + properties: + cloud_provider: + additionalProperties: + additionalProperties: + items: + description: Tag filter in format "key:value" + example: environment:production + type: string + type: array + type: object + description: >- + A map of cloud provider names (e.g., "aws", "gcp", "azure") to a map + of account/resource IDs and their associated tag filters. + type: object + uuid: + description: The UUID of the resource filter. + type: string + required: + - cloud_provider + type: object + ResourceFilterRequestType: + description: Constant string to identify the request type. + enum: + - csm_resource_filter + example: csm_resource_filter + type: string + x-enum-varnames: + - CSM_RESOURCE_FILTER + CsmAgentsAttributes: + description: A CSM Agent returned by the API. + properties: + agent_version: + description: Version of the Datadog Agent. + type: string + aws_fargate: + description: AWS Fargate details. + type: string + cluster_name: + description: List of cluster names associated with the Agent. + items: + type: string + type: array + datadog_agent: + description: Unique identifier for the Datadog Agent. + type: string + ecs_fargate_task_arn: + description: ARN of the ECS Fargate task. + type: string + envs: + description: List of environments associated with the Agent. + items: + type: string + nullable: true + type: array + host_id: + description: ID of the host. + format: int64 + type: integer + hostname: + description: Name of the host. + type: string + install_method_installer_version: + description: Version of the installer used for installing the Datadog Agent. + type: string + install_method_tool: + description: Tool used for installing the Datadog Agent. + type: string + is_csm_vm_containers_enabled: + description: Indicates if CSM VM Containers is enabled. + nullable: true + type: boolean + is_csm_vm_hosts_enabled: + description: Indicates if CSM VM Hosts is enabled. + nullable: true + type: boolean + is_cspm_enabled: + description: Indicates if CSPM is enabled. + nullable: true + type: boolean + is_cws_enabled: + description: Indicates if CWS is enabled. + nullable: true + type: boolean + is_cws_remote_configuration_enabled: + description: Indicates if CWS Remote Configuration is enabled. + nullable: true + type: boolean + is_remote_configuration_enabled: + description: Indicates if Remote Configuration is enabled. + nullable: true + type: boolean + os: + description: Operating system of the host. + type: string + type: object + CSMAgentsType: + default: datadog_agent + description: The type of the resource. The value should always be `datadog_agent`. + enum: + - datadog_agent + example: datadog_agent + type: string + x-enum-varnames: + - DATADOG_AGENT + CsmCloudAccountsCoverageAnalysisAttributes: + description: CSM Cloud Accounts Coverage Analysis attributes. + properties: + aws_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + azure_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + gcp_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + org_id: + description: The ID of your organization. + example: 123456 + format: int64 + type: integer + total_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + type: object + CsmHostsAndContainersCoverageAnalysisAttributes: + description: CSM Hosts and Containers Coverage Analysis attributes. + properties: + cspm_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + cws_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + org_id: + description: The ID of your organization. + example: 123456 + format: int64 + type: integer + total_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + vm_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + type: object + CsmServerlessCoverageAnalysisAttributes: + description: CSM Serverless Resources Coverage Analysis attributes. + properties: + cws_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + org_id: + description: The ID of your organization. + example: 123456 + format: int64 + type: integer + total_coverage: + $ref: '#/components/schemas/CsmCoverageAnalysis' + type: object + Finding: + description: A single finding without the message and resource configuration. + properties: + attributes: + $ref: '#/components/schemas/FindingAttributes' + id: + $ref: '#/components/schemas/FindingID' + type: + $ref: '#/components/schemas/FindingType' + type: object + ListFindingsPage: + additionalProperties: false + description: Pagination and findings count information. + properties: + cursor: + description: The cursor used to paginate requests. + example: >- + eyJhZnRlciI6IkFRQUFBWWJiaEJXQS1OY1dqUUFBQUFCQldXSmlhRUpYUVVGQlJFSktkbTlDTUdaWFRVbDNRVUUiLCJ2YWx1ZXMiOlsiY3JpdGljYWwiXX0= + type: string + total_filtered_count: + description: The total count of findings after the filter has been applied. + example: 213 + format: int64 + type: integer + type: object + BulkMuteFindingsRequestAttributes: + additionalProperties: false + description: The mute properties to be updated. + properties: + mute: + $ref: '#/components/schemas/BulkMuteFindingsRequestProperties' + required: + - mute + type: object + BulkMuteFindingsRequestMeta: + description: Meta object containing the findings to be updated. + properties: + findings: + description: Array of findings. + items: + $ref: '#/components/schemas/BulkMuteFindingsRequestMetaFindings' + type: array + type: object + FindingType: + default: finding + description: The JSON:API type for findings. + enum: + - finding + example: finding + type: string + x-enum-varnames: + - FINDING + JSONAPIErrorItemSource: + description: References to the source of the error. + properties: + header: + description: >- + A string indicating the name of a single request header which caused + the error. + example: Authorization + type: string + parameter: + description: A string indicating which URI query parameter caused the error. + example: limit + type: string + pointer: + description: >- + A JSON pointer to the value in the request document that caused the + error. + example: /data/attributes/title + type: string + type: object + DetailedFindingAttributes: + description: The JSON:API attributes of the detailed finding. + properties: + evaluation: + $ref: '#/components/schemas/FindingEvaluation' + evaluation_changed_at: + $ref: '#/components/schemas/FindingEvaluationChangedAt' + message: + description: The remediation message for this finding. + example: >- + ## Remediation + + + ### From the console + + + 1. Go to Storage Account + + 2. For each Storage Account, navigate to Data Protection + + 3. Select Set soft delete enabled and enter the number of days to + retain soft deleted data. + type: string + mute: + $ref: '#/components/schemas/FindingMute' + resource: + $ref: '#/components/schemas/FindingResource' + resource_configuration: + description: The resource configuration for this finding. + type: object + resource_discovery_date: + $ref: '#/components/schemas/FindingResourceDiscoveryDate' + resource_type: + $ref: '#/components/schemas/FindingResourceType' + rule: + $ref: '#/components/schemas/FindingRule' + status: + $ref: '#/components/schemas/FindingStatus' + tags: + $ref: '#/components/schemas/FindingTags' + type: object + FindingID: + description: The unique ID for this finding. + example: ZGVmLTAwcC1pZXJ-aS0wZjhjNjMyZDNmMzRlZTgzNw== + type: string + DetailedFindingType: + default: detailed_finding + description: >- + The JSON:API type for findings that have the message and resource + configuration. + enum: + - detailed_finding + example: detailed_finding + type: string + x-enum-varnames: + - DETAILED_FINDING + AssetAttributes: + description: The JSON:API attributes of the asset. + properties: + arch: + description: Asset architecture. + example: arm64 + type: string + environments: + description: List of environments where the asset is deployed. + example: + - staging + items: + example: staging + type: string + type: array + name: + description: Asset name. + example: github.com/DataDog/datadog-agent.git + type: string + operating_system: + $ref: '#/components/schemas/AssetOperatingSystem' + risks: + $ref: '#/components/schemas/AssetRisks' + teams: + description: List of teams that own the asset. + example: + - compute + items: + example: compute + type: string + type: array + type: + $ref: '#/components/schemas/AssetType' + version: + $ref: '#/components/schemas/AssetVersion' + required: + - name + - type + - risks + - environments + type: object + AssetEntityType: + description: The JSON:API type. + enum: + - assets + example: assets + type: string + x-enum-varnames: + - ASSETS + SBOMAttributes: + description: The JSON:API attributes of the SBOM. + properties: + bomFormat: + description: >- + Specifies the format of the BOM. This helps to identify the file as + CycloneDX since BOM do not have a filename convention nor does JSON + schema support namespaces. This value MUST be `CycloneDX`. + example: CycloneDX + type: string + components: + description: A list of software and hardware components. + items: + $ref: '#/components/schemas/SBOMComponent' + type: array + dependencies: + description: List of dependencies between components of the SBOM. + items: + $ref: '#/components/schemas/SBOMComponentDependency' + type: array + metadata: + $ref: '#/components/schemas/SBOMMetadata' + serialNumber: + description: >- + Every BOM generated has a unique serial number, even if the contents + of the BOM have not changed overt time. The serial number follows + [RFC-4122](https://datatracker.ietf.org/doc/html/rfc4122) + example: urn:uuid:f7119d2f-1vgh-24b5-91f0-12010db72da7 + type: string + specVersion: + $ref: '#/components/schemas/SpecVersion' + version: + description: It increments when a BOM is modified. The default value is 1. + example: 1 + format: int64 + type: integer + required: + - bomFormat + - specVersion + - components + - metadata + - serialNumber + - version + - dependencies + type: object + SBOMType: + description: The JSON:API type. + enum: + - sboms + example: sboms + type: string + x-enum-varnames: + - SBOMS + NotificationRuleAttributes: + description: Attributes of the notification rule. + properties: + created_at: + $ref: '#/components/schemas/Date' + created_by: + $ref: '#/components/schemas/RuleUser' + enabled: + $ref: '#/components/schemas/Enabled' + modified_at: + $ref: '#/components/schemas/Date' + modified_by: + $ref: '#/components/schemas/RuleUser' + name: + $ref: '#/components/schemas/RuleName' + selectors: + $ref: '#/components/schemas/Selectors' + targets: + $ref: '#/components/schemas/Targets' + time_aggregation: + $ref: '#/components/schemas/TimeAggregation' + version: + $ref: '#/components/schemas/Version' + required: + - created_at + - created_by + - enabled + - modified_at + - modified_by + - name + - selectors + - targets + - version + type: object + ID: + description: The ID of a notification rule. + example: aaa-bbb-ccc + type: string + NotificationRulesType: + description: The rule type associated to notification rules. + enum: + - notification_rules + example: notification_rules + type: string + x-enum-varnames: + - NOTIFICATION_RULES + CreateNotificationRuleParametersDataAttributes: + description: Attributes of the notification rule create request. + properties: + enabled: + $ref: '#/components/schemas/Enabled' + name: + $ref: '#/components/schemas/RuleName' + selectors: + $ref: '#/components/schemas/Selectors' + targets: + $ref: '#/components/schemas/Targets' + time_aggregation: + $ref: '#/components/schemas/TimeAggregation' + required: + - selectors + - name + - targets + type: object + PatchNotificationRuleParametersDataAttributes: + description: >- + Attributes of the notification rule patch request. It is required to + update the version of the rule when patching it. + properties: + enabled: + $ref: '#/components/schemas/Enabled' + name: + $ref: '#/components/schemas/RuleName' + selectors: + $ref: '#/components/schemas/Selectors' + targets: + $ref: '#/components/schemas/Targets' + time_aggregation: + $ref: '#/components/schemas/TimeAggregation' + version: + $ref: '#/components/schemas/Version' + type: object + VulnerabilityAttributes: + description: The JSON:API attributes of the vulnerability. + properties: + advisory_id: + description: Vulnerability advisory ID. + example: TRIVY-CVE-2023-0615 + type: string + code_location: + $ref: '#/components/schemas/CodeLocation' + cve_list: + description: Vulnerability CVE list. + example: + - CVE-2023-0615 + items: + example: CVE-2023-0615 + type: string + type: array + cvss: + $ref: '#/components/schemas/VulnerabilityCvss' + dependency_locations: + $ref: '#/components/schemas/VulnerabilityDependencyLocations' + description: + description: Vulnerability description. + example: >- + LDAP Injection is a security vulnerability that occurs when + untrusted user input is improperly handled and directly incorporated + into LDAP queries without appropriate sanitization or validation. + This vulnerability enables attackers to manipulate LDAP queries and + potentially gain unauthorized access, modify data, or extract + sensitive information from the directory server. By exploiting the + LDAP injection vulnerability, attackers can execute malicious + commands, bypass authentication mechanisms, and perform unauthorized + actions within the directory service. + type: string + ecosystem: + $ref: '#/components/schemas/VulnerabilityEcosystem' + exposure_time: + description: Vulnerability exposure time in seconds. + example: 5618604 + format: int64 + type: integer + first_detection: + description: >- + First detection of the vulnerability in [RFC + 3339](https://datatracker.ietf.org/doc/html/rfc3339) format + example: '2024-09-19T21:23:08.000Z' + type: string + fix_available: + description: Whether the vulnerability has a remediation or not. + example: false + type: boolean + language: + description: Vulnerability language. + example: ubuntu + type: string + last_detection: + description: >- + Last detection of the vulnerability in [RFC + 3339](https://datatracker.ietf.org/doc/html/rfc3339) format + example: '2024-09-01T21:23:08.000Z' + type: string + library: + $ref: '#/components/schemas/Library' + origin: + description: Vulnerability origin. + example: + - agentless-scanner + items: + example: agentless-scanner + type: string + type: array + remediations: + description: List of remediations. + items: + $ref: '#/components/schemas/Remediation' + type: array + repo_digests: + description: >- + Vulnerability `repo_digest` list (when the vulnerability is related + to `Image` asset). + items: + example: >- + sha256:0ae7da091191787229d321e3638e39c319a97d6e20f927d465b519d699215bf7 + type: string + type: array + risks: + $ref: '#/components/schemas/VulnerabilityRisks' + status: + $ref: '#/components/schemas/VulnerabilityStatus' + title: + description: Vulnerability title. + example: LDAP Injection + type: string + tool: + $ref: '#/components/schemas/VulnerabilityTool' + type: + $ref: '#/components/schemas/VulnerabilityType' + required: + - type + - cvss + - status + - tool + - title + - description + - cve_list + - risks + - language + - first_detection + - last_detection + - exposure_time + - remediations + - fix_available + - origin + type: object + VulnerabilityRelationships: + description: Related entities object. + properties: + affects: + $ref: '#/components/schemas/VulnerabilityRelationshipsAffects' + required: + - affects + type: object + VulnerabilitiesType: + description: The JSON:API type. + enum: + - vulnerabilities + example: vulnerabilities + type: string + x-enum-varnames: + - VULNERABILITIES + CloudWorkloadSecurityAgentRuleAttributes: + description: A Cloud Workload Security Agent rule returned by the API + properties: + actions: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActions' + agentConstraint: + description: The version of the Agent + type: string + blocking: + description: The blocking policies that the rule belongs to + items: + type: string + type: array + category: + description: The category of the Agent rule + example: Process Activity + type: string + creationAuthorUuId: + description: The ID of the user who created the rule + example: e51c9744-d158-11ec-ad23-da7ad0900002 + type: string + creationDate: + description: When the Agent rule was created, timestamp in milliseconds + example: 1624366480320 + format: int64 + type: integer + creator: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleCreatorAttributes' + defaultRule: + description: Whether the rule is included by default + example: false + type: boolean + description: + description: The description of the Agent rule + example: My Agent rule + type: string + disabled: + description: The disabled policies that the rule belongs to + items: + type: string + type: array + enabled: + description: Whether the Agent rule is enabled + example: true + type: boolean + expression: + description: The SECL expression of the Agent rule + example: exec.file.name == "sh" + type: string + filters: + description: The platforms the Agent rule is supported on + items: + type: string + type: array + monitoring: + description: The monitoring policies that the rule belongs to + items: + type: string + type: array + name: + description: The name of the Agent rule + example: my_agent_rule + type: string + product_tags: + description: The list of product tags associated with the rule + items: + type: string + type: array + updateAuthorUuId: + description: The ID of the user who updated the rule + example: e51c9744-d158-11ec-ad23-da7ad0900002 + type: string + updateDate: + description: Timestamp in milliseconds when the Agent rule was last updated + example: 1624366480320 + format: int64 + type: integer + updatedAt: + description: When the Agent rule was last updated, timestamp in milliseconds + example: 1624366480320 + format: int64 + type: integer + updater: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleUpdaterAttributes' + version: + description: The version of the Agent rule + example: 23 + format: int64 + type: integer + type: object + CloudWorkloadSecurityAgentRuleType: + default: agent_rule + description: The type of the resource, must always be `agent_rule` + enum: + - agent_rule + example: agent_rule + type: string + x-enum-varnames: + - AGENT_RULE + CloudWorkloadSecurityAgentRuleCreateAttributes: + description: Create a new Cloud Workload Security Agent rule. + properties: + actions: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActions' + blocking: + description: The blocking policies that the rule belongs to + items: + type: string + type: array + description: + description: The description of the Agent rule. + example: My Agent rule + type: string + disabled: + description: The disabled policies that the rule belongs to + items: + type: string + type: array + enabled: + description: Whether the Agent rule is enabled + example: true + type: boolean + expression: + description: The SECL expression of the Agent rule. + example: exec.file.name == "sh" + type: string + filters: + description: The platforms the Agent rule is supported on + items: + type: string + type: array + monitoring: + description: The monitoring policies that the rule belongs to + items: + type: string + type: array + name: + description: The name of the Agent rule. + example: my_agent_rule + type: string + policy_id: + description: The ID of the policy where the Agent rule is saved + example: a8c8e364-6556-434d-b798-a4c23de29c0b + type: string + product_tags: + description: The list of product tags associated with the rule + items: + type: string + type: array + required: + - name + - expression + type: object + CloudWorkloadSecurityAgentRuleUpdateAttributes: + description: Update an existing Cloud Workload Security Agent rule + properties: + actions: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActions' + blocking: + description: The blocking policies that the rule belongs to + items: + type: string + type: array + description: + description: The description of the Agent rule + example: My Agent rule + type: string + disabled: + description: The disabled policies that the rule belongs to + items: + type: string + type: array + enabled: + description: Whether the Agent rule is enabled + example: true + type: boolean + expression: + description: The SECL expression of the Agent rule + example: exec.file.name == "sh" + type: string + monitoring: + description: The monitoring policies that the rule belongs to + items: + type: string + type: array + policy_id: + description: The ID of the policy where the Agent rule is saved + example: a8c8e364-6556-434d-b798-a4c23de29c0b + type: string + product_tags: + description: The list of product tags associated with the rule + items: + type: string + type: array + type: object + CloudWorkloadSecurityAgentRuleID: + description: The ID of the Agent rule + example: 3dd-0uc-h1s + type: string + SecurityFilterAttributes: + description: The object describing a security filter. + properties: + exclusion_filters: + description: The list of exclusion filters applied in this security filter. + items: + $ref: '#/components/schemas/SecurityFilterExclusionFilterResponse' + type: array + filtered_data_type: + $ref: '#/components/schemas/SecurityFilterFilteredDataType' + is_builtin: + description: Whether the security filter is the built-in filter. + example: false + type: boolean + is_enabled: + description: Whether the security filter is enabled. + example: false + type: boolean + name: + description: The security filter name. + example: Custom security filter + type: string + query: + description: >- + The security filter query. Logs accepted by this query will be + accepted by this filter. + example: service:api + type: string + version: + description: The version of the security filter. + example: 1 + format: int32 + maximum: 2147483647 + type: integer + type: object + SecurityFilterID: + description: The ID of the security filter. + example: 3dd-0uc-h1s + type: string + SecurityFilterType: + default: security_filters + description: The type of the resource. The value should always be `security_filters`. + enum: + - security_filters + example: security_filters + type: string + x-enum-varnames: + - SECURITY_FILTERS + SecurityFilterCreateAttributes: + description: Object containing the attributes of the security filter to be created. + properties: + exclusion_filters: + description: Exclusion filters to exclude some logs from the security filter. + example: + - name: Exclude staging + query: source:staging + items: + $ref: '#/components/schemas/SecurityFilterExclusionFilter' + type: array + filtered_data_type: + $ref: '#/components/schemas/SecurityFilterFilteredDataType' + is_enabled: + description: Whether the security filter is enabled. + example: true + type: boolean + name: + description: The name of the security filter. + example: Custom security filter + type: string + query: + description: The query of the security filter. + example: service:api + type: string + required: + - name + - query + - exclusion_filters + - filtered_data_type + - is_enabled + type: object + SecurityFilterUpdateAttributes: + description: The security filters properties to be updated. + properties: + exclusion_filters: + description: Exclusion filters to exclude some logs from the security filter. + example: [] + items: + $ref: '#/components/schemas/SecurityFilterExclusionFilter' + type: array + filtered_data_type: + $ref: '#/components/schemas/SecurityFilterFilteredDataType' + is_enabled: + description: Whether the security filter is enabled. + example: true + type: boolean + name: + description: The name of the security filter. + example: Custom security filter + type: string + query: + description: The query of the security filter. + example: service:api + type: string + version: + description: The version of the security filter to update. + example: 1 + format: int32 + maximum: 2147483647 + type: integer + type: object + SecurityMonitoringSuppressionAttributes: + description: The attributes of the suppression rule. + properties: + creation_date: + description: >- + A Unix millisecond timestamp given the creation date of the + suppression rule. + format: int64 + type: integer + creator: + $ref: '#/components/schemas/SecurityMonitoringUser' + data_exclusion_query: + description: >- + An exclusion query on the input data of the security rules, which + could be logs, Agent events, or other types of data based on the + security rule. Events matching this query are ignored by any + detection rules referenced in the suppression rule. + example: source:cloudtrail account_id:12345 + type: string + description: + description: A description for the suppression rule. + example: This rule suppresses low-severity signals in staging environments. + type: string + editable: + description: Whether the suppression rule is editable. + example: true + type: boolean + enabled: + description: Whether the suppression rule is enabled. + example: true + type: boolean + expiration_date: + description: >- + A Unix millisecond timestamp giving an expiration date for the + suppression rule. After this date, it won't suppress signals + anymore. + example: 1703187336000 + format: int64 + type: integer + name: + description: The name of the suppression rule. + example: Custom suppression + type: string + rule_query: + description: >- + The rule query of the suppression rule, with the same syntax as the + search bar for detection rules. + example: type:log_detection source:cloudtrail + type: string + start_date: + description: >- + A Unix millisecond timestamp giving the start date for the + suppression rule. After this date, it starts suppressing signals. + example: 1703187336000 + format: int64 + type: integer + suppression_query: + description: >- + The suppression query of the suppression rule. If a signal matches + this query, it is suppressed and not triggered. Same syntax as the + queries to search signals in the signal explorer. + example: env:staging status:low + type: string + update_date: + description: >- + A Unix millisecond timestamp given the update date of the + suppression rule. + format: int64 + type: integer + updater: + $ref: '#/components/schemas/SecurityMonitoringUser' + version: + description: >- + The version of the suppression rule; it starts at 1, and is + incremented at each update. + example: 42 + format: int32 + maximum: 2147483647 + type: integer + type: object + SecurityMonitoringSuppressionID: + description: The ID of the suppression rule. + example: 3dd-0uc-h1s + type: string + SecurityMonitoringSuppressionType: + default: suppressions + description: The type of the resource. The value should always be `suppressions`. + enum: + - suppressions + example: suppressions + type: string + x-enum-varnames: + - SUPPRESSIONS + SecurityMonitoringSuppressionCreateAttributes: + description: Object containing the attributes of the suppression rule to be created. + properties: + data_exclusion_query: + description: >- + An exclusion query on the input data of the security rules, which + could be logs, Agent events, or other types of data based on the + security rule. Events matching this query are ignored by any + detection rules referenced in the suppression rule. + example: source:cloudtrail account_id:12345 + type: string + description: + description: A description for the suppression rule. + example: This rule suppresses low-severity signals in staging environments. + type: string + enabled: + description: Whether the suppression rule is enabled. + example: true + type: boolean + expiration_date: + description: >- + A Unix millisecond timestamp giving an expiration date for the + suppression rule. After this date, it won't suppress signals + anymore. + example: 1703187336000 + format: int64 + type: integer + name: + description: The name of the suppression rule. + example: Custom suppression + type: string + rule_query: + description: >- + The rule query of the suppression rule, with the same syntax as the + search bar for detection rules. + example: type:log_detection source:cloudtrail + type: string + start_date: + description: >- + A Unix millisecond timestamp giving the start date for the + suppression rule. After this date, it starts suppressing signals. + example: 1703187336000 + format: int64 + type: integer + suppression_query: + description: >- + The suppression query of the suppression rule. If a signal matches + this query, it is suppressed and is not triggered. It uses the same + syntax as the queries to search signals in the Signals Explorer. + example: env:staging status:low + type: string + required: + - name + - enabled + - rule_query + type: object + SecurityMonitoringRuleCaseCreate: + description: Case when signal is generated. + properties: + actions: + description: Action to perform for each rule case. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseAction' + type: array + condition: + description: >- + A case contains logical operations (`>`,`>=`, `&&`, `||`) to + determine if a signal should be generated + + based on the event counts in the previously defined queries. + type: string + name: + description: Name of the case. + type: string + notifications: + description: Notification targets. + items: + description: Notification. + type: string + type: array + status: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + required: + - status + type: object + SecurityMonitoringStandardRuleQuery: + description: Query for matching rule. + properties: + aggregation: + $ref: '#/components/schemas/SecurityMonitoringRuleQueryAggregation' + customQueryExtension: + description: Query extension to append to the logs query. + example: a > 3 + type: string + dataSource: + $ref: '#/components/schemas/SecurityMonitoringStandardDataSource' + distinctFields: + description: Field for which the cardinality is measured. Sent as an array. + items: + description: Field. + type: string + type: array + groupByFields: + description: Fields to group by. + items: + description: Field. + type: string + type: array + hasOptionalGroupByFields: + default: false + description: >- + When false, events without a group-by value are ignored by the rule. + When true, events with missing group-by fields are processed with + `N/A`, replacing the missing values. + example: false + type: boolean + index: + description: >- + **This field is currently unstable and might be removed in a minor + version upgrade.** + + The index to run the query on, if the `dataSource` is `logs`. Only + used for scheduled rules - in other words, when the + `schedulingOptions` field is present in the rule payload. + type: string + metric: + deprecated: true + description: >- + (Deprecated) The target field to aggregate over when using the sum + or max + + aggregations. `metrics` field should be used instead. + type: string + metrics: + description: >- + Group of target fields to aggregate over when using the sum, max, + geo data, or new value aggregations. The sum, max, and geo data + aggregations only accept one value in this list, whereas the new + value aggregation accepts up to five values. + items: + description: Field. + type: string + type: array + name: + description: Name of the query. + type: string + query: + description: Query to run on logs. + example: a > 3 + type: string + type: object + SecurityMonitoringThirdPartyRuleCaseCreate: + description: Case when a signal is generated by a third party rule. + properties: + name: + description: Name of the case. + type: string + notifications: + description: Notification targets for each case. + items: + description: Notification. + type: string + type: array + query: + description: A query to map a third party event to this case. + type: string + status: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + required: + - status + type: object + SecurityMonitoringRuleTypeCreate: + description: The rule type. + enum: + - api_security + - application_security + - log_detection + - workload_security + type: string + x-enum-varnames: + - API_SECURITY + - APPLICATION_SECURITY + - LOG_DETECTION + - WORKLOAD_SECURITY + SecurityMonitoringSignalRuleQuery: + description: Query for matching rule on signals. + properties: + aggregation: + $ref: '#/components/schemas/SecurityMonitoringRuleQueryAggregation' + correlatedByFields: + description: Fields to group by. + items: + description: Field. + type: string + type: array + correlatedQueryIndex: + description: Index of the rule query used to retrieve the correlated field. + format: int32 + maximum: 9 + type: integer + metrics: + description: Group of target fields to aggregate over. + items: + description: Field. + type: string + type: array + name: + description: Name of the query. + type: string + ruleId: + description: Rule ID to match on signals. + example: org-ru1-e1d + type: string + required: + - ruleId + type: object + SecurityMonitoringSignalRuleType: + description: The rule type. + enum: + - signal_correlation + type: string + x-enum-varnames: + - SIGNAL_CORRELATION + CloudConfigurationRuleCaseCreate: + description: Description of signals. + properties: + notifications: + description: Notification targets for each rule case. + items: + description: Notification. + type: string + type: array + status: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + required: + - status + type: object + CloudConfigurationRuleOptions: + description: Options on cloud configuration rules. + properties: + complianceRuleOptions: + $ref: '#/components/schemas/CloudConfigurationComplianceRuleOptions' + required: + - complianceRuleOptions + type: object + CloudConfigurationRuleType: + description: The rule type. + enum: + - cloud_configuration + type: string + x-enum-varnames: + - CLOUD_CONFIGURATION + SecurityMonitoringSuppressionUpdateAttributes: + description: The suppression rule properties to be updated. + properties: + data_exclusion_query: + description: >- + An exclusion query on the input data of the security rules, which + could be logs, Agent events, or other types of data based on the + security rule. Events matching this query are ignored by any + detection rules referenced in the suppression rule. + example: source:cloudtrail account_id:12345 + type: string + description: + description: A description for the suppression rule. + example: This rule suppresses low-severity signals in staging environments. + type: string + enabled: + description: Whether the suppression rule is enabled. + example: true + type: boolean + expiration_date: + description: >- + A Unix millisecond timestamp giving an expiration date for the + suppression rule. After this date, it won't suppress signals + anymore. If unset, the expiration date of the suppression rule is + left untouched. If set to `null`, the expiration date is removed. + example: 1703187336000 + format: int64 + nullable: true + type: integer + name: + description: The name of the suppression rule. + example: Custom suppression + type: string + rule_query: + description: >- + The rule query of the suppression rule, with the same syntax as the + search bar for detection rules. + example: type:log_detection source:cloudtrail + type: string + start_date: + description: >- + A Unix millisecond timestamp giving the start date for the + suppression rule. After this date, it starts suppressing signals. If + unset, the start date of the suppression rule is left untouched. If + set to `null`, the start date is removed. + example: 1703187336000 + format: int64 + nullable: true + type: integer + suppression_query: + description: >- + The suppression query of the suppression rule. If a signal matches + this query, it is suppressed and not triggered. Same syntax as the + queries to search signals in the signal explorer. + example: env:staging status:low + type: string + version: + description: >- + The current version of the suppression. This is optional, but it can + help prevent concurrent modifications. + format: int32 + maximum: 2147483647 + type: integer + type: object + Pagination: + description: Pagination object. + properties: + total_count: + description: Total count. + format: int64 + type: integer + total_filtered_count: + description: Total count of elements matched by the filter. + format: int64 + type: integer + type: object + SecurityMonitoringRuleTypeRead: + description: The rule type. + enum: + - log_detection + - infrastructure_configuration + - workload_security + - cloud_configuration + - application_security + - api_security + type: string + x-enum-varnames: + - LOG_DETECTION + - INFRASTRUCTURE_CONFIGURATION + - WORKLOAD_SECURITY + - CLOUD_CONFIGURATION + - APPLICATION_SECURITY + - API_SECURITY + SecurityMonitoringSignalRuleResponseQuery: + description: Query for matching rule on signals. + properties: + aggregation: + $ref: '#/components/schemas/SecurityMonitoringRuleQueryAggregation' + correlatedByFields: + description: Fields to correlate by. + items: + description: Field. + type: string + type: array + correlatedQueryIndex: + description: Index of the rule query used to retrieve the correlated field. + format: int32 + maximum: 9 + type: integer + defaultRuleId: + description: Default Rule ID to match on signals. + example: d3f-ru1-e1d + type: string + distinctFields: + description: Field for which the cardinality is measured. Sent as an array. + items: + description: Field. + type: string + type: array + groupByFields: + description: Fields to group by. + items: + description: Field. + type: string + type: array + metrics: + description: Group of target fields to aggregate over. + items: + description: Field. + type: string + type: array + name: + description: Name of the query. + type: string + ruleId: + description: Rule ID to match on signals. + example: org-ru1-e1d + type: string + type: object + SecurityMonitoringStandardRuleTestPayload: + description: The payload of a rule to test + properties: + calculatedFields: + description: >- + Calculated fields. Only allowed for scheduled rules - in other + words, when schedulingOptions is also defined. + items: + $ref: '#/components/schemas/CalculatedField' + type: array + cases: + description: Cases for generating signals. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseCreate' + type: array + filters: + description: >- + Additional queries to filter matched events before they are + processed. This field is deprecated for log detection, signal + correlation, and workload security rules. + items: + $ref: '#/components/schemas/SecurityMonitoringFilter' + type: array + groupSignalsBy: + description: >- + Additional grouping to perform on top of the existing groups in the + query section. Must be a subset of the existing groups. + example: + - service + items: + description: Field to group by. + type: string + type: array + hasExtendedTitle: + description: >- + Whether the notifications include the triggering group-by values in + their title. + example: true + type: boolean + isEnabled: + description: Whether the rule is enabled. + example: true + type: boolean + message: + description: Message for generated signals. + example: '' + type: string + name: + description: The name of the rule. + example: My security monitoring rule. + type: string + options: + $ref: '#/components/schemas/SecurityMonitoringRuleOptions' + queries: + description: Queries for selecting logs which are part of the rule. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringStandardRuleQuery' + type: array + referenceTables: + description: Reference tables for the rule. + items: + $ref: '#/components/schemas/SecurityMonitoringReferenceTable' + type: array + schedulingOptions: + $ref: '#/components/schemas/SecurityMonitoringSchedulingOptions' + tags: + description: Tags for generated signals. + example: + - env:prod + - team:security + items: + description: Tag. + type: string + type: array + thirdPartyCases: + description: >- + Cases for generating signals from third-party rules. Only available + for third-party rules. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCaseCreate' + type: array + type: + $ref: '#/components/schemas/SecurityMonitoringRuleTypeTest' + required: + - name + - isEnabled + - queries + - options + - cases + - message + type: object + SecurityMonitoringRuleQueryPayloadData: + additionalProperties: {} + description: Payload used to test the rule query. + properties: + ddsource: + description: Source of the payload. + example: nginx + type: string + ddtags: + description: Tags associated with your data. + example: env:staging,version:5.1 + type: string + hostname: + description: The name of the originating host of the log. + example: i-012345678 + type: string + message: + description: The message of the payload. + example: 2019-11-19T14:37:58,995 INFO [process.name][20081] Hello World + type: string + service: + description: The name of the application or service generating the data. + example: payment + type: string + type: object + SecurityMonitoringRuleCaseAction: + description: >- + Action to perform when a signal is triggered. Only available for + Application Security rule type. + properties: + options: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseActionOptions' + type: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseActionType' + type: object + SecurityMonitoringRuleSeverity: + description: Severity of the Security Signal. + enum: + - info + - low + - medium + - high + - critical + example: critical + type: string + x-enum-varnames: + - INFO + - LOW + - MEDIUM + - HIGH + - CRITICAL + SecurityMonitoringFilterAction: + description: The type of filtering action. + enum: + - require + - suppress + type: string + x-enum-varnames: + - REQUIRE + - SUPPRESS + CloudConfigurationComplianceRuleOptions: + additionalProperties: {} + description: > + Options for cloud_configuration rules. + + Fields `resourceType` and `regoRule` are mandatory when managing custom + `cloud_configuration` rules. + properties: + complexRule: + description: > + Whether the rule is a complex one. + + Must be set to true if `regoRule.resourceTypes` contains more than + one item. Defaults to false. + type: boolean + regoRule: + $ref: '#/components/schemas/CloudConfigurationRegoRule' + resourceType: + description: > + Main resource type to be checked by the rule. It should be specified + again in `regoRule.resourceTypes`. + example: aws_acm + type: string + type: object + SecurityMonitoringRuleDecreaseCriticalityBasedOnEnv: + description: >- + If true, signals in non-production environments have a lower severity + than what is defined by the rule case, which can reduce signal noise. + + The severity is decreased by one level: `CRITICAL` in production becomes + `HIGH` in non-production, `HIGH` becomes `MEDIUM` and so on. `INFO` + remains `INFO`. + + The decrement is applied when the environment tag of the signal starts + with `staging`, `test` or `dev`. + example: false + type: boolean + SecurityMonitoringRuleDetectionMethod: + description: The detection method. + enum: + - threshold + - new_value + - anomaly_detection + - impossible_travel + - hardcoded + - third_party + - anomaly_threshold + type: string + x-enum-varnames: + - THRESHOLD + - NEW_VALUE + - ANOMALY_DETECTION + - IMPOSSIBLE_TRAVEL + - HARDCODED + - THIRD_PARTY + - ANOMALY_THRESHOLD + SecurityMonitoringRuleEvaluationWindow: + description: >- + A time window is specified to match when at least one of the cases + matches true. This is a sliding window + + and evaluates in real time. For third party detection method, this field + is not used. + enum: + - 0 + - 60 + - 300 + - 600 + - 900 + - 1800 + - 3600 + - 7200 + - 10800 + - 21600 + - 43200 + - 86400 + format: int32 + type: integer + x-enum-varnames: + - ZERO_MINUTES + - ONE_MINUTE + - FIVE_MINUTES + - TEN_MINUTES + - FIFTEEN_MINUTES + - THIRTY_MINUTES + - ONE_HOUR + - TWO_HOURS + - THREE_HOURS + - SIX_HOURS + - TWELVE_HOURS + - ONE_DAY + SecurityMonitoringRuleHardcodedEvaluatorType: + description: Hardcoded evaluator type. + enum: + - log4shell + type: string + x-enum-varnames: + - LOG4SHELL + SecurityMonitoringRuleImpossibleTravelOptions: + description: Options on impossible travel detection method. + properties: + baselineUserLocations: + $ref: >- + #/components/schemas/SecurityMonitoringRuleImpossibleTravelOptionsBaselineUserLocations + type: object + SecurityMonitoringRuleKeepAlive: + description: >- + Once a signal is generated, the signal will remain "open" if a case is + matched at least once within + + this keep alive window. For third party detection method, this field is + not used. + enum: + - 0 + - 60 + - 300 + - 600 + - 900 + - 1800 + - 3600 + - 7200 + - 10800 + - 21600 + - 43200 + - 86400 + format: int32 + type: integer + x-enum-varnames: + - ZERO_MINUTES + - ONE_MINUTE + - FIVE_MINUTES + - TEN_MINUTES + - FIFTEEN_MINUTES + - THIRTY_MINUTES + - ONE_HOUR + - TWO_HOURS + - THREE_HOURS + - SIX_HOURS + - TWELVE_HOURS + - ONE_DAY + SecurityMonitoringRuleMaxSignalDuration: + description: >- + A signal will "close" regardless of the query being matched once the + time exceeds the maximum duration. + + This time is calculated from the first seen timestamp. + enum: + - 0 + - 60 + - 300 + - 600 + - 900 + - 1800 + - 3600 + - 7200 + - 10800 + - 21600 + - 43200 + - 86400 + format: int32 + type: integer + x-enum-varnames: + - ZERO_MINUTES + - ONE_MINUTE + - FIVE_MINUTES + - TEN_MINUTES + - FIFTEEN_MINUTES + - THIRTY_MINUTES + - ONE_HOUR + - TWO_HOURS + - THREE_HOURS + - SIX_HOURS + - TWELVE_HOURS + - ONE_DAY + SecurityMonitoringRuleNewValueOptions: + description: Options on new value detection method. + properties: + forgetAfter: + $ref: >- + #/components/schemas/SecurityMonitoringRuleNewValueOptionsForgetAfter + learningDuration: + $ref: >- + #/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningDuration + learningMethod: + $ref: >- + #/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningMethod + learningThreshold: + $ref: >- + #/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningThreshold + type: object + SecurityMonitoringRuleThirdPartyOptions: + description: Options on third party detection method. + properties: + defaultNotifications: + description: >- + Notification targets for the logs that do not correspond to any of + the cases. + items: + description: Notification. + type: string + type: array + defaultStatus: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + rootQueries: + description: >- + Queries to be combined with third party case queries. Each of them + can have different group by fields, to aggregate differently based + on the type of alert. + items: + $ref: '#/components/schemas/SecurityMonitoringThirdPartyRootQuery' + type: array + signalTitleTemplate: + description: >- + A template for the signal title; if omitted, the title is generated + based on the case name. + type: string + type: object + RuleVersionHistory: + description: Response object containing the version history of a rule. + properties: + count: + description: The number of rule versions. + format: int32 + maximum: 2147483647 + type: integer + data: + additionalProperties: + $ref: '#/components/schemas/RuleVersions' + description: A rule version with a list of updates. + description: The `RuleVersionHistory` `data`. + type: object + type: object + GetRuleVersionHistoryDataType: + description: Type of data. + enum: + - GetRuleVersionHistoryResponse + type: string + x-enum-varnames: + - GETRULEVERSIONHISTORYRESPONSE + SecurityMonitoringSignalAttributes: + additionalProperties: {} + description: |- + The object containing all signal attributes and their + associated values. + properties: + custom: + additionalProperties: {} + description: A JSON object of attributes in the security signal. + example: + workflow: + first_seen: '2020-06-23T14:46:01.000Z' + last_seen: '2020-06-23T14:46:49.000Z' + rule: + id: 0f5-e0c-805 + name: 'Brute Force Attack Grouped By User ' + version: 12 + type: object + message: + description: >- + The message in the security signal defined by the rule that + generated the signal. + example: Detect Account Take Over (ATO) through brute force attempts + type: string + tags: + description: An array of tags associated with the security signal. + example: + - security:attack + - technique:T1110-brute-force + items: + description: The tag associated with the security signal. + type: string + type: array + timestamp: + description: The timestamp of the security signal. + example: '2019-01-02T09:42:36.320Z' + format: date-time + type: string + type: object + SecurityMonitoringSignalType: + default: signal + description: The type of event. + enum: + - signal + example: signal + type: string + x-enum-varnames: + - SIGNAL + SecurityMonitoringSignalsListResponseMetaPage: + description: Paging attributes. + properties: + after: + description: >- + The cursor used to get the next results, if any. To make the next + request, use the same + + parameters with the addition of the `page[cursor]`. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + SecurityMonitoringSignalAssigneeUpdateAttributes: + description: Attributes describing the new assignee of a security signal. + properties: + assignee: + $ref: '#/components/schemas/SecurityMonitoringTriageUser' + version: + $ref: '#/components/schemas/SecurityMonitoringSignalVersion' + required: + - assignee + type: object + SecurityMonitoringSignalTriageAttributes: + description: >- + Attributes describing a triage state update operation over a security + signal. + properties: + archive_comment: + $ref: '#/components/schemas/SecurityMonitoringSignalArchiveComment' + archive_comment_timestamp: + description: Timestamp of the last edit to the comment. + format: int64 + minimum: 0 + type: integer + archive_comment_user: + $ref: '#/components/schemas/SecurityMonitoringTriageUser' + archive_reason: + $ref: '#/components/schemas/SecurityMonitoringSignalArchiveReason' + assignee: + $ref: '#/components/schemas/SecurityMonitoringTriageUser' + incident_ids: + $ref: '#/components/schemas/SecurityMonitoringSignalIncidentIds' + state: + $ref: '#/components/schemas/SecurityMonitoringSignalState' + state_update_timestamp: + description: Timestamp of the last update to the signal state. + format: int64 + minimum: 0 + type: integer + state_update_user: + $ref: '#/components/schemas/SecurityMonitoringTriageUser' + required: + - assignee + - state + - incident_ids + type: object + SecurityMonitoringSignalMetadataType: + default: signal_metadata + description: The type of event. + enum: + - signal_metadata + example: signal_metadata + type: string + x-enum-varnames: + - SIGNAL_METADATA + SecurityMonitoringSignalIncidentsUpdateAttributes: + description: >- + Attributes describing the new list of related signals for a security + signal. + properties: + incident_ids: + $ref: '#/components/schemas/SecurityMonitoringSignalIncidentIds' + version: + $ref: '#/components/schemas/SecurityMonitoringSignalVersion' + required: + - incident_ids + type: object + SecurityMonitoringSignalStateUpdateAttributes: + description: Attributes describing the change of state of a security signal. + properties: + archive_comment: + $ref: '#/components/schemas/SecurityMonitoringSignalArchiveComment' + archive_reason: + $ref: '#/components/schemas/SecurityMonitoringSignalArchiveReason' + state: + $ref: '#/components/schemas/SecurityMonitoringSignalState' + version: + $ref: '#/components/schemas/SecurityMonitoringSignalVersion' + required: + - state + type: object + SensitiveDataScannerConfigurationRelationships: + description: Relationships of the configuration. + properties: + groups: + $ref: '#/components/schemas/SensitiveDataScannerGroupList' + type: object + SensitiveDataScannerConfigurationType: + default: sensitive_data_scanner_configuration + description: Sensitive Data Scanner configuration type. + enum: + - sensitive_data_scanner_configuration + example: sensitive_data_scanner_configuration + type: string + x-enum-varnames: + - SENSITIVE_DATA_SCANNER_CONFIGURATIONS + SensitiveDataScannerGetConfigIncludedItem: + description: An object related to the configuration. + oneOf: + - $ref: '#/components/schemas/SensitiveDataScannerRuleIncludedItem' + - $ref: '#/components/schemas/SensitiveDataScannerGroupIncludedItem' + SensitiveDataScannerGroupAttributes: + description: Attributes of the Sensitive Data Scanner group. + properties: + description: + description: Description of the group. + type: string + filter: + $ref: '#/components/schemas/SensitiveDataScannerFilter' + is_enabled: + description: Whether or not the group is enabled. + type: boolean + name: + description: Name of the group. + type: string + product_list: + description: List of products the scanning group applies. + items: + $ref: '#/components/schemas/SensitiveDataScannerProduct' + type: array + samplings: + description: List of sampling rates per product type. + items: + $ref: '#/components/schemas/SensitiveDataScannerSamplings' + type: array + type: object + SensitiveDataScannerGroupRelationships: + description: Relationships of the group. + properties: + configuration: + $ref: '#/components/schemas/SensitiveDataScannerConfigurationData' + rules: + $ref: '#/components/schemas/SensitiveDataScannerRuleData' + type: object + SensitiveDataScannerGroupType: + default: sensitive_data_scanner_group + description: Sensitive Data Scanner group type. + enum: + - sensitive_data_scanner_group + example: sensitive_data_scanner_group + type: string + x-enum-varnames: + - SENSITIVE_DATA_SCANNER_GROUP + SensitiveDataScannerRuleAttributes: + description: Attributes of the Sensitive Data Scanner rule. + properties: + description: + description: Description of the rule. + type: string + excluded_namespaces: + description: >- + Attributes excluded from the scan. If namespaces is provided, it has + to be a sub-path of the namespaces array. + example: + - admin.name + items: + type: string + type: array + included_keyword_configuration: + $ref: >- + #/components/schemas/SensitiveDataScannerIncludedKeywordConfiguration + is_enabled: + description: Whether or not the rule is enabled. + type: boolean + name: + description: Name of the rule. + type: string + namespaces: + description: >- + Attributes included in the scan. If namespaces is empty or missing, + all attributes except excluded_namespaces are scanned. + + If both are missing the whole event is scanned. + example: + - admin + items: + type: string + type: array + pattern: + description: Not included if there is a relationship to a standard pattern. + type: string + priority: + description: Integer from 1 (high) to 5 (low) indicating rule issue severity. + format: int64 + maximum: 5 + minimum: 1 + type: integer + tags: + description: List of tags. + items: + type: string + type: array + text_replacement: + $ref: '#/components/schemas/SensitiveDataScannerTextReplacement' + type: object + SensitiveDataScannerRuleRelationships: + description: Relationships of a scanning rule. + properties: + group: + $ref: '#/components/schemas/SensitiveDataScannerGroupData' + standard_pattern: + $ref: '#/components/schemas/SensitiveDataScannerStandardPatternData' + type: object + SensitiveDataScannerRuleType: + default: sensitive_data_scanner_rule + description: Sensitive Data Scanner rule type. + enum: + - sensitive_data_scanner_rule + example: sensitive_data_scanner_rule + type: string + x-enum-varnames: + - SENSITIVE_DATA_SCANNER_RULE + SensitiveDataScannerStandardPatternsResponseItem: + description: Standard pattern item. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerStandardPatternAttributes' + id: + description: ID of the standard pattern. + type: string + type: + $ref: '#/components/schemas/SensitiveDataScannerStandardPatternType' + type: object + HistoricalJobResponseAttributes: + description: Historical job attributes. + properties: + createdAt: + description: Time when the job was created. + type: string + createdByHandle: + description: The handle of the user who created the job. + type: string + createdByName: + description: The name of the user who created the job. + type: string + createdFromRuleId: + description: >- + ID of the rule used to create the job (if it is created from a + rule). + type: string + jobDefinition: + $ref: '#/components/schemas/JobDefinition' + jobName: + description: Job name. + type: string + jobStatus: + description: Job status. + type: string + modifiedAt: + description: Last modification time of the job. + type: string + type: object + HistoricalJobDataType: + description: Type of payload. + enum: + - historicalDetectionsJob + type: string + x-enum-varnames: + - HISTORICALDETECTIONSJOB + RunHistoricalJobRequestAttributes: + description: Run a historical job request. + properties: + fromRule: + $ref: '#/components/schemas/JobDefinitionFromRule' + id: + description: Request ID. + type: string + jobDefinition: + $ref: '#/components/schemas/JobDefinition' + type: object + RunHistoricalJobRequestDataType: + description: Type of data. + enum: + - historicalDetectionsJobCreate + type: string + x-enum-varnames: + - HISTORICALDETECTIONSJOBCREATE + ConvertJobResultsToSignalsAttributes: + description: Attributes for converting historical job results to signals. + properties: + id: + description: Request ID. + type: string + jobResultIds: + description: Job result IDs. + example: + - '' + items: + type: string + type: array + notifications: + description: Notifications sent. + example: + - '' + items: + type: string + type: array + signalMessage: + description: Message of generated signals. + example: A large number of failed login attempts. + type: string + signalSeverity: + $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' + required: + - jobResultIds + - signalSeverity + - signalMessage + - notifications + type: object + ConvertJobResultsToSignalsDataType: + description: Type of payload. + enum: + - historicalDetectionsJobResultSignalConversion + type: string + x-enum-varnames: + - HISTORICALDETECTIONSJOBRESULTSIGNALCONVERSION + CustomFrameworkRequirement: + description: Framework Requirement. + properties: + controls: + description: Requirement Controls. + items: + $ref: '#/components/schemas/CustomFrameworkControl' + type: array + name: + description: Requirement Name. + example: criteria + type: string + required: + - name + - controls + type: object + CsmCoverageAnalysis: + description: CSM Coverage Analysis. + properties: + configured_resources_count: + description: The number of fully configured resources. + example: 8 + format: int64 + type: integer + coverage: + description: The coverage percentage. + example: 0.8 + format: double + type: number + partially_configured_resources_count: + description: The number of partially configured resources. + example: 0 + format: int64 + type: integer + total_resources_count: + description: The total number of resources. + example: 10 + format: int64 + type: integer + type: object + FindingAttributes: + description: The JSON:API attributes of the finding. + properties: + datadog_link: + $ref: '#/components/schemas/FindingDatadogLink' + description: + $ref: '#/components/schemas/FindingDescription' + evaluation: + $ref: '#/components/schemas/FindingEvaluation' + evaluation_changed_at: + $ref: '#/components/schemas/FindingEvaluationChangedAt' + external_id: + $ref: '#/components/schemas/FindingExternalId' + mute: + $ref: '#/components/schemas/FindingMute' + resource: + $ref: '#/components/schemas/FindingResource' + resource_discovery_date: + $ref: '#/components/schemas/FindingResourceDiscoveryDate' + resource_type: + $ref: '#/components/schemas/FindingResourceType' + rule: + $ref: '#/components/schemas/FindingRule' + status: + $ref: '#/components/schemas/FindingStatus' + tags: + $ref: '#/components/schemas/FindingTags' + vulnerability_type: + $ref: '#/components/schemas/FindingVulnerabilityType' + type: object + BulkMuteFindingsRequestProperties: + additionalProperties: false + description: Object containing the new mute properties of the findings. + properties: + description: + description: >- + Additional information about the reason why those findings are muted + or unmuted. This field has a maximum limit of 280 characters. + type: string + expiration_date: + description: > + The expiration date of the mute or unmute action (Unix ms). It must + be set to a value greater than the current timestamp. + + If this field is not provided, the finding will be muted or unmuted + indefinitely, which is equivalent to setting the expiration date to + 9999999999999. + example: 1778721573794 + format: int64 + type: integer + muted: + description: Whether those findings should be muted or unmuted. + example: true + type: boolean + reason: + $ref: '#/components/schemas/FindingMuteReason' + required: + - muted + - reason + type: object + BulkMuteFindingsRequestMetaFindings: + description: Finding object containing the finding information. + properties: + finding_id: + $ref: '#/components/schemas/FindingID' + type: object + FindingEvaluationChangedAt: + description: The date on which the evaluation for this finding changed (Unix ms). + example: 1678721573794 + format: int64 + minimum: 1 + type: integer + FindingMute: + additionalProperties: false + description: Information about the mute status of this finding. + properties: + description: + description: >- + Additional information about the reason why this finding is muted or + unmuted. + example: To be resolved later + type: string + expiration_date: + description: The expiration date of the mute or unmute action (Unix ms). + example: 1778721573794 + format: int64 + type: integer + muted: + description: Whether this finding is muted or unmuted. + example: true + type: boolean + reason: + $ref: '#/components/schemas/FindingMuteReason' + start_date: + description: The start of the mute period. + example: 1678721573794 + format: int64 + type: integer + uuid: + description: The ID of the user who muted or unmuted this finding. + example: e51c9744-d158-11ec-ad23-da7ad0900002 + type: string + type: object + FindingResource: + description: The resource name of this finding. + example: my_resource_name + type: string + FindingResourceDiscoveryDate: + description: The date on which the resource was discovered (Unix ms). + example: 1678721573794 + format: int64 + minimum: 1 + type: integer + FindingResourceType: + description: The resource type of this finding. + example: azure_storage_account + type: string + FindingRule: + additionalProperties: false + description: The rule that triggered this finding. + properties: + id: + description: The ID of the rule that triggered this finding. + example: dv2-jzf-41i + type: string + name: + description: The name of the rule that triggered this finding. + example: Soft delete is enabled for Azure Storage + type: string + type: object + FindingTags: + description: The tags associated with this finding. + example: + - cloud_provider:aws + - myTag:myValue + items: + description: The list of tags. + type: string + type: array + AssetOperatingSystem: + description: Asset operating system. + properties: + description: + description: Operating system version. + example: '24.04' + type: string + name: + description: Operating system name. + example: ubuntu + type: string + required: + - name + type: object + AssetRisks: + description: Asset risks. + properties: + has_access_to_sensitive_data: + description: Whether the asset has access to sensitive data or not. + example: false + type: boolean + has_privileged_access: + description: Whether the asset has privileged access or not. + example: false + type: boolean + in_production: + description: Whether the asset is in production or not. + example: false + type: boolean + is_publicly_accessible: + description: Whether the asset is publicly accessible or not. + example: false + type: boolean + under_attack: + description: Whether the asset is under attack or not. + example: false + type: boolean + required: + - in_production + type: object + AssetVersion: + description: Asset version. + properties: + first: + description: Asset first version. + example: _latest + type: string + last: + description: Asset last version. + example: _latest + type: string + type: object + SBOMComponent: + description: Software or hardware component. + properties: + bom-ref: + description: >- + An optional identifier that can be used to reference the component + elsewhere in the BOM. + example: pkg:golang/google.golang.org/grpc@1.68.1 + type: string + licenses: + description: The software licenses of the SBOM component. + items: + $ref: '#/components/schemas/SBOMComponentLicense' + type: array + name: + description: >- + The name of the component. This will often be a shortened, single + name of the component. + example: google.golang.org/grpc + type: string + properties: + description: The custom properties of the component of the SBOM. + items: + $ref: '#/components/schemas/SBOMComponentProperty' + type: array + purl: + description: >- + Specifies the package-url (purl). The purl, if specified, MUST be + valid and conform to the + [specification](https://github.com/package-url/purl-spec). + example: pkg:golang/google.golang.org/grpc@1.68.1 + type: string + supplier: + $ref: '#/components/schemas/SBOMComponentSupplier' + type: + $ref: '#/components/schemas/SBOMComponentType' + version: + description: The component version. + example: 1.68.1 + type: string + required: + - type + - name + - version + - supplier + type: object + SBOMComponentDependency: + description: The dependencies of a component of the SBOM. + properties: + dependsOn: + description: The components that are dependencies of the ref component. + items: + example: pkg:golang/google.golang.org/grpc@1.68.1 + type: string + required: + - ref + - dependsOn + type: array + ref: + description: The identifier for the related component. + example: Repository|github.com/datadog/datadog-agent + type: string + type: object + SBOMMetadata: + description: Provides additional information about a BOM. + properties: + authors: + description: List of authors of the SBOM. + items: + $ref: '#/components/schemas/SBOMMetadataAuthor' + type: array + component: + $ref: '#/components/schemas/SBOMMetadataComponent' + timestamp: + description: The timestamp of the SBOM creation. + example: '2025-07-08T07:24:53Z' + type: string + type: object + SpecVersion: + description: The version of the CycloneDX specification a BOM conforms to. + enum: + - '1.0' + - '1.1' + - '1.2' + - '1.3' + - '1.4' + - '1.5' + example: '1.5' + type: string + x-enum-varnames: + - ONE_ZERO + - ONE_ONE + - ONE_TWO + - ONE_THREE + - ONE_FOUR + - ONE_FIVE + Date: + description: Date as Unix timestamp in milliseconds. + example: 1722439510282 + format: int64 + type: integer + RuleUser: + description: User creating or modifying a rule. + properties: + handle: + description: The user handle. + example: john.doe@domain.com + type: string + name: + description: The user name. + example: John Doe + type: string + type: object + Enabled: + description: Field used to enable or disable the rule. + example: true + type: boolean + RuleName: + description: Name of the notification rule. + example: Rule 1 + type: string + Selectors: + description: >- + Selectors are used to filter security issues for which notifications + should be generated. + + Users can specify rule severities, rule types, a query to filter + security issues on tags and attributes, and the trigger source. + + Only the trigger_source field is required. + properties: + query: + $ref: '#/components/schemas/NotificationRuleQuery' + rule_types: + $ref: '#/components/schemas/RuleTypes' + severities: + description: The security rules severities to consider. + items: + $ref: '#/components/schemas/RuleSeverity' + type: array + trigger_source: + $ref: '#/components/schemas/TriggerSource' + required: + - trigger_source + type: object + Targets: + description: >- + List of recipients to notify when a notification rule is triggered. Many + different target types are supported, + + such as email addresses, Slack channels, and PagerDuty services. + + The appropriate integrations need to be properly configured to send + notifications to the specified targets. + example: + - '@john.doe@email.com' + items: + description: Recipients to notify. + type: string + type: array + TimeAggregation: + description: >- + Time aggregation period (in seconds) is used to aggregate the results of + the notification rule evaluation. + + Results are aggregated over a selected time frame using a rolling + window, which updates with each new evaluation. + + Notifications are only sent for new issues discovered during the window. + + Time aggregation is only available for vulnerability-based notification + rules. When omitted or set to 0, no aggregation + + is done. + example: 86400 + format: int64 + type: integer + Version: + description: >- + Version of the notification rule. It is updated when the rule is + modified. + example: 1 + format: int64 + type: integer + CodeLocation: + description: Code vulnerability location. + properties: + file_path: + description: Vulnerability location file path. + example: src/Class.java:100 + type: string + location: + description: Vulnerability extracted location. + example: com.example.Class:100 + type: string + method: + description: Vulnerability location method. + example: FooBar + type: string + required: + - location + type: object + VulnerabilityCvss: + description: Vulnerability severities. + properties: + base: + $ref: '#/components/schemas/CVSS' + datadog: + $ref: '#/components/schemas/CVSS' + required: + - base + - datadog + type: object + VulnerabilityDependencyLocations: + description: Static library vulnerability location. + properties: + block: + $ref: '#/components/schemas/DependencyLocation' + name: + $ref: '#/components/schemas/DependencyLocation' + version: + $ref: '#/components/schemas/DependencyLocation' + required: + - block + type: object + Library: + description: Vulnerability library. + properties: + name: + description: Vulnerability library name. + example: linux-aws-5.15 + type: string + version: + description: Vulnerability library version. + example: 5.15.0 + type: string + required: + - name + type: object + Remediation: + description: Vulnerability remediation. + properties: + auto_solvable: + description: >- + Whether the vulnerability can be resolved when recompiling the + package or not. + example: false + type: boolean + avoided_advisories: + description: Avoided advisories. + items: + $ref: '#/components/schemas/Advisory' + type: array + fixed_advisories: + description: Remediation fixed advisories. + items: + $ref: '#/components/schemas/Advisory' + type: array + library_name: + description: Library name remediating the vulnerability. + example: stdlib + type: string + library_version: + description: Library version remediating the vulnerability. + example: Upgrade to a version >= 1.20.0 + type: string + new_advisories: + description: New advisories. + items: + $ref: '#/components/schemas/Advisory' + type: array + remaining_advisories: + description: Remaining advisories. + items: + $ref: '#/components/schemas/Advisory' + type: array + type: + description: Remediation type. + example: text + type: string + required: + - type + - library_name + - library_version + - auto_solvable + - fixed_advisories + - remaining_advisories + - new_advisories + - avoided_advisories + type: object + VulnerabilityRisks: + description: Vulnerability risks. + properties: + epss: + $ref: '#/components/schemas/EPSS' + exploit_available: + description: Vulnerability public exploit availability. + example: false + type: boolean + exploit_sources: + description: Vulnerability exploit sources. + example: + - NIST + items: + example: NIST + type: string + type: array + exploitation_probability: + description: Vulnerability exploitation probability. + example: false + type: boolean + poc_exploit_available: + description: Vulnerability POC exploit availability. + example: false + type: boolean + required: + - exploitation_probability + - poc_exploit_available + - exploit_available + - exploit_sources + type: object + VulnerabilityRelationshipsAffects: + description: Relationship type. + properties: + data: + $ref: '#/components/schemas/VulnerabilityRelationshipsAffectsData' + required: + - data + type: object + CloudWorkloadSecurityAgentRuleActions: + description: The array of actions the rule can perform if triggered + items: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleAction' + nullable: true + type: array + CloudWorkloadSecurityAgentRuleCreatorAttributes: + description: The attributes of the user who created the Agent rule + properties: + handle: + description: The handle of the user + example: datadog.user@example.com + type: string + name: + description: The name of the user + example: Datadog User + nullable: true + type: string + type: object + CloudWorkloadSecurityAgentRuleUpdaterAttributes: + description: The attributes of the user who last updated the Agent rule + properties: + handle: + description: The handle of the user + example: datadog.user@example.com + type: string + name: + description: The name of the user + example: Datadog User + nullable: true + type: string + type: object + SecurityFilterExclusionFilterResponse: + description: A single exclusion filter. + properties: + name: + description: The exclusion filter name. + example: Exclude staging + type: string + query: + description: The exclusion filter query. + example: source:staging + type: string + type: object + SecurityFilterFilteredDataType: + description: The filtered data type. + enum: + - logs + example: logs + type: string + x-enum-varnames: + - LOGS + SecurityFilterExclusionFilter: + description: Exclusion filter for the security filter. + example: + name: Exclude staging + query: source:staging + properties: + name: + description: Exclusion filter name. + example: Exclude staging + type: string + query: + description: >- + Exclusion filter query. Logs that match this query are excluded from + the security filter. + example: source:staging + type: string + required: + - name + - query + type: object + SecurityMonitoringUser: + description: A user. + properties: + handle: + description: The handle of the user. + example: john.doe@datadoghq.com + type: string + name: + description: The name of the user. + example: John Doe + nullable: true + type: string + type: object + SecurityMonitoringRuleQueryAggregation: + description: The aggregation type. + enum: + - count + - cardinality + - sum + - max + - new_value + - geo_data + - event_count + - none + type: string + x-enum-varnames: + - COUNT + - CARDINALITY + - SUM + - MAX + - NEW_VALUE + - GEO_DATA + - EVENT_COUNT + - NONE + SecurityMonitoringStandardDataSource: + default: logs + description: Source of events, either logs, audit trail, or Datadog events. + enum: + - logs + - audit + - app_sec_spans + - spans + - security_runtime + - network + - events + example: logs + type: string + x-enum-varnames: + - LOGS + - AUDIT + - APP_SEC_SPANS + - SPANS + - SECURITY_RUNTIME + - NETWORK + - EVENTS + SecurityMonitoringRuleTypeTest: + description: The rule type. + enum: + - log_detection + type: string + x-enum-varnames: + - LOG_DETECTION + SecurityMonitoringRuleCaseActionOptions: + additionalProperties: {} + description: Options for the rule action + properties: + duration: + description: Duration of the action in seconds. 0 indicates no expiration. + example: 0 + format: int64 + minimum: 0 + type: integer + flaggedIPType: + $ref: >- + #/components/schemas/SecurityMonitoringRuleCaseActionOptionsFlaggedIPType + userBehaviorName: + $ref: >- + #/components/schemas/SecurityMonitoringRuleCaseActionOptionsUserBehaviorName + type: object + SecurityMonitoringRuleCaseActionType: + description: The action type. + enum: + - block_ip + - block_user + - user_behavior + - flag_ip + type: string + x-enum-varnames: + - BLOCK_IP + - BLOCK_USER + - USER_BEHAVIOR + - FLAG_IP + CloudConfigurationRegoRule: + description: Rule details. + properties: + policy: + description: >- + The policy written in `rego`, see: + https://www.openpolicyagent.org/docs/latest/policy-language/ + example: | + package datadog + + import data.datadog.output as dd_output + import future.keywords.contains + import future.keywords.if + import future.keywords.in + + eval(resource) = "skip" if { + # Logic that evaluates to true if the resource should be skipped + true + } else = "pass" { + # Logic that evaluates to true if the resource is compliant + true + } else = "fail" { + # Logic that evaluates to true if the resource is not compliant + true + } + + # This part remains unchanged for all rules + results contains result if { + some resource in input.resources[input.main_resource_type] + result := dd_output.format(resource, eval(resource)) + } + type: string + resourceTypes: + description: >- + List of resource types that will be evaluated upon. Must have at + least one element. + example: + - gcp_iam_service_account + - gcp_iam_policy + items: + type: string + type: array + required: + - policy + - resourceTypes + type: object + SecurityMonitoringRuleImpossibleTravelOptionsBaselineUserLocations: + description: >- + If true, signals are suppressed for the first 24 hours. In that time, + Datadog learns the user's regular + + access locations. This can be helpful to reduce noise and infer VPN + usage or credentialed API access. + example: true + type: boolean + SecurityMonitoringRuleNewValueOptionsForgetAfter: + description: The duration in days after which a learned value is forgotten. + enum: + - 1 + - 2 + - 7 + - 14 + - 21 + - 28 + format: int32 + type: integer + x-enum-varnames: + - ONE_DAY + - TWO_DAYS + - ONE_WEEK + - TWO_WEEKS + - THREE_WEEKS + - FOUR_WEEKS + SecurityMonitoringRuleNewValueOptionsLearningDuration: + default: 0 + description: >- + The duration in days during which values are learned, and after which + signals will be generated for values that + + weren't learned. If set to 0, a signal will be generated for all new + values after the first value is learned. + enum: + - 0 + - 1 + - 7 + format: int32 + type: integer + x-enum-varnames: + - ZERO_DAYS + - ONE_DAY + - SEVEN_DAYS + SecurityMonitoringRuleNewValueOptionsLearningMethod: + default: duration + description: >- + The learning method used to determine when signals should be generated + for values that weren't learned. + enum: + - duration + - threshold + type: string + x-enum-varnames: + - DURATION + - THRESHOLD + SecurityMonitoringRuleNewValueOptionsLearningThreshold: + default: 0 + description: >- + A number of occurrences after which signals will be generated for values + that weren't learned. + enum: + - 0 + - 1 + format: int32 + type: integer + x-enum-varnames: + - ZERO_OCCURRENCES + - ONE_OCCURRENCE + SecurityMonitoringThirdPartyRootQuery: + description: A query to be combined with the third party case query. + properties: + groupByFields: + description: Fields to group by. + items: + description: Field. + type: string + type: array + query: + description: Query to run on logs. + example: source:cloudtrail + type: string + type: object + RuleVersions: + description: A rule version with a list of updates. + properties: + changes: + description: A list of changes. + items: + $ref: '#/components/schemas/RuleVersionUpdate' + type: array + rule: + $ref: '#/components/schemas/SecurityMonitoringRuleResponse' + type: object + SecurityMonitoringTriageUser: + description: Object representing a given user entity. + properties: + handle: + description: The handle for this user account. + type: string + icon: + description: Gravatar icon associated to the user. + example: /path/to/matching/gravatar/icon + readOnly: true + type: string + id: + description: Numerical ID assigned by Datadog to this user account. + format: int64 + type: integer + name: + description: The name for this user account. + nullable: true + type: string + uuid: + description: UUID assigned by Datadog to this user account. + example: 773b045d-ccf8-4808-bd3b-955ef6a8c940 + type: string + required: + - uuid + type: object + SecurityMonitoringSignalVersion: + description: >- + Version of the updated signal. If server side version is higher, update + will be rejected. + format: int64 + type: integer + SecurityMonitoringSignalArchiveComment: + description: Optional comment to display on archived signals. + type: string + SecurityMonitoringSignalArchiveReason: + description: Reason a signal is archived. + enum: + - none + - false_positive + - testing_or_maintenance + - investigated_case_opened + - other + type: string + x-enum-varnames: + - NONE + - FALSE_POSITIVE + - TESTING_OR_MAINTENANCE + - INVESTIGATED_CASE_OPENED + - OTHER + SecurityMonitoringSignalIncidentIds: + description: Array of incidents that are associated with this signal. + example: + - 2066 + items: + description: >- + Public ID attribute of the incident that is associated with the + signal. + example: 2066 + format: int64 + type: integer + type: array + SecurityMonitoringSignalState: + description: The new triage state of the signal. + enum: + - open + - archived + - under_review + example: open + type: string + x-enum-varnames: + - OPEN + - ARCHIVED + - UNDER_REVIEW + SensitiveDataScannerGroupList: + description: List of groups, ordered. + properties: + data: + description: List of groups. The order is important. + items: + $ref: '#/components/schemas/SensitiveDataScannerGroupItem' + type: array + type: object + SensitiveDataScannerRuleIncludedItem: + description: A Scanning Rule included item. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerRuleAttributes' + id: + description: ID of the rule. + type: string + relationships: + $ref: '#/components/schemas/SensitiveDataScannerRuleRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerRuleType' + type: object + SensitiveDataScannerGroupIncludedItem: + description: A Scanning Group included item. + properties: + attributes: + $ref: '#/components/schemas/SensitiveDataScannerGroupAttributes' + id: + description: ID of the group. + type: string + relationships: + $ref: '#/components/schemas/SensitiveDataScannerGroupRelationships' + type: + $ref: '#/components/schemas/SensitiveDataScannerGroupType' + type: object + SensitiveDataScannerFilter: + description: Filter for the Scanning Group. + properties: + query: + description: Query to filter the events. + type: string + type: object + SensitiveDataScannerProduct: + default: logs + description: Datadog product onto which Sensitive Data Scanner can be activated. + enum: + - logs + - rum + - events + - apm + type: string + x-enum-varnames: + - LOGS + - RUM + - EVENTS + - APM + SensitiveDataScannerSamplings: + description: Sampling configurations for the Scanning Group. + properties: + product: + $ref: '#/components/schemas/SensitiveDataScannerProduct' + rate: + description: Rate at which data in product type will be scanned, as a percentage. + example: 100 + format: double + maximum: 100 + minimum: 0 + type: number + type: object + SensitiveDataScannerConfigurationData: + description: A Sensitive Data Scanner configuration data. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerConfiguration' + type: object + SensitiveDataScannerRuleData: + description: Rules included in the group. + properties: + data: + description: Rules included in the group. The order is important. + items: + $ref: '#/components/schemas/SensitiveDataScannerRule' + type: array + type: object + SensitiveDataScannerIncludedKeywordConfiguration: + description: >- + Object defining a set of keywords and a number of characters that help + reduce noise. + + You can provide a list of keywords you would like to check within a + defined proximity of the matching pattern. + + If any of the keywords are found within the proximity check, the match + is kept. + + If none are found, the match is discarded. + properties: + character_count: + description: >- + The number of characters behind a match detected by Sensitive Data + Scanner to look for the keywords defined. + + `character_count` should be greater than the maximum length of a + keyword defined for a rule. + example: 30 + format: int64 + maximum: 50 + minimum: 1 + type: integer + keywords: + description: >- + Keyword list that will be checked during scanning in order to + validate a match. + + The number of keywords in the list must be less than or equal to 30. + example: + - credit card + - cc + items: + type: string + type: array + use_recommended_keywords: + description: >- + Should the rule use the underlying standard pattern keyword + configuration. If set to `true`, the rule must be tied + + to a standard pattern. If set to `false`, the specified keywords and + `character_count` are applied. + type: boolean + required: + - keywords + - character_count + type: object + SensitiveDataScannerTextReplacement: + description: Object describing how the scanned event will be replaced. + properties: + number_of_chars: + description: |- + Required if type == 'partial_replacement_from_beginning' + or 'partial_replacement_from_end'. It must be > 0. + format: int64 + minimum: 0 + type: integer + replacement_string: + description: Required if type == 'replacement_string'. + type: string + should_save_match: + description: >- + Only valid when type == `replacement_string`. When enabled, matches + can be unmasked in logs by users with ‘Data Scanner Unmask’ + permission. As a security best practice, avoid masking for + highly-sensitive, long-lived data. + type: boolean + type: + $ref: '#/components/schemas/SensitiveDataScannerTextReplacementType' + type: object + SensitiveDataScannerGroupData: + description: A scanning group data. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerGroup' + type: object + SensitiveDataScannerStandardPatternData: + description: A standard pattern. + properties: + data: + $ref: '#/components/schemas/SensitiveDataScannerStandardPattern' + type: object + SensitiveDataScannerStandardPatternAttributes: + description: Attributes of the Sensitive Data Scanner standard pattern. + properties: + description: + description: Description of the standard pattern. + type: string + included_keywords: + description: List of included keywords. + items: + type: string + type: array + name: + description: Name of the standard pattern. + type: string + pattern: + deprecated: true + description: >- + (Deprecated) Regex to match, optionally documented for older + standard rules. Refer to the `description` field to understand what + the rule does. + type: string + priority: + description: >- + Integer from 1 (high) to 5 (low) indicating standard pattern issue + severity. + format: int64 + maximum: 5 + minimum: 1 + type: integer + tags: + description: List of tags. + items: + type: string + type: array + type: object + SensitiveDataScannerStandardPatternType: + default: sensitive_data_scanner_standard_pattern + description: Sensitive Data Scanner standard pattern type. + enum: + - sensitive_data_scanner_standard_pattern + example: sensitive_data_scanner_standard_pattern + type: string + x-enum-varnames: + - SENSITIVE_DATA_SCANNER_STANDARD_PATTERN + JobDefinition: + description: Definition of a historical job. + properties: + calculatedFields: + description: Calculated fields. + items: + $ref: '#/components/schemas/CalculatedField' + type: array + cases: + description: Cases used for generating job results. + items: + $ref: '#/components/schemas/SecurityMonitoringRuleCaseCreate' + type: array + from: + description: Starting time of data analyzed by the job. + example: 1729843470000 + format: int64 + type: integer + groupSignalsBy: + description: >- + Additional grouping to perform on top of the existing groups in the + query section. Must be a subset of the existing groups. + example: + - service + items: + description: Field to group by. + type: string + type: array + index: + description: Index used to load the data. + example: cloud_siem + type: string + message: + description: Message for generated results. + example: A large number of failed login attempts. + type: string + name: + description: Job name. + example: Excessive number of failed attempts. + type: string + options: + $ref: '#/components/schemas/HistoricalJobOptions' + queries: + description: Queries for selecting logs analyzed by the job. + items: + $ref: '#/components/schemas/HistoricalJobQuery' + type: array + referenceTables: + description: Reference tables used in the queries. + items: + $ref: '#/components/schemas/SecurityMonitoringReferenceTable' + type: array + tags: + description: Tags for generated signals. + items: + type: string + type: array + thirdPartyCases: + description: >- + Cases for generating results from third-party detection method. Only + available for third-party detection method. + example: [] + items: + $ref: '#/components/schemas/SecurityMonitoringThirdPartyRuleCaseCreate' + type: array + to: + description: Ending time of data analyzed by the job. + example: 1729847070000 + format: int64 + type: integer + type: + description: Job type. + type: string + required: + - from + - to + - index + - name + - cases + - queries + - message + type: object + JobDefinitionFromRule: + description: Definition of a historical job based on a security monitoring rule. + properties: + from: + description: Starting time of data analyzed by the job. + example: 1729843470000 + format: int64 + type: integer + id: + description: ID of the detection rule used to create the job. + example: abc-def-ghi + type: string + index: + description: Index used to load the data. + example: cloud_siem + type: string + notifications: + description: Notifications sent when the job is completed. + example: + - '@sns-cloudtrail-results' + items: + type: string + type: array + to: + description: Ending time of data analyzed by the job. + example: 1729847070000 + format: int64 + type: integer + required: + - id + - from + - to + - index + type: object + CustomFrameworkControl: + description: Framework Control. + properties: + name: + description: Control Name. + example: A1.2 + type: string + rules_id: + description: Rule IDs. + example: + - '["def-000-abc"]' + items: + type: string + type: array + required: + - name + - rules_id + type: object + FindingDatadogLink: + description: The Datadog relative link for this finding. + example: >- + /security/compliance?panels=cpfinding%7Cevent%7CruleId%3Adef-000-u5t%7CresourceId%3Ae8c9ab7c52ebd7bf2fdb4db641082d7d%7CtabId%3Aoverview + type: string + FindingDescription: + description: The description and remediation steps for this finding. + example: >- + ## Remediation + + + 1. In the console, go to **Storage Account**. + + 2. For each Storage Account, navigate to **Data Protection**. + + 3. Select **Set soft delete enabled** and enter the number of days to + retain soft deleted data. + type: string + FindingExternalId: + description: The cloud-based ID for the resource related to the finding. + example: arn:aws:s3:::my-example-bucket + type: string + FindingMuteReason: + description: The reason why this finding is muted or unmuted. + enum: + - PENDING_FIX + - FALSE_POSITIVE + - ACCEPTED_RISK + - NO_PENDING_FIX + - HUMAN_ERROR + - NO_LONGER_ACCEPTED_RISK + - OTHER + example: ACCEPTED_RISK + type: string + x-enum-varnames: + - PENDING_FIX + - FALSE_POSITIVE + - ACCEPTED_RISK + - NO_PENDING_FIX + - HUMAN_ERROR + - NO_LONGER_ACCEPTED_RISK + - OTHER + SBOMComponentLicense: + description: The software license of the component of the SBOM. + properties: + license: + $ref: '#/components/schemas/SBOMComponentLicenseLicense' + required: + - license + type: object + SBOMComponentProperty: + description: The custom property of the component of the SBOM. + properties: + name: + description: The name of the custom property of the component of the SBOM. + example: license_type + type: string + value: + description: The value of the custom property of the component of the SBOM. + example: permissive + type: string + required: + - name + - value + type: object + SBOMComponentSupplier: + description: The supplier of the component. + properties: + name: + description: Identifier of the supplier of the component. + example: https://go.dev + type: string + required: + - name + type: object + SBOMComponentType: + description: The SBOM component type + enum: + - application + - container + - data + - device + - device-driver + - file + - firmware + - framework + - library + - machine-learning-model + - operating-system + - platform + example: application + type: string + x-enum-varnames: + - APPLICATION + - CONTAINER + - DATA + - DEVICE + - DEVICE_DRIVER + - FILE + - FIRMWARE + - FRAMEWORK + - LIBRARY + - MACHINE_LEARNING_MODEL + - OPERATING_SYSTEM + - PLATFORM + SBOMMetadataAuthor: + description: Author of the SBOM. + properties: + name: + description: The identifier of the Author of the SBOM. + example: Datadog, Inc. + type: string + type: object + SBOMMetadataComponent: + description: The component that the BOM describes. + properties: + name: + description: >- + The name of the component. This will often be a shortened, single + name of the component. + example: github.com/datadog/datadog-agent + type: string + type: + description: Specifies the type of the component. + example: application + type: string + type: object + NotificationRuleQuery: + description: >- + The query is composed of one or several key:value pairs, which can be + used to filter security issues on tags and attributes. + example: (source:production_service OR env:prod) + type: string + RuleTypes: + description: Security rule types used as filters in security rules. + example: + - misconfiguration + - attack_path + items: + $ref: '#/components/schemas/RuleTypesItems' + type: array + RuleSeverity: + description: Severity of a security rule. + enum: + - critical + - high + - medium + - low + - unknown + - info + example: critical + type: string + x-enum-varnames: + - CRITICAL + - HIGH + - MEDIUM + - LOW + - UNKNOWN + - INFO + TriggerSource: + description: >- + The type of security issues on which the rule applies. Notification + rules based on security signals need to use the trigger source + "security_signals", + + while notification rules based on security vulnerabilities need to use + the trigger source "security_findings". + enum: + - security_findings + - security_signals + example: security_findings + type: string + x-enum-varnames: + - SECURITY_FINDINGS + - SECURITY_SIGNALS + CVSS: + description: Vulnerability severity. + properties: + score: + description: Vulnerability severity score. + example: 4.5 + format: double + type: number + severity: + $ref: '#/components/schemas/VulnerabilitySeverity' + vector: + description: Vulnerability CVSS vector. + example: CVSS:3.0/AV:L/AC:L/PR:L/UI:N/S:U/C:N/I:N/A:H + type: string + required: + - score + - severity + - vector + type: object + DependencyLocation: + description: Static library vulnerability location. + properties: + column_end: + description: Location column end. + example: 140 + format: int64 + type: integer + column_start: + description: Location column start. + example: 5 + format: int64 + type: integer + file_name: + description: Location file name. + example: src/go.mod + type: string + line_end: + description: Location line end. + example: 10 + format: int64 + type: integer + line_start: + description: Location line start. + example: 1 + format: int64 + type: integer + required: + - file_name + - line_start + - line_end + - column_start + - column_end + type: object + Advisory: + description: Advisory. + properties: + base_severity: + description: Advisory base severity. + example: Critical + type: string + id: + description: Advisory id. + example: GHSA-4wrc-f8pq-fpqp + type: string + severity: + description: Advisory Datadog severity. + example: Medium + type: string + required: + - id + - base_severity + type: object + EPSS: + description: Vulnerability EPSS severity. + properties: + score: + description: Vulnerability EPSS severity score. + example: 0.2 + format: double + type: number + severity: + $ref: '#/components/schemas/VulnerabilitySeverity' + required: + - score + - severity + type: object + VulnerabilityRelationshipsAffectsData: + description: Asset affected by this vulnerability. + properties: + id: + description: The unique ID for this related asset. + example: Repository|github.com/DataDog/datadog-agent.git + type: string + type: + $ref: '#/components/schemas/AssetEntityType' + required: + - id + - type + type: object + CloudWorkloadSecurityAgentRuleAction: + description: The action the rule can perform if triggered + properties: + filter: + description: SECL expression used to target the container to apply the action on + type: string + hash: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActionHash' + kill: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleKill' + metadata: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActionMetadata' + set: + $ref: '#/components/schemas/CloudWorkloadSecurityAgentRuleActionSet' + type: object + SecurityMonitoringRuleCaseActionOptionsFlaggedIPType: + description: >- + Used with the case action of type 'flag_ip'. The value specified in this + field is applied as a flag to the IP addresses. + enum: + - SUSPICIOUS + - FLAGGED + example: FLAGGED + type: string + x-enum-varnames: + - SUSPICIOUS + - FLAGGED + SecurityMonitoringRuleCaseActionOptionsUserBehaviorName: + description: >- + Used with the case action of type 'user_behavior'. The value specified + in this field is applied as a risk tag to all users affected by the + rule. + type: string + RuleVersionUpdate: + description: A change in a rule version. + properties: + change: + description: The new value of the field. + example: cloud_provider:aws + type: string + field: + description: The field that was changed. + example: Tags + type: string + type: + $ref: '#/components/schemas/RuleVersionUpdateType' + type: object + SensitiveDataScannerGroupItem: + description: Data related to a Sensitive Data Scanner Group. + properties: + id: + description: ID of the group. + type: string + type: + $ref: '#/components/schemas/SensitiveDataScannerGroupType' + type: object + SensitiveDataScannerConfiguration: + description: A Sensitive Data Scanner configuration. + properties: + id: + description: ID of the configuration. + type: string + type: + $ref: '#/components/schemas/SensitiveDataScannerConfigurationType' + type: object + SensitiveDataScannerRule: + description: Rule item included in the group. + properties: + id: + description: ID of the rule. + type: string + type: + $ref: '#/components/schemas/SensitiveDataScannerRuleType' + type: object + SensitiveDataScannerTextReplacementType: + default: none + description: >- + Type of the replacement text. None means no replacement. + + hash means the data will be stubbed. replacement_string means that + + one can chose a text to replace the data. + partial_replacement_from_beginning + + allows a user to partially replace the data from the beginning, and + + partial_replacement_from_end on the other hand, allows to replace data + from + + the end. + enum: + - none + - hash + - replacement_string + - partial_replacement_from_beginning + - partial_replacement_from_end + type: string + x-enum-varnames: + - NONE + - HASH + - REPLACEMENT_STRING + - PARTIAL_REPLACEMENT_FROM_BEGINNING + - PARTIAL_REPLACEMENT_FROM_END + SensitiveDataScannerGroup: + description: A scanning group. + properties: + id: + description: ID of the group. + type: string + type: + $ref: '#/components/schemas/SensitiveDataScannerGroupType' + type: object + SensitiveDataScannerStandardPattern: + description: Data containing the standard pattern id. + properties: + id: + description: ID of the standard pattern. + type: string + type: + $ref: '#/components/schemas/SensitiveDataScannerStandardPatternType' + type: object + HistoricalJobOptions: + description: Job options. + properties: + detectionMethod: + $ref: '#/components/schemas/SecurityMonitoringRuleDetectionMethod' + evaluationWindow: + $ref: '#/components/schemas/SecurityMonitoringRuleEvaluationWindow' + impossibleTravelOptions: + $ref: '#/components/schemas/SecurityMonitoringRuleImpossibleTravelOptions' + keepAlive: + $ref: '#/components/schemas/SecurityMonitoringRuleKeepAlive' + maxSignalDuration: + $ref: '#/components/schemas/SecurityMonitoringRuleMaxSignalDuration' + newValueOptions: + $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptions' + thirdPartyRuleOptions: + $ref: '#/components/schemas/SecurityMonitoringRuleThirdPartyOptions' + type: object + HistoricalJobQuery: + description: Query for selecting logs analyzed by the historical job. + properties: + aggregation: + $ref: '#/components/schemas/SecurityMonitoringRuleQueryAggregation' + dataSource: + $ref: '#/components/schemas/SecurityMonitoringStandardDataSource' + distinctFields: + description: Field for which the cardinality is measured. Sent as an array. + items: + description: Field. + type: string + type: array + groupByFields: + description: Fields to group by. + items: + description: Field. + type: string + type: array + hasOptionalGroupByFields: + default: false + description: >- + When false, events without a group-by value are ignored by the + query. When true, events with missing group-by fields are processed + with `N/A`, replacing the missing values. + example: false + type: boolean + metrics: + description: >- + Group of target fields to aggregate over when using the sum, max, + geo data, or new value aggregations. The sum, max, and geo data + aggregations only accept one value in this list, whereas the new + value aggregation accepts up to five values. + items: + description: Field. + type: string + type: array + name: + description: Name of the query. + type: string + query: + description: Query to run on logs. + example: a > 3 + type: string + type: object + SBOMComponentLicenseLicense: + description: The software license of the component of the SBOM. + properties: + name: + description: The name of the software license of the component of the SBOM. + example: MIT + type: string + required: + - name + type: object + RuleTypesItems: + description: >- + Security rule type which can be used in security rules. + + Signal-based notification rules can filter signals based on rule types + application_security, log_detection, + + workload_security, signal_correlation, cloud_configuration and + infrastructure_configuration. + + Vulnerability-based notification rules can filter vulnerabilities based + on rule types application_code_vulnerability, + + application_library_vulnerability, attack_path, + container_image_vulnerability, identity_risk, misconfiguration, + api_security, host_vulnerability and iac_misconfiguration. + enum: + - application_security + - log_detection + - workload_security + - signal_correlation + - cloud_configuration + - infrastructure_configuration + - application_code_vulnerability + - application_library_vulnerability + - attack_path + - container_image_vulnerability + - identity_risk + - misconfiguration + - api_security + - host_vulnerability + - iac_misconfiguration + type: string + x-enum-varnames: + - APPLICATION_SECURITY + - LOG_DETECTION + - WORKLOAD_SECURITY + - SIGNAL_CORRELATION + - CLOUD_CONFIGURATION + - INFRASTRUCTURE_CONFIGURATION + - APPLICATION_CODE_VULNERABILITY + - APPLICATION_LIBRARY_VULNERABILITY + - ATTACK_PATH + - CONTAINER_IMAGE_VULNERABILITY + - IDENTITY_RISK + - MISCONFIGURATION + - API_SECURITY + - HOST_VULNERABILITY + - IAC_MISCONFIGURATION + CloudWorkloadSecurityAgentRuleActionHash: + additionalProperties: {} + description: An empty object indicating the hash action + type: object + CloudWorkloadSecurityAgentRuleKill: + description: Kill system call applied on the container matching the rule + properties: + signal: + description: Supported signals for the kill system call + type: string + type: object + CloudWorkloadSecurityAgentRuleActionMetadata: + description: The metadata action applied on the scope matching the rule + properties: + image_tag: + description: The image tag of the metadata action + type: string + service: + description: The service of the metadata action + type: string + short_image: + description: The short image of the metadata action + type: string + type: object + CloudWorkloadSecurityAgentRuleActionSet: + description: The set action applied on the scope matching the rule + properties: + append: + description: Whether the value should be appended to the field + type: boolean + field: + description: The field of the set action + type: string + name: + description: The name of the set action + type: string + scope: + description: The scope of the set action + type: string + size: + description: The size of the set action + format: int64 + type: integer + ttl: + description: The time to live of the set action + format: int64 + type: integer + value: + description: The value of the set action + type: string + type: object + RuleVersionUpdateType: + description: The type of change. + enum: + - create + - update + - delete + type: string + x-enum-varnames: + - CREATE + - UPDATE + - DELETE + responses: + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + ConflictResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + FindingsBadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: >- + Bad Request: The server cannot process the request due to invalid syntax + in the request. + FindingsForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Forbidden: Access denied' + FindingsNotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Not Found: The requested finding cannot be found.' + FindingsTooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: 'Too many requests: The rate limit set by the API has been exceeded.' + NotificationRulesList: + content: + application/json: + schema: + properties: + data: + items: + $ref: '#/components/schemas/NotificationRule' + type: array + type: object + description: The list of notification rules. + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + UnprocessableEntityResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: The server cannot process the request because it contains invalid data. + ConcurrentModificationResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Concurrent Modification + parameters: + AwsAccountId: + description: The ID of an AWS account. + example: '123456789012' + in: path + name: account_id + required: true + schema: + type: string + OnDemandTaskId: + description: The UUID of the task. + example: 6d09294c-9ad9-42fd-a759-a0c1599b4828 + in: path + name: task_id + required: true + schema: + type: string + CustomFrameworkHandle: + description: The framework handle + in: path + name: handle + required: true + schema: + type: string + CustomFrameworkVersion: + description: The framework version + in: path + name: version + required: true + schema: + type: string + ResourceFilterProvider: + description: Filter resource filters by cloud provider (e.g. aws, gcp, azure). + in: query + name: cloud_provider + required: false + schema: + type: string + ResourceFilterAccountID: + description: >- + Filter resource filters by cloud provider account ID. This parameter is + only valid when provider is specified. + in: query + name: account_id + required: false + schema: + type: string + SkipCache: + description: Skip cache for resource filters. + in: query + name: skip_cache + required: false + schema: + type: boolean + CloudWorkloadSecurityAgentRuleID: + description: The ID of the Agent rule + example: 3b5-v82-ns6 + in: path + name: agent_rule_id + required: true + schema: + type: string + SecurityFilterID: + description: The ID of the security filter. + in: path + name: security_filter_id + required: true + schema: + type: string + SecurityMonitoringRuleID: + description: The ID of the rule. + in: path + name: rule_id + required: true + schema: + type: string + SecurityMonitoringSuppressionID: + description: The ID of the suppression rule + in: path + name: suppression_id + required: true + schema: + type: string + PageSize: + description: Size for a given page. The maximum allowed value is 100. + in: query + name: page[size] + required: false + schema: + default: 10 + example: 10 + format: int64 + type: integer + PageNumber: + description: Specific page number to return. + in: query + name: page[number] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + QueryFilterSearch: + description: The search query for security signals. + example: security:attack status:high + in: query + name: filter[query] + required: false + schema: + type: string + QueryFilterFrom: + description: The minimum timestamp for requested security signals. + example: '2019-01-02T09:42:36.320Z' + in: query + name: filter[from] + required: false + schema: + format: date-time + type: string + QueryFilterTo: + description: The maximum timestamp for requested security signals. + example: '2019-01-03T09:42:36.320Z' + in: query + name: filter[to] + required: false + schema: + format: date-time + type: string + QuerySort: + description: The order of the security signals in results. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/SecurityMonitoringSignalsSort' + QueryPageCursor: + description: A list of results using the cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + in: query + name: page[cursor] + required: false + schema: + type: string + QueryPageLimit: + description: The maximum number of security signals in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 10 + format: int32 + maximum: 1000 + type: integer + SignalID: + description: The ID of the signal. + in: path + name: signal_id + required: true + schema: + type: string + SensitiveDataScannerGroupID: + description: The ID of a group of rules. + in: path + name: group_id + required: true + schema: + type: string + SensitiveDataScannerRuleID: + description: The ID of the rule. + in: path + name: rule_id + required: true + schema: + type: string + HistoricalSignalID: + description: The ID of the historical signal. + in: path + name: histsignal_id + required: true + schema: + type: string + HistoricalJobID: + description: The ID of the job. + in: path + name: job_id + required: true + schema: + type: string + x-stackQL-resources: + aws_scan_options: + id: datadog.security.aws_scan_options + name: aws_scan_options + title: Aws Scan Options + methods: + list_aws_scan_options: + operation: + $ref: '#/paths/~1api~1v2~1agentless_scanning~1accounts~1aws/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_aws_scan_options: + operation: + $ref: '#/paths/~1api~1v2~1agentless_scanning~1accounts~1aws/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_aws_scan_options: + operation: + $ref: >- + #/paths/~1api~1v2~1agentless_scanning~1accounts~1aws~1{account_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_aws_scan_options: + operation: + $ref: >- + #/paths/~1api~1v2~1agentless_scanning~1accounts~1aws~1{account_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_aws_scan_options: + operation: + $ref: >- + #/paths/~1api~1v2~1agentless_scanning~1accounts~1aws~1{account_id}/patch + response: + mediaType: application/json + openAPIDocKey: '204' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aws_scan_options/methods/get_aws_scan_options + - $ref: >- + #/components/x-stackQL-resources/aws_scan_options/methods/list_aws_scan_options + insert: + - $ref: >- + #/components/x-stackQL-resources/aws_scan_options/methods/create_aws_scan_options + update: + - $ref: >- + #/components/x-stackQL-resources/aws_scan_options/methods/update_aws_scan_options + delete: + - $ref: >- + #/components/x-stackQL-resources/aws_scan_options/methods/delete_aws_scan_options + replace: [] + aws_on_demand_tasks: + id: datadog.security.aws_on_demand_tasks + name: aws_on_demand_tasks + title: Aws On Demand Tasks + methods: + list_aws_on_demand_tasks: + operation: + $ref: '#/paths/~1api~1v2~1agentless_scanning~1ondemand~1aws/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_aws_on_demand_task: + operation: + $ref: '#/paths/~1api~1v2~1agentless_scanning~1ondemand~1aws/post' + response: + mediaType: application/json + openAPIDocKey: '201' + get_aws_on_demand_task: + operation: + $ref: >- + #/paths/~1api~1v2~1agentless_scanning~1ondemand~1aws~1{task_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/aws_on_demand_tasks/methods/get_aws_on_demand_task + - $ref: >- + #/components/x-stackQL-resources/aws_on_demand_tasks/methods/list_aws_on_demand_tasks + insert: + - $ref: >- + #/components/x-stackQL-resources/aws_on_demand_tasks/methods/create_aws_on_demand_task + update: [] + delete: [] + replace: [] + custom_frameworks: + id: datadog.security.custom_frameworks + name: custom_frameworks + title: Custom Frameworks + methods: + create_custom_framework: + operation: + $ref: >- + #/paths/~1api~1v2~1cloud_security_management~1custom_frameworks/post + response: + mediaType: application/json + openAPIDocKey: '200' + delete_custom_framework: + operation: + $ref: >- + #/paths/~1api~1v2~1cloud_security_management~1custom_frameworks~1{handle}~1{version}/delete + response: + mediaType: application/json + openAPIDocKey: '200' + get_custom_framework: + operation: + $ref: >- + #/paths/~1api~1v2~1cloud_security_management~1custom_frameworks~1{handle}~1{version}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_custom_framework: + operation: + $ref: >- + #/paths/~1api~1v2~1cloud_security_management~1custom_frameworks~1{handle}~1{version}/put + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/custom_frameworks/methods/get_custom_framework + insert: + - $ref: >- + #/components/x-stackQL-resources/custom_frameworks/methods/create_custom_framework + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/custom_frameworks/methods/delete_custom_framework + replace: + - $ref: >- + #/components/x-stackQL-resources/custom_frameworks/methods/update_custom_framework + resource_evaluation_filters: + id: datadog.security.resource_evaluation_filters + name: resource_evaluation_filters + title: Resource Evaluation Filters + methods: + get_resource_evaluation_filters: + operation: + $ref: '#/paths/~1api~1v2~1cloud_security_management~1resource_filters/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_resource_evaluation_filters: + operation: + $ref: '#/paths/~1api~1v2~1cloud_security_management~1resource_filters/put' + response: + mediaType: application/json + openAPIDocKey: '201' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/resource_evaluation_filters/methods/get_resource_evaluation_filters + insert: [] + update: [] + delete: [] + replace: + - $ref: >- + #/components/x-stackQL-resources/resource_evaluation_filters/methods/update_resource_evaluation_filters + csm_agents: + id: datadog.security.csm_agents + name: csm_agents + title: Csm Agents + methods: + list_all_csmagents: + operation: + $ref: '#/paths/~1api~1v2~1csm~1onboarding~1agents/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/csm_agents/methods/list_all_csmagents + insert: [] + update: [] + delete: [] + replace: [] + csm_cloud_accounts_coverage_analysis: + id: datadog.security.csm_cloud_accounts_coverage_analysis + name: csm_cloud_accounts_coverage_analysis + title: Csm Cloud Accounts Coverage Analysis + methods: + get_csmcloud_accounts_coverage_analysis: + operation: + $ref: >- + #/paths/~1api~1v2~1csm~1onboarding~1coverage_analysis~1cloud_accounts/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/csm_cloud_accounts_coverage_analysis/methods/get_csmcloud_accounts_coverage_analysis + insert: [] + update: [] + delete: [] + replace: [] + csm_hosts_and_containers_coverage_analysis: + id: datadog.security.csm_hosts_and_containers_coverage_analysis + name: csm_hosts_and_containers_coverage_analysis + title: Csm Hosts And Containers Coverage Analysis + methods: + get_csmhosts_and_containers_coverage_analysis: + operation: + $ref: >- + #/paths/~1api~1v2~1csm~1onboarding~1coverage_analysis~1hosts_and_containers/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/csm_hosts_and_containers_coverage_analysis/methods/get_csmhosts_and_containers_coverage_analysis + insert: [] + update: [] + delete: [] + replace: [] + csm_serverless_coverage_analysis: + id: datadog.security.csm_serverless_coverage_analysis + name: csm_serverless_coverage_analysis + title: Csm Serverless Coverage Analysis + methods: + get_csmserverless_coverage_analysis: + operation: + $ref: >- + #/paths/~1api~1v2~1csm~1onboarding~1coverage_analysis~1serverless/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/csm_serverless_coverage_analysis/methods/get_csmserverless_coverage_analysis + insert: [] + update: [] + delete: [] + replace: [] + csm_serverless_agents: + id: datadog.security.csm_serverless_agents + name: csm_serverless_agents + title: Csm Serverless Agents + methods: + list_all_csmserverless_agents: + operation: + $ref: '#/paths/~1api~1v2~1csm~1onboarding~1serverless~1agents/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/csm_serverless_agents/methods/list_all_csmserverless_agents + insert: [] + update: [] + delete: [] + replace: [] + findings: + id: datadog.security.findings + name: findings + title: Findings + methods: + list_findings: + operation: + $ref: '#/paths/~1api~1v2~1posture_management~1findings/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + mute_findings: + operation: + $ref: '#/paths/~1api~1v2~1posture_management~1findings/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + get_finding: + operation: + $ref: '#/paths/~1api~1v2~1posture_management~1findings~1{finding_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/findings/methods/get_finding' + - $ref: '#/components/x-stackQL-resources/findings/methods/list_findings' + insert: [] + update: [] + delete: [] + replace: [] + vulnerable_assets: + id: datadog.security.vulnerable_assets + name: vulnerable_assets + title: Vulnerable Assets + methods: + list_vulnerable_assets: + operation: + $ref: '#/paths/~1api~1v2~1security~1assets/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/vulnerable_assets/methods/list_vulnerable_assets + insert: [] + update: [] + delete: [] + replace: [] + cloud_workload_security_agent_rules: + id: datadog.security.cloud_workload_security_agent_rules + name: cloud_workload_security_agent_rules + title: Cloud Workload Security Agent Rules + methods: + download_cloud_workload_policy_file: + operation: + $ref: '#/paths/~1api~1v2~1security~1cloud_workload~1policy~1download/get' + response: + mediaType: application/yaml + openAPIDocKey: '200' + list_cloud_workload_security_agent_rules: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_cloud_workload_security_agent_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules/post + response: + mediaType: application/json + openAPIDocKey: '200' + delete_cloud_workload_security_agent_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules~1{agent_rule_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_cloud_workload_security_agent_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules~1{agent_rule_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_cloud_workload_security_agent_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1cloud_workload_security~1agent_rules~1{agent_rule_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/get_cloud_workload_security_agent_rule + - $ref: >- + #/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/list_cloud_workload_security_agent_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/create_cloud_workload_security_agent_rule + update: + - $ref: >- + #/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/update_cloud_workload_security_agent_rule + delete: + - $ref: >- + #/components/x-stackQL-resources/cloud_workload_security_agent_rules/methods/delete_cloud_workload_security_agent_rule + replace: [] + sboms: + id: datadog.security.sboms + name: sboms + title: Sboms + methods: + list_assets_sboms: + operation: + $ref: '#/paths/~1api~1v2~1security~1sboms/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + get_sbom: + operation: + $ref: '#/paths/~1api~1v2~1security~1sboms~1{asset_type}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/sboms/methods/get_sbom' + - $ref: '#/components/x-stackQL-resources/sboms/methods/list_assets_sboms' + insert: [] + update: [] + delete: [] + replace: [] + signal_notification_rules: + id: datadog.security.signal_notification_rules + name: signal_notification_rules + title: Signal Notification Rules + methods: + get_signal_notification_rules: + operation: + $ref: '#/paths/~1api~1v2~1security~1signals~1notification_rules/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_signal_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1security~1signals~1notification_rules/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_signal_notification_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security~1signals~1notification_rules~1{id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_signal_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1security~1signals~1notification_rules~1{id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + patch_signal_notification_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security~1signals~1notification_rules~1{id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/signal_notification_rules/methods/get_signal_notification_rule + - $ref: >- + #/components/x-stackQL-resources/signal_notification_rules/methods/get_signal_notification_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/signal_notification_rules/methods/create_signal_notification_rule + update: + - $ref: >- + #/components/x-stackQL-resources/signal_notification_rules/methods/patch_signal_notification_rule + delete: + - $ref: >- + #/components/x-stackQL-resources/signal_notification_rules/methods/delete_signal_notification_rule + replace: [] + vulnerabilities: + id: datadog.security.vulnerabilities + name: vulnerabilities + title: Vulnerabilities + methods: + list_vulnerabilities: + operation: + $ref: '#/paths/~1api~1v2~1security~1vulnerabilities/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/vulnerabilities/methods/list_vulnerabilities + insert: [] + update: [] + delete: [] + replace: [] + vulnerability_notification_rules: + id: datadog.security.vulnerability_notification_rules + name: vulnerability_notification_rules + title: Vulnerability Notification Rules + methods: + get_vulnerability_notification_rules: + operation: + $ref: >- + #/paths/~1api~1v2~1security~1vulnerabilities~1notification_rules/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_vulnerability_notification_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security~1vulnerabilities~1notification_rules/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_vulnerability_notification_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security~1vulnerabilities~1notification_rules~1{id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_vulnerability_notification_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security~1vulnerabilities~1notification_rules~1{id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + patch_vulnerability_notification_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security~1vulnerabilities~1notification_rules~1{id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/vulnerability_notification_rules/methods/get_vulnerability_notification_rule + - $ref: >- + #/components/x-stackQL-resources/vulnerability_notification_rules/methods/get_vulnerability_notification_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/vulnerability_notification_rules/methods/create_vulnerability_notification_rule + update: + - $ref: >- + #/components/x-stackQL-resources/vulnerability_notification_rules/methods/patch_vulnerability_notification_rule + delete: + - $ref: >- + #/components/x-stackQL-resources/vulnerability_notification_rules/methods/delete_vulnerability_notification_rule + replace: [] + filters: + id: datadog.security.filters + name: filters + title: Filters + methods: + list_security_filters: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_security_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters/post + response: + mediaType: application/json + openAPIDocKey: '200' + delete_security_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters~1{security_filter_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_security_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters~1{security_filter_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_security_filter: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters~1{security_filter_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/filters/methods/get_security_filter + - $ref: >- + #/components/x-stackQL-resources/filters/methods/list_security_filters + insert: + - $ref: >- + #/components/x-stackQL-resources/filters/methods/create_security_filter + update: + - $ref: >- + #/components/x-stackQL-resources/filters/methods/update_security_filter + delete: + - $ref: >- + #/components/x-stackQL-resources/filters/methods/delete_security_filter + replace: [] + monitoring_suppressions: + id: datadog.security.monitoring_suppressions + name: monitoring_suppressions + title: Monitoring Suppressions + methods: + list_security_monitoring_suppressions: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1suppressions/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_security_monitoring_suppression: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1suppressions/post + response: + mediaType: application/json + openAPIDocKey: '200' + validate_security_monitoring_suppression: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1suppressions~1validation/post + response: + mediaType: application/json + openAPIDocKey: '204' + delete_security_monitoring_suppression: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1suppressions~1{suppression_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_security_monitoring_suppression: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1suppressions~1{suppression_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_security_monitoring_suppression: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1suppressions~1{suppression_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/monitoring_suppressions/methods/get_security_monitoring_suppression + - $ref: >- + #/components/x-stackQL-resources/monitoring_suppressions/methods/list_security_monitoring_suppressions + insert: + - $ref: >- + #/components/x-stackQL-resources/monitoring_suppressions/methods/create_security_monitoring_suppression + update: + - $ref: >- + #/components/x-stackQL-resources/monitoring_suppressions/methods/update_security_monitoring_suppression + delete: + - $ref: >- + #/components/x-stackQL-resources/monitoring_suppressions/methods/delete_security_monitoring_suppression + replace: [] + suppressions_affecting_future_rule: + id: datadog.security.suppressions_affecting_future_rule + name: suppressions_affecting_future_rule + title: Suppressions Affecting Future Rule + methods: + get_suppressions_affecting_future_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1suppressions~1rules/post + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: [] + insert: + - $ref: >- + #/components/x-stackQL-resources/suppressions_affecting_future_rule/methods/get_suppressions_affecting_future_rule + update: [] + delete: [] + replace: [] + suppressions_affecting_rule: + id: datadog.security.suppressions_affecting_rule + name: suppressions_affecting_rule + title: Suppressions Affecting Rule + methods: + get_suppressions_affecting_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1configuration~1suppressions~1rules~1{rule_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/suppressions_affecting_rule/methods/get_suppressions_affecting_rule + insert: [] + update: [] + delete: [] + replace: [] + monitoring_rules: + id: datadog.security.monitoring_rules + name: monitoring_rules + title: Monitoring Rules + methods: + list_security_monitoring_rules: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1rules/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_security_monitoring_rule: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1rules/post' + response: + mediaType: application/json + openAPIDocKey: '200' + convert_security_monitoring_rule_from_jsonto_terraform: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1convert/post' + response: + mediaType: application/json + openAPIDocKey: '200' + test_security_monitoring_rule: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1test/post' + response: + mediaType: application/json + openAPIDocKey: '200' + validate_security_monitoring_rule: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1validation/post' + response: + mediaType: application/json + openAPIDocKey: '204' + delete_security_monitoring_rule: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_security_monitoring_rule: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + update_security_monitoring_rule: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + convert_existing_security_monitoring_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}~1convert/get + response: + mediaType: application/json + openAPIDocKey: '200' + test_existing_security_monitoring_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}~1test/post + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/monitoring_rules/methods/get_security_monitoring_rule + - $ref: >- + #/components/x-stackQL-resources/monitoring_rules/methods/list_security_monitoring_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/monitoring_rules/methods/create_security_monitoring_rule + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/monitoring_rules/methods/delete_security_monitoring_rule + replace: + - $ref: >- + #/components/x-stackQL-resources/monitoring_rules/methods/update_security_monitoring_rule + rule_version_history: + id: datadog.security.rule_version_history + name: rule_version_history + title: Rule Version History + methods: + get_rule_version_history: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}~1version_history/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/rule_version_history/methods/get_rule_version_history + insert: [] + update: [] + delete: [] + replace: [] + monitoring_signals: + id: datadog.security.monitoring_signals + name: monitoring_signals + title: Monitoring Signals + methods: + list_security_monitoring_signals: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1signals/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + search_security_monitoring_signals: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1signals~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + get_security_monitoring_signal: + operation: + $ref: '#/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + edit_security_monitoring_signal_assignee: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}~1assignee/patch + response: + mediaType: application/json + openAPIDocKey: '200' + edit_security_monitoring_signal_incidents: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}~1incidents/patch + response: + mediaType: application/json + openAPIDocKey: '200' + edit_security_monitoring_signal_state: + operation: + $ref: >- + #/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}~1state/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/monitoring_signals/methods/get_security_monitoring_signal + - $ref: >- + #/components/x-stackQL-resources/monitoring_signals/methods/list_security_monitoring_signals + insert: [] + update: [] + delete: [] + replace: [] + scanning_groups: + id: datadog.security.scanning_groups + name: scanning_groups + title: Scanning Groups + methods: + list_scanning_groups: + operation: + $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + reorder_scanning_groups: + operation: + $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + create_scanning_group: + operation: + $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1groups/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_scanning_group: + operation: + $ref: >- + #/paths/~1api~1v2~1sensitive-data-scanner~1config~1groups~1{group_id}/delete + response: + mediaType: application/json + openAPIDocKey: '200' + update_scanning_group: + operation: + $ref: >- + #/paths/~1api~1v2~1sensitive-data-scanner~1config~1groups~1{group_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/scanning_groups/methods/list_scanning_groups + insert: + - $ref: >- + #/components/x-stackQL-resources/scanning_groups/methods/create_scanning_group + update: + - $ref: >- + #/components/x-stackQL-resources/scanning_groups/methods/update_scanning_group + delete: + - $ref: >- + #/components/x-stackQL-resources/scanning_groups/methods/delete_scanning_group + replace: [] + scanning_rules: + id: datadog.security.scanning_rules + name: scanning_rules + title: Scanning Rules + methods: + create_scanning_rule: + operation: + $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1rules/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_scanning_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1sensitive-data-scanner~1config~1rules~1{rule_id}/delete + response: + mediaType: application/json + openAPIDocKey: '200' + update_scanning_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1sensitive-data-scanner~1config~1rules~1{rule_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: [] + insert: + - $ref: >- + #/components/x-stackQL-resources/scanning_rules/methods/create_scanning_rule + update: + - $ref: >- + #/components/x-stackQL-resources/scanning_rules/methods/update_scanning_rule + delete: + - $ref: >- + #/components/x-stackQL-resources/scanning_rules/methods/delete_scanning_rule + replace: [] + standard_patterns: + id: datadog.security.standard_patterns + name: standard_patterns + title: Standard Patterns + methods: + list_standard_patterns: + operation: + $ref: >- + #/paths/~1api~1v2~1sensitive-data-scanner~1config~1standard-patterns/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/standard_patterns/methods/list_standard_patterns + insert: [] + update: [] + delete: [] + replace: [] + monitoring_hist_signals: + id: datadog.security.monitoring_hist_signals + name: monitoring_hist_signals + title: Monitoring Hist Signals + methods: + list_security_monitoring_histsignals: + operation: + $ref: '#/paths/~1api~1v2~1siem-historical-detections~1histsignals/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + search_security_monitoring_histsignals: + operation: + $ref: >- + #/paths/~1api~1v2~1siem-historical-detections~1histsignals~1search/get + response: + mediaType: application/json + openAPIDocKey: '200' + get_security_monitoring_histsignal: + operation: + $ref: >- + #/paths/~1api~1v2~1siem-historical-detections~1histsignals~1{histsignal_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + convert_job_result_to_signal: + operation: + $ref: >- + #/paths/~1api~1v2~1siem-historical-detections~1jobs~1signal_convert/post + response: + mediaType: application/json + openAPIDocKey: '204' + get_security_monitoring_histsignals_by_job_id: + operation: + $ref: >- + #/paths/~1api~1v2~1siem-historical-detections~1jobs~1{job_id}~1histsignals/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/monitoring_hist_signals/methods/get_security_monitoring_histsignal + - $ref: >- + #/components/x-stackQL-resources/monitoring_hist_signals/methods/get_security_monitoring_histsignals_by_job_id + - $ref: >- + #/components/x-stackQL-resources/monitoring_hist_signals/methods/list_security_monitoring_histsignals + insert: [] + update: [] + delete: [] + replace: [] + historical_jobs: + id: datadog.security.historical_jobs + name: historical_jobs + title: Historical Jobs + methods: + list_historical_jobs: + operation: + $ref: '#/paths/~1api~1v2~1siem-historical-detections~1jobs/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + run_historical_job: + operation: + $ref: '#/paths/~1api~1v2~1siem-historical-detections~1jobs/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_historical_job: + operation: + $ref: >- + #/paths/~1api~1v2~1siem-historical-detections~1jobs~1{job_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_historical_job: + operation: + $ref: '#/paths/~1api~1v2~1siem-historical-detections~1jobs~1{job_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + cancel_historical_job: + operation: + $ref: >- + #/paths/~1api~1v2~1siem-historical-detections~1jobs~1{job_id}~1cancel/patch + response: + mediaType: application/json + openAPIDocKey: '204' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/historical_jobs/methods/get_historical_job + - $ref: >- + #/components/x-stackQL-resources/historical_jobs/methods/list_historical_jobs + insert: + - $ref: >- + #/components/x-stackQL-resources/historical_jobs/methods/run_historical_job + update: + - $ref: >- + #/components/x-stackQL-resources/historical_jobs/methods/cancel_historical_job + delete: + - $ref: >- + #/components/x-stackQL-resources/historical_jobs/methods/delete_historical_job + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/security_monitoring.yaml b/providers/src/datadog/v00.00.00000/services/security_monitoring.yaml deleted file mode 100644 index cc94d949..00000000 --- a/providers/src/datadog/v00.00.00000/services/security_monitoring.yaml +++ /dev/null @@ -1,3919 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - security_monitoring - description: Security_Monitoring -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - FindingEvaluation: - description: The evaluation of the finding. - enum: - - pass - - fail - example: pass - type: string - x-enum-varnames: - - PASS - - FAIL - FindingStatus: - description: The status of the finding. - enum: - - critical - - high - - medium - - low - - info - example: critical - type: string - x-enum-varnames: - - CRITICAL - - HIGH - - MEDIUM - - LOW - - INFO - ListFindingsResponse: - description: The expected response schema when listing findings. - properties: - data: - $ref: '#/components/schemas/ListFindingsData' - meta: - $ref: '#/components/schemas/ListFindingsMeta' - required: - - data - - meta - type: object - ListFindingsData: - description: Array of findings. - items: - $ref: '#/components/schemas/Finding' - type: array - ListFindingsMeta: - additionalProperties: false - description: Metadata for pagination. - properties: - page: - $ref: '#/components/schemas/ListFindingsPage' - snapshot_timestamp: - description: The point in time corresponding to the listed findings. - example: 1678721573794 - format: int64 - minimum: 1 - type: integer - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - JSONAPIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - $ref: '#/components/schemas/JSONAPIErrorItem' - type: array - required: - - errors - type: object - Finding: - description: A single finding without the message and resource configuration. - properties: - attributes: - $ref: '#/components/schemas/FindingAttributes' - id: - $ref: '#/components/schemas/FindingID' - type: - $ref: '#/components/schemas/FindingType' - type: object - ListFindingsPage: - additionalProperties: false - description: Pagination and findings count information. - properties: - cursor: - description: The cursor used to paginate requests. - example: eyJhZnRlciI6IkFRQUFBWWJiaEJXQS1OY1dqUUFBQUFCQldXSmlhRUpYUVVGQlJFSktkbTlDTUdaWFRVbDNRVUUiLCJ2YWx1ZXMiOlsiY3JpdGljYWwiXX0= - type: string - total_filtered_count: - description: The total count of findings after the filter has been applied. - example: 213 - format: int64 - type: integer - type: object - JSONAPIErrorItem: - description: API error response body - properties: - detail: - description: A human-readable explanation specific to this occurrence of the error. - example: Missing required attribute in body - type: string - status: - description: Status code of the response. - example: '400' - type: string - title: - description: Short human-readable summary of the error. - example: Bad Request - type: string - type: object - FindingAttributes: - description: 'The JSON:API attributes of the finding.' - properties: - evaluation: - $ref: '#/components/schemas/FindingEvaluation' - evaluation_changed_at: - $ref: '#/components/schemas/FindingEvaluationChangedAt' - mute: - $ref: '#/components/schemas/FindingMute' - resource: - $ref: '#/components/schemas/FindingResource' - resource_discovery_date: - $ref: '#/components/schemas/FindingResourceDiscoveryDate' - resource_type: - $ref: '#/components/schemas/FindingResourceType' - rule: - $ref: '#/components/schemas/FindingRule' - status: - $ref: '#/components/schemas/FindingStatus' - tags: - $ref: '#/components/schemas/FindingTags' - type: object - FindingID: - description: The unique ID for this finding. - example: ZGVmLTAwcC1pZXJ-aS0wZjhjNjMyZDNmMzRlZTgzNw== - type: string - FindingType: - default: finding - description: 'The JSON:API type for findings.' - enum: - - finding - example: finding - type: string - x-enum-varnames: - - FINDING - FindingEvaluationChangedAt: - description: The date on which the evaluation for this finding changed (Unix ms). - example: 1678721573794 - format: int64 - minimum: 1 - type: integer - FindingMute: - additionalProperties: false - description: Information about the mute status of this finding. - properties: - description: - description: Additional information about the reason why this finding is muted or unmuted. - example: To be resolved later - type: string - expiration_date: - description: The expiration date of the mute or unmute action (Unix ms). - example: 1778721573794 - format: int64 - type: integer - muted: - description: Whether this finding is muted or unmuted. - example: true - type: boolean - reason: - $ref: '#/components/schemas/FindingMuteReason' - start_date: - description: The start of the mute period. - example: 1678721573794 - format: int64 - type: integer - uuid: - description: The ID of the user who muted or unmuted this finding. - example: e51c9744-d158-11ec-ad23-da7ad0900002 - type: string - type: object - FindingResource: - description: The resource name of this finding. - example: my_resource_name - type: string - FindingResourceDiscoveryDate: - description: The date on which the resource was discovered (Unix ms). - example: 1678721573794 - format: int64 - minimum: 1 - type: integer - FindingResourceType: - description: The resource type of this finding. - example: azure_storage_account - type: string - FindingRule: - additionalProperties: false - description: The rule that triggered this finding. - properties: - id: - description: The ID of the rule that triggered this finding. - example: dv2-jzf-41i - type: string - name: - description: The name of the rule that triggered this finding. - example: Soft delete is enabled for Azure Storage - type: string - type: object - FindingTags: - description: The tags associated with this finding. - example: - - 'cloud_provider:aws' - - 'myTag:myValue' - items: - description: The list of tags. - type: string - type: array - FindingMuteReason: - description: The reason why this finding is muted or unmuted. - enum: - - PENDING_FIX - - FALSE_POSITIVE - - ACCEPTED_RISK - - NO_PENDING_FIX - - HUMAN_ERROR - - NO_LONGER_ACCEPTED_RISK - - OTHER - example: ACCEPTED_RISK - type: string - x-enum-varnames: - - PENDING_FIX - - FALSE_POSITIVE - - ACCEPTED_RISK - - NO_PENDING_FIX - - HUMAN_ERROR - - NO_LONGER_ACCEPTED_RISK - - OTHER - BulkMuteFindingsRequest: - description: The new bulk mute finding request. - properties: - data: - $ref: '#/components/schemas/BulkMuteFindingsRequestData' - required: - - data - type: object - BulkMuteFindingsResponse: - description: The expected response schema. - properties: - data: - $ref: '#/components/schemas/BulkMuteFindingsResponseData' - required: - - data - type: object - BulkMuteFindingsRequestData: - description: Data object containing the new bulk mute properties of the finding. - properties: - attributes: - $ref: '#/components/schemas/BulkMuteFindingsRequestAttributes' - id: - description: UUID to identify the request - example: dbe5f567-192b-4404-b908-29b70e1c9f76 - type: string - meta: - $ref: '#/components/schemas/BulkMuteFindingsRequestMeta' - type: - $ref: '#/components/schemas/FindingType' - required: - - id - - type - - attributes - - meta - type: object - BulkMuteFindingsResponseData: - description: Data object containing the ID of the request that was updated. - properties: - id: - description: UUID used to identify the request - example: 93bfeb70-af47-424d-908a-948d3f08e37f - type: string - type: - $ref: '#/components/schemas/FindingType' - type: object - BulkMuteFindingsRequestAttributes: - additionalProperties: false - description: The mute properties to be updated. - properties: - mute: - $ref: '#/components/schemas/BulkMuteFindingsRequestProperties' - required: - - mute - type: object - BulkMuteFindingsRequestMeta: - description: Meta object containing the findings to be updated. - properties: - findings: - description: Array of findings. - items: - $ref: '#/components/schemas/BulkMuteFindingsRequestMetaFindings' - type: array - type: object - BulkMuteFindingsRequestProperties: - additionalProperties: false - description: Object containing the new mute properties of the findings. - properties: - description: - description: Additional information about the reason why those findings are muted or unmuted. This field has a maximum limit of 280 characters. - type: string - expiration_date: - description: | - The expiration date of the mute or unmute action (Unix ms). It must be set to a value greater than the current timestamp. - If this field is not provided, the finding will be muted or unmuted indefinitely, which is equivalent to setting the expiration date to 9999999999999. - example: 1778721573794 - format: int64 - type: integer - muted: - description: Whether those findings should be muted or unmuted. - example: true - type: boolean - reason: - $ref: '#/components/schemas/FindingMuteReason' - required: - - muted - - reason - type: object - BulkMuteFindingsRequestMetaFindings: - description: Finding object containing the finding information. - properties: - finding_id: - $ref: '#/components/schemas/FindingID' - type: object - GetFindingResponse: - description: The expected response schema when getting a finding. - properties: - data: - $ref: '#/components/schemas/DetailedFinding' - required: - - data - type: object - DetailedFinding: - description: A single finding with with message and resource configuration. - properties: - attributes: - $ref: '#/components/schemas/DetailedFindingAttributes' - id: - $ref: '#/components/schemas/FindingID' - type: - $ref: '#/components/schemas/DetailedFindingType' - type: object - DetailedFindingAttributes: - description: 'The JSON:API attributes of the detailed finding.' - properties: - evaluation: - $ref: '#/components/schemas/FindingEvaluation' - evaluation_changed_at: - $ref: '#/components/schemas/FindingEvaluationChangedAt' - message: - description: The remediation message for this finding. - example: |- - ## Remediation - - ### From the console - - 1. Go to Storage Account - 2. For each Storage Account, navigate to Data Protection - 3. Select Set soft delete enabled and enter the number of days to retain soft deleted data. - type: string - mute: - $ref: '#/components/schemas/FindingMute' - resource: - $ref: '#/components/schemas/FindingResource' - resource_configuration: - description: The resource configuration for this finding. - type: object - resource_discovery_date: - $ref: '#/components/schemas/FindingResourceDiscoveryDate' - resource_type: - $ref: '#/components/schemas/FindingResourceType' - rule: - $ref: '#/components/schemas/FindingRule' - status: - $ref: '#/components/schemas/FindingStatus' - tags: - $ref: '#/components/schemas/FindingTags' - type: object - DetailedFindingType: - default: detailed_finding - description: 'The JSON:API type for findings that have the message and resource configuration.' - enum: - - detailed_finding - example: detailed_finding - type: string - x-enum-varnames: - - DETAILED_FINDING - SecurityFiltersResponse: - description: All the available security filters objects. - properties: - data: - description: A list of security filters objects. - items: - $ref: '#/components/schemas/SecurityFilter' - type: array - meta: - $ref: '#/components/schemas/SecurityFilterMeta' - type: object - SecurityFilter: - description: The security filter's properties. - properties: - attributes: - $ref: '#/components/schemas/SecurityFilterAttributes' - id: - $ref: '#/components/schemas/SecurityFilterID' - type: - $ref: '#/components/schemas/SecurityFilterType' - type: object - SecurityFilterMeta: - description: Optional metadata associated to the response. - properties: - warning: - description: A warning message. - example: 'All the security filters are disabled. As a result, no logs are being analyzed.' - type: string - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - SecurityFilterAttributes: - description: The object describing a security filter. - properties: - exclusion_filters: - description: The list of exclusion filters applied in this security filter. - items: - $ref: '#/components/schemas/SecurityFilterExclusionFilterResponse' - type: array - filtered_data_type: - $ref: '#/components/schemas/SecurityFilterFilteredDataType' - is_builtin: - description: Whether the security filter is the built-in filter. - example: false - type: boolean - is_enabled: - description: Whether the security filter is enabled. - example: false - type: boolean - name: - description: The security filter name. - example: Custom security filter - type: string - query: - description: The security filter query. Logs accepted by this query will be accepted by this filter. - example: 'service:api' - type: string - version: - description: The version of the security filter. - example: 1 - format: int32 - maximum: 2147483647 - type: integer - type: object - SecurityFilterID: - description: The ID of the security filter. - example: 3dd-0uc-h1s - type: string - SecurityFilterType: - default: security_filters - description: The type of the resource. The value should always be `security_filters`. - enum: - - security_filters - example: security_filters - type: string - x-enum-varnames: - - SECURITY_FILTERS - SecurityFilterExclusionFilterResponse: - description: A single exclusion filter. - properties: - name: - description: The exclusion filter name. - example: Exclude staging - type: string - query: - description: The exclusion filter query. - example: 'source:staging' - type: string - type: object - SecurityFilterFilteredDataType: - description: The filtered data type. - enum: - - logs - example: logs - type: string - x-enum-varnames: - - LOGS - SecurityFilterCreateRequest: - description: Request object that includes the security filter that you would like to create. - properties: - data: - $ref: '#/components/schemas/SecurityFilterCreateData' - required: - - data - type: object - SecurityFilterResponse: - description: Response object which includes a single security filter. - properties: - data: - $ref: '#/components/schemas/SecurityFilter' - meta: - $ref: '#/components/schemas/SecurityFilterMeta' - type: object - SecurityFilterCreateData: - description: Object for a single security filter. - properties: - attributes: - $ref: '#/components/schemas/SecurityFilterCreateAttributes' - type: - $ref: '#/components/schemas/SecurityFilterType' - required: - - type - - attributes - type: object - SecurityFilterCreateAttributes: - description: Object containing the attributes of the security filter to be created. - properties: - exclusion_filters: - description: Exclusion filters to exclude some logs from the security filter. - example: - - name: Exclude staging - query: 'source:staging' - items: - $ref: '#/components/schemas/SecurityFilterExclusionFilter' - type: array - filtered_data_type: - $ref: '#/components/schemas/SecurityFilterFilteredDataType' - is_enabled: - description: Whether the security filter is enabled. - example: true - type: boolean - name: - description: The name of the security filter. - example: Custom security filter - type: string - query: - description: The query of the security filter. - example: 'service:api' - type: string - required: - - name - - query - - exclusion_filters - - filtered_data_type - - is_enabled - type: object - SecurityFilterExclusionFilter: - description: Exclusion filter for the security filter. - example: - name: Exclude staging - query: 'source:staging' - properties: - name: - description: Exclusion filter name. - example: Exclude staging - type: string - query: - description: Exclusion filter query. Logs that match this query are excluded from the security filter. - example: 'source:staging' - type: string - required: - - name - - query - type: object - SecurityFilterUpdateRequest: - description: The new security filter body. - properties: - data: - $ref: '#/components/schemas/SecurityFilterUpdateData' - required: - - data - type: object - SecurityFilterUpdateData: - description: The new security filter properties. - properties: - attributes: - $ref: '#/components/schemas/SecurityFilterUpdateAttributes' - type: - $ref: '#/components/schemas/SecurityFilterType' - required: - - type - - attributes - type: object - SecurityFilterUpdateAttributes: - description: The security filters properties to be updated. - properties: - exclusion_filters: - description: Exclusion filters to exclude some logs from the security filter. - example: [] - items: - $ref: '#/components/schemas/SecurityFilterExclusionFilter' - type: array - filtered_data_type: - $ref: '#/components/schemas/SecurityFilterFilteredDataType' - is_enabled: - description: Whether the security filter is enabled. - example: true - type: boolean - name: - description: The name of the security filter. - example: Custom security filter - type: string - query: - description: The query of the security filter. - example: 'service:api' - type: string - version: - description: The version of the security filter to update. - example: 1 - format: int32 - maximum: 2147483647 - type: integer - type: object - SecurityMonitoringListRulesResponse: - description: List of rules. - properties: - data: - description: Array containing the list of rules. - items: - $ref: '#/components/schemas/SecurityMonitoringRuleResponse' - type: array - meta: - $ref: '#/components/schemas/ResponseMetaAttributes' - type: object - SecurityMonitoringRuleResponse: - description: Create a new rule. - oneOf: - - $ref: '#/components/schemas/SecurityMonitoringStandardRuleResponse' - - $ref: '#/components/schemas/SecurityMonitoringSignalRuleResponse' - ResponseMetaAttributes: - description: Object describing meta attributes of response. - properties: - page: - $ref: '#/components/schemas/Pagination' - type: object - SecurityMonitoringStandardRuleResponse: - description: Rule. - properties: - cases: - description: Cases for generating signals. - items: - $ref: '#/components/schemas/SecurityMonitoringRuleCase' - type: array - complianceSignalOptions: - $ref: '#/components/schemas/CloudConfigurationRuleComplianceSignalOptions' - createdAt: - description: 'When the rule was created, timestamp in milliseconds.' - format: int64 - type: integer - creationAuthorId: - description: User ID of the user who created the rule. - format: int64 - type: integer - deprecationDate: - description: 'When the rule will be deprecated, timestamp in milliseconds.' - format: int64 - type: integer - filters: - description: Additional queries to filter matched events before they are processed. - items: - $ref: '#/components/schemas/SecurityMonitoringFilter' - type: array - hasExtendedTitle: - description: Whether the notifications include the triggering group-by values in their title. - type: boolean - id: - description: The ID of the rule. - type: string - isDefault: - description: Whether the rule is included by default. - type: boolean - isDeleted: - description: Whether the rule has been deleted. - type: boolean - isEnabled: - description: Whether the rule is enabled. - type: boolean - message: - description: Message for generated signals. - type: string - name: - description: The name of the rule. - type: string - options: - $ref: '#/components/schemas/SecurityMonitoringRuleOptions' - queries: - description: Queries for selecting logs which are part of the rule. - items: - $ref: '#/components/schemas/SecurityMonitoringStandardRuleQuery' - type: array - tags: - description: Tags for generated signals. - items: - description: Tag. - type: string - type: array - type: - $ref: '#/components/schemas/SecurityMonitoringRuleTypeRead' - updateAuthorId: - description: User ID of the user who updated the rule. - format: int64 - type: integer - version: - description: The version of the rule. - format: int64 - type: integer - SecurityMonitoringSignalRuleResponse: - description: Rule. - properties: - cases: - description: Cases for generating signals. - items: - $ref: '#/components/schemas/SecurityMonitoringRuleCase' - type: array - createdAt: - description: 'When the rule was created, timestamp in milliseconds.' - format: int64 - type: integer - creationAuthorId: - description: User ID of the user who created the rule. - format: int64 - type: integer - deprecationDate: - description: 'When the rule will be deprecated, timestamp in milliseconds.' - format: int64 - type: integer - filters: - description: Additional queries to filter matched events before they are processed. - items: - $ref: '#/components/schemas/SecurityMonitoringFilter' - type: array - hasExtendedTitle: - description: Whether the notifications include the triggering group-by values in their title. - type: boolean - id: - description: The ID of the rule. - type: string - isDefault: - description: Whether the rule is included by default. - type: boolean - isDeleted: - description: Whether the rule has been deleted. - type: boolean - isEnabled: - description: Whether the rule is enabled. - type: boolean - message: - description: Message for generated signals. - type: string - name: - description: The name of the rule. - type: string - options: - $ref: '#/components/schemas/SecurityMonitoringRuleOptions' - queries: - description: Queries for selecting logs which are part of the rule. - items: - $ref: '#/components/schemas/SecurityMonitoringSignalRuleResponseQuery' - type: array - tags: - description: Tags for generated signals. - items: - description: Tag. - type: string - type: array - type: - $ref: '#/components/schemas/SecurityMonitoringSignalRuleType' - updateAuthorId: - description: User ID of the user who updated the rule. - format: int64 - type: integer - version: - description: The version of the rule. - format: int64 - type: integer - Pagination: - description: Pagination object. - properties: - total_count: - description: Total count. - format: int64 - type: integer - total_filtered_count: - description: Total count of elements matched by the filter. - format: int64 - type: integer - type: object - SecurityMonitoringRuleCase: - description: Case when signal is generated. - properties: - condition: - description: |- - A rule case contains logical operations (`>`,`>=`, `&&`, `||`) to determine if a signal should be generated - based on the event counts in the previously defined queries. - type: string - name: - description: Name of the case. - type: string - notifications: - description: Notification targets for each rule case. - items: - description: Notification. - type: string - type: array - status: - $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' - type: object - CloudConfigurationRuleComplianceSignalOptions: - description: How to generate compliance signals. Useful for cloud_configuration rules only. - properties: - defaultActivationStatus: - description: The default activation status. - nullable: true - type: boolean - defaultGroupByFields: - description: The default group by fields. - items: - type: string - nullable: true - type: array - userActivationStatus: - description: Whether signals will be sent. - nullable: true - type: boolean - userGroupByFields: - description: Fields to use to group findings by when sending signals. - items: - type: string - nullable: true - type: array - type: object - SecurityMonitoringFilter: - description: The rule's suppression filter. - properties: - action: - $ref: '#/components/schemas/SecurityMonitoringFilterAction' - query: - description: Query for selecting logs to apply the filtering action. - type: string - type: object - SecurityMonitoringRuleOptions: - description: Options on rules. - properties: - complianceRuleOptions: - $ref: '#/components/schemas/CloudConfigurationComplianceRuleOptions' - decreaseCriticalityBasedOnEnv: - $ref: '#/components/schemas/SecurityMonitoringRuleDecreaseCriticalityBasedOnEnv' - detectionMethod: - $ref: '#/components/schemas/SecurityMonitoringRuleDetectionMethod' - evaluationWindow: - $ref: '#/components/schemas/SecurityMonitoringRuleEvaluationWindow' - hardcodedEvaluatorType: - $ref: '#/components/schemas/SecurityMonitoringRuleHardcodedEvaluatorType' - impossibleTravelOptions: - $ref: '#/components/schemas/SecurityMonitoringRuleImpossibleTravelOptions' - keepAlive: - $ref: '#/components/schemas/SecurityMonitoringRuleKeepAlive' - maxSignalDuration: - $ref: '#/components/schemas/SecurityMonitoringRuleMaxSignalDuration' - newValueOptions: - $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptions' - type: object - SecurityMonitoringStandardRuleQuery: - description: Query for matching rule. - properties: - aggregation: - $ref: '#/components/schemas/SecurityMonitoringRuleQueryAggregation' - distinctFields: - description: Field for which the cardinality is measured. Sent as an array. - items: - description: Field. - type: string - type: array - groupByFields: - description: Fields to group by. - items: - description: Field. - type: string - type: array - hasOptionalGroupByFields: - description: 'When false, events without a group-by value are ignored by the rule. When true, events with missing group-by fields are processed with `N/A`, replacing the missing values.' - example: false - readOnly: true - type: boolean - metric: - deprecated: true - description: |- - (Deprecated) The target field to aggregate over when using the sum or max - aggregations. `metrics` field should be used instead. - type: string - metrics: - description: 'Group of target fields to aggregate over when using the sum, max, geo data, or new value aggregations. The sum, max, and geo data aggregations only accept one value in this list, whereas the new value aggregation accepts up to five values.' - items: - description: Field. - type: string - type: array - name: - description: Name of the query. - type: string - query: - description: Query to run on logs. - example: a > 3 - type: string - type: object - SecurityMonitoringRuleTypeRead: - description: The rule type. - enum: - - log_detection - - infrastructure_configuration - - workload_security - - cloud_configuration - - application_security - type: string - x-enum-varnames: - - LOG_DETECTION - - INFRASTRUCTURE_CONFIGURATION - - WORKLOAD_SECURITY - - CLOUD_CONFIGURATION - - APPLICATION_SECURITY - SecurityMonitoringSignalRuleResponseQuery: - description: Query for matching rule on signals. - properties: - aggregation: - $ref: '#/components/schemas/SecurityMonitoringRuleQueryAggregation' - correlatedByFields: - description: Fields to correlate by. - items: - description: Field. - type: string - type: array - correlatedQueryIndex: - description: Index of the rule query used to retrieve the correlated field. - format: int32 - maximum: 9 - type: integer - defaultRuleId: - description: Default Rule ID to match on signals. - example: d3f-ru1-e1d - type: string - distinctFields: - description: Field for which the cardinality is measured. Sent as an array. - items: - description: Field. - type: string - type: array - groupByFields: - description: Fields to group by. - items: - description: Field. - type: string - type: array - metrics: - description: Group of target fields to aggregate over. - items: - description: Field. - type: string - type: array - name: - description: Name of the query. - type: string - ruleId: - description: Rule ID to match on signals. - example: org-ru1-e1d - type: string - type: object - SecurityMonitoringSignalRuleType: - description: The rule type. - enum: - - signal_correlation - type: string - x-enum-varnames: - - SIGNAL_CORRELATION - SecurityMonitoringRuleSeverity: - description: Severity of the Security Signal. - enum: - - info - - low - - medium - - high - - critical - example: critical - type: string - x-enum-varnames: - - INFO - - LOW - - MEDIUM - - HIGH - - CRITICAL - SecurityMonitoringFilterAction: - description: The type of filtering action. - enum: - - require - - suppress - type: string - x-enum-varnames: - - REQUIRE - - SUPPRESS - CloudConfigurationComplianceRuleOptions: - additionalProperties: {} - description: | - Options for cloud_configuration rules. - Fields `resourceType` and `regoRule` are mandatory when managing custom `cloud_configuration` rules. - properties: - complexRule: - description: | - Whether the rule is a complex one. - Must be set to true if `regoRule.resourceTypes` contains more than one item. Defaults to false. - type: boolean - regoRule: - $ref: '#/components/schemas/CloudConfigurationRegoRule' - resourceType: - description: | - Main resource type to be checked by the rule. It should be specified again in `regoRule.resourceTypes`. - example: aws_acm - type: string - type: object - SecurityMonitoringRuleDecreaseCriticalityBasedOnEnv: - description: |- - If true, signals in non-production environments have a lower severity than what is defined by the rule case, which can reduce signal noise. - The severity is decreased by one level: `CRITICAL` in production becomes `HIGH` in non-production, `HIGH` becomes `MEDIUM` and so on. `INFO` remains `INFO`. - The decrement is applied when the environment tag of the signal starts with `staging`, `test` or `dev`. - example: false - type: boolean - SecurityMonitoringRuleDetectionMethod: - description: The detection method. - enum: - - threshold - - new_value - - anomaly_detection - - impossible_travel - - hardcoded - - third_party - type: string - x-enum-varnames: - - THRESHOLD - - NEW_VALUE - - ANOMALY_DETECTION - - IMPOSSIBLE_TRAVEL - - HARDCODED - - THIRD_PARTY - SecurityMonitoringRuleEvaluationWindow: - description: |- - A time window is specified to match when at least one of the cases matches true. This is a sliding window - and evaluates in real time. - enum: - - 0 - - 60 - - 300 - - 600 - - 900 - - 1800 - - 3600 - - 7200 - format: int32 - type: integer - x-enum-varnames: - - ZERO_MINUTES - - ONE_MINUTE - - FIVE_MINUTES - - TEN_MINUTES - - FIFTEEN_MINUTES - - THIRTY_MINUTES - - ONE_HOUR - - TWO_HOURS - SecurityMonitoringRuleHardcodedEvaluatorType: - description: Hardcoded evaluator type. - enum: - - log4shell - type: string - x-enum-varnames: - - LOG4SHELL - SecurityMonitoringRuleImpossibleTravelOptions: - description: Options on impossible travel rules. - properties: - baselineUserLocations: - $ref: '#/components/schemas/SecurityMonitoringRuleImpossibleTravelOptionsBaselineUserLocations' - type: object - SecurityMonitoringRuleKeepAlive: - description: |- - Once a signal is generated, the signal will remain “open” if a case is matched at least once within - this keep alive window. - enum: - - 0 - - 60 - - 300 - - 600 - - 900 - - 1800 - - 3600 - - 7200 - - 10800 - - 21600 - format: int32 - type: integer - x-enum-varnames: - - ZERO_MINUTES - - ONE_MINUTE - - FIVE_MINUTES - - TEN_MINUTES - - FIFTEEN_MINUTES - - THIRTY_MINUTES - - ONE_HOUR - - TWO_HOURS - - THREE_HOURS - - SIX_HOURS - SecurityMonitoringRuleMaxSignalDuration: - description: |- - A signal will “close” regardless of the query being matched once the time exceeds the maximum duration. - This time is calculated from the first seen timestamp. - enum: - - 0 - - 60 - - 300 - - 600 - - 900 - - 1800 - - 3600 - - 7200 - - 10800 - - 21600 - - 43200 - - 86400 - format: int32 - type: integer - x-enum-varnames: - - ZERO_MINUTES - - ONE_MINUTE - - FIVE_MINUTES - - TEN_MINUTES - - FIFTEEN_MINUTES - - THIRTY_MINUTES - - ONE_HOUR - - TWO_HOURS - - THREE_HOURS - - SIX_HOURS - - TWELVE_HOURS - - ONE_DAY - SecurityMonitoringRuleNewValueOptions: - description: Options on new value rules. - properties: - forgetAfter: - $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptionsForgetAfter' - learningDuration: - $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningDuration' - learningMethod: - $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningMethod' - learningThreshold: - $ref: '#/components/schemas/SecurityMonitoringRuleNewValueOptionsLearningThreshold' - type: object - SecurityMonitoringRuleQueryAggregation: - description: The aggregation type. - enum: - - count - - cardinality - - sum - - max - - new_value - - geo_data - - event_count - - none - type: string - x-enum-varnames: - - COUNT - - CARDINALITY - - SUM - - MAX - - NEW_VALUE - - GEO_DATA - - EVENT_COUNT - - NONE - CloudConfigurationRegoRule: - description: Rule details. - properties: - policy: - description: 'The policy written in `rego`, see: https://www.openpolicyagent.org/docs/latest/policy-language/' - example: | - package datadog - - import data.datadog.output as dd_output - import future.keywords.contains - import future.keywords.if - import future.keywords.in - - eval(resource) = "skip" if { - # Logic that evaluates to true if the resource should be skipped - true - } else = "pass" { - # Logic that evaluates to true if the resource is compliant - true - } else = "fail" { - # Logic that evaluates to true if the resource is not compliant - true - } - - # This part remains unchanged for all rules - results contains result if { - some resource in input.resources[input.main_resource_type] - result := dd_output.format(resource, eval(resource)) - } - type: string - resourceTypes: - description: List of resource types that will be evaluated upon. Must have at least one element. - example: - - gcp_iam_service_account - - gcp_iam_policy - items: - type: string - type: array - required: - - policy - - resourceTypes - type: object - SecurityMonitoringRuleImpossibleTravelOptionsBaselineUserLocations: - description: |- - If true, signals are suppressed for the first 24 hours. In that time, Datadog learns the user's regular - access locations. This can be helpful to reduce noise and infer VPN usage or credentialed API access. - example: true - type: boolean - SecurityMonitoringRuleNewValueOptionsForgetAfter: - description: The duration in days after which a learned value is forgotten. - enum: - - 1 - - 2 - - 7 - - 14 - - 21 - - 28 - format: int32 - type: integer - x-enum-varnames: - - ONE_DAY - - TWO_DAYS - - ONE_WEEK - - TWO_WEEKS - - THREE_WEEKS - - FOUR_WEEKS - SecurityMonitoringRuleNewValueOptionsLearningDuration: - default: 0 - description: |- - The duration in days during which values are learned, and after which signals will be generated for values that - weren't learned. If set to 0, a signal will be generated for all new values after the first value is learned. - enum: - - 0 - - 1 - - 7 - format: int32 - type: integer - x-enum-varnames: - - ZERO_DAYS - - ONE_DAY - - SEVEN_DAYS - SecurityMonitoringRuleNewValueOptionsLearningMethod: - default: duration - description: The learning method used to determine when signals should be generated for values that weren't learned. - enum: - - duration - - threshold - type: string - x-enum-varnames: - - DURATION - - THRESHOLD - SecurityMonitoringRuleNewValueOptionsLearningThreshold: - default: 0 - description: A number of occurrences after which signals will be generated for values that weren't learned. - enum: - - 0 - - 1 - format: int32 - type: integer - x-enum-varnames: - - ZERO_OCCURRENCES - - ONE_OCCURRENCE - SecurityMonitoringRuleCreatePayload: - description: Create a new rule. - oneOf: - - $ref: '#/components/schemas/SecurityMonitoringStandardRuleCreatePayload' - - $ref: '#/components/schemas/SecurityMonitoringSignalRuleCreatePayload' - - $ref: '#/components/schemas/CloudConfigurationRuleCreatePayload' - SecurityMonitoringStandardRuleCreatePayload: - description: Create a new rule. - properties: - cases: - description: Cases for generating signals. - example: [] - items: - $ref: '#/components/schemas/SecurityMonitoringRuleCaseCreate' - type: array - filters: - description: Additional queries to filter matched events before they are processed. - items: - $ref: '#/components/schemas/SecurityMonitoringFilter' - type: array - hasExtendedTitle: - description: Whether the notifications include the triggering group-by values in their title. - example: true - type: boolean - isEnabled: - description: Whether the rule is enabled. - example: true - type: boolean - message: - description: Message for generated signals. - example: '' - type: string - name: - description: The name of the rule. - example: My security monitoring rule. - type: string - options: - $ref: '#/components/schemas/SecurityMonitoringRuleOptions' - queries: - description: Queries for selecting logs which are part of the rule. - example: [] - items: - $ref: '#/components/schemas/SecurityMonitoringStandardRuleQuery' - type: array - tags: - description: Tags for generated signals. - example: - - 'env:prod' - - 'team:security' - items: - description: Tag. - type: string - type: array - type: - $ref: '#/components/schemas/SecurityMonitoringRuleTypeCreate' - required: - - name - - isEnabled - - queries - - options - - cases - - message - type: object - SecurityMonitoringSignalRuleCreatePayload: - description: Create a new signal correlation rule. - properties: - cases: - description: Cases for generating signals. - example: [] - items: - $ref: '#/components/schemas/SecurityMonitoringRuleCaseCreate' - type: array - filters: - description: Additional queries to filter matched events before they are processed. - items: - $ref: '#/components/schemas/SecurityMonitoringFilter' - type: array - hasExtendedTitle: - description: Whether the notifications include the triggering group-by values in their title. - example: true - type: boolean - isEnabled: - description: Whether the rule is enabled. - example: true - type: boolean - message: - description: Message for generated signals. - example: '' - type: string - name: - description: The name of the rule. - example: My security monitoring rule. - type: string - options: - $ref: '#/components/schemas/SecurityMonitoringRuleOptions' - queries: - description: Queries for selecting signals which are part of the rule. - example: [] - items: - $ref: '#/components/schemas/SecurityMonitoringSignalRuleQuery' - type: array - tags: - description: Tags for generated signals. - example: - - 'env:prod' - - 'team:security' - items: - description: Tag. - type: string - type: array - type: - $ref: '#/components/schemas/SecurityMonitoringSignalRuleType' - required: - - name - - isEnabled - - queries - - options - - cases - - message - type: object - CloudConfigurationRuleCreatePayload: - description: Create a new cloud configuration rule. - properties: - cases: - description: | - Description of generated findings and signals (severity and channels to be notified in case of a signal). Must contain exactly one item. - items: - $ref: '#/components/schemas/CloudConfigurationRuleCaseCreate' - type: array - complianceSignalOptions: - $ref: '#/components/schemas/CloudConfigurationRuleComplianceSignalOptions' - filters: - description: Additional queries to filter matched events before they are processed. - items: - $ref: '#/components/schemas/SecurityMonitoringFilter' - type: array - isEnabled: - description: Whether the rule is enabled. - example: true - type: boolean - message: - description: Message in markdown format for generated findings and signals. - example: | - #Description - Explanation of the rule. - - #Remediation - How to fix the security issue. - type: string - name: - description: The name of the rule. - example: My security monitoring rule. - type: string - options: - $ref: '#/components/schemas/CloudConfigurationRuleOptions' - tags: - description: Tags for generated findings and signals. - example: - - 'env:prod' - - 'team:security' - items: - description: Tag. - type: string - type: array - type: - $ref: '#/components/schemas/CloudConfigurationRuleType' - required: - - name - - isEnabled - - options - - complianceSignalOptions - - cases - - message - type: object - SecurityMonitoringRuleCaseCreate: - description: Case when signal is generated. - properties: - condition: - description: |- - A rule case contains logical operations (`>`,`>=`, `&&`, `||`) to determine if a signal should be generated - based on the event counts in the previously defined queries. - type: string - name: - description: Name of the case. - type: string - notifications: - description: Notification targets for each rule case. - items: - description: Notification. - type: string - type: array - status: - $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' - required: - - status - type: object - SecurityMonitoringRuleTypeCreate: - description: The rule type. - enum: - - application_security - - log_detection - - workload_security - type: string - x-enum-varnames: - - APPLICATION_SECURITY - - LOG_DETECTION - - WORKLOAD_SECURITY - SecurityMonitoringSignalRuleQuery: - description: Query for matching rule on signals. - properties: - aggregation: - $ref: '#/components/schemas/SecurityMonitoringRuleQueryAggregation' - correlatedByFields: - description: Fields to group by. - items: - description: Field. - type: string - type: array - correlatedQueryIndex: - description: Index of the rule query used to retrieve the correlated field. - format: int32 - maximum: 9 - type: integer - metrics: - description: Group of target fields to aggregate over. - items: - description: Field. - type: string - type: array - name: - description: Name of the query. - type: string - ruleId: - description: Rule ID to match on signals. - example: org-ru1-e1d - type: string - required: - - ruleId - type: object - CloudConfigurationRuleCaseCreate: - description: Description of signals. - properties: - notifications: - description: Notification targets for each rule case. - items: - description: Notification. - type: string - type: array - status: - $ref: '#/components/schemas/SecurityMonitoringRuleSeverity' - required: - - status - type: object - CloudConfigurationRuleOptions: - description: Options on cloud configuration rules. - properties: - complianceRuleOptions: - $ref: '#/components/schemas/CloudConfigurationComplianceRuleOptions' - required: - - complianceRuleOptions - type: object - CloudConfigurationRuleType: - description: The rule type. - enum: - - cloud_configuration - type: string - x-enum-varnames: - - CLOUD_CONFIGURATION - SecurityMonitoringRuleUpdatePayload: - description: Update an existing rule. - properties: - cases: - description: Cases for generating signals. - items: - $ref: '#/components/schemas/SecurityMonitoringRuleCase' - type: array - complianceSignalOptions: - $ref: '#/components/schemas/CloudConfigurationRuleComplianceSignalOptions' - filters: - description: Additional queries to filter matched events before they are processed. - items: - $ref: '#/components/schemas/SecurityMonitoringFilter' - type: array - hasExtendedTitle: - description: Whether the notifications include the triggering group-by values in their title. - example: true - type: boolean - isEnabled: - description: Whether the rule is enabled. - type: boolean - message: - description: Message for generated signals. - type: string - name: - description: Name of the rule. - type: string - options: - $ref: '#/components/schemas/SecurityMonitoringRuleOptions' - queries: - description: Queries for selecting logs which are part of the rule. - items: - $ref: '#/components/schemas/SecurityMonitoringRuleQuery' - type: array - tags: - description: Tags for generated signals. - items: - description: Tag. - type: string - type: array - version: - description: The version of the rule being updated. - example: 1 - format: int32 - maximum: 2147483647 - type: integer - type: object - SecurityMonitoringRuleQuery: - description: Query for matching rule. - oneOf: - - $ref: '#/components/schemas/SecurityMonitoringStandardRuleQuery' - - $ref: '#/components/schemas/SecurityMonitoringSignalRuleQuery' - SecurityMonitoringSignalsSort: - description: The sort parameters used for querying security signals. - enum: - - timestamp - - '-timestamp' - type: string - x-enum-varnames: - - TIMESTAMP_ASCENDING - - TIMESTAMP_DESCENDING - SecurityMonitoringSignalsListResponse: - description: |- - The response object with all security signals matching the request - and pagination information. - properties: - data: - description: An array of security signals matching the request. - items: - $ref: '#/components/schemas/SecurityMonitoringSignal' - type: array - links: - $ref: '#/components/schemas/SecurityMonitoringSignalsListResponseLinks' - meta: - $ref: '#/components/schemas/SecurityMonitoringSignalsListResponseMeta' - type: object - SecurityMonitoringSignal: - description: Object description of a security signal. - properties: - attributes: - $ref: '#/components/schemas/SecurityMonitoringSignalAttributes' - id: - description: The unique ID of the security signal. - example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA - type: string - type: - $ref: '#/components/schemas/SecurityMonitoringSignalType' - type: object - SecurityMonitoringSignalsListResponseLinks: - description: Links attributes. - properties: - next: - description: |- - The link for the next set of results. **Note**: The request can also be made using the - POST endpoint. - example: 'https://app.datadoghq.com/api/v2/security_monitoring/signals?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==' - type: string - type: object - SecurityMonitoringSignalsListResponseMeta: - description: Meta attributes. - properties: - page: - $ref: '#/components/schemas/SecurityMonitoringSignalsListResponseMetaPage' - type: object - SecurityMonitoringSignalAttributes: - additionalProperties: {} - description: |- - The object containing all signal attributes and their - associated values. - properties: - custom: - additionalProperties: {} - description: A JSON object of attributes in the security signal. - example: - workflow: - first_seen: '2020-06-23T14:46:01.000Z' - last_seen: '2020-06-23T14:46:49.000Z' - rule: - id: 0f5-e0c-805 - name: 'Brute Force Attack Grouped By User ' - version: 12 - type: object - message: - description: The message in the security signal defined by the rule that generated the signal. - example: Detect Account Take Over (ATO) through brute force attempts - type: string - tags: - description: An array of tags associated with the security signal. - example: - - 'security:attack' - - 'technique:T1110-brute-force' - items: - description: The tag associated with the security signal. - type: string - type: array - timestamp: - description: The timestamp of the security signal. - example: '2019-01-02T09:42:36.320Z' - format: date-time - type: string - type: object - SecurityMonitoringSignalType: - default: signal - description: The type of event. - enum: - - signal - example: signal - type: string - x-enum-varnames: - - SIGNAL - SecurityMonitoringSignalsListResponseMetaPage: - description: Paging attributes. - properties: - after: - description: |- - The cursor used to get the next results, if any. To make the next request, use the same - parameters with the addition of the `page[cursor]`. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - type: object - SecurityMonitoringSignalListRequest: - description: The request for a security signal list. - properties: - filter: - $ref: '#/components/schemas/SecurityMonitoringSignalListRequestFilter' - page: - $ref: '#/components/schemas/SecurityMonitoringSignalListRequestPage' - sort: - $ref: '#/components/schemas/SecurityMonitoringSignalsSort' - type: object - SecurityMonitoringSignalListRequestFilter: - description: Search filters for listing security signals. - properties: - from: - description: The minimum timestamp for requested security signals. - example: '2019-01-02T09:42:36.320Z' - format: date-time - type: string - query: - description: Search query for listing security signals. - example: 'security:attack status:high' - type: string - to: - description: The maximum timestamp for requested security signals. - example: '2019-01-03T09:42:36.320Z' - format: date-time - type: string - type: object - SecurityMonitoringSignalListRequestPage: - description: The paging attributes for listing security signals. - properties: - cursor: - description: A list of results using the cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - limit: - default: 10 - description: The maximum number of security signals in the response. - example: 25 - format: int32 - maximum: 1000 - type: integer - type: object - SecurityMonitoringSignalResponse: - description: Security Signal response data object. - properties: - data: - $ref: '#/components/schemas/SecurityMonitoringSignal' - type: object - SecurityMonitoringSignalAssigneeUpdateRequest: - description: Request body for changing the assignee of a given security monitoring signal. - properties: - data: - $ref: '#/components/schemas/SecurityMonitoringSignalAssigneeUpdateData' - required: - - data - type: object - SecurityMonitoringSignalTriageUpdateResponse: - description: 'The response returned after all triage operations, containing the updated signal triage data.' - properties: - data: - $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateData' - required: - - data - type: object - SecurityMonitoringSignalAssigneeUpdateData: - description: Data containing the patch for changing the assignee of a signal. - properties: - attributes: - $ref: '#/components/schemas/SecurityMonitoringSignalAssigneeUpdateAttributes' - required: - - attributes - type: object - SecurityMonitoringSignalTriageUpdateData: - description: Data containing the updated triage attributes of the signal. - properties: - attributes: - $ref: '#/components/schemas/SecurityMonitoringSignalTriageAttributes' - id: - description: The unique ID of the security signal. - type: string - type: - $ref: '#/components/schemas/SecurityMonitoringSignalMetadataType' - type: object - SecurityMonitoringSignalAssigneeUpdateAttributes: - description: Attributes describing the new assignee of a security signal. - properties: - assignee: - $ref: '#/components/schemas/SecurityMonitoringTriageUser' - version: - $ref: '#/components/schemas/SecurityMonitoringSignalVersion' - required: - - assignee - type: object - SecurityMonitoringSignalTriageAttributes: - description: Attributes describing a triage state update operation over a security signal. - properties: - archive_comment: - $ref: '#/components/schemas/SecurityMonitoringSignalArchiveComment' - archive_comment_timestamp: - description: Timestamp of the last edit to the comment. - format: int64 - minimum: 0 - type: integer - archive_comment_user: - $ref: '#/components/schemas/SecurityMonitoringTriageUser' - archive_reason: - $ref: '#/components/schemas/SecurityMonitoringSignalArchiveReason' - assignee: - $ref: '#/components/schemas/SecurityMonitoringTriageUser' - incident_ids: - $ref: '#/components/schemas/SecurityMonitoringSignalIncidentIds' - state: - $ref: '#/components/schemas/SecurityMonitoringSignalState' - state_update_timestamp: - description: Timestamp of the last update to the signal state. - format: int64 - minimum: 0 - type: integer - state_update_user: - $ref: '#/components/schemas/SecurityMonitoringTriageUser' - required: - - assignee - - state - - incident_ids - type: object - SecurityMonitoringSignalMetadataType: - default: signal_metadata - description: The type of event. - enum: - - signal_metadata - example: signal_metadata - type: string - x-enum-varnames: - - SIGNAL_METADATA - SecurityMonitoringTriageUser: - description: Object representing a given user entity. - properties: - handle: - description: The handle for this user account. - type: string - icon: - description: Gravatar icon associated to the user. - example: /path/to/matching/gravatar/icon - readOnly: true - type: string - id: - description: Numerical ID assigned by Datadog to this user account. - format: int64 - type: integer - name: - description: The name for this user account. - nullable: true - type: string - uuid: - description: UUID assigned by Datadog to this user account. - example: 773b045d-ccf8-4808-bd3b-955ef6a8c940 - type: string - required: - - uuid - type: object - SecurityMonitoringSignalVersion: - description: 'Version of the updated signal. If server side version is higher, update will be rejected.' - format: int64 - type: integer - SecurityMonitoringSignalArchiveComment: - description: Optional comment to display on archived signals. - type: string - SecurityMonitoringSignalArchiveReason: - description: Reason a signal is archived. - enum: - - none - - false_positive - - testing_or_maintenance - - investigated_case_opened - - other - type: string - x-enum-varnames: - - NONE - - FALSE_POSITIVE - - TESTING_OR_MAINTENANCE - - INVESTIGATED_CASE_OPENED - - OTHER - SecurityMonitoringSignalIncidentIds: - description: Array of incidents that are associated with this signal. - items: - description: Public ID attribute of the incident that is associated with the signal. - example: 2066 - format: int64 - type: integer - type: array - SecurityMonitoringSignalState: - description: The new triage state of the signal. - enum: - - open - - archived - - under_review - example: open - type: string - x-enum-varnames: - - OPEN - - ARCHIVED - - UNDER_REVIEW - SecurityMonitoringSignalIncidentsUpdateRequest: - description: Request body for changing the related incidents of a given security monitoring signal. - properties: - data: - $ref: '#/components/schemas/SecurityMonitoringSignalIncidentsUpdateData' - required: - - data - type: object - SecurityMonitoringSignalIncidentsUpdateData: - description: Data containing the patch for changing the related incidents of a signal. - properties: - attributes: - $ref: '#/components/schemas/SecurityMonitoringSignalIncidentsUpdateAttributes' - required: - - attributes - type: object - SecurityMonitoringSignalIncidentsUpdateAttributes: - description: Attributes describing the new list of related signals for a security signal. - properties: - incident_ids: - $ref: '#/components/schemas/SecurityMonitoringSignalIncidentIds' - version: - $ref: '#/components/schemas/SecurityMonitoringSignalVersion' - required: - - incident_ids - type: object - SecurityMonitoringSignalStateUpdateRequest: - description: Request body for changing the state of a given security monitoring signal. - properties: - data: - $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateData' - required: - - data - type: object - SecurityMonitoringSignalStateUpdateData: - description: Data containing the patch for changing the state of a signal. - properties: - attributes: - $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateAttributes' - id: - description: The unique ID of the security signal. - type: - $ref: '#/components/schemas/SecurityMonitoringSignalMetadataType' - required: - - attributes - type: object - SecurityMonitoringSignalStateUpdateAttributes: - description: Attributes describing the change of state of a security signal. - properties: - archive_comment: - $ref: '#/components/schemas/SecurityMonitoringSignalArchiveComment' - archive_reason: - $ref: '#/components/schemas/SecurityMonitoringSignalArchiveReason' - state: - $ref: '#/components/schemas/SecurityMonitoringSignalState' - version: - $ref: '#/components/schemas/SecurityMonitoringSignalVersion' - required: - - state - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - FindingsBadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: 'Bad Request: The server cannot process the request due to invalid syntax in the request.' - FindingsForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: 'Forbidden: Access denied' - FindingsNotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: 'Not Found: The requested finding cannot be found.' - FindingsTooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: 'Too many requests: The rate limit set by the API has been exceeded.' - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ConflictResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - ConcurrentModificationResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Concurrent Modification - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - findings: - id: datadog.security_monitoring.findings - name: findings - title: Findings - methods: - list_findings: - operation: - $ref: '#/paths/~1api~1v2~1posture_management~1findings/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_findings: - operation: - $ref: '#/paths/~1api~1v2~1posture_management~1findings/get' - response: - mediaType: application/json - openAPIDocKey: '200' - mute_findings: - operation: - $ref: '#/paths/~1api~1v2~1posture_management~1findings/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - get_finding: - operation: - $ref: '#/paths/~1api~1v2~1posture_management~1findings~1{finding_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_finding: - operation: - $ref: '#/paths/~1api~1v2~1posture_management~1findings~1{finding_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/findings/methods/get_finding' - - $ref: '#/components/x-stackQL-resources/findings/methods/list_findings' - insert: [] - update: [] - delete: [] - security_filters: - id: datadog.security_monitoring.security_filters - name: security_filters - title: Security Filters - methods: - list_security_filters: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_security_filters: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_security_filter: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_security_filter: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters~1{security_filter_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_security_filter: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters~1{security_filter_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_security_filter: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters~1{security_filter_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_security_filter: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1configuration~1security_filters~1{security_filter_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/security_filters/methods/get_security_filter' - - $ref: '#/components/x-stackQL-resources/security_filters/methods/list_security_filters' - insert: - - $ref: '#/components/x-stackQL-resources/security_filters/methods/create_security_filter' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/security_filters/methods/delete_security_filter' - security_monitoring_rules: - id: datadog.security_monitoring.security_monitoring_rules - name: security_monitoring_rules - title: Security Monitoring Rules - methods: - list_security_monitoring_rules: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1rules/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_security_monitoring_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1rules/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_security_monitoring_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_security_monitoring_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_security_monitoring_rule: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1rules~1{rule_id}/put' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/security_monitoring_rules/methods/get_security_monitoring_rule' - - $ref: '#/components/x-stackQL-resources/security_monitoring_rules/methods/list_security_monitoring_rules' - insert: - - $ref: '#/components/x-stackQL-resources/security_monitoring_rules/methods/create_security_monitoring_rule' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/security_monitoring_rules/methods/delete_security_monitoring_rule' - security_monitoring_signals: - id: datadog.security_monitoring.security_monitoring_signals - name: security_monitoring_signals - title: Security Monitoring Signals - methods: - list_security_monitoring_signals: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1signals/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_security_monitoring_signals: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1signals/get' - response: - mediaType: application/json - openAPIDocKey: '200' - search_security_monitoring_signals: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1signals~1search/post' - response: - mediaType: application/json - openAPIDocKey: '200' - get_security_monitoring_signal: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_security_monitoring_signal: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - edit_security_monitoring_signal_assignee: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}~1assignee/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - edit_security_monitoring_signal_incidents: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}~1incidents/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - edit_security_monitoring_signal_state: - operation: - $ref: '#/paths/~1api~1v2~1security_monitoring~1signals~1{signal_id}~1state/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/security_monitoring_signals/methods/get_security_monitoring_signal' - - $ref: '#/components/x-stackQL-resources/security_monitoring_signals/methods/list_security_monitoring_signals' - insert: [] - update: [] - delete: [] -paths: - /api/v2/posture_management/findings: - get: - description: | - Get a list of CSPM findings. - - ### Filtering - - Filters can be applied by appending query parameters to the URL. - - - Using a single filter: `?filter[attribute_key]=attribute_value` - - Chaining filters: `?filter[attribute_key]=attribute_value&filter[attribute_key]=attribute_value...` - - Filtering on tags: `?filter[tags]=tag_key:tag_value&filter[tags]=tag_key_2:tag_value_2` - - Here, `attribute_key` can be any of the filter keys described further below. - - Query parameters of type `integer` support comparison operators (`>`, `>=`, `<`, `<=`). This is particularly useful when filtering by `evaluation_changed_at` or `resource_discovery_timestamp`. For example: `?filter[evaluation_changed_at]=>20123123121`. - - You can also use the negation operator on strings. For example, use `filter[resource_type]=-aws*` to filter for any non-AWS resources. - - The operator must come after the equal sign. For example, to filter with the `>=` operator, add the operator after the equal sign: `filter[evaluation_changed_at]=>=1678809373257`. - - Query parameters must be only among the documented ones and with values of correct types. Duplicated query parameters (e.g. `filter[status]=low&filter[status]=info`) are not allowed. - - ### Response - - The response includes an array of finding objects, pagination metadata, and a count of items that match the query. - - Each finding object contains the following: - - - The finding ID that can be used in a `GetFinding` request to retrieve the full finding details. - - Core attributes, including status, evaluation, high-level resource details, muted state, and rule details. - - `evaluation_changed_at` and `resource_discovery_date` time stamps. - - An array of associated tags. - operationId: ListFindings - parameters: - - description: Limit the number of findings returned. Must be <= 1000. - example: 50 - in: query - name: 'page[limit]' - required: false - schema: - default: 100 - format: int64 - maximum: 1000 - minimum: 1 - type: integer - - description: Return findings for a given snapshot of time (Unix ms). - example: 1678721573794 - in: query - name: snapshot_timestamp - required: false - schema: - format: int64 - minimum: 1 - type: integer - - description: Return the next page of findings pointed to by the cursor. - example: eyJhZnRlciI6IkFRQUFBWWJiaEJXQS1OY1dqUUFBQUFCQldXSmlhRUpYUVVGQlJFSktkbTlDTUdaWFRVbDNRVUUiLCJ2YWx1ZXMiOlsiY3JpdGljYWwiXX0= - in: query - name: 'page[cursor]' - required: false - schema: - type: string - - description: Return findings that have these associated tags (repeatable). - example: 'filter[tags]=cloud_provider:aws&filter[tags]=aws_account:999999999999' - in: query - name: 'filter[tags]' - required: false - schema: - type: string - - description: Return findings that have changed from pass to fail or vice versa on a specified date (Unix ms) or date range (using comparison operators). - example: '>=1678721573794' - in: query - name: 'filter[evaluation_changed_at]' - required: false - schema: - type: string - - description: Set to `true` to return findings that are muted. Set to `false` to return unmuted findings. - in: query - name: 'filter[muted]' - required: false - schema: - type: boolean - - description: Return findings for the specified rule ID. - in: query - name: 'filter[rule_id]' - required: false - schema: - type: string - - description: Return findings for the specified rule. - in: query - name: 'filter[rule_name]' - required: false - schema: - type: string - - description: Return only findings for the specified resource type. - in: query - name: 'filter[resource_type]' - required: false - schema: - type: string - - description: Return findings that were found on a specified date (Unix ms) or date range (using comparison operators). - example: '>=1678721573794' - in: query - name: 'filter[discovery_timestamp]' - required: false - schema: - type: string - - description: Return only `pass` or `fail` findings. - example: pass - in: query - name: 'filter[evaluation]' - required: false - schema: - $ref: '#/components/schemas/FindingEvaluation' - - description: Return only findings with the specified status. - example: critical - in: query - name: 'filter[status]' - required: false - schema: - $ref: '#/components/schemas/FindingStatus' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ListFindingsResponse' - description: OK - '400': - $ref: '#/components/responses/FindingsBadRequestResponse' - '403': - $ref: '#/components/responses/FindingsForbiddenResponse' - '404': - $ref: '#/components/responses/FindingsNotFoundResponse' - '429': - $ref: '#/components/responses/FindingsTooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_findings_read - summary: List findings - tags: - - Security Monitoring - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.cursor - limitParam: 'page[limit]' - resultsPath: data - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - patch: - description: Mute or unmute findings. - operationId: MuteFindings - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/BulkMuteFindingsRequest' - description: | - ### Attributes - - All findings are updated with the same attributes. The request body must include at least two attributes: `muted` and `reason`. - The allowed reasons depend on whether the finding is being muted or unmuted: - - To mute a finding: `PENDING_FIX`, `FALSE_POSITIVE`, `ACCEPTED_RISK`, `OTHER`. - - To unmute a finding : `NO_PENDING_FIX`, `HUMAN_ERROR`, `NO_LONGER_ACCEPTED_RISK`, `OTHER`. - - ### Meta - - The request body must include a list of the finding IDs to be updated. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/BulkMuteFindingsResponse' - description: OK - '400': - $ref: '#/components/responses/FindingsBadRequestResponse' - '403': - $ref: '#/components/responses/FindingsForbiddenResponse' - '404': - $ref: '#/components/responses/FindingsNotFoundResponse' - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: 'Invalid Request: The server understands the request syntax but cannot process it due to invalid data.' - '429': - $ref: '#/components/responses/FindingsTooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - summary: Mute or unmute a batch of findings - tags: - - Security Monitoring - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/posture_management/findings/{finding_id}': - get: - description: Returns a single finding with message and resource configuration. - operationId: GetFinding - parameters: - - description: The ID of the finding. - in: path - name: finding_id - required: true - schema: - type: string - - description: Return the finding for a given snapshot of time (Unix ms). - example: 1678721573794 - in: query - name: snapshot_timestamp - required: false - schema: - format: int64 - minimum: 1 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/GetFindingResponse' - description: OK - '400': - $ref: '#/components/responses/FindingsBadRequestResponse' - '403': - $ref: '#/components/responses/FindingsForbiddenResponse' - '404': - $ref: '#/components/responses/FindingsNotFoundResponse' - '429': - $ref: '#/components/responses/FindingsTooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_findings_read - summary: Get a finding - tags: - - Security Monitoring - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/security_monitoring/configuration/security_filters: - get: - description: Get the list of configured security filters with their definitions. - operationId: ListSecurityFilters - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityFiltersResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_filters_read - summary: Get all security filters - tags: - - Security Monitoring - post: - description: |- - Create a security filter. - - See the [security filter guide](https://docs.datadoghq.com/security_platform/guide/how-to-setup-security-filters-using-security-monitoring-api/) - for more examples. - operationId: CreateSecurityFilter - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityFilterCreateRequest' - description: The definition of the new security filter. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityFilterResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_filters_write - summary: Create a security filter - tags: - - Security Monitoring - x-codegen-request-body-name: body - '/api/v2/security_monitoring/configuration/security_filters/{security_filter_id}': - delete: - description: Delete a specific security filter. - operationId: DeleteSecurityFilter - parameters: - - $ref: '#/components/parameters/SecurityFilterID' - responses: - '204': - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_filters_write - summary: Delete a security filter - tags: - - Security Monitoring - get: - description: |- - Get the details of a specific security filter. - - See the [security filter guide](https://docs.datadoghq.com/security_platform/guide/how-to-setup-security-filters-using-security-monitoring-api/) - for more examples. - operationId: GetSecurityFilter - parameters: - - $ref: '#/components/parameters/SecurityFilterID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityFilterResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_filters_read - summary: Get a security filter - tags: - - Security Monitoring - patch: - description: |- - Update a specific security filter. - Returns the security filter object when the request is successful. - operationId: UpdateSecurityFilter - parameters: - - $ref: '#/components/parameters/SecurityFilterID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityFilterUpdateRequest' - description: New definition of the security filter. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityFilterResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '409': - $ref: '#/components/responses/ConcurrentModificationResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_filters_write - summary: Update a security filter - tags: - - Security Monitoring - x-codegen-request-body-name: body - /api/v2/security_monitoring/rules: - get: - description: List rules. - operationId: ListSecurityMonitoringRules - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringListRulesResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_rules_read - summary: List rules - tags: - - Security Monitoring - post: - description: Create a detection rule. - operationId: CreateSecurityMonitoringRule - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringRuleCreatePayload' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringRuleResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_rules_write - summary: Create a detection rule - tags: - - Security Monitoring - x-codegen-request-body-name: body - '/api/v2/security_monitoring/rules/{rule_id}': - delete: - description: Delete an existing rule. Default rules cannot be deleted. - operationId: DeleteSecurityMonitoringRule - parameters: - - $ref: '#/components/parameters/SecurityMonitoringRuleID' - responses: - '204': - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_rules_write - summary: Delete an existing rule - tags: - - Security Monitoring - get: - description: Get a rule's details. - operationId: GetSecurityMonitoringRule - parameters: - - $ref: '#/components/parameters/SecurityMonitoringRuleID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringRuleResponse' - description: OK - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_rules_read - summary: Get a rule's details - tags: - - Security Monitoring - put: - description: |- - Update an existing rule. When updating `cases`, `queries` or `options`, the whole field - must be included. For example, when modifying a query all queries must be included. - Default rules can only be updated to be enabled and to change notifications. - operationId: UpdateSecurityMonitoringRule - parameters: - - $ref: '#/components/parameters/SecurityMonitoringRuleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringRuleUpdatePayload' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringRuleResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '401': - $ref: '#/components/responses/ConcurrentModificationResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_rules_write - summary: Update an existing rule - tags: - - Security Monitoring - x-codegen-request-body-name: body - /api/v2/security_monitoring/signals: - get: - description: |- - The list endpoint returns security signals that match a search query. - Both this endpoint and the POST endpoint can be used interchangeably when listing - security signals. - operationId: ListSecurityMonitoringSignals - parameters: - - description: The search query for security signals. - example: 'security:attack status:high' - in: query - name: 'filter[query]' - required: false - schema: - type: string - - description: The minimum timestamp for requested security signals. - example: '2019-01-02T09:42:36.320Z' - in: query - name: 'filter[from]' - required: false - schema: - format: date-time - type: string - - description: The maximum timestamp for requested security signals. - example: '2019-01-03T09:42:36.320Z' - in: query - name: 'filter[to]' - required: false - schema: - format: date-time - type: string - - description: The order of the security signals in results. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalsSort' - - description: A list of results using the cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - in: query - name: 'page[cursor]' - required: false - schema: - type: string - - description: The maximum number of security signals in the response. - example: 25 - in: query - name: 'page[limit]' - required: false - schema: - default: 10 - format: int32 - maximum: 1000 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalsListResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_signals_read - summary: Get a quick list of security signals - tags: - - Security Monitoring - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data - /api/v2/security_monitoring/signals/search: - post: - description: |- - Returns security signals that match a search query. - Both this endpoint and the GET endpoint can be used interchangeably for listing - security signals. - operationId: SearchSecurityMonitoringSignals - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalListRequest' - required: false - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalsListResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_signals_read - summary: Get a list of security signals - tags: - - Security Monitoring - x-codegen-request-body-name: body - x-pagination: - cursorParam: body.page.cursor - cursorPath: meta.page.after - limitParam: body.page.limit - resultsPath: data - '/api/v2/security_monitoring/signals/{signal_id}': - get: - description: Get a signal's details. - operationId: GetSecurityMonitoringSignal - parameters: - - $ref: '#/components/parameters/SignalID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalResponse' - description: OK - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - security_monitoring_signals_read - summary: Get a signal's details - tags: - - Security Monitoring - '/api/v2/security_monitoring/signals/{signal_id}/assignee': - patch: - description: Modify the triage assignee of a security signal. - operationId: EditSecurityMonitoringSignalAssignee - parameters: - - $ref: '#/components/parameters/SignalID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalAssigneeUpdateRequest' - description: Attributes describing the signal update. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Modify the triage assignee of a security signal - tags: - - Security Monitoring - x-codegen-request-body-name: body - '/api/v2/security_monitoring/signals/{signal_id}/incidents': - patch: - description: Change the related incidents for a security signal. - operationId: EditSecurityMonitoringSignalIncidents - parameters: - - $ref: '#/components/parameters/SignalID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalIncidentsUpdateRequest' - description: Attributes describing the signal update. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Change the related incidents of a security signal - tags: - - Security Monitoring - x-codegen-request-body-name: body - '/api/v2/security_monitoring/signals/{signal_id}/state': - patch: - description: Change the triage state of a security signal. - operationId: EditSecurityMonitoringSignalState - parameters: - - $ref: '#/components/parameters/SignalID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalStateUpdateRequest' - description: Attributes describing the signal update. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SecurityMonitoringSignalTriageUpdateResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Change the triage state of a security signal - tags: - - Security Monitoring - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/sensitive_data_scanner.yaml b/providers/src/datadog/v00.00.00000/services/sensitive_data_scanner.yaml deleted file mode 100644 index 6c5d110e..00000000 --- a/providers/src/datadog/v00.00.00000/services/sensitive_data_scanner.yaml +++ /dev/null @@ -1,1931 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - sensitive_data_scanner - description: Sensitive_Data_Scanner -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - SensitiveDataScannerGetConfigResponse: - description: Get all groups response. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerGetConfigResponseData' - included: - $ref: '#/components/schemas/SensitiveDataScannerGetConfigIncludedArray' - meta: - $ref: '#/components/schemas/SensitiveDataScannerMeta' - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - SensitiveDataScannerGetConfigResponseData: - description: Response data related to the scanning groups. - properties: - attributes: - additionalProperties: {} - description: Attributes of the Sensitive Data configuration. - type: object - id: - description: ID of the configuration. - type: string - relationships: - $ref: '#/components/schemas/SensitiveDataScannerConfigurationRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerConfigurationType' - type: object - SensitiveDataScannerGetConfigIncludedArray: - description: Included objects from relationships. - items: - $ref: '#/components/schemas/SensitiveDataScannerGetConfigIncludedItem' - type: array - SensitiveDataScannerMeta: - description: Meta response containing information about the API. - properties: - count_limit: - description: Maximum number of scanning rules allowed for the org. - format: int64 - type: integer - group_count_limit: - description: Maximum number of scanning groups allowed for the org. - format: int64 - type: integer - has_highlight_enabled: - description: Whether or not scanned events are highlighted in Logs or RUM for the org. - type: boolean - has_multi_pass_enabled: - description: Whether or not scanned events have multi-pass enabled. - type: boolean - is_pci_compliant: - description: Whether or not the org is compliant to the payment card industry standard. - type: boolean - version: - description: Version of the API. - example: 0 - format: int64 - minimum: 0 - type: integer - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - SensitiveDataScannerConfigurationRelationships: - description: Relationships of the configuration. - properties: - groups: - $ref: '#/components/schemas/SensitiveDataScannerGroupList' - type: object - SensitiveDataScannerConfigurationType: - default: sensitive_data_scanner_configuration - description: Sensitive Data Scanner configuration type. - enum: - - sensitive_data_scanner_configuration - example: sensitive_data_scanner_configuration - type: string - x-enum-varnames: - - SENSITIVE_DATA_SCANNER_CONFIGURATIONS - SensitiveDataScannerGetConfigIncludedItem: - description: An object related to the configuration. - oneOf: - - $ref: '#/components/schemas/SensitiveDataScannerRuleIncludedItem' - - $ref: '#/components/schemas/SensitiveDataScannerGroupIncludedItem' - SensitiveDataScannerGroupList: - description: 'List of groups, ordered.' - properties: - data: - description: List of groups. The order is important. - items: - $ref: '#/components/schemas/SensitiveDataScannerGroupItem' - type: array - type: object - SensitiveDataScannerRuleIncludedItem: - description: A Scanning Rule included item. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerRuleAttributes' - id: - description: ID of the rule. - type: string - relationships: - $ref: '#/components/schemas/SensitiveDataScannerRuleRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerRuleType' - type: object - SensitiveDataScannerGroupIncludedItem: - description: A Scanning Group included item. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerGroupAttributes' - id: - description: ID of the group. - type: string - relationships: - $ref: '#/components/schemas/SensitiveDataScannerGroupRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerGroupType' - type: object - SensitiveDataScannerGroupItem: - description: Data related to a Sensitive Data Scanner Group. - properties: - id: - description: ID of the group. - type: string - type: - $ref: '#/components/schemas/SensitiveDataScannerGroupType' - type: object - SensitiveDataScannerRuleAttributes: - description: Attributes of the Sensitive Data Scanner rule. - properties: - description: - description: Description of the rule. - type: string - excluded_namespaces: - description: 'Attributes excluded from the scan. If namespaces is provided, it has to be a sub-path of the namespaces array.' - example: - - admin.name - items: - type: string - type: array - is_enabled: - description: Whether or not the rule is enabled. - type: boolean - name: - description: Name of the rule. - type: string - namespaces: - description: |- - Attributes included in the scan. If namespaces is empty or missing, all attributes except excluded_namespaces are scanned. - If both are missing the whole event is scanned. - example: - - admin - items: - type: string - type: array - pattern: - description: Not included if there is a relationship to a standard pattern. - type: string - priority: - description: Integer from 1 (high) to 5 (low) indicating rule issue severity. - format: int64 - maximum: 5 - minimum: 1 - type: integer - tags: - description: List of tags. - items: - type: string - type: array - text_replacement: - $ref: '#/components/schemas/SensitiveDataScannerTextReplacement' - type: object - SensitiveDataScannerRuleRelationships: - description: Relationships of a scanning rule. - properties: - group: - $ref: '#/components/schemas/SensitiveDataScannerGroupData' - standard_pattern: - $ref: '#/components/schemas/SensitiveDataScannerStandardPatternData' - type: object - SensitiveDataScannerRuleType: - default: sensitive_data_scanner_rule - description: Sensitive Data Scanner rule type. - enum: - - sensitive_data_scanner_rule - example: sensitive_data_scanner_rule - type: string - x-enum-varnames: - - SENSITIVE_DATA_SCANNER_RULE - SensitiveDataScannerGroupAttributes: - description: Attributes of the Sensitive Data Scanner group. - properties: - description: - description: Description of the group. - type: string - filter: - $ref: '#/components/schemas/SensitiveDataScannerFilter' - is_enabled: - description: Whether or not the group is enabled. - type: boolean - name: - description: Name of the group. - type: string - product_list: - description: List of products the scanning group applies. - items: - $ref: '#/components/schemas/SensitiveDataScannerProduct' - type: array - type: object - SensitiveDataScannerGroupRelationships: - description: Relationships of the group. - properties: - configuration: - $ref: '#/components/schemas/SensitiveDataScannerConfigurationData' - rules: - $ref: '#/components/schemas/SensitiveDataScannerRuleData' - type: object - SensitiveDataScannerGroupType: - default: sensitive_data_scanner_group - description: Sensitive Data Scanner group type. - enum: - - sensitive_data_scanner_group - example: sensitive_data_scanner_group - type: string - x-enum-varnames: - - SENSITIVE_DATA_SCANNER_GROUP - SensitiveDataScannerTextReplacement: - description: Object describing how the scanned event will be replaced. - properties: - number_of_chars: - description: |- - Required if type == 'partial_replacement_from_beginning' - or 'partial_replacement_from_end'. It must be > 0. - format: int64 - minimum: 0 - type: integer - replacement_string: - description: Required if type == 'replacement_string'. - type: string - type: - $ref: '#/components/schemas/SensitiveDataScannerTextReplacementType' - type: object - SensitiveDataScannerGroupData: - description: A scanning group data. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerGroup' - type: object - SensitiveDataScannerStandardPatternData: - description: A standard pattern. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerStandardPattern' - type: object - SensitiveDataScannerFilter: - description: Filter for the Scanning Group. - properties: - query: - description: Query to filter the events. - type: string - type: object - SensitiveDataScannerProduct: - default: logs - description: Datadog product onto which Sensitive Data Scanner can be activated. - enum: - - logs - - rum - - events - - apm - type: string - x-enum-varnames: - - LOGS - - RUM - - EVENTS - - APM - SensitiveDataScannerConfigurationData: - description: A Sensitive Data Scanner configuration data. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerConfiguration' - type: object - SensitiveDataScannerRuleData: - description: Rules included in the group. - properties: - data: - description: Rules included in the group. The order is important. - items: - $ref: '#/components/schemas/SensitiveDataScannerRule' - type: array - type: object - SensitiveDataScannerTextReplacementType: - default: none - description: |- - Type of the replacement text. None means no replacement. - hash means the data will be stubbed. replacement_string means that - one can chose a text to replace the data. partial_replacement_from_beginning - allows a user to partially replace the data from the beginning, and - partial_replacement_from_end on the other hand, allows to replace data from - the end. - enum: - - none - - hash - - replacement_string - - partial_replacement_from_beginning - - partial_replacement_from_end - type: string - x-enum-varnames: - - NONE - - HASH - - REPLACEMENT_STRING - - PARTIAL_REPLACEMENT_FROM_BEGINNING - - PARTIAL_REPLACEMENT_FROM_END - SensitiveDataScannerGroup: - description: A scanning group. - properties: - id: - description: ID of the group. - type: string - type: - $ref: '#/components/schemas/SensitiveDataScannerGroupType' - type: object - SensitiveDataScannerStandardPattern: - description: Data containing the standard pattern id. - properties: - id: - description: ID of the standard pattern. - type: string - type: - $ref: '#/components/schemas/SensitiveDataScannerStandardPatternType' - type: object - SensitiveDataScannerConfiguration: - description: A Sensitive Data Scanner configuration. - properties: - id: - description: ID of the configuration. - type: string - type: - $ref: '#/components/schemas/SensitiveDataScannerConfigurationType' - type: object - SensitiveDataScannerRule: - description: Rule item included in the group. - properties: - id: - description: ID of the rule. - type: string - type: - $ref: '#/components/schemas/SensitiveDataScannerRuleType' - type: object - SensitiveDataScannerStandardPatternType: - default: sensitive_data_scanner_standard_pattern - description: Sensitive Data Scanner standard pattern type. - enum: - - sensitive_data_scanner_standard_pattern - example: sensitive_data_scanner_standard_pattern - type: string - x-enum-varnames: - - SENSITIVE_DATA_SCANNER_STANDARD_PATTERN - SensitiveDataScannerConfigRequest: - description: Group reorder request. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerReorderConfig' - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - required: - - data - - meta - type: object - SensitiveDataScannerReorderGroupsResponse: - description: Group reorder response. - properties: - meta: - $ref: '#/components/schemas/SensitiveDataScannerMeta' - type: object - SensitiveDataScannerReorderConfig: - description: Data related to the reordering of scanning groups. - properties: - id: - description: ID of the configuration. - type: string - relationships: - $ref: '#/components/schemas/SensitiveDataScannerConfigurationRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerConfigurationType' - type: object - SensitiveDataScannerMetaVersionOnly: - description: Meta payload containing information about the API. - properties: - version: - description: Version of the API (optional). - example: 0 - format: int64 - minimum: 0 - type: integer - type: object - SensitiveDataScannerGroupCreateRequest: - description: Create group request. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerGroupCreate' - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - type: object - SensitiveDataScannerCreateGroupResponse: - description: Create group response. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerGroupResponse' - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - type: object - SensitiveDataScannerGroupCreate: - description: Data related to the creation of a group. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerGroupAttributes' - relationships: - $ref: '#/components/schemas/SensitiveDataScannerGroupRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerGroupType' - required: - - type - - attributes - type: object - SensitiveDataScannerGroupResponse: - description: Response data related to the creation of a group. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerGroupAttributes' - id: - description: ID of the group. - type: string - relationships: - $ref: '#/components/schemas/SensitiveDataScannerGroupRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerGroupType' - type: object - SensitiveDataScannerGroupDeleteRequest: - description: Delete group request. - properties: - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - required: - - meta - type: object - SensitiveDataScannerGroupDeleteResponse: - description: Delete group response. - properties: - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - type: object - SensitiveDataScannerGroupUpdateRequest: - description: Update group request. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerGroupUpdate' - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - required: - - data - - meta - type: object - SensitiveDataScannerGroupUpdateResponse: - description: Update group response. - properties: - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - type: object - SensitiveDataScannerGroupUpdate: - description: Data related to the update of a group. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerGroupAttributes' - id: - description: ID of the group. - type: string - relationships: - $ref: '#/components/schemas/SensitiveDataScannerGroupRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerGroupType' - type: object - SensitiveDataScannerRuleCreateRequest: - description: Create rule request. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerRuleCreate' - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - required: - - data - - meta - type: object - SensitiveDataScannerCreateRuleResponse: - description: Create rule response. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerRuleResponse' - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - type: object - SensitiveDataScannerRuleCreate: - description: Data related to the creation of a rule. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerRuleAttributes' - relationships: - $ref: '#/components/schemas/SensitiveDataScannerRuleRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerRuleType' - required: - - type - - attributes - - relationships - type: object - SensitiveDataScannerRuleResponse: - description: Response data related to the creation of a rule. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerRuleAttributes' - id: - description: ID of the rule. - type: string - relationships: - $ref: '#/components/schemas/SensitiveDataScannerRuleRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerRuleType' - type: object - SensitiveDataScannerRuleDeleteRequest: - description: Delete rule request. - properties: - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - required: - - meta - type: object - SensitiveDataScannerRuleDeleteResponse: - description: Delete rule response. - properties: - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - type: object - SensitiveDataScannerRuleUpdateRequest: - description: Update rule request. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerRuleUpdate' - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - required: - - data - - meta - type: object - SensitiveDataScannerRuleUpdateResponse: - description: Update rule response. - properties: - meta: - $ref: '#/components/schemas/SensitiveDataScannerMetaVersionOnly' - type: object - SensitiveDataScannerRuleUpdate: - description: Data related to the update of a rule. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerRuleAttributes' - id: - description: ID of the rule. - type: string - relationships: - $ref: '#/components/schemas/SensitiveDataScannerRuleRelationships' - type: - $ref: '#/components/schemas/SensitiveDataScannerRuleType' - type: object - SensitiveDataScannerStandardPatternsResponseData: - description: List Standard patterns response data. - properties: - data: - $ref: '#/components/schemas/SensitiveDataScannerStandardPatternsResponse' - type: object - SensitiveDataScannerStandardPatternsResponse: - description: List Standard patterns response. - items: - $ref: '#/components/schemas/SensitiveDataScannerStandardPatternsResponseItem' - type: array - SensitiveDataScannerStandardPatternsResponseItem: - description: Standard pattern item. - properties: - attributes: - $ref: '#/components/schemas/SensitiveDataScannerStandardPatternAttributes' - id: - description: ID of the standard pattern. - type: string - type: - $ref: '#/components/schemas/SensitiveDataScannerStandardPatternType' - type: object - SensitiveDataScannerStandardPatternAttributes: - description: Attributes of the Sensitive Data Scanner standard pattern. - properties: - description: - description: Description of the standard pattern. - type: string - included_keywords: - description: List of included keywords. - items: - type: string - type: array - name: - description: Name of the standard pattern. - type: string - pattern: - description: Regex to match. - type: string - priority: - description: Integer from 1 (high) to 5 (low) indicating standard pattern issue severity. - format: int64 - maximum: 5 - minimum: 1 - type: integer - tags: - description: List of tags. - items: - type: string - type: array - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - scanning_groups: - id: datadog.sensitive_data_scanner.scanning_groups - name: scanning_groups - title: Scanning Groups - methods: - list_scanning_groups: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_scanning_groups: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config/get' - response: - mediaType: application/json - openAPIDocKey: '200' - reorder_scanning_groups: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - create_scanning_group: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1groups/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_scanning_group: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1groups~1{group_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '200' - update_scanning_group: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1groups~1{group_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/scanning_groups/methods/list_scanning_groups' - insert: - - $ref: '#/components/x-stackQL-resources/scanning_groups/methods/create_scanning_group' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/scanning_groups/methods/delete_scanning_group' - scanning_rules: - id: datadog.sensitive_data_scanner.scanning_rules - name: scanning_rules - title: Scanning Rules - methods: - create_scanning_rule: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1rules/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_scanning_rule: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1rules~1{rule_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '200' - update_scanning_rule: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1rules~1{rule_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: [] - insert: - - $ref: '#/components/x-stackQL-resources/scanning_rules/methods/create_scanning_rule' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/scanning_rules/methods/delete_scanning_rule' - standard_patterns: - id: datadog.sensitive_data_scanner.standard_patterns - name: standard_patterns - title: Standard Patterns - methods: - list_standard_patterns: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1standard-patterns/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_standard_patterns: - operation: - $ref: '#/paths/~1api~1v2~1sensitive-data-scanner~1config~1standard-patterns/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/standard_patterns/methods/list_standard_patterns' - insert: [] - update: [] - delete: [] -paths: - /api/v2/sensitive-data-scanner/config: - get: - description: List all the Scanning groups in your organization. - operationId: ListScanningGroups - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerGetConfigResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List Scanning Groups - tags: - - Sensitive Data Scanner - patch: - description: Reorder the list of groups. - operationId: ReorderScanningGroups - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerConfigRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerReorderGroupsResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Reorder Groups - tags: - - Sensitive Data Scanner - x-codegen-request-body-name: body - /api/v2/sensitive-data-scanner/config/groups: - post: - description: |- - Create a scanning group. - The request MAY include a configuration relationship. - A rules relationship can be omitted entirely, but if it is included it MUST be - null or an empty array (rules cannot be created at the same time). - The new group will be ordered last within the configuration. - operationId: CreateScanningGroup - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerGroupCreateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerCreateGroupResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create Scanning Group - tags: - - Sensitive Data Scanner - x-codegen-request-body-name: body - '/api/v2/sensitive-data-scanner/config/groups/{group_id}': - delete: - description: Delete a given group. - operationId: DeleteScanningGroup - parameters: - - $ref: '#/components/parameters/SensitiveDataScannerGroupID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerGroupDeleteRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerGroupDeleteResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete Scanning Group - tags: - - Sensitive Data Scanner - x-codegen-request-body-name: body - patch: - description: |- - Update a group, including the order of the rules. - Rules within the group are reordered by including a rules relationship. If the rules - relationship is present, its data section MUST contain linkages for all of the rules - currently in the group, and MUST NOT contain any others. - operationId: UpdateScanningGroup - parameters: - - $ref: '#/components/parameters/SensitiveDataScannerGroupID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerGroupUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerGroupUpdateResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update Scanning Group - tags: - - Sensitive Data Scanner - x-codegen-request-body-name: body - /api/v2/sensitive-data-scanner/config/rules: - post: - description: |- - Create a scanning rule in a sensitive data scanner group, ordered last. - The posted rule MUST include a group relationship. - It MUST include either a standard_pattern relationship or a regex attribute, but not both. - If included_attributes is empty or missing, we will scan all attributes except - excluded_attributes. If both are missing, we will scan the whole event. - operationId: CreateScanningRule - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerRuleCreateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerCreateRuleResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create Scanning Rule - tags: - - Sensitive Data Scanner - x-codegen-request-body-name: body - '/api/v2/sensitive-data-scanner/config/rules/{rule_id}': - delete: - description: Delete a given rule. - operationId: DeleteScanningRule - parameters: - - $ref: '#/components/parameters/SensitiveDataScannerRuleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerRuleDeleteRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerRuleDeleteResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete Scanning Rule - tags: - - Sensitive Data Scanner - x-codegen-request-body-name: body - patch: - description: |- - Update a scanning rule. - The request body MUST NOT include a standard_pattern relationship, as that relationship - is non-editable. Trying to edit the regex attribute of a rule with a standard_pattern - relationship will also result in an error. - operationId: UpdateScanningRule - parameters: - - $ref: '#/components/parameters/SensitiveDataScannerRuleID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerRuleUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerRuleUpdateResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update Scanning Rule - tags: - - Sensitive Data Scanner - x-codegen-request-body-name: body - /api/v2/sensitive-data-scanner/config/standard-patterns: - get: - description: Returns all standard patterns. - operationId: ListStandardPatterns - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SensitiveDataScannerStandardPatternsResponseData' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication Error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List standard patterns - tags: - - Sensitive Data Scanner diff --git a/providers/src/datadog/v00.00.00000/services/service_accounts.yaml b/providers/src/datadog/v00.00.00000/services/service_accounts.yaml deleted file mode 100644 index f82d4cb6..00000000 --- a/providers/src/datadog/v00.00.00000/services/service_accounts.yaml +++ /dev/null @@ -1,1807 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - service_accounts - description: Service_Accounts -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ServiceAccountCreateRequest: - description: Create a service account. - properties: - data: - $ref: '#/components/schemas/ServiceAccountCreateData' - required: - - data - type: object - UserResponse: - description: Response containing information about a single user. - properties: - data: - $ref: '#/components/schemas/User' - included: - description: Array of objects related to the user. - items: - $ref: '#/components/schemas/UserResponseIncludedItem' - type: array - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - ServiceAccountCreateData: - description: Object to create a service account User. - properties: - attributes: - $ref: '#/components/schemas/ServiceAccountCreateAttributes' - relationships: - $ref: '#/components/schemas/UserRelationships' - type: - $ref: '#/components/schemas/UsersType' - required: - - attributes - - type - type: object - User: - description: User object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserAttributes' - id: - description: ID of the user. - type: string - relationships: - $ref: '#/components/schemas/UserResponseRelationships' - type: - $ref: '#/components/schemas/UsersType' - type: object - UserResponseIncludedItem: - description: An object related to a user. - oneOf: - - $ref: '#/components/schemas/Organization' - - $ref: '#/components/schemas/Permission' - - $ref: '#/components/schemas/Role' - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - ServiceAccountCreateAttributes: - description: Attributes of the created user. - properties: - email: - description: The email of the user. - example: jane.doe@example.com - type: string - name: - description: The name of the user. - type: string - service_account: - description: Whether the user is a service account. Must be true. - example: true - type: boolean - title: - description: The title of the user. - type: string - required: - - email - - service_account - type: object - UserRelationships: - description: Relationships of the user object. - properties: - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - UsersType: - default: users - description: Users resource type. - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - UserAttributes: - description: Attributes of user object returned by the API. - properties: - created_at: - description: Creation time of the user. - format: date-time - type: string - disabled: - description: Whether the user is disabled. - type: boolean - email: - description: Email of the user. - type: string - handle: - description: Handle of the user. - type: string - icon: - description: URL of the user's icon. - type: string - modified_at: - description: Time that the user was last modified. - format: date-time - type: string - name: - description: Name of the user. - nullable: true - type: string - service_account: - description: Whether the user is a service account. - type: boolean - status: - description: Status of the user. - type: string - title: - description: Title of the user. - nullable: true - type: string - verified: - description: Whether the user is verified. - type: boolean - type: object - UserResponseRelationships: - description: Relationships of the user object returned by the API. - properties: - org: - $ref: '#/components/schemas/RelationshipToOrganization' - other_orgs: - $ref: '#/components/schemas/RelationshipToOrganizations' - other_users: - $ref: '#/components/schemas/RelationshipToUsers' - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - Organization: - description: Organization object. - properties: - attributes: - $ref: '#/components/schemas/OrganizationAttributes' - id: - description: ID of the organization. - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - type - type: object - Permission: - description: Permission object. - properties: - attributes: - $ref: '#/components/schemas/PermissionAttributes' - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - required: - - type - type: object - Role: - description: Role object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/RoleAttributes' - id: - description: The unique identifier of the role. - type: string - relationships: - $ref: '#/components/schemas/RoleResponseRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - type: object - RelationshipToRoles: - description: Relationship to roles. - properties: - data: - description: An array containing type and the unique identifier of a role. - items: - $ref: '#/components/schemas/RelationshipToRoleData' - type: array - type: object - RelationshipToOrganization: - description: Relationship to an organization. - properties: - data: - $ref: '#/components/schemas/RelationshipToOrganizationData' - required: - - data - type: object - RelationshipToOrganizations: - description: Relationship to organizations. - properties: - data: - description: Relationships to organization objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToOrganizationData' - type: array - required: - - data - type: object - RelationshipToUsers: - description: Relationship to users. - properties: - data: - description: Relationships to user objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToUserData' - type: array - required: - - data - type: object - OrganizationAttributes: - description: Attributes of the organization. - properties: - created_at: - description: Creation time of the organization. - format: date-time - type: string - description: - description: Description of the organization. - type: string - disabled: - description: Whether or not the organization is disabled. - type: boolean - modified_at: - description: Time of last organization modification. - format: date-time - type: string - name: - description: Name of the organization. - type: string - public_id: - description: Public ID of the organization. - type: string - sharing: - description: Sharing type of the organization. - type: string - url: - description: URL of the site that this organization exists at. - type: string - type: object - OrganizationsType: - default: orgs - description: Organizations resource type. - enum: - - orgs - example: orgs - type: string - x-enum-varnames: - - ORGS - PermissionAttributes: - description: Attributes of a permission. - properties: - created: - description: Creation time of the permission. - format: date-time - type: string - description: - description: Description of the permission. - type: string - display_name: - description: Displayed name for the permission. - type: string - display_type: - description: Display type. - type: string - group_name: - description: Name of the permission group. - type: string - name: - description: Name of the permission. - type: string - restricted: - description: Whether or not the permission is restricted. - type: boolean - type: object - PermissionsType: - default: permissions - description: Permissions resource type. - enum: - - permissions - example: permissions - type: string - x-enum-varnames: - - PERMISSIONS - RoleAttributes: - description: Attributes of the role. - properties: - created_at: - description: Creation time of the role. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last role modification. - format: date-time - readOnly: true - type: string - name: - description: The name of the role. The name is neither unique nor a stable identifier of the role. - type: string - user_count: - description: Number of users with that role. - format: int64 - readOnly: true - type: integer - type: object - RoleResponseRelationships: - description: Relationships of the role object returned by the API. - properties: - permissions: - $ref: '#/components/schemas/RelationshipToPermissions' - type: object - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - RelationshipToOrganizationData: - description: Relationship to organization object. - properties: - id: - description: ID of the organization. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - id - - type - type: object - RelationshipToUserData: - description: Relationship to user object. - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - RelationshipToPermissions: - description: Relationship to multiple permissions objects. - properties: - data: - description: Relationships to permission objects. - items: - $ref: '#/components/schemas/RelationshipToPermissionData' - type: array - type: object - RelationshipToPermissionData: - description: Relationship to permission object. - properties: - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - type: object - ListApplicationKeysResponse: - description: Response for a list of application keys. - properties: - data: - description: Array of application keys. - items: - $ref: '#/components/schemas/PartialApplicationKey' - type: array - included: - description: Array of objects related to the application key. - items: - $ref: '#/components/schemas/ApplicationKeyResponseIncludedItem' - type: array - meta: - $ref: '#/components/schemas/ApplicationKeyResponseMeta' - type: object - PartialApplicationKey: - description: Partial Datadog application key. - properties: - attributes: - $ref: '#/components/schemas/PartialApplicationKeyAttributes' - id: - description: ID of the application key. - type: string - relationships: - $ref: '#/components/schemas/ApplicationKeyRelationships' - type: - $ref: '#/components/schemas/ApplicationKeysType' - type: object - ApplicationKeyResponseIncludedItem: - description: An object related to an application key. - oneOf: - - $ref: '#/components/schemas/User' - - $ref: '#/components/schemas/Role' - ApplicationKeyResponseMeta: - description: Additional information related to the application key response. - properties: - max_allowed_per_user: - description: Max allowed number of application keys per user. - format: int64 - type: integer - page: - $ref: '#/components/schemas/ApplicationKeyResponseMetaPage' - type: object - PartialApplicationKeyAttributes: - description: Attributes of a partial application key. - properties: - created_at: - description: Creation date of the application key. - example: '2020-11-23T10:00:00.000Z' - readOnly: true - type: string - last4: - description: The last four characters of the application key. - example: abcd - maxLength: 4 - minLength: 4 - readOnly: true - type: string - name: - description: Name of the application key. - example: Application Key for managing dashboards - type: string - scopes: - description: Array of scopes to grant the application key. - example: - - dashboards_read - - dashboards_write - - dashboards_public_share - items: - description: Name of scope. - type: string - nullable: true - type: array - type: object - ApplicationKeyRelationships: - description: Resources related to the application key. - properties: - owned_by: - $ref: '#/components/schemas/RelationshipToUser' - type: object - ApplicationKeysType: - default: application_keys - description: Application Keys resource type. - enum: - - application_keys - example: application_keys - type: string - x-enum-varnames: - - APPLICATION_KEYS - ApplicationKeyResponseMetaPage: - description: Additional information related to the application key response. - properties: - total_filtered_count: - description: Total filtered application key count. - format: int64 - type: integer - type: object - RelationshipToUser: - description: Relationship to user. - properties: - data: - $ref: '#/components/schemas/RelationshipToUserData' - required: - - data - type: object - ApplicationKeyCreateRequest: - description: Request used to create an application key. - properties: - data: - $ref: '#/components/schemas/ApplicationKeyCreateData' - required: - - data - type: object - ApplicationKeyResponse: - description: Response for retrieving an application key. - properties: - data: - $ref: '#/components/schemas/FullApplicationKey' - included: - description: Array of objects related to the application key. - items: - $ref: '#/components/schemas/ApplicationKeyResponseIncludedItem' - type: array - type: object - ApplicationKeyCreateData: - description: Object used to create an application key. - properties: - attributes: - $ref: '#/components/schemas/ApplicationKeyCreateAttributes' - type: - $ref: '#/components/schemas/ApplicationKeysType' - required: - - attributes - - type - type: object - FullApplicationKey: - description: Datadog application key. - properties: - attributes: - $ref: '#/components/schemas/FullApplicationKeyAttributes' - id: - description: ID of the application key. - type: string - relationships: - $ref: '#/components/schemas/ApplicationKeyRelationships' - type: - $ref: '#/components/schemas/ApplicationKeysType' - type: object - ApplicationKeyCreateAttributes: - description: Attributes used to create an application Key. - properties: - name: - description: Name of the application key. - example: Application Key for managing dashboards - type: string - scopes: - description: Array of scopes to grant the application key. - example: - - dashboards_read - - dashboards_write - - dashboards_public_share - items: - description: Name of scope. - type: string - nullable: true - type: array - required: - - name - type: object - FullApplicationKeyAttributes: - description: Attributes of a full application key. - properties: - created_at: - description: Creation date of the application key. - example: '2020-11-23T10:00:00.000Z' - readOnly: true - type: string - key: - description: The application key. - readOnly: true - type: string - last4: - description: The last four characters of the application key. - example: abcd - maxLength: 4 - minLength: 4 - readOnly: true - type: string - name: - description: Name of the application key. - example: Application Key for managing dashboards - type: string - scopes: - description: Array of scopes to grant the application key. - example: - - dashboards_read - - dashboards_write - - dashboards_public_share - items: - description: Name of scope. - type: string - nullable: true - type: array - type: object - PartialApplicationKeyResponse: - description: Response for retrieving a partial application key. - properties: - data: - $ref: '#/components/schemas/PartialApplicationKey' - included: - description: Array of objects related to the application key. - items: - $ref: '#/components/schemas/ApplicationKeyResponseIncludedItem' - type: array - type: object - ApplicationKeyUpdateRequest: - description: Request used to update an application key. - properties: - data: - $ref: '#/components/schemas/ApplicationKeyUpdateData' - required: - - data - type: object - ApplicationKeyUpdateData: - description: Object used to update an application key. - properties: - attributes: - $ref: '#/components/schemas/ApplicationKeyUpdateAttributes' - id: - description: ID of the application key. - example: 00112233-4455-6677-8899-aabbccddeeff - type: string - type: - $ref: '#/components/schemas/ApplicationKeysType' - required: - - attributes - - id - - type - type: object - ApplicationKeyUpdateAttributes: - description: Attributes used to update an application Key. - properties: - name: - description: Name of the application key. - example: Application Key for managing dashboards - type: string - scopes: - description: Array of scopes to grant the application key. - example: - - dashboards_read - - dashboards_write - - dashboards_public_share - items: - description: Name of scope. - type: string - nullable: true - type: array - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - service_accounts: - id: datadog.service_accounts.service_accounts - name: service_accounts - title: Service Accounts - methods: - create_service_account: - operation: - $ref: '#/paths/~1api~1v2~1service_accounts/post' - response: - mediaType: application/json - openAPIDocKey: '201' - sqlVerbs: - select: [] - insert: - - $ref: '#/components/x-stackQL-resources/service_accounts/methods/create_service_account' - update: [] - delete: [] - service_account_application_keys: - id: datadog.service_accounts.service_account_application_keys - name: service_account_application_keys - title: Service Account Application Keys - methods: - list_service_account_application_keys: - operation: - $ref: '#/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_service_account_application_keys: - operation: - $ref: '#/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_service_account_application_key: - operation: - $ref: '#/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_service_account_application_key: - operation: - $ref: '#/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys~1{app_key_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_service_account_application_key: - operation: - $ref: '#/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys~1{app_key_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_service_account_application_key: - operation: - $ref: '#/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys~1{app_key_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_service_account_application_key: - operation: - $ref: '#/paths/~1api~1v2~1service_accounts~1{service_account_id}~1application_keys~1{app_key_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/service_account_application_keys/methods/get_service_account_application_key' - - $ref: '#/components/x-stackQL-resources/service_account_application_keys/methods/list_service_account_application_keys' - insert: - - $ref: '#/components/x-stackQL-resources/service_account_application_keys/methods/create_service_account_application_key' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/service_account_application_keys/methods/delete_service_account_application_key' -paths: - /api/v2/service_accounts: - post: - description: Create a service account for your organization. - operationId: CreateServiceAccount - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ServiceAccountCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/UserResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a service account - tags: - - Service Accounts - x-codegen-request-body-name: body - '/api/v2/service_accounts/{service_account_id}/application_keys': - get: - description: List all application keys available for this service account. - operationId: ListServiceAccountApplicationKeys - parameters: - - $ref: '#/components/parameters/ServiceAccountID' - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - $ref: '#/components/parameters/ApplicationKeysSortParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtStartParameter' - - $ref: '#/components/parameters/ApplicationKeyFilterCreatedAtEndParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ListApplicationKeysResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: List application keys for this service account - tags: - - Service Accounts - post: - description: Create an application key for this service account. - operationId: CreateServiceAccountApplicationKey - parameters: - - $ref: '#/components/parameters/ServiceAccountID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyResponse' - description: Created - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create an application key for this service account - tags: - - Service Accounts - x-codegen-request-body-name: body - '/api/v2/service_accounts/{service_account_id}/application_keys/{app_key_id}': - delete: - description: Delete an application key owned by this service account. - operationId: DeleteServiceAccountApplicationKey - parameters: - - $ref: '#/components/parameters/ServiceAccountID' - - $ref: '#/components/parameters/ApplicationKeyID' - responses: - '204': - description: No Content - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete an application key for this service account - tags: - - Service Accounts - get: - description: Get an application key owned by this service account. - operationId: GetServiceAccountApplicationKey - parameters: - - $ref: '#/components/parameters/ServiceAccountID' - - $ref: '#/components/parameters/ApplicationKeyID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PartialApplicationKeyResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get one application key for this service account - tags: - - Service Accounts - patch: - description: Edit an application key owned by this service account. - operationId: UpdateServiceAccountApplicationKey - parameters: - - $ref: '#/components/parameters/ServiceAccountID' - - $ref: '#/components/parameters/ApplicationKeyID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ApplicationKeyUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PartialApplicationKeyResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Edit an application key for this service account - tags: - - Service Accounts - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/service_definition.yaml b/providers/src/datadog/v00.00.00000/services/service_definition.yaml deleted file mode 100644 index 91557e0e..00000000 --- a/providers/src/datadog/v00.00.00000/services/service_definition.yaml +++ /dev/null @@ -1,1994 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - service_definition - description: Service_Definition -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ServiceDefinitionsListResponse: - description: Create service definitions response. - properties: - data: - description: Data representing service definitions. - items: - $ref: '#/components/schemas/ServiceDefinitionData' - type: array - type: object - ServiceDefinitionData: - description: Service definition data. - properties: - attributes: - $ref: '#/components/schemas/ServiceDefinitionDataAttributes' - id: - description: Service definition id. - type: string - type: - description: Service definition type. - type: string - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - ServiceDefinitionDataAttributes: - description: Service definition attributes. - properties: - meta: - $ref: '#/components/schemas/ServiceDefinitionMeta' - schema: - $ref: '#/components/schemas/ServiceDefinitionSchema' - type: object - ServiceDefinitionMeta: - description: Metadata about a service definition. - properties: - github-html-url: - description: GitHub HTML URL. - type: string - ingested-schema-version: - description: Ingestion schema version. - type: string - ingestion-source: - description: Ingestion source of the service definition. - type: string - last-modified-time: - description: Last modified time of the service definition. - type: string - origin: - description: User defined origin of the service definition. - type: string - origin-detail: - description: User defined origin's detail of the service definition. - type: string - warnings: - description: A list of schema validation warnings. - items: - $ref: '#/components/schemas/ServiceDefinitionMetaWarnings' - type: array - type: object - ServiceDefinitionSchema: - description: Service definition schema. - oneOf: - - $ref: '#/components/schemas/ServiceDefinitionV1' - - $ref: '#/components/schemas/ServiceDefinitionV2' - - $ref: '#/components/schemas/ServiceDefinitionV2Dot1' - - $ref: '#/components/schemas/ServiceDefinitionV2Dot2' - type: object - ServiceDefinitionMetaWarnings: - description: Schema validation warnings. - properties: - instance-location: - description: The warning instance location. - type: string - keyword-location: - description: The warning keyword location. - type: string - message: - description: The warning message. - type: string - type: object - ServiceDefinitionV1: - deprecated: true - description: Deprecated - Service definition V1 for providing additional service metadata and integrations. - properties: - contact: - $ref: '#/components/schemas/ServiceDefinitionV1Contact' - extensions: - additionalProperties: {} - description: Extensions to V1 schema. - example: - myorg/extension: extensionValue - type: object - external-resources: - description: A list of external links related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV1Resource' - type: array - info: - $ref: '#/components/schemas/ServiceDefinitionV1Info' - integrations: - $ref: '#/components/schemas/ServiceDefinitionV1Integrations' - org: - $ref: '#/components/schemas/ServiceDefinitionV1Org' - schema-version: - $ref: '#/components/schemas/ServiceDefinitionV1Version' - tags: - description: A set of custom tags. - example: - - 'my:tag' - - 'service:tag' - items: - type: string - type: array - required: - - schema-version - - info - type: object - ServiceDefinitionV2: - description: Service definition V2 for providing service metadata and integrations. - properties: - contacts: - description: A list of contacts related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV2Contact' - type: array - dd-service: - description: Unique identifier of the service. Must be unique across all services and is used to match with a service in Datadog. - example: my-service - type: string - dd-team: - description: Experimental feature. A Team handle that matches a Team in the Datadog Teams product. - example: my-team - type: string - docs: - description: A list of documentation related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV2Doc' - type: array - extensions: - additionalProperties: {} - description: Extensions to V2 schema. - example: - myorg/extension: extensionValue - type: object - integrations: - $ref: '#/components/schemas/ServiceDefinitionV2Integrations' - links: - description: A list of links related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV2Link' - type: array - repos: - description: A list of code repositories related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV2Repo' - type: array - schema-version: - $ref: '#/components/schemas/ServiceDefinitionV2Version' - tags: - description: A set of custom tags. - example: - - 'my:tag' - - 'service:tag' - items: - type: string - type: array - team: - description: Team that owns the service. - example: my-team - type: string - required: - - schema-version - - dd-service - type: object - ServiceDefinitionV2Dot1: - description: Service definition v2.1 for providing service metadata and integrations. - properties: - application: - description: 'Identifier for a group of related services serving a product feature, which the service is a part of.' - example: my-app - type: string - contacts: - description: A list of contacts related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Contact' - type: array - dd-service: - description: Unique identifier of the service. Must be unique across all services and is used to match with a service in Datadog. - example: my-service - type: string - description: - description: A short description of the service. - example: My service description - type: string - extensions: - additionalProperties: {} - description: Extensions to v2.1 schema. - example: - myorg/extension: extensionValue - type: object - integrations: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Integrations' - lifecycle: - description: The current life cycle phase of the service. - example: sandbox - type: string - links: - description: A list of links related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Link' - type: array - schema-version: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Version' - tags: - description: A set of custom tags. - example: - - 'my:tag' - - 'service:tag' - items: - type: string - type: array - team: - description: Team that owns the service. It is used to locate a team defined in Datadog Teams if it exists. - example: my-team - type: string - tier: - description: Importance of the service. - example: High - type: string - required: - - schema-version - - dd-service - type: object - ServiceDefinitionV2Dot2: - description: Service definition v2.2 for providing service metadata and integrations. - properties: - application: - description: 'Identifier for a group of related services serving a product feature, which the service is a part of.' - example: my-app - type: string - contacts: - description: A list of contacts related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV2Dot2Contact' - type: array - dd-service: - description: Unique identifier of the service. Must be unique across all services and is used to match with a service in Datadog. - example: my-service - type: string - description: - description: A short description of the service. - example: My service description - type: string - extensions: - additionalProperties: {} - description: Extensions to v2.2 schema. - example: - myorg/extension: extensionValue - type: object - integrations: - $ref: '#/components/schemas/ServiceDefinitionV2Dot2Integrations' - languages: - description: 'The service''s programming language. Datadog recognizes the following languages: `dotnet`, `go`, `java`, `js`, `php`, `python`, `ruby`, and `c++`.' - example: - - dotnet - - go - - java - - js - - php - - python - - ruby - - c++ - items: - type: string - type: array - lifecycle: - description: The current life cycle phase of the service. - example: sandbox - type: string - links: - description: A list of links related to the services. - items: - $ref: '#/components/schemas/ServiceDefinitionV2Dot2Link' - type: array - schema-version: - $ref: '#/components/schemas/ServiceDefinitionV2Dot2Version' - tags: - description: A set of custom tags. - example: - - 'my:tag' - - 'service:tag' - items: - type: string - type: array - team: - description: Team that owns the service. It is used to locate a team defined in Datadog Teams if it exists. - example: my-team - type: string - tier: - description: Importance of the service. - example: High - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2Dot2Type' - required: - - schema-version - - dd-service - type: object - ServiceDefinitionV1Contact: - description: Contact information about the service. - properties: - email: - description: Service owner’s email. - example: contact@datadoghq.com - format: email - type: string - slack: - description: Service owner’s Slack channel. - example: 'https://yourcompany.slack.com/archives/channel123' - type: string - type: object - ServiceDefinitionV1Resource: - description: Service's external links. - properties: - name: - description: Link name. - example: Runbook - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV1ResourceType' - url: - description: Link URL. - example: 'https://my-runbook' - type: string - required: - - name - - type - - url - type: object - ServiceDefinitionV1Info: - description: Basic information about a service. - properties: - dd-service: - description: Unique identifier of the service. Must be unique across all services and is used to match with a service in Datadog. - example: myservice - type: string - description: - description: A short description of the service. - example: A shopping cart service - type: string - display-name: - description: A friendly name of the service. - example: My Service - type: string - service-tier: - description: Service tier. - example: Tier 1 - type: string - required: - - dd-service - type: object - ServiceDefinitionV1Integrations: - description: Third party integrations that Datadog supports. - properties: - pagerduty: - $ref: '#/components/schemas/ServiceDefinitionV1Pagerduty' - type: object - ServiceDefinitionV1Org: - description: Org related information about the service. - properties: - application: - description: App feature this service supports. - example: E-Commerce - type: string - team: - description: Team that owns the service. - example: my-team - type: string - type: object - ServiceDefinitionV1Version: - default: v1 - description: Schema version being used. - enum: - - v1 - example: v1 - type: string - x-enum-varnames: - - V1 - ServiceDefinitionV2Contact: - description: Service owner's contacts information. - oneOf: - - $ref: '#/components/schemas/ServiceDefinitionV2Email' - - $ref: '#/components/schemas/ServiceDefinitionV2Slack' - - $ref: '#/components/schemas/ServiceDefinitionV2MSTeams' - ServiceDefinitionV2Doc: - description: Service documents. - properties: - name: - description: Document name. - example: Architecture - type: string - provider: - description: Document provider. - example: google drive - type: string - url: - description: Document URL. - example: 'https://gdrive/mydoc' - type: string - required: - - name - - url - type: object - ServiceDefinitionV2Integrations: - description: Third party integrations that Datadog supports. - properties: - opsgenie: - $ref: '#/components/schemas/ServiceDefinitionV2Opsgenie' - pagerduty: - $ref: '#/components/schemas/ServiceDefinitionV2Pagerduty' - type: object - ServiceDefinitionV2Link: - description: Service's external links. - properties: - name: - description: Link name. - example: Runbook - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2LinkType' - url: - description: Link URL. - example: 'https://my-runbook' - type: string - required: - - name - - type - - url - type: object - ServiceDefinitionV2Repo: - description: Service code repositories. - properties: - name: - description: Repository name. - example: Source Code - type: string - provider: - description: Repository provider. - example: GitHub - type: string - url: - description: Repository URL. - example: 'https://github.com/DataDog/schema' - type: string - required: - - name - - url - type: object - ServiceDefinitionV2Version: - default: v2 - description: Schema version being used. - enum: - - v2 - example: v2 - type: string - x-enum-varnames: - - V2 - ServiceDefinitionV2Dot1Contact: - description: Service owner's contacts information. - oneOf: - - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Email' - - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Slack' - - $ref: '#/components/schemas/ServiceDefinitionV2Dot1MSTeams' - ServiceDefinitionV2Dot1Integrations: - description: Third party integrations that Datadog supports. - properties: - opsgenie: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Opsgenie' - pagerduty: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Pagerduty' - type: object - ServiceDefinitionV2Dot1Link: - description: Service's external links. - properties: - name: - description: Link name. - example: Runbook - type: string - provider: - description: Link provider. - example: Github - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1LinkType' - url: - description: Link URL. - example: 'https://my-runbook' - type: string - required: - - name - - type - - url - type: object - ServiceDefinitionV2Dot1Version: - default: v2.1 - description: Schema version being used. - enum: - - v2.1 - example: v2.1 - type: string - x-enum-varnames: - - V2_1 - ServiceDefinitionV2Dot2Contact: - description: Service owner's contacts information. - properties: - contact: - description: Contact value. - example: 'https://teams.microsoft.com/myteam' - type: string - name: - description: Contact Name. - example: My team channel - type: string - type: - description: 'Contact type. Datadog recognizes the following types: `email`, `slack`, and `microsoft-teams`.' - example: slack - type: string - required: - - type - - contact - type: object - ServiceDefinitionV2Dot2Integrations: - description: Third party integrations that Datadog supports. - properties: - opsgenie: - $ref: '#/components/schemas/ServiceDefinitionV2Dot2Opsgenie' - pagerduty: - $ref: '#/components/schemas/ServiceDefinitionV2Dot2Pagerduty' - type: object - ServiceDefinitionV2Dot2Link: - description: Service's external links. - properties: - name: - description: Link name. - example: Runbook - type: string - provider: - description: Link provider. - example: Github - type: string - type: - description: 'Link type. Datadog recognizes the following types: `runbook`, `doc`, `repo`, `dashboard`, and `other`.' - example: runbook - type: string - url: - description: Link URL. - example: 'https://my-runbook' - type: string - required: - - name - - type - - url - type: object - ServiceDefinitionV2Dot2Version: - default: v2.2 - description: Schema version being used. - enum: - - v2.2 - example: v2.2 - type: string - x-enum-varnames: - - V2_2 - ServiceDefinitionV2Dot2Type: - description: The type of service. - enum: - - web - - db - - cache - - function - - browser - - mobile - - custom - example: web - type: string - x-enum-varnames: - - WEB - - DB - - CACHE - - FUNCTION - - BROSWER - - MOBILE - - CUSTOM - ServiceDefinitionV1ResourceType: - description: Link type. - enum: - - doc - - wiki - - runbook - - url - - repo - - dashboard - - oncall - - code - - link - example: runbook - type: string - x-enum-varnames: - - DOC - - WIKI - - RUNBOOK - - URL - - REPO - - DASHBOARD - - ONCALL - - CODE - - LINK - ServiceDefinitionV1Pagerduty: - description: PagerDuty service URL for the service. - example: 'https://my-org.pagerduty.com/service-directory/PMyService' - type: string - ServiceDefinitionV2Email: - description: Service owner's email. - properties: - contact: - description: Contact value. - example: contact@datadoghq.com - format: email - type: string - name: - description: Contact email. - example: Team Email - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2EmailType' - required: - - type - - contact - type: object - ServiceDefinitionV2Slack: - description: Service owner's Slack channel. - properties: - contact: - description: Slack Channel. - example: 'https://yourcompany.slack.com/archives/channel123' - type: string - name: - description: Contact Slack. - example: Team Slack - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2SlackType' - required: - - type - - contact - type: object - ServiceDefinitionV2MSTeams: - description: Service owner's Microsoft Teams. - properties: - contact: - description: Contact value. - example: 'https://teams.microsoft.com/myteam' - type: string - name: - description: Contact Microsoft Teams. - example: My team channel - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2MSTeamsType' - required: - - type - - contact - type: object - ServiceDefinitionV2Opsgenie: - description: Opsgenie integration for the service. - properties: - region: - $ref: '#/components/schemas/ServiceDefinitionV2OpsgenieRegion' - service-url: - description: Opsgenie service url. - example: 'https://my-org.opsgenie.com/service/123e4567-e89b-12d3-a456-426614174000' - type: string - required: - - service-url - type: object - ServiceDefinitionV2Pagerduty: - description: PagerDuty service URL for the service. - example: 'https://my-org.pagerduty.com/service-directory/PMyService' - type: string - ServiceDefinitionV2LinkType: - description: Link type. - enum: - - doc - - wiki - - runbook - - url - - repo - - dashboard - - oncall - - code - - link - example: runbook - type: string - x-enum-varnames: - - DOC - - WIKI - - RUNBOOK - - URL - - REPO - - DASHBOARD - - ONCALL - - CODE - - LINK - ServiceDefinitionV2Dot1Email: - description: Service owner's email. - properties: - contact: - description: Contact value. - example: contact@datadoghq.com - format: email - type: string - name: - description: Contact email. - example: Team Email - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1EmailType' - required: - - type - - contact - type: object - ServiceDefinitionV2Dot1Slack: - description: Service owner's Slack channel. - properties: - contact: - description: Slack Channel. - example: 'https://yourcompany.slack.com/archives/channel123' - type: string - name: - description: Contact Slack. - example: Team Slack - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1SlackType' - required: - - type - - contact - type: object - ServiceDefinitionV2Dot1MSTeams: - description: Service owner's Microsoft Teams. - properties: - contact: - description: Contact value. - example: 'https://teams.microsoft.com/myteam' - type: string - name: - description: Contact Microsoft Teams. - example: My team channel - type: string - type: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1MSTeamsType' - required: - - type - - contact - type: object - ServiceDefinitionV2Dot1Opsgenie: - description: Opsgenie integration for the service. - properties: - region: - $ref: '#/components/schemas/ServiceDefinitionV2Dot1OpsgenieRegion' - service-url: - description: Opsgenie service url. - example: 'https://my-org.opsgenie.com/service/123e4567-e89b-12d3-a456-426614174000' - type: string - required: - - service-url - type: object - ServiceDefinitionV2Dot1Pagerduty: - description: PagerDuty integration for the service. - properties: - service-url: - description: PagerDuty service url. - example: 'https://my-org.pagerduty.com/service-directory/PMyService' - type: string - type: object - ServiceDefinitionV2Dot1LinkType: - description: Link type. - enum: - - doc - - repo - - runbook - - dashboard - - other - example: runbook - type: string - x-enum-varnames: - - DOC - - REPO - - RUNBOOK - - DASHBOARD - - OTHER - ServiceDefinitionV2Dot2Opsgenie: - description: Opsgenie integration for the service. - properties: - region: - $ref: '#/components/schemas/ServiceDefinitionV2Dot2OpsgenieRegion' - service-url: - description: Opsgenie service url. - example: 'https://my-org.opsgenie.com/service/123e4567-e89b-12d3-a456-426614174000' - type: string - required: - - service-url - type: object - ServiceDefinitionV2Dot2Pagerduty: - description: PagerDuty integration for the service. - properties: - service-url: - description: PagerDuty service url. - example: 'https://my-org.pagerduty.com/service-directory/PMyService' - type: string - type: object - ServiceDefinitionV2EmailType: - description: Contact type. - enum: - - email - example: email - type: string - x-enum-varnames: - - EMAIL - ServiceDefinitionV2SlackType: - description: Contact type. - enum: - - slack - example: slack - type: string - x-enum-varnames: - - SLACK - ServiceDefinitionV2MSTeamsType: - description: Contact type. - enum: - - microsoft-teams - example: microsoft-teams - type: string - x-enum-varnames: - - MICROSOFT_TEAMS - ServiceDefinitionV2OpsgenieRegion: - description: Opsgenie instance region. - enum: - - US - - EU - example: US - type: string - x-enum-varnames: - - US - - EU - ServiceDefinitionV2Dot1EmailType: - description: Contact type. - enum: - - email - example: email - type: string - x-enum-varnames: - - EMAIL - ServiceDefinitionV2Dot1SlackType: - description: Contact type. - enum: - - slack - example: slack - type: string - x-enum-varnames: - - SLACK - ServiceDefinitionV2Dot1MSTeamsType: - description: Contact type. - enum: - - microsoft-teams - example: microsoft-teams - type: string - x-enum-varnames: - - MICROSOFT_TEAMS - ServiceDefinitionV2Dot1OpsgenieRegion: - description: Opsgenie instance region. - enum: - - US - - EU - example: US - type: string - x-enum-varnames: - - US - - EU - ServiceDefinitionV2Dot2OpsgenieRegion: - description: Opsgenie instance region. - enum: - - US - - EU - example: US - type: string - x-enum-varnames: - - US - - EU - ServiceDefinitionsCreateRequest: - description: Create service definitions request. - oneOf: - - $ref: '#/components/schemas/ServiceDefinitionV2Dot2' - - $ref: '#/components/schemas/ServiceDefinitionV2Dot1' - - $ref: '#/components/schemas/ServiceDefinitionV2' - - $ref: '#/components/schemas/ServiceDefinitionRaw' - ServiceDefinitionCreateResponse: - description: Create service definitions response. - properties: - data: - description: Create service definitions response payload. - items: - $ref: '#/components/schemas/ServiceDefinitionData' - type: array - type: object - ServiceDefinitionRaw: - description: Service Definition in raw JSON/YAML representation. - example: | - --- - schema-version: v2 - dd-service: my-service - type: string - ServiceDefinitionGetResponse: - description: Get service definition response. - properties: - data: - $ref: '#/components/schemas/ServiceDefinitionData' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ConflictResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - service_definitions: - id: datadog.service_definition.service_definitions - name: service_definitions - title: Service Definitions - methods: - list_service_definitions: - operation: - $ref: '#/paths/~1api~1v2~1services~1definitions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_service_definitions: - operation: - $ref: '#/paths/~1api~1v2~1services~1definitions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_or_update_service_definitions: - operation: - $ref: '#/paths/~1api~1v2~1services~1definitions/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_service_definition: - operation: - $ref: '#/paths/~1api~1v2~1services~1definitions~1{service_name}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_service_definition: - operation: - $ref: '#/paths/~1api~1v2~1services~1definitions~1{service_name}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_service_definition: - operation: - $ref: '#/paths/~1api~1v2~1services~1definitions~1{service_name}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/service_definitions/methods/get_service_definition' - - $ref: '#/components/x-stackQL-resources/service_definitions/methods/list_service_definitions' - insert: - - $ref: '#/components/x-stackQL-resources/service_definitions/methods/create_or_update_service_definitions' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/service_definitions/methods/delete_service_definition' -paths: - /api/v2/services/definitions: - get: - description: Get a list of all service definitions from the Datadog Service Catalog. - operationId: ListServiceDefinitions - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - $ref: '#/components/parameters/SchemaVersion' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ServiceDefinitionsListResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_read - summary: Get all service definitions - tags: - - Service Definition - x-pagination: - limitParam: 'page[size]' - pageOffsetParam: 'page[number]' - resultsPath: data - post: - description: Create or update service definition in the Datadog Service Catalog. - operationId: CreateOrUpdateServiceDefinitions - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/ServiceDefinitionsCreateRequest' - description: Service Definition YAML/JSON. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ServiceDefinitionCreateResponse' - description: CREATED - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_write - summary: Create or update service definition - tags: - - Service Definition - x-codegen-request-body-name: body - '/api/v2/services/definitions/{service_name}': - delete: - description: Delete a single service definition in the Datadog Service Catalog. - operationId: DeleteServiceDefinition - parameters: - - $ref: '#/components/parameters/ServiceName' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_write - summary: Delete a single service definition - tags: - - Service Definition - get: - description: Get a single service definition from the Datadog Service Catalog. - operationId: GetServiceDefinition - parameters: - - $ref: '#/components/parameters/ServiceName' - - $ref: '#/components/parameters/SchemaVersion' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ServiceDefinitionGetResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_read - summary: Get a single service definition - tags: - - Service Definition diff --git a/providers/src/datadog/v00.00.00000/services/service_management.yaml b/providers/src/datadog/v00.00.00000/services/service_management.yaml new file mode 100644 index 00000000..a115bc0f --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/service_management.yaml @@ -0,0 +1,15378 @@ +openapi: 3.0.0 +info: + title: service_management API + description: datadog service_management API + version: '1.0' +paths: + /api/v2/cases: + get: + description: Search cases. + operationId: SearchCases + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - $ref: '#/components/parameters/CaseSortableFieldParameter' + - description: Search query + in: query + name: filter + required: false + schema: + example: status:open (team:case-management OR team:event-management) + type: string + - description: Specify if order is ascending or not + in: query + name: sort[asc] + required: false + schema: + default: false + type: boolean + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CasesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_read + summary: Search cases + tags: + - Case Management + x-pagination: + limitParam: page[size] + pageParam: page[number] + resultsPath: data + post: + description: Create a Case + operationId: CreateCase + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CaseCreateRequest' + description: Case payload + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Create a case + tags: + - Case Management + /api/v2/cases/projects: + get: + description: Get all projects. + operationId: GetProjects + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ProjectsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_read + summary: Get all projects + tags: + - Case Management + post: + description: Create a project. + operationId: CreateProject + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ProjectCreateRequest' + description: Project payload + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/ProjectResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Create a project + tags: + - Case Management + /api/v2/cases/projects/{project_id}: + delete: + description: Remove a project using the project's `id`. + operationId: DeleteProject + parameters: + - $ref: '#/components/parameters/ProjectIDPathParameter' + responses: + '204': + description: No Content + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: API error response + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Remove a project + tags: + - Case Management + get: + description: Get the details of a project by `project_id`. + operationId: GetProject + parameters: + - $ref: '#/components/parameters/ProjectIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ProjectResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_read + summary: Get the details of a project + tags: + - Case Management + /api/v2/cases/{case_id}: + get: + description: Get the details of case by `case_id` + operationId: GetCase + parameters: + - $ref: '#/components/parameters/CaseIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_read + summary: Get the details of a case + tags: + - Case Management + /api/v2/cases/{case_id}/archive: + post: + description: Archive case + operationId: ArchiveCase + parameters: + - $ref: '#/components/parameters/CaseIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CaseEmptyRequest' + description: Archive case payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Archive case + tags: + - Case Management + /api/v2/cases/{case_id}/assign: + post: + description: Assign case to a user + operationId: AssignCase + parameters: + - $ref: '#/components/parameters/CaseIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CaseAssignRequest' + description: Assign case payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Assign case + tags: + - Case Management + /api/v2/cases/{case_id}/attributes: + post: + description: Update case attributes + operationId: UpdateAttributes + parameters: + - $ref: '#/components/parameters/CaseIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CaseUpdateAttributesRequest' + description: Case attributes update payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Update case attributes + tags: + - Case Management + /api/v2/cases/{case_id}/priority: + post: + description: Update case priority + operationId: UpdatePriority + parameters: + - $ref: '#/components/parameters/CaseIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CaseUpdatePriorityRequest' + description: Case priority update payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Update case priority + tags: + - Case Management + /api/v2/cases/{case_id}/status: + post: + description: Update case status + operationId: UpdateStatus + parameters: + - $ref: '#/components/parameters/CaseIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CaseUpdateStatusRequest' + description: Case status update payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Update case status + tags: + - Case Management + /api/v2/cases/{case_id}/unarchive: + post: + description: Unarchive case + operationId: UnarchiveCase + parameters: + - $ref: '#/components/parameters/CaseIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CaseEmptyRequest' + description: Unarchive case payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Unarchive case + tags: + - Case Management + /api/v2/cases/{case_id}/unassign: + post: + description: Unassign case + operationId: UnassignCase + parameters: + - $ref: '#/components/parameters/CaseIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CaseEmptyRequest' + description: Unassign case payload + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CaseResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - cases_write + summary: Unassign case + tags: + - Case Management + /api/v2/downtime: + get: + description: Get all scheduled downtimes. + operationId: ListDowntimes + parameters: + - description: Only return downtimes that are active when the request is made. + in: query + name: current_only + required: false + schema: + type: boolean + - description: >- + Comma-separated list of resource paths for related resources to + include in the response. Supported resource + + paths are `created_by` and `monitor`. + in: query + name: include + required: false + schema: + example: created_by,monitor + type: string + - $ref: '#/components/parameters/PageOffset' + - description: Maximum number of downtimes in the response. + example: 100 + in: query + name: page[limit] + required: false + schema: + default: 30 + format: int64 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ListDowntimesResponse' + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_downtime + summary: Get all downtimes + tags: + - Downtimes + x-pagination: + limitParam: page[limit] + pageOffsetParam: page[offset] + resultsPath: data + x-permission: + operator: OR + permissions: + - monitors_downtime + post: + description: Schedule a downtime. + operationId: CreateDowntime + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DowntimeCreateRequest' + description: Schedule a downtime request body. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DowntimeResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_downtime + summary: Schedule a downtime + tags: + - Downtimes + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - monitors_downtime + /api/v2/downtime/{downtime_id}: + delete: + description: >- + Cancel a downtime. + + + **Note**: Downtimes canceled through the API are no longer active, but + are retained for approximately two days before being permanently + removed. The downtime may still appear in search results until it is + permanently removed. + operationId: CancelDowntime + parameters: + - description: ID of the downtime to cancel. + in: path + name: downtime_id + required: true + schema: + example: 00000000-0000-1234-0000-000000000000 + type: string + responses: + '204': + description: OK + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Downtime not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_downtime + summary: Cancel a downtime + tags: + - Downtimes + x-permission: + operator: OR + permissions: + - monitors_downtime + get: + description: Get downtime detail by `downtime_id`. + operationId: GetDowntime + parameters: + - description: ID of the downtime to fetch. + in: path + name: downtime_id + required: true + schema: + example: 00000000-0000-1234-0000-000000000000 + type: string + - description: >- + Comma-separated list of resource paths for related resources to + include in the response. Supported resource + + paths are `created_by` and `monitor`. + in: query + name: include + required: false + schema: + example: created_by,monitor + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DowntimeResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_downtime + summary: Get a downtime + tags: + - Downtimes + x-permission: + operator: OR + permissions: + - monitors_downtime + patch: + description: Update a downtime by `downtime_id`. + operationId: UpdateDowntime + parameters: + - description: ID of the downtime to update. + in: path + name: downtime_id + required: true + schema: + example: 00e000000-0000-1234-0000-000000000000 + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DowntimeUpdateRequest' + description: Update a downtime request body. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DowntimeResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Downtime not found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - monitors_downtime + summary: Update a downtime + tags: + - Downtimes + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - monitors_downtime + /api/v2/error-tracking/issues/search: + post: + description: >- + Search issues endpoint allows you to programmatically search for issues + within your organization. This endpoint returns a list of issues that + match a given search query, following the event search syntax. The + search results are limited to a maximum of 100 issues per request. + operationId: SearchIssues + parameters: + - $ref: '#/components/parameters/SearchIssuesIncludeQueryParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IssuesSearchRequest' + description: Search issues request payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IssuesSearchResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - error_tracking_read + summary: Search error tracking issues + tags: + - Error Tracking + /api/v2/error-tracking/issues/{issue_id}: + get: + description: >- + Retrieve the full details for a specific error tracking issue, including + attributes and relationships. + operationId: GetIssue + parameters: + - $ref: '#/components/parameters/IssueIDPathParameter' + - $ref: '#/components/parameters/GetIssueIncludeQueryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IssueResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - error_tracking_read + summary: Get the details of an error tracking issue + tags: + - Error Tracking + /api/v2/error-tracking/issues/{issue_id}/assignee: + put: + description: Update the assignee of an issue by `issue_id`. + operationId: UpdateIssueAssignee + parameters: + - $ref: '#/components/parameters/IssueIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IssueUpdateAssigneeRequest' + description: Update issue assignee request payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IssueResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - error_tracking_read + - error_tracking_write + - cases_read + - cases_write + summary: Update the assignee of an issue + tags: + - Error Tracking + /api/v2/error-tracking/issues/{issue_id}/state: + put: + description: >- + Update the state of an issue by `issue_id`. Use this endpoint to move an + issue between states such as `OPEN`, `RESOLVED`, or `IGNORED`. + operationId: UpdateIssueState + parameters: + - $ref: '#/components/parameters/IssueIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IssueUpdateStateRequest' + description: Update issue state request payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IssueResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - error_tracking_read + - error_tracking_write + summary: Update the state of an issue + tags: + - Error Tracking + /api/v2/events: + get: + description: >- + List endpoint returns events that match an events search query. + + [Results are paginated similarly to + logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). + + + Use this endpoint to see your latest events. + operationId: ListEvents + parameters: + - description: Search query following events syntax. + in: query + name: filter[query] + required: false + schema: + type: string + - description: Minimum timestamp for requested events, in milliseconds. + in: query + name: filter[from] + required: false + schema: + type: string + - description: Maximum timestamp for requested events, in milliseconds. + in: query + name: filter[to] + required: false + schema: + type: string + - description: Order of events in results. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/EventsSort' + - description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + in: query + name: page[cursor] + required: false + schema: + type: string + - description: Maximum number of events in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 10 + format: int32 + maximum: 1000 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/EventsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - events_read + summary: Get a list of events + tags: + - Events + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + x-permission: + operator: OR + permissions: + - events_read + post: + description: >- + This endpoint allows you to publish events. + + + **Note:** To utilize this endpoint with our client libraries, please + ensure you are using the latest version released on or after July 1, + 2025. Earlier versions do not support this functionality. + + + ✅ **Only events with the `change` or `alert` category** are in General + Availability. For change events, see [Change + Tracking](https://docs.datadoghq.com/change_tracking) for more details. + + + ❌ For use cases involving other event categories, use the V1 endpoint or + reach out to [support](https://www.datadoghq.com/support/). + + + ❌ Notifications are not yet supported for events sent to this endpoint. + Use the V1 endpoint for notification functionality. + operationId: CreateEvent + requestBody: + content: + application/json: + examples: + json-request-body: + value: + data: + attributes: + aggregation_key: aggregation_key_123 + attributes: + author: + name: example@datadog.com + type: user + change_metadata: + dd: + team: datadog_team + user_email: datadog@datadog.com + user_id: datadog_user_id + user_name: datadog_username + resource_link: datadog.com/feature/fallback_payments_test + changed_resource: + name: fallback_payments_test + type: feature_flag + impacted_resources: + - name: payments_api + type: service + new_value: + enabled: true + percentage: 50% + rule: + datacenter: devcycle.us1.prod + prev_value: + enabled: true + percentage: 10% + rule: + datacenter: devcycle.us1.prod + category: change + integration_id: custom-events + message: payment_processed feature flag has been enabled + tags: + - env:api_client_test + timestamp: '2020-01-01T01:30:15.010000Z' + title: payment_processed feature flag updated + type: event + schema: + $ref: '#/components/schemas/EventCreateRequestPayload' + description: Event creation request payload. + required: true + responses: + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/EventCreateResponsePayload' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + servers: + - url: https://{subdomain}.{site} + variables: + site: + default: datadoghq.com + description: The regional site for customers. + enum: + - datadoghq.com + - us3.datadoghq.com + - us5.datadoghq.com + - ap1.datadoghq.com + - datadoghq.eu + - ddog-gov.com + subdomain: + default: event-management-intake + description: The subdomain where the API is deployed. + - url: '{protocol}://{name}' + variables: + name: + default: event-management-intake.datadoghq.com + description: Full site DNS name. + protocol: + default: https + description: The protocol for accessing the API. + - url: https://{subdomain}.{site} + variables: + site: + default: datadoghq.com + description: Any Datadog deployment. + subdomain: + default: event-management-intake + description: The subdomain where the API is deployed. + summary: Post an event + tags: + - Events + x-codegen-request-body-name: body + /api/v2/events/search: + post: + description: >- + List endpoint returns events that match an events search query. + + [Results are paginated similarly to + logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). + + + Use this endpoint to build complex events filtering and search. + operationId: SearchEvents + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/EventsListRequest' + required: false + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/EventsListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Search events + tags: + - Events + x-codegen-request-body-name: body + x-pagination: + cursorParam: body.page.cursor + cursorPath: meta.page.after + limitParam: body.page.limit + resultsPath: data + x-permission: + operator: OR + permissions: + - events_read + /api/v2/events/{event_id}: + get: + description: Get the details of an event by `event_id`. + operationId: GetEvent + parameters: + - description: The UID of the event. + in: path + name: event_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/V2EventResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - events_read + summary: Get an event + tags: + - Events + x-permission: + operator: OR + permissions: + - events_read + /api/v2/incidents: + get: + description: Get all incidents for the user's organization. + operationId: ListIncidents + parameters: + - $ref: '#/components/parameters/IncidentIncludeQueryParameter' + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageOffset' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get a list of incidents + tags: + - Incidents + x-pagination: + limitParam: page[size] + pageOffsetParam: page[offset] + resultsPath: data + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + post: + description: Create an incident. + operationId: CreateIncident + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentCreateRequest' + description: Incident payload. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Create an incident + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/config/notification-rules: + get: + description: >- + Lists all notification rules for the organization. Optionally filter by + incident type. + operationId: ListIncidentNotificationRules + parameters: + - $ref: >- + #/components/parameters/IncidentNotificationRuleIncludeQueryParameter + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentNotificationRuleArray' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_notification_settings_read + summary: List incident notification rules + tags: + - Incidents + x-permission: + operator: AND + permissions: + - incident_notification_settings_read + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + post: + description: Creates a new notification rule. + operationId: CreateIncidentNotificationRule + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateIncidentNotificationRuleRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentNotificationRule' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_notification_settings_write + summary: Create an incident notification rule + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - incident_notification_settings_write + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/config/notification-rules/{id}: + delete: + description: Deletes a notification rule by its ID. + operationId: DeleteIncidentNotificationRule + parameters: + - $ref: '#/components/parameters/IncidentNotificationRuleIDPathParameter' + - $ref: >- + #/components/parameters/IncidentNotificationRuleIncludeQueryParameter + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_notification_settings_write + summary: Delete an incident notification rule + tags: + - Incidents + x-permission: + operator: AND + permissions: + - incident_notification_settings_write + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + get: + description: Retrieves a specific notification rule by its ID. + operationId: GetIncidentNotificationRule + parameters: + - $ref: '#/components/parameters/IncidentNotificationRuleIDPathParameter' + - $ref: >- + #/components/parameters/IncidentNotificationRuleIncludeQueryParameter + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentNotificationRule' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_notification_settings_read + summary: Get an incident notification rule + tags: + - Incidents + x-permission: + operator: AND + permissions: + - incident_notification_settings_read + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + put: + description: Updates an existing notification rule with a complete replacement. + operationId: UpdateIncidentNotificationRule + parameters: + - $ref: '#/components/parameters/IncidentNotificationRuleIDPathParameter' + - $ref: >- + #/components/parameters/IncidentNotificationRuleIncludeQueryParameter + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/PutIncidentNotificationRuleRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentNotificationRule' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_notification_settings_write + summary: Update an incident notification rule + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - incident_notification_settings_write + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/config/notification-templates: + get: + description: Lists all notification templates. Optionally filter by incident type. + operationId: ListIncidentNotificationTemplates + parameters: + - $ref: >- + #/components/parameters/IncidentNotificationTemplateIncidentTypeFilterQueryParameter + - $ref: >- + #/components/parameters/IncidentNotificationTemplateIncludeQueryParameter + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentNotificationTemplateArray' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_read + summary: List incident notification templates + tags: + - Incidents + x-permission: + operator: AND + permissions: + - incident_notification_settings_read + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + post: + description: Creates a new notification template. + operationId: CreateIncidentNotificationTemplate + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateIncidentNotificationTemplateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentNotificationTemplate' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_notification_settings_write + summary: Create incident notification template + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - incident_notification_settings_write + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/config/notification-templates/{id}: + delete: + description: Deletes a notification template by its ID. + operationId: DeleteIncidentNotificationTemplate + parameters: + - $ref: '#/components/parameters/IncidentNotificationTemplateIDPathParameter' + - $ref: >- + #/components/parameters/IncidentNotificationTemplateIncludeQueryParameter + responses: + '204': + description: No Content + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_notification_settings_write + summary: Delete a notification template + tags: + - Incidents + x-permission: + operator: AND + permissions: + - incident_notification_settings_write + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + get: + description: Retrieves a specific notification template by its ID. + operationId: GetIncidentNotificationTemplate + parameters: + - $ref: '#/components/parameters/IncidentNotificationTemplateIDPathParameter' + - $ref: >- + #/components/parameters/IncidentNotificationTemplateIncludeQueryParameter + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentNotificationTemplate' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_read + summary: Get incident notification template + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_settings_read + - incident_write + - incident_read + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + patch: + description: Updates an existing notification template's attributes. + operationId: UpdateIncidentNotificationTemplate + parameters: + - $ref: '#/components/parameters/IncidentNotificationTemplateIDPathParameter' + - $ref: >- + #/components/parameters/IncidentNotificationTemplateIncludeQueryParameter + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/PatchIncidentNotificationTemplateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentNotificationTemplate' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_notification_settings_write + summary: Update incident notification template + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: AND + permissions: + - incident_notification_settings_write + x-unstable: >- + **Note**: This endpoint is in Preview. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/config/types: + get: + description: Get all incident types. + operationId: ListIncidentTypes + parameters: + - $ref: '#/components/parameters/IncidentTypeIncludeDeletedParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTypeListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get a list of incident types + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + post: + description: Create an incident type. + operationId: CreateIncidentType + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTypeCreateRequest' + description: Incident type payload. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTypeResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Create an incident type + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/config/types/{incident_type_id}: + delete: + description: Delete an incident type. + operationId: DeleteIncidentType + parameters: + - $ref: '#/components/parameters/IncidentTypeIDPathParameter' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Delete an incident type + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + get: + description: Get incident type details. + operationId: GetIncidentType + parameters: + - $ref: '#/components/parameters/IncidentTypeIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTypeResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get incident type details + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + patch: + description: Update an incident type. + operationId: UpdateIncidentType + parameters: + - $ref: '#/components/parameters/IncidentTypeIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTypePatchRequest' + description: Incident type payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTypeResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Update an incident type + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/search: + get: + description: Search for incidents matching a certain query. + operationId: SearchIncidents + parameters: + - $ref: '#/components/parameters/IncidentSearchIncludeQueryParameter' + - $ref: '#/components/parameters/IncidentSearchQueryQueryParameter' + - $ref: '#/components/parameters/IncidentSearchSortQueryParameter' + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageOffset' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentSearchResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Search for incidents + tags: + - Incidents + x-pagination: + limitParam: page[size] + pageOffsetParam: page[offset] + resultsPath: data.attributes.incidents + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/{incident_id}: + delete: + description: Deletes an existing incident from the users organization. + operationId: DeleteIncident + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Delete an existing incident + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + get: + description: Get the details of an incident by `incident_id`. + operationId: GetIncident + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentIncludeQueryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get the details of an incident + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + patch: + description: >- + Updates an incident. Provide only the attributes that should be updated + as this request is a partial update. + operationId: UpdateIncident + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentIncludeQueryParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentUpdateRequest' + description: Incident Payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Update an existing incident + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/{incident_id}/attachments: + get: + description: Get all attachments for a given incident. + operationId: ListIncidentAttachments + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentAttachmentIncludeQueryParameter' + - $ref: '#/components/parameters/IncidentAttachmentFilterQueryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentAttachmentsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Get a list of attachments + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + patch: + description: >- + The bulk update endpoint for creating, updating, and deleting + attachments for a given incident. + operationId: UpdateIncidentAttachments + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentAttachmentIncludeQueryParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentAttachmentUpdateRequest' + description: Incident Attachment Payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentAttachmentUpdateResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Create, update, and delete incident attachments + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/{incident_id}/relationships/integrations: + get: + description: Get all integration metadata for an incident. + operationId: ListIncidentIntegrations + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentIntegrationMetadataListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get a list of an incident's integration metadata + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + post: + description: Create an incident integration metadata. + operationId: CreateIncidentIntegration + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentIntegrationMetadataCreateRequest' + description: Incident integration metadata payload. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentIntegrationMetadataResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Create an incident integration metadata + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/{incident_id}/relationships/integrations/{integration_metadata_id}: + delete: + description: Delete an incident integration metadata. + operationId: DeleteIncidentIntegration + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentIntegrationMetadataIDPathParameter' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Delete an incident integration metadata + tags: + - Incidents + x-codegen-request-body-name: body + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + get: + description: Get incident integration metadata details. + operationId: GetIncidentIntegration + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentIntegrationMetadataIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentIntegrationMetadataResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get incident integration metadata details + tags: + - Incidents + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + patch: + description: Update an existing incident integration metadata. + operationId: UpdateIncidentIntegration + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentIntegrationMetadataIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentIntegrationMetadataPatchRequest' + description: Incident integration metadata payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentIntegrationMetadataResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Update an existing incident integration metadata + tags: + - Incidents + x-codegen-request-body-name: body + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/{incident_id}/relationships/todos: + get: + description: Get all todos for an incident. + operationId: ListIncidentTodos + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTodoListResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get a list of an incident's todos + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + post: + description: Create an incident todo. + operationId: CreateIncidentTodo + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTodoCreateRequest' + description: Incident todo payload. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTodoResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Create an incident todo + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/incidents/{incident_id}/relationships/todos/{todo_id}: + delete: + description: Delete an incident todo. + operationId: DeleteIncidentTodo + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentTodoIDPathParameter' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Delete an incident todo + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + get: + description: Get incident todo details. + operationId: GetIncidentTodo + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentTodoIDPathParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTodoResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get incident todo details + tags: + - Incidents + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + patch: + description: Update an incident todo. + operationId: UpdateIncidentTodo + parameters: + - $ref: '#/components/parameters/IncidentIDPathParameter' + - $ref: '#/components/parameters/IncidentTodoIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTodoPatchRequest' + description: Incident todo payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTodoResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_write + summary: Update an incident todo + tags: + - Incidents + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_write + x-unstable: >- + **Note**: This endpoint is in public beta. + + If you have any feedback, contact [Datadog + support](https://docs.datadoghq.com/help/). + /api/v2/on-call/escalation-policies: + post: + description: Create a new On-Call escalation policy + operationId: CreateOnCallEscalationPolicy + parameters: + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `teams`, `steps`, `steps.targets`. + in: query + name: include + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/EscalationPolicyCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/EscalationPolicy' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Create On-Call escalation policy + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_write + /api/v2/on-call/escalation-policies/{policy_id}: + delete: + description: Delete an On-Call escalation policy + operationId: DeleteOnCallEscalationPolicy + parameters: + - description: The ID of the escalation policy + in: path + name: policy_id + required: true + schema: + example: a3000000-0000-0000-0000-000000000000 + type: string + responses: + '204': + description: No Content + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Delete On-Call escalation policy + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_write + get: + description: Get an On-Call escalation policy + operationId: GetOnCallEscalationPolicy + parameters: + - description: The ID of the escalation policy + in: path + name: policy_id + required: true + schema: + example: a3000000-0000-0000-0000-000000000000 + type: string + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `teams`, `steps`, `steps.targets`. + in: query + name: include + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/EscalationPolicy' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get On-Call escalation policy + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_read + put: + description: Update an On-Call escalation policy + operationId: UpdateOnCallEscalationPolicy + parameters: + - description: The ID of the escalation policy + in: path + name: policy_id + required: true + schema: + example: a3000000-0000-0000-0000-000000000000 + type: string + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `teams`, `steps`, `steps.targets`. + in: query + name: include + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/EscalationPolicyUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/EscalationPolicy' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Update On-Call escalation policy + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_write + /api/v2/on-call/pages: + post: + description: | + Trigger a new On-Call Page. + operationId: CreateOnCallPage + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreatePageRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CreatePageResponse' + description: OK. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + servers: + - url: https://{site} + variables: + site: + default: navy.oncall.datadoghq.com + description: The globally available endpoint for On-Call. + enum: + - lava.oncall.datadoghq.com + - saffron.oncall.datadoghq.com + - navy.oncall.datadoghq.com + - coral.oncall.datadoghq.com + - teal.oncall.datadoghq.com + - beige.oncall.datadoghq.eu + - url: '{protocol}://{name}' + variables: + name: + default: api.datadoghq.com + description: Full site DNS name. + protocol: + default: https + description: The protocol for accessing the API. + - url: https://{subdomain}.{site} + variables: + site: + default: datadoghq.com + description: Any Datadog deployment. + subdomain: + default: api + description: The subdomain where the API is deployed. + summary: Create On-Call Page + tags: + - On-Call Paging + /api/v2/on-call/pages/{page_id}/acknowledge: + post: + description: | + Acknowledges an On-Call Page. + operationId: AcknowledgeOnCallPage + parameters: + - description: The page ID. + in: path + name: page_id + required: true + schema: + example: 15e74b8b-f865-48d0-bcc5-453323ed2c8f + format: uuid + type: string + responses: + '202': + description: Accepted. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + servers: + - url: https://{site} + variables: + site: + default: navy.oncall.datadoghq.com + description: The globally available endpoint for On-Call. + enum: + - lava.oncall.datadoghq.com + - saffron.oncall.datadoghq.com + - navy.oncall.datadoghq.com + - coral.oncall.datadoghq.com + - teal.oncall.datadoghq.com + - beige.oncall.datadoghq.eu + - url: '{protocol}://{name}' + variables: + name: + default: api.datadoghq.com + description: Full site DNS name. + protocol: + default: https + description: The protocol for accessing the API. + - url: https://{subdomain}.{site} + variables: + site: + default: datadoghq.com + description: Any Datadog deployment. + subdomain: + default: api + description: The subdomain where the API is deployed. + summary: Acknowledge On-Call Page + tags: + - On-Call Paging + /api/v2/on-call/pages/{page_id}/escalate: + post: + description: | + Escalates an On-Call Page. + operationId: EscalateOnCallPage + parameters: + - description: The page ID. + in: path + name: page_id + required: true + schema: + example: 15e74b8b-f865-48d0-bcc5-453323ed2c8f + format: uuid + type: string + responses: + '202': + description: Accepted. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + servers: + - url: https://{site} + variables: + site: + default: navy.oncall.datadoghq.com + description: The globally available endpoint for On-Call. + enum: + - lava.oncall.datadoghq.com + - saffron.oncall.datadoghq.com + - navy.oncall.datadoghq.com + - coral.oncall.datadoghq.com + - teal.oncall.datadoghq.com + - beige.oncall.datadoghq.eu + - url: '{protocol}://{name}' + variables: + name: + default: api.datadoghq.com + description: Full site DNS name. + protocol: + default: https + description: The protocol for accessing the API. + - url: https://{subdomain}.{site} + variables: + site: + default: datadoghq.com + description: Any Datadog deployment. + subdomain: + default: api + description: The subdomain where the API is deployed. + summary: Escalate On-Call Page + tags: + - On-Call Paging + /api/v2/on-call/pages/{page_id}/resolve: + post: + description: | + Resolves an On-Call Page. + operationId: ResolveOnCallPage + parameters: + - description: The page ID. + in: path + name: page_id + required: true + schema: + example: 15e74b8b-f865-48d0-bcc5-453323ed2c8f + format: uuid + type: string + responses: + '202': + description: Accepted. + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + servers: + - url: https://{site} + variables: + site: + default: navy.oncall.datadoghq.com + description: The globally available endpoint for On-Call. + enum: + - lava.oncall.datadoghq.com + - saffron.oncall.datadoghq.com + - navy.oncall.datadoghq.com + - coral.oncall.datadoghq.com + - teal.oncall.datadoghq.com + - beige.oncall.datadoghq.eu + - url: '{protocol}://{name}' + variables: + name: + default: api.datadoghq.com + description: Full site DNS name. + protocol: + default: https + description: The protocol for accessing the API. + - url: https://{subdomain}.{site} + variables: + site: + default: datadoghq.com + description: Any Datadog deployment. + subdomain: + default: api + description: The subdomain where the API is deployed. + summary: Resolve On-Call Page + tags: + - On-Call Paging + /api/v2/on-call/schedules: + post: + description: Create a new On-Call schedule + operationId: CreateOnCallSchedule + parameters: + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `teams`, `layers`, `layers.members`, + `layers.members.user`. + in: query + name: include + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ScheduleCreateRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/Schedule' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Create On-Call schedule + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_write + /api/v2/on-call/schedules/{schedule_id}: + delete: + description: Delete an On-Call schedule + operationId: DeleteOnCallSchedule + parameters: + - description: The ID of the schedule + in: path + name: schedule_id + required: true + schema: + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + responses: + '204': + description: No Content + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Delete On-Call schedule + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_write + get: + description: Get an On-Call schedule + operationId: GetOnCallSchedule + parameters: + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `teams`, `layers`, `layers.members`, + `layers.members.user`. + in: query + name: include + schema: + type: string + - description: The ID of the schedule + in: path + name: schedule_id + required: true + schema: + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/Schedule' + description: OK + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get On-Call schedule + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_read + put: + description: Update a new On-Call schedule + operationId: UpdateOnCallSchedule + parameters: + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `teams`, `layers`, `layers.members`, + `layers.members.user`. + in: query + name: include + schema: + type: string + - description: The ID of the schedule + in: path + name: schedule_id + required: true + schema: + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ScheduleUpdateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/Schedule' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Update On-Call schedule + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_write + /api/v2/on-call/schedules/{schedule_id}/on-call: + get: + description: >- + Retrieves the user who is on-call for the specified schedule at a given + time. + operationId: GetScheduleOnCallUser + parameters: + - description: >- + Specifies related resources to include in the response as a + comma-separated list. Allowed value: `user`. + in: query + name: include + schema: + type: string + - description: The ID of the schedule. + in: path + name: schedule_id + required: true + schema: + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + - description: >- + Retrieves the on-call user at the given timestamp (ISO-8601). + Defaults to the current time if omitted." + in: query + name: filter[at_ts] + schema: + example: '2025-05-07T02:53:01Z' + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/Shift' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get the schedule on-call user + tags: + - On-Call + /api/v2/on-call/teams/{team_id}/on-call: + get: + description: Get a team's on-call users at a given time + operationId: GetTeamOnCallUsers + parameters: + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `responders`, `escalations`, + `escalations.responders`. + in: query + name: include + schema: + type: string + - description: The team ID + in: path + name: team_id + required: true + schema: + example: 27590dae-47be-4a7d-9abf-8f4e45124020 + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamOnCallResponders' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get team on-call users + tags: + - On-Call + /api/v2/on-call/teams/{team_id}/routing-rules: + get: + description: Get a team's On-Call routing rules + operationId: GetOnCallTeamRoutingRules + parameters: + - description: The team ID + in: path + name: team_id + required: true + schema: + example: 27590dae-47be-4a7d-9abf-8f4e45124020 + type: string + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `rules`, `rules.policy`. + in: query + name: include + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamRoutingRules' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Get On-Call team routing rules + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_read + put: + description: Set a team's On-Call routing rules + operationId: SetOnCallTeamRoutingRules + parameters: + - description: The team ID + in: path + name: team_id + required: true + schema: + example: 27590dae-47be-4a7d-9abf-8f4e45124020 + type: string + - description: >- + Comma-separated list of included relationships to be returned. + Allowed values: `rules`, `rules.policy`. + in: query + name: include + schema: + type: string + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/TeamRoutingRulesRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/TeamRoutingRules' + description: OK + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: [] + summary: Set On-Call team routing rules + tags: + - On-Call + x-permission: + operator: AND + permissions: + - on_call_write + /api/v2/services: + get: + deprecated: true + description: >- + Get all incident services uploaded for the requesting user's + organization. If the `include[users]` query parameter is provided, the + included attribute will contain the users related to these incident + services. + operationId: ListIncidentServices + parameters: + - $ref: '#/components/parameters/IncidentServiceIncludeQueryParameter' + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageOffset' + - $ref: '#/components/parameters/IncidentServiceSearchQueryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentServicesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get a list of all incident services + tags: + - Incident Services + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: '**Note**: This endpoint is deprecated.' + post: + deprecated: true + description: Creates a new incident service. + operationId: CreateIncidentService + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentServiceCreateRequest' + description: Incident Service Payload. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentServiceResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Create a new incident service + tags: + - Incident Services + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: '**Note**: This endpoint is deprecated.' + /api/v2/services/definitions: + get: + description: Get a list of all service definitions from the Datadog Service Catalog. + operationId: ListServiceDefinitions + parameters: + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + - $ref: '#/components/parameters/SchemaVersion' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ServiceDefinitionsListResponse' + description: OK + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_read + summary: Get all service definitions + tags: + - Service Definition + x-pagination: + limitParam: page[size] + pageParam: page[number] + resultsPath: data + x-permission: + operator: OR + permissions: + - apm_service_catalog_read + post: + description: Create or update service definition in the Datadog Service Catalog. + operationId: CreateOrUpdateServiceDefinitions + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/ServiceDefinitionsCreateRequest' + description: Service Definition YAML/JSON. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ServiceDefinitionCreateResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Create or update service definition + tags: + - Service Definition + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - apm_service_catalog_write + /api/v2/services/definitions/{service_name}: + delete: + description: Delete a single service definition in the Datadog Service Catalog. + operationId: DeleteServiceDefinition + parameters: + - $ref: '#/components/parameters/ServiceName' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_write + summary: Delete a single service definition + tags: + - Service Definition + x-permission: + operator: OR + permissions: + - apm_service_catalog_write + get: + description: Get a single service definition from the Datadog Service Catalog. + operationId: GetServiceDefinition + parameters: + - $ref: '#/components/parameters/ServiceName' + - $ref: '#/components/parameters/SchemaVersion' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/ServiceDefinitionGetResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '409': + $ref: '#/components/responses/ConflictResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - apm_service_catalog_read + summary: Get a single service definition + tags: + - Service Definition + x-permission: + operator: OR + permissions: + - apm_service_catalog_read + /api/v2/services/{service_id}: + delete: + deprecated: true + description: Deletes an existing incident service. + operationId: DeleteIncidentService + parameters: + - $ref: '#/components/parameters/IncidentServiceIDPathParameter' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Delete an existing incident service + tags: + - Incident Services + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: '**Note**: This endpoint is deprecated.' + get: + deprecated: true + description: >- + Get details of an incident service. If the `include[users]` query + parameter is provided, + + the included attribute will contain the users related to these incident + services. + operationId: GetIncidentService + parameters: + - $ref: '#/components/parameters/IncidentServiceIDPathParameter' + - $ref: '#/components/parameters/IncidentServiceIncludeQueryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentServiceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get details of an incident service + tags: + - Incident Services + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: '**Note**: This endpoint is deprecated.' + patch: + deprecated: true + description: >- + Updates an existing incident service. Only provide the attributes which + should be updated as this request is a partial update. + operationId: UpdateIncidentService + parameters: + - $ref: '#/components/parameters/IncidentServiceIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentServiceUpdateRequest' + description: Incident Service Payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentServiceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Update an existing incident service + tags: + - Incident Services + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: '**Note**: This endpoint is deprecated.' + /api/v2/slo/report: + post: + description: >- + Create a job to generate an SLO report. The report job is processed + asynchronously and eventually results in a CSV report being available + for download. + + + Check the status of the job and download the CSV report using the + returned `report_id`. + operationId: CreateSLOReportJob + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/SloReportCreateRequest' + description: Create SLO report job request body. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SLOReportPostResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - slos_read + summary: Create a new SLO report + tags: + - Service Level Objectives + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - slos_read + x-unstable: >- + **Note**: This feature is in private beta. To request access, use the + request access form in the [Service Level + Objectives](https://docs.datadoghq.com/service_management/service_level_objectives/#slo-csv-export) + docs. + /api/v2/slo/report/{report_id}/download: + get: + description: >- + Download an SLO report. This can only be performed after the report job + has completed. + + + Reports are not guaranteed to exist indefinitely. Datadog recommends + that you download the report as soon as it is available. + operationId: GetSLOReport + parameters: + - $ref: '#/components/parameters/ReportID' + responses: + '200': + content: + text/csv: + schema: + type: string + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - slos_read + summary: Get SLO report + tags: + - Service Level Objectives + x-unstable: >- + **Note**: This feature is in private beta. To request access, use the + request access form in the [Service Level + Objectives](https://docs.datadoghq.com/service_management/service_level_objectives/#slo-csv-export) + docs. + /api/v2/slo/report/{report_id}/status: + get: + description: Get the status of the SLO report job. + operationId: GetSLOReportJobStatus + parameters: + - $ref: '#/components/parameters/ReportID' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/SLOReportStatusGetResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - slos_read + summary: Get SLO report status + tags: + - Service Level Objectives + x-unstable: >- + **Note**: This feature is in private beta. To request access, use the + request access form in the [Service Level + Objectives](https://docs.datadoghq.com/service_management/service_level_objectives/#slo-csv-export) + docs. + /api/v2/teams: + get: + deprecated: true + description: >- + Get all incident teams for the requesting user's organization. If the + `include[users]` query parameter is provided, the included attribute + will contain the users related to these incident teams. + operationId: ListIncidentTeams + parameters: + - $ref: '#/components/parameters/IncidentTeamIncludeQueryParameter' + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageOffset' + - $ref: '#/components/parameters/IncidentTeamSearchQueryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTeamsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get a list of all incident teams + tags: + - Incident Teams + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is deprecated. See the [Teams API + endpoints](https://docs.datadoghq.com/api/latest/teams/). + post: + deprecated: true + description: Creates a new incident team. + operationId: CreateIncidentTeam + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTeamCreateRequest' + description: Incident Team Payload. + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTeamResponse' + description: CREATED + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Create a new incident team + tags: + - Incident Teams + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: >- + **Note**: This endpoint is deprecated. See the [Teams API + endpoints](https://docs.datadoghq.com/api/latest/teams/). + /api/v2/teams/{team_id}: + delete: + deprecated: true + description: Deletes an existing incident team. + operationId: DeleteIncidentTeam + parameters: + - $ref: '#/components/parameters/IncidentTeamIDPathParameter' + responses: + '204': + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Delete an existing incident team + tags: + - Incident Teams + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: >- + **Note**: This endpoint is deprecated. See the [Teams API + endpoints](https://docs.datadoghq.com/api/latest/teams/). + get: + deprecated: true + description: >- + Get details of an incident team. If the `include[users]` query parameter + is provided, + + the included attribute will contain the users related to these incident + teams. + operationId: GetIncidentTeam + parameters: + - $ref: '#/components/parameters/IncidentTeamIDPathParameter' + - $ref: '#/components/parameters/IncidentTeamIncludeQueryParameter' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTeamResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_read + summary: Get details of an incident team + tags: + - Incident Teams + x-permission: + operator: OR + permissions: + - incident_read + x-unstable: >- + **Note**: This endpoint is deprecated. See the [Teams API + endpoints](https://docs.datadoghq.com/api/latest/teams/). + patch: + deprecated: true + description: >- + Updates an existing incident team. Only provide the attributes which + should be updated as this request is a partial update. + operationId: UpdateIncidentTeam + parameters: + - $ref: '#/components/parameters/IncidentTeamIDPathParameter' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTeamUpdateRequest' + description: Incident Team Payload. + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/IncidentTeamResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '401': + $ref: '#/components/responses/UnauthorizedResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - incident_settings_write + summary: Update an existing incident team + tags: + - Incident Teams + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - incident_settings_write + x-unstable: >- + **Note**: This endpoint is deprecated. See the [Teams API + endpoints](https://docs.datadoghq.com/api/latest/teams/). +components: + schemas: + CasesResponse: + description: Response with cases + properties: + data: + description: Cases response data + items: + $ref: '#/components/schemas/Case' + type: array + meta: + $ref: '#/components/schemas/CasesResponseMeta' + type: object + CaseCreateRequest: + description: Case create request + properties: + data: + $ref: '#/components/schemas/CaseCreate' + required: + - data + type: object + CaseResponse: + description: Case response + properties: + data: + $ref: '#/components/schemas/Case' + type: object + ProjectsResponse: + description: Response with projects + properties: + data: + description: Projects response data + items: + $ref: '#/components/schemas/Project' + type: array + type: object + ProjectCreateRequest: + description: Project create request + properties: + data: + $ref: '#/components/schemas/ProjectCreate' + required: + - data + type: object + ProjectResponse: + description: Project response + properties: + data: + $ref: '#/components/schemas/Project' + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + CaseEmptyRequest: + description: Case empty request + properties: + data: + $ref: '#/components/schemas/CaseEmpty' + required: + - data + type: object + CaseAssignRequest: + description: Case assign request + properties: + data: + $ref: '#/components/schemas/CaseAssign' + required: + - data + type: object + CaseUpdateAttributesRequest: + description: Case update attributes request + properties: + data: + $ref: '#/components/schemas/CaseUpdateAttributes' + required: + - data + type: object + CaseUpdatePriorityRequest: + description: Case update priority request + properties: + data: + $ref: '#/components/schemas/CaseUpdatePriority' + required: + - data + type: object + CaseUpdateStatusRequest: + description: Case update status request + properties: + data: + $ref: '#/components/schemas/CaseUpdateStatus' + required: + - data + type: object + ListDowntimesResponse: + description: Response for retrieving all downtimes. + properties: + data: + description: An array of downtimes. + items: + $ref: '#/components/schemas/DowntimeResponseData' + type: array + included: + description: Array of objects related to the downtimes. + items: + $ref: '#/components/schemas/DowntimeResponseIncludedItem' + type: array + meta: + $ref: '#/components/schemas/DowntimeMeta' + type: object + DowntimeCreateRequest: + description: Request for creating a downtime. + properties: + data: + $ref: '#/components/schemas/DowntimeCreateRequestData' + required: + - data + type: object + DowntimeResponse: + description: |- + Downtiming gives you greater control over monitor notifications by + allowing you to globally exclude scopes from alerting. + Downtime settings, which can be scheduled with start and end times, + prevent all alerting related to specified Datadog tags. + properties: + data: + $ref: '#/components/schemas/DowntimeResponseData' + included: + description: Array of objects related to the downtime that the user requested. + items: + $ref: '#/components/schemas/DowntimeResponseIncludedItem' + type: array + type: object + DowntimeUpdateRequest: + description: Request for editing a downtime. + properties: + data: + $ref: '#/components/schemas/DowntimeUpdateRequestData' + required: + - data + type: object + IssuesSearchRequest: + description: Search issues request payload. + properties: + data: + $ref: '#/components/schemas/IssuesSearchRequestData' + required: + - data + type: object + IssuesSearchResponse: + description: Search issues response payload. + properties: + data: + description: Array of results matching the search query. + items: + $ref: '#/components/schemas/IssuesSearchResult' + type: array + included: + description: Array of resources related to the search results. + items: + $ref: '#/components/schemas/IssuesSearchResultIncluded' + type: array + type: object + IssueResponse: + description: Response containing error tracking issue data. + properties: + data: + $ref: '#/components/schemas/Issue' + included: + description: Array of resources related to the issue. + items: + $ref: '#/components/schemas/IssueIncluded' + type: array + type: object + IssueUpdateAssigneeRequest: + description: Update issue assignee request payload. + properties: + data: + $ref: '#/components/schemas/IssueUpdateAssigneeRequestData' + required: + - data + type: object + IssueUpdateStateRequest: + description: Update issue state request payload. + properties: + data: + $ref: '#/components/schemas/IssueUpdateStateRequestData' + required: + - data + type: object + EventsSort: + description: The sort parameters when querying events. + enum: + - timestamp + - '-timestamp' + type: string + x-enum-varnames: + - TIMESTAMP_ASCENDING + - TIMESTAMP_DESCENDING + EventsListResponse: + description: >- + The response object with all events matching the request and pagination + information. + properties: + data: + description: An array of events matching the request. + items: + $ref: '#/components/schemas/EventResponse' + type: array + links: + $ref: '#/components/schemas/EventsListResponseLinks' + meta: + $ref: '#/components/schemas/EventsResponseMetadata' + type: object + EventCreateRequestPayload: + description: Payload for creating an event. + properties: + data: + $ref: '#/components/schemas/EventCreateRequest' + required: + - data + type: object + EventCreateResponsePayload: + description: Event creation response. + properties: + data: + $ref: '#/components/schemas/EventCreateResponse' + links: + $ref: '#/components/schemas/EventCreateResponsePayloadLinks' + type: object + JSONAPIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + items: + $ref: '#/components/schemas/JSONAPIErrorItem' + type: array + required: + - errors + type: object + EventsListRequest: + description: >- + The object sent with the request to retrieve a list of events from your + organization. + properties: + filter: + $ref: '#/components/schemas/EventsQueryFilter' + options: + $ref: '#/components/schemas/EventsQueryOptions' + page: + $ref: '#/components/schemas/EventsRequestPage' + sort: + $ref: '#/components/schemas/EventsSort' + type: object + V2EventResponse: + description: Get an event response. + properties: + data: + $ref: '#/components/schemas/V2Event' + type: object + IncidentsResponse: + description: Response with a list of incidents. + properties: + data: + description: An array of incidents. + example: + - attributes: + created: '2020-04-21T15:34:08.627205+00:00' + creation_idempotency_key: null + customer_impact_duration: 0 + customer_impact_end: null + customer_impact_scope: null + customer_impact_start: null + customer_impacted: false + detected: '2020-04-14T00:00:00+00:00' + incident_type_uuid: 00000000-0000-0000-0000-000000000001 + modified: '2020-09-17T14:16:58.696424+00:00' + public_id: 1 + resolved: null + severity: SEV-1 + time_to_detect: 0 + time_to_internal_response: 0 + time_to_repair: 0 + time_to_resolve: 0 + title: Example Incident + id: 00000000-aaaa-0000-0000-000000000000 + relationships: + attachments: + data: + - id: 00000000-9999-0000-0000-000000000000 + type: incident_attachments + - id: 00000000-1234-0000-0000-000000000000 + type: incident_attachments + commander_user: + data: + id: 00000000-0000-0000-cccc-000000000000 + type: users + created_by_user: + data: + id: 00000000-0000-0000-cccc-000000000000 + type: users + integrations: + data: + - id: 00000000-0000-0000-4444-000000000000 + type: incident_integrations + - id: 00000000-0000-0000-5555-000000000000 + type: incident_integrations + last_modified_by_user: + data: + id: 00000000-0000-0000-cccc-000000000000 + type: users + type: incidents + - attributes: + created: '2020-04-21T15:34:08.627205+00:00' + creation_idempotency_key: null + customer_impact_duration: 0 + customer_impact_end: null + customer_impact_scope: null + customer_impact_start: null + customer_impacted: false + detected: '2020-04-14T00:00:00+00:00' + incident_type_uuid: 00000000-0000-0000-0000-000000000002 + modified: '2020-09-17T14:16:58.696424+00:00' + public_id: 2 + resolved: null + severity: SEV-5 + time_to_detect: 0 + time_to_internal_response: 0 + time_to_repair: 0 + time_to_resolve: 0 + title: Example Incident 2 + id: 00000000-1111-0000-0000-000000000000 + relationships: + attachments: + data: + - id: 00000000-9999-0000-0000-000000000000 + type: incident_attachments + commander_user: + data: + id: 00000000-aaaa-0000-0000-000000000000 + type: users + created_by_user: + data: + id: 00000000-aaaa-0000-0000-000000000000 + type: users + integrations: + data: + - id: 00000000-0000-0000-0001-000000000000 + type: incident_integrations + - id: 00000000-0000-0000-0002-000000000000 + type: incident_integrations + last_modified_by_user: + data: + id: 00000000-aaaa-0000-0000-000000000000 + type: users + type: incidents + items: + $ref: '#/components/schemas/IncidentResponseData' + type: array + included: + description: Included related resources that the user requested. + items: + $ref: '#/components/schemas/IncidentResponseIncludedItem' + readOnly: true + type: array + meta: + $ref: '#/components/schemas/IncidentResponseMeta' + required: + - data + type: object + IncidentCreateRequest: + description: Create request for an incident. + properties: + data: + $ref: '#/components/schemas/IncidentCreateData' + required: + - data + type: object + IncidentResponse: + description: Response with an incident. + properties: + data: + $ref: '#/components/schemas/IncidentResponseData' + included: + description: Included related resources that the user requested. + items: + $ref: '#/components/schemas/IncidentResponseIncludedItem' + readOnly: true + type: array + required: + - data + type: object + IncidentNotificationRuleArray: + description: Response with notification rules. + properties: + data: + description: The `NotificationRuleArray` `data`. + items: + $ref: '#/components/schemas/IncidentNotificationRuleResponseData' + type: array + included: + description: Related objects that are included in the response. + items: + $ref: '#/components/schemas/IncidentNotificationRuleIncludedItems' + type: array + meta: + $ref: '#/components/schemas/IncidentNotificationRuleArrayMeta' + required: + - data + type: object + CreateIncidentNotificationRuleRequest: + description: Create request for a notification rule. + properties: + data: + $ref: '#/components/schemas/IncidentNotificationRuleCreateData' + required: + - data + type: object + IncidentNotificationRule: + description: Response with a notification rule. + properties: + data: + $ref: '#/components/schemas/IncidentNotificationRuleResponseData' + included: + description: Related objects that are included in the response. + items: + $ref: '#/components/schemas/IncidentNotificationRuleIncludedItems' + type: array + required: + - data + type: object + PutIncidentNotificationRuleRequest: + description: Put request for a notification rule. + properties: + data: + $ref: '#/components/schemas/IncidentNotificationRuleUpdateData' + required: + - data + type: object + IncidentNotificationTemplateArray: + description: Response with notification templates. + properties: + data: + description: The `NotificationTemplateArray` `data`. + items: + $ref: '#/components/schemas/IncidentNotificationTemplateResponseData' + type: array + included: + description: Related objects that are included in the response. + items: + $ref: '#/components/schemas/IncidentNotificationTemplateIncludedItems' + type: array + meta: + $ref: '#/components/schemas/IncidentNotificationTemplateArrayMeta' + required: + - data + type: object + CreateIncidentNotificationTemplateRequest: + description: Create request for a notification template. + properties: + data: + $ref: '#/components/schemas/IncidentNotificationTemplateCreateData' + required: + - data + type: object + IncidentNotificationTemplate: + description: Response with a notification template. + properties: + data: + $ref: '#/components/schemas/IncidentNotificationTemplateResponseData' + included: + description: Related objects that are included in the response. + items: + $ref: '#/components/schemas/IncidentNotificationTemplateIncludedItems' + type: array + required: + - data + type: object + PatchIncidentNotificationTemplateRequest: + description: Update request for a notification template. + properties: + data: + $ref: '#/components/schemas/IncidentNotificationTemplateUpdateData' + required: + - data + type: object + IncidentTypeListResponse: + description: Response with a list of incident types. + properties: + data: + description: An array of incident type objects. + items: + $ref: '#/components/schemas/IncidentTypeObject' + type: array + required: + - data + type: object + IncidentTypeCreateRequest: + description: Create request for an incident type. + properties: + data: + $ref: '#/components/schemas/IncidentTypeCreateData' + required: + - data + type: object + IncidentTypeResponse: + description: Incident type response data. + properties: + data: + $ref: '#/components/schemas/IncidentTypeObject' + required: + - data + type: object + IncidentTypePatchRequest: + description: Patch request for an incident type. + properties: + data: + $ref: '#/components/schemas/IncidentTypePatchData' + required: + - data + type: object + IncidentSearchResponse: + description: Response with incidents and facets. + properties: + data: + $ref: '#/components/schemas/IncidentSearchResponseData' + included: + description: Included related resources that the user requested. + items: + $ref: '#/components/schemas/IncidentResponseIncludedItem' + readOnly: true + type: array + meta: + $ref: '#/components/schemas/IncidentSearchResponseMeta' + required: + - data + type: object + IncidentUpdateRequest: + description: Update request for an incident. + properties: + data: + $ref: '#/components/schemas/IncidentUpdateData' + required: + - data + type: object + IncidentAttachmentsResponse: + description: The response object containing an incident's attachments. + properties: + data: + description: An array of incident attachments. + example: + - attributes: + attachment: + documentUrl: '' + title: Postmortem IR-123 + attachment_type: postmortem + id: 00000000-abcd-0002-0000-000000000000 + relationships: + last_modified_by_user: + data: + id: 00000000-0000-0000-cccc-000000000000 + type: users + type: incident_attachments + items: + $ref: '#/components/schemas/IncidentAttachmentData' + type: array + included: + description: Included related resources that the user requested. + items: + $ref: '#/components/schemas/IncidentAttachmentsResponseIncludedItem' + type: array + required: + - data + type: object + IncidentAttachmentUpdateRequest: + description: The update request for an incident's attachments. + properties: + data: + description: >- + An array of incident attachments. An attachment object without an + "id" key indicates that you want to + + create that attachment. An attachment object without an "attributes" + key indicates that you want to + + delete that attachment. An attachment object with both the "id" key + and a populated "attributes" object + + indicates that you want to update that attachment. + example: + - attributes: + attachment: + documentUrl: https://app.datadoghq.com/notebook/123 + title: Postmortem IR-123 + attachment_type: postmortem + id: 00000000-abcd-0002-0000-000000000000 + type: incident_attachments + - attributes: + attachment: + documentUrl: https://www.example.com/webstore-failure-runbook + title: Runbook for webstore service failures + attachment_type: link + type: incident_attachments + - id: 00000000-abcd-0003-0000-000000000000 + type: incident_attachments + items: + $ref: '#/components/schemas/IncidentAttachmentUpdateData' + type: array + required: + - data + type: object + IncidentAttachmentUpdateResponse: + description: >- + The response object containing the created or updated incident + attachments. + properties: + data: + description: >- + An array of incident attachments. Only the attachments that were + created or updated by the request are + + returned. + example: + - attributes: + attachment: + documentUrl: '' + title: Postmortem IR-123 + attachment_type: postmortem + id: 00000000-abcd-0002-0000-000000000000 + relationships: + last_modified_by_user: + data: + id: 00000000-0000-0000-cccc-000000000000 + type: users + type: incident_attachments + items: + $ref: '#/components/schemas/IncidentAttachmentData' + type: array + included: + description: Included related resources that the user requested. + items: + $ref: '#/components/schemas/IncidentAttachmentsResponseIncludedItem' + type: array + required: + - data + type: object + IncidentIntegrationMetadataListResponse: + description: Response with a list of incident integration metadata. + properties: + data: + description: An array of incident integration metadata. + items: + $ref: '#/components/schemas/IncidentIntegrationMetadataResponseData' + type: array + included: + description: Included related resources that the user requested. + items: + $ref: >- + #/components/schemas/IncidentIntegrationMetadataResponseIncludedItem + readOnly: true + type: array + meta: + $ref: '#/components/schemas/IncidentResponseMeta' + required: + - data + type: object + IncidentIntegrationMetadataCreateRequest: + description: Create request for an incident integration metadata. + properties: + data: + $ref: '#/components/schemas/IncidentIntegrationMetadataCreateData' + required: + - data + type: object + IncidentIntegrationMetadataResponse: + description: Response with an incident integration metadata. + properties: + data: + $ref: '#/components/schemas/IncidentIntegrationMetadataResponseData' + included: + description: Included related resources that the user requested. + items: + $ref: >- + #/components/schemas/IncidentIntegrationMetadataResponseIncludedItem + readOnly: true + type: array + required: + - data + type: object + IncidentIntegrationMetadataPatchRequest: + description: Patch request for an incident integration metadata. + properties: + data: + $ref: '#/components/schemas/IncidentIntegrationMetadataPatchData' + required: + - data + type: object + IncidentTodoListResponse: + description: Response with a list of incident todos. + properties: + data: + description: An array of incident todos. + items: + $ref: '#/components/schemas/IncidentTodoResponseData' + type: array + included: + description: Included related resources that the user requested. + items: + $ref: '#/components/schemas/IncidentTodoResponseIncludedItem' + readOnly: true + type: array + meta: + $ref: '#/components/schemas/IncidentResponseMeta' + required: + - data + type: object + IncidentTodoCreateRequest: + description: Create request for an incident todo. + properties: + data: + $ref: '#/components/schemas/IncidentTodoCreateData' + required: + - data + type: object + IncidentTodoResponse: + description: Response with an incident todo. + properties: + data: + $ref: '#/components/schemas/IncidentTodoResponseData' + included: + description: Included related resources that the user requested. + items: + $ref: '#/components/schemas/IncidentTodoResponseIncludedItem' + readOnly: true + type: array + required: + - data + type: object + IncidentTodoPatchRequest: + description: Patch request for an incident todo. + properties: + data: + $ref: '#/components/schemas/IncidentTodoPatchData' + required: + - data + type: object + EscalationPolicyCreateRequest: + description: >- + Represents a request to create a new escalation policy, including the + policy data. + example: + data: + attributes: + name: Escalation Policy 1 + resolve_page_on_policy_end: true + retries: 2 + steps: + - assignment: default + escalate_after_seconds: 3600 + targets: + - id: 00000000-aba1-0000-0000-000000000000 + type: users + - id: 00000000-aba2-0000-0000-000000000000 + type: schedules + - id: 00000000-aba3-0000-0000-000000000000 + type: teams + - assignment: round-robin + escalate_after_seconds: 3600 + targets: + - id: 00000000-aba1-0000-0000-000000000000 + type: users + - id: 00000000-abb1-0000-0000-000000000000 + type: users + relationships: + teams: + data: + - id: 00000000-da3a-0000-0000-000000000000 + type: teams + type: policies + properties: + data: + $ref: '#/components/schemas/EscalationPolicyCreateRequestData' + required: + - data + type: object + EscalationPolicy: + description: >- + Represents a complete escalation policy response, including policy data + and optionally included related resources. + example: + data: + attributes: + name: Escalation Policy 1 + resolve_page_on_policy_end: true + retries: 2 + id: 00000000-aba1-0000-0000-000000000000 + relationships: + steps: + data: + - id: 00000000-aba1-0000-0000-000000000000 + type: steps + teams: + data: + - id: 00000000-da3a-0000-0000-000000000000 + type: teams + type: policies + included: + - attributes: + avatar: '' + description: Team 1 description + handle: team1 + name: Team 1 + id: 00000000-da3a-0000-0000-000000000000 + type: teams + - attributes: + assignment: default + escalate_after_seconds: 3600 + id: 00000000-aba1-0000-0000-000000000000 + relationships: + targets: + data: + - id: 00000000-aba1-0000-0000-000000000000 + type: users + - id: 00000000-aba2-0000-0000-000000000000 + type: schedules + - id: 00000000-aba3-0000-0000-000000000000 + type: teams + type: steps + - id: 00000000-aba1-0000-0000-000000000000 + type: users + - id: 00000000-aba2-0000-0000-000000000000 + type: schedules + - id: 00000000-aba3-0000-0000-000000000000 + type: teams + properties: + data: + $ref: '#/components/schemas/EscalationPolicyData' + included: + description: >- + Provides any included related resources, such as steps or targets, + returned with the policy. + items: + $ref: '#/components/schemas/EscalationPolicyIncluded' + type: array + type: object + EscalationPolicyUpdateRequest: + description: >- + Represents a request to update an existing escalation policy, including + the updated policy data. + example: + data: + attributes: + name: Escalation Policy 1 + resolve_page_on_policy_end: false + retries: 2 + steps: + - assignment: default + escalate_after_seconds: 3600 + id: 00000000-aba1-0000-0000-000000000000 + targets: + - id: 00000000-aba1-0000-0000-000000000000 + type: users + - id: 00000000-aba2-0000-0000-000000000000 + type: schedules + id: a3000000-0000-0000-0000-000000000000 + relationships: + teams: + data: + - id: 00000000-da3a-0000-0000-000000000000 + type: teams + type: policies + properties: + data: + $ref: '#/components/schemas/EscalationPolicyUpdateRequestData' + required: + - data + type: object + CreatePageRequest: + description: Full request to trigger an On-Call Page. + example: + data: + attributes: + description: Page details. + tags: + - service:test + target: + identifier: my-team + type: team_handle + title: Page title + urgency: low + type: pages + properties: + data: + $ref: '#/components/schemas/CreatePageRequestData' + type: object + CreatePageResponse: + description: The full response object after creating a new On-Call Page. + example: + data: + id: 15e74b8b-f865-48d0-bcc5-453323ed2c8f + type: pages + properties: + data: + $ref: '#/components/schemas/CreatePageResponseData' + type: object + ScheduleCreateRequest: + description: >- + The top-level request body for schedule creation, wrapping a `data` + object. + example: + data: + attributes: + layers: + - effective_date: '2025-02-03T05:00:00Z' + end_date: '2025-12-31T00:00:00Z' + interval: + days: 1 + members: + - user: + id: 00000000-aba1-0000-0000-000000000000 + name: Layer 1 + restrictions: + - end_day: friday + end_time: '17:00:00' + start_day: monday + start_time: '09:00:00' + rotation_start: '2025-02-01T00:00:00Z' + name: On-Call Schedule + time_zone: America/New_York + relationships: + teams: + data: + - id: 00000000-da3a-0000-0000-000000000000 + type: teams + type: schedules + properties: + data: + $ref: '#/components/schemas/ScheduleCreateRequestData' + required: + - data + type: object + Schedule: + description: >- + Top-level container for a schedule object, including both the `data` + payload and any related `included` resources (such as teams, layers, or + members). + example: + data: + attributes: + name: On-Call Schedule + time_zone: America/New_York + id: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + relationships: + layers: + data: + - id: 00000000-0000-0000-0000-000000000001 + type: layers + teams: + data: + - id: 00000000-da3a-0000-0000-000000000000 + type: teams + type: schedules + included: + - attributes: + avatar: '' + description: Team 1 description + handle: team1 + name: Team 1 + id: 00000000-da3a-0000-0000-000000000000 + type: teams + - attributes: + effective_date: '2025-02-03T05:00:00Z' + end_date: '2025-12-31T00:00:00Z' + interval: + days: 1 + name: Layer 1 + restrictions: + - end_day: friday + end_time: '17:00:00' + start_day: monday + start_time: '09:00:00' + rotation_start: '2025-02-01T00:00:00Z' + id: 00000000-0000-0000-0000-000000000001 + relationships: + members: + data: + - id: 00000000-0000-0000-0000-000000000002 + type: members + type: layers + - id: 00000000-0000-0000-0000-000000000002 + relationships: + user: + data: + id: 00000000-aba1-0000-0000-000000000000 + type: users + type: members + - attributes: + email: foo@bar.com + name: User 1 + id: 00000000-aba1-0000-0000-000000000000 + type: users + properties: + data: + $ref: '#/components/schemas/ScheduleData' + included: + description: >- + Any additional resources related to this schedule, such as teams and + layers. + items: + $ref: '#/components/schemas/ScheduleDataIncludedItem' + type: array + type: object + ScheduleUpdateRequest: + description: >- + A top-level wrapper for a schedule update request, referring to the + `data` object with the new details. + example: + data: + attributes: + layers: + - effective_date: '2025-02-03T05:00:00Z' + end_date: '2025-12-31T00:00:00Z' + interval: + seconds: 3600 + members: + - user: + id: 00000000-aba1-0000-0000-000000000000 + name: Layer 1 + restrictions: + - end_day: friday + end_time: '17:00:00' + start_day: monday + start_time: '09:00:00' + rotation_start: '2025-02-01T00:00:00Z' + name: On-Call Schedule Updated + time_zone: America/New_York + id: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + relationships: + teams: + data: + - id: 00000000-da3a-0000-0000-000000000000 + type: teams + type: schedules + properties: + data: + $ref: '#/components/schemas/ScheduleUpdateRequestData' + required: + - data + type: object + Shift: + description: An on-call shift with its associated data and relationships. + example: + data: + attributes: + end: '2025-05-07T03:53:01.206662873Z' + start: '2025-05-07T02:53:01.206662814Z' + id: 00000000-0000-0000-0000-000000000000 + relationships: + user: + data: + id: 00000000-aba1-0000-0000-000000000000 + type: users + type: shifts + included: + - attributes: + email: foo@bar.com + name: User 1 + status: '' + id: 00000000-aba1-0000-0000-000000000000 + type: users + properties: + data: + $ref: '#/components/schemas/ShiftData' + nullable: true + included: + description: The `Shift` `included`. + items: + $ref: '#/components/schemas/ShiftIncluded' + type: array + type: object + TeamOnCallResponders: + description: Root object representing a team's on-call responder configuration. + example: + data: + id: 111ee23r-aaaaa-aaaa-aaww-1234wertsd23 + relationships: + escalations: + data: + - id: 111ee23r-aaaaa-aaaa-aaww-1234wertsd23 + type: escalation_policy_steps + responders: + data: + - id: 111ee23r-aaaaa-aaaa-aaww-1234wertsd23 + type: users + type: team_oncall_responders + included: + - attributes: + email: test@test.com + name: Test User + status: active + id: 111ee23r-aaaaa-aaaa-aaww-1234wertsd23 + type: users + - id: 111ee23r-aaaaa-aaaa-aaww-1234wertsd23 + relationships: + responders: + data: + - id: 111ee23r-aaaaa-aaaa-aaww-1234wertsd23 + type: users + type: escalation_policy_steps + properties: + data: + $ref: '#/components/schemas/TeamOnCallRespondersData' + included: + description: The `TeamOnCallResponders` `included`. + items: + $ref: '#/components/schemas/TeamOnCallRespondersIncluded' + type: array + type: object + TeamRoutingRules: + description: >- + Represents a complete set of team routing rules, including data and + optionally included related resources. + example: + data: + id: 27590dae-47be-4a7d-9abf-8f4e45124020 + relationships: + rules: + data: + - id: 03aff2d6-6cbf-496c-997f-a857bbe9a94a + type: team_routing_rules + - id: 03aff2d6-6cbf-496c-997f-a857bbe9a94a + type: team_routing_rules + type: team_routing_rules + included: + - attributes: + actions: null + query: tags.service:test + time_restriction: + restrictions: + - end_day: monday + end_time: '17:00:00' + start_day: monday + start_time: '09:00:00' + - end_day: tuesday + end_time: '17:00:00' + start_day: tuesday + start_time: '09:00:00' + time_zone: '' + urgency: high + id: 03aff2d6-6cbf-496c-997f-a857bbe9a94a + relationships: + policy: + data: null + type: team_routing_rules + properties: + data: + $ref: '#/components/schemas/TeamRoutingRulesData' + included: + description: Provides related routing rules or other included resources. + items: + $ref: '#/components/schemas/TeamRoutingRulesIncluded' + type: array + type: object + TeamRoutingRulesRequest: + description: >- + Represents a request to create or update team routing rules, including + the data payload. + example: + data: + attributes: + rules: + - actions: null + policy_id: '' + query: tags.service:test + time_restriction: + restrictions: + - end_day: monday + end_time: '17:00:00' + start_day: monday + start_time: '09:00:00' + - end_day: tuesday + end_time: '17:00:00' + start_day: tuesday + start_time: '09:00:00' + time_zone: '' + urgency: high + - actions: + - channel: channel + type: send_slack_message + workspace: workspace + policy_id: fad4eee1-13f5-40d8-886b-4e56d8d5d1c6 + query: '' + time_restriction: null + urgency: low + id: 27590dae-47be-4a7d-9abf-8f4e45124020 + type: team_routing_rules + properties: + data: + $ref: '#/components/schemas/TeamRoutingRulesRequestData' + type: object + IncidentServicesResponse: + description: Response with a list of incident service payloads. + properties: + data: + description: An array of incident services. + example: + - id: 00000000-0000-0000-0000-000000000000 + type: services + items: + $ref: '#/components/schemas/IncidentServiceResponseData' + type: array + included: + description: Included related resources which the user requested. + items: + $ref: '#/components/schemas/IncidentServiceIncludedItems' + readOnly: true + type: array + meta: + $ref: '#/components/schemas/IncidentResponseMeta' + required: + - data + type: object + IncidentServiceCreateRequest: + description: Create request with an incident service payload. + properties: + data: + $ref: '#/components/schemas/IncidentServiceCreateData' + required: + - data + type: object + IncidentServiceResponse: + description: Response with an incident service payload. + properties: + data: + $ref: '#/components/schemas/IncidentServiceResponseData' + included: + description: Included objects from relationships. + items: + $ref: '#/components/schemas/IncidentServiceIncludedItems' + readOnly: true + type: array + required: + - data + type: object + ServiceDefinitionsListResponse: + description: Create service definitions response. + properties: + data: + description: Data representing service definitions. + items: + $ref: '#/components/schemas/ServiceDefinitionData' + type: array + type: object + ServiceDefinitionsCreateRequest: + description: Create service definitions request. + oneOf: + - $ref: '#/components/schemas/ServiceDefinitionV2Dot2' + - $ref: '#/components/schemas/ServiceDefinitionV2Dot1' + - $ref: '#/components/schemas/ServiceDefinitionV2' + - $ref: '#/components/schemas/ServiceDefinitionRaw' + ServiceDefinitionCreateResponse: + description: Create service definitions response. + properties: + data: + description: Create service definitions response payload. + items: + $ref: '#/components/schemas/ServiceDefinitionData' + type: array + type: object + ServiceDefinitionGetResponse: + description: Get service definition response. + properties: + data: + $ref: '#/components/schemas/ServiceDefinitionData' + type: object + IncidentServiceUpdateRequest: + description: Update request with an incident service payload. + properties: + data: + $ref: '#/components/schemas/IncidentServiceUpdateData' + required: + - data + type: object + SloReportCreateRequest: + description: The SLO report request body. + properties: + data: + $ref: '#/components/schemas/SloReportCreateRequestData' + required: + - data + type: object + SLOReportPostResponse: + description: The SLO report response. + properties: + data: + $ref: '#/components/schemas/SLOReportPostResponseData' + type: object + SLOReportStatusGetResponse: + description: The SLO report status response. + properties: + data: + $ref: '#/components/schemas/SLOReportStatusGetResponseData' + type: object + IncidentTeamsResponse: + description: Response with a list of incident team payloads. + properties: + data: + description: An array of incident teams. + example: + - attributes: + name: team name + id: 00000000-7ea3-0000-0000-000000000000 + type: teams + items: + $ref: '#/components/schemas/IncidentTeamResponseData' + type: array + included: + description: Included related resources which the user requested. + items: + $ref: '#/components/schemas/IncidentTeamIncludedItems' + readOnly: true + type: array + meta: + $ref: '#/components/schemas/IncidentResponseMeta' + required: + - data + type: object + IncidentTeamCreateRequest: + description: Create request with an incident team payload. + properties: + data: + $ref: '#/components/schemas/IncidentTeamCreateData' + required: + - data + type: object + IncidentTeamResponse: + description: Response with an incident team payload. + properties: + data: + $ref: '#/components/schemas/IncidentTeamResponseData' + included: + description: Included objects from relationships. + items: + $ref: '#/components/schemas/IncidentTeamIncludedItems' + readOnly: true + type: array + required: + - data + type: object + IncidentTeamUpdateRequest: + description: Update request with an incident team payload. + properties: + data: + $ref: '#/components/schemas/IncidentTeamUpdateData' + required: + - data + type: object + CaseSortableField: + description: Case field that can be sorted on + enum: + - created_at + - priority + - status + example: created_at + type: string + x-enum-varnames: + - CREATED_AT + - PRIORITY + - STATUS + Case: + description: A case + properties: + attributes: + $ref: '#/components/schemas/CaseAttributes' + id: + description: Case's identifier + example: aeadc05e-98a8-11ec-ac2c-da7ad0900001 + type: string + relationships: + $ref: '#/components/schemas/CaseRelationships' + type: + $ref: '#/components/schemas/CaseResourceType' + required: + - id + - type + - attributes + type: object + CasesResponseMeta: + description: Cases response metadata + properties: + page: + $ref: '#/components/schemas/CasesResponseMetaPagination' + type: object + CaseCreate: + description: Case creation data + properties: + attributes: + $ref: '#/components/schemas/CaseCreateAttributes' + relationships: + $ref: '#/components/schemas/CaseCreateRelationships' + type: + $ref: '#/components/schemas/CaseResourceType' + required: + - attributes + - type + type: object + Project: + description: A Project + properties: + attributes: + $ref: '#/components/schemas/ProjectAttributes' + id: + description: The Project's identifier + example: aeadc05e-98a8-11ec-ac2c-da7ad0900001 + type: string + relationships: + $ref: '#/components/schemas/ProjectRelationships' + type: + $ref: '#/components/schemas/ProjectResourceType' + required: + - id + - type + - attributes + type: object + ProjectCreate: + description: Project create + properties: + attributes: + $ref: '#/components/schemas/ProjectCreateAttributes' + type: + $ref: '#/components/schemas/ProjectResourceType' + required: + - attributes + - type + type: object + CaseEmpty: + description: Case empty request data + properties: + type: + $ref: '#/components/schemas/CaseResourceType' + required: + - type + type: object + CaseAssign: + description: Case assign + properties: + attributes: + $ref: '#/components/schemas/CaseAssignAttributes' + type: + $ref: '#/components/schemas/CaseResourceType' + required: + - attributes + - type + type: object + CaseUpdateAttributes: + description: Case update attributes + properties: + attributes: + $ref: '#/components/schemas/CaseUpdateAttributesAttributes' + type: + $ref: '#/components/schemas/CaseResourceType' + required: + - attributes + - type + type: object + CaseUpdatePriority: + description: Case priority status + properties: + attributes: + $ref: '#/components/schemas/CaseUpdatePriorityAttributes' + type: + $ref: '#/components/schemas/CaseResourceType' + required: + - attributes + - type + type: object + CaseUpdateStatus: + description: Case update status + properties: + attributes: + $ref: '#/components/schemas/CaseUpdateStatusAttributes' + type: + $ref: '#/components/schemas/CaseResourceType' + required: + - attributes + - type + type: object + DowntimeResponseData: + description: Downtime data. + properties: + attributes: + $ref: '#/components/schemas/DowntimeResponseAttributes' + id: + description: The downtime ID. + example: 00000000-0000-1234-0000-000000000000 + type: string + relationships: + $ref: '#/components/schemas/DowntimeRelationships' + type: + $ref: '#/components/schemas/DowntimeResourceType' + type: object + DowntimeResponseIncludedItem: + description: An object related to a downtime. + oneOf: + - $ref: '#/components/schemas/User' + - $ref: '#/components/schemas/DowntimeMonitorIncludedItem' + DowntimeMeta: + description: Pagination metadata returned by the API. + properties: + page: + $ref: '#/components/schemas/DowntimeMetaPage' + type: object + DowntimeCreateRequestData: + description: Object to create a downtime. + properties: + attributes: + $ref: '#/components/schemas/DowntimeCreateRequestAttributes' + type: + $ref: '#/components/schemas/DowntimeResourceType' + required: + - type + - attributes + type: object + DowntimeUpdateRequestData: + description: Object to update a downtime. + properties: + attributes: + $ref: '#/components/schemas/DowntimeUpdateRequestAttributes' + id: + description: ID of this downtime. + example: 00000000-0000-1234-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/DowntimeResourceType' + required: + - id + - type + - attributes + type: object + SearchIssuesIncludeQueryParameterItem: + description: Relationship object that should be included in the search response. + enum: + - issue + - issue.assignee + - issue.case + - issue.team_owners + example: issue.case + type: string + x-enum-varnames: + - ISSUE + - ISSUE_ASSIGNEE + - ISSUE_CASE + - ISSUE_TEAM_OWNERS + IssuesSearchRequestData: + description: Search issues request. + properties: + attributes: + $ref: '#/components/schemas/IssuesSearchRequestDataAttributes' + type: + $ref: '#/components/schemas/IssuesSearchRequestDataType' + required: + - type + - attributes + type: object + IssuesSearchResult: + description: Result matching the search query. + properties: + attributes: + $ref: '#/components/schemas/IssuesSearchResultAttributes' + id: + description: Search result identifier (matches the nested issue's identifier). + example: c1726a66-1f64-11ee-b338-da7ad0900002 + type: string + relationships: + $ref: '#/components/schemas/IssuesSearchResultRelationships' + type: + $ref: '#/components/schemas/IssuesSearchResultType' + required: + - id + - type + - attributes + type: object + IssuesSearchResultIncluded: + description: >- + An array of related resources, returned when the `include` query + parameter is used. + oneOf: + - $ref: '#/components/schemas/Issue' + - $ref: '#/components/schemas/Case' + - $ref: '#/components/schemas/IssueUser' + - $ref: '#/components/schemas/IssueTeam' + GetIssueIncludeQueryParameterItem: + description: Relationship object that should be included in the response. + enum: + - assignee + - case + - team_owners + example: case + type: string + x-enum-varnames: + - ASSIGNEE + - CASE + - TEAM_OWNERS + Issue: + description: The issue matching the request. + properties: + attributes: + $ref: '#/components/schemas/IssueAttributes' + id: + description: Issue identifier. + example: c1726a66-1f64-11ee-b338-da7ad0900002 + type: string + relationships: + $ref: '#/components/schemas/IssueRelationships' + type: + $ref: '#/components/schemas/IssueType' + required: + - id + - type + - attributes + type: object + IssueIncluded: + description: >- + An array of related resources, returned when the `include` query + parameter is used. + oneOf: + - $ref: '#/components/schemas/IssueCase' + - $ref: '#/components/schemas/IssueUser' + - $ref: '#/components/schemas/IssueTeam' + IssueUpdateAssigneeRequestData: + description: Update issue assignee request. + properties: + id: + description: User identifier. + example: 87cb11a0-278c-440a-99fe-701223c80296 + type: string + type: + $ref: '#/components/schemas/IssueUpdateAssigneeRequestDataType' + required: + - id + - type + type: object + IssueUpdateStateRequestData: + description: Update issue state request. + properties: + attributes: + $ref: '#/components/schemas/IssueUpdateStateRequestDataAttributes' + id: + description: Issue identifier. + example: c1726a66-1f64-11ee-b338-da7ad0900002 + type: string + type: + $ref: '#/components/schemas/IssueUpdateStateRequestDataType' + required: + - id + - type + - attributes + type: object + EventResponse: + description: >- + The object description of an event after being processed and stored by + Datadog. + properties: + attributes: + $ref: '#/components/schemas/EventResponseAttributes' + id: + description: the unique ID of the event. + example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA + type: string + type: + $ref: '#/components/schemas/EventType' + type: object + EventsListResponseLinks: + description: Links attributes. + properties: + next: + description: >- + Link for the next set of results. Note that the request can also be + made using the + + POST endpoint. + example: >- + https://app.datadoghq.com/api/v2/events?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + EventsResponseMetadata: + description: The metadata associated with a request. + properties: + elapsed: + description: The time elapsed in milliseconds. + example: 132 + format: int64 + type: integer + page: + $ref: '#/components/schemas/EventsResponseMetadataPage' + request_id: + description: The identifier of the request. + example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR + type: string + status: + description: The request status. + example: done + type: string + warnings: + description: >- + A list of warnings (non-fatal errors) encountered. Partial results + might be returned if + + warnings are present in the response. + items: + $ref: '#/components/schemas/EventsWarning' + type: array + type: object + EventCreateRequest: + description: An event object. + properties: + attributes: + $ref: '#/components/schemas/EventPayload' + type: + $ref: '#/components/schemas/EventCreateRequestType' + required: + - type + - attributes + type: object + EventCreateResponse: + description: Event object. + properties: + attributes: + $ref: '#/components/schemas/EventCreateResponseAttributes' + type: + description: Entity type. + example: event + type: string + type: object + EventCreateResponsePayloadLinks: + description: Links to the event. + properties: + self: + description: >- + The URL of the event. This link is only functional when using the + default subdomain. + type: string + type: object + JSONAPIErrorItem: + description: API error response body + properties: + detail: + description: >- + A human-readable explanation specific to this occurrence of the + error. + example: Missing required attribute in body + type: string + meta: + additionalProperties: {} + description: Non-standard meta-information about the error + type: object + source: + $ref: '#/components/schemas/JSONAPIErrorItemSource' + status: + description: Status code of the response. + example: '400' + type: string + title: + description: Short human-readable summary of the error. + example: Bad Request + type: string + type: object + EventsQueryFilter: + description: The search and filter query settings. + properties: + from: + default: now-15m + description: >- + The minimum time for the requested events. Supports date math and + regular timestamps in milliseconds. + example: now-15m + type: string + query: + default: '*' + description: The search query following the event search syntax. + example: service:web* AND @http.status_code:[200 TO 299] + type: string + to: + default: now + description: >- + The maximum time for the requested events. Supports date math and + regular timestamps in milliseconds. + example: now + type: string + type: object + EventsQueryOptions: + description: >- + The global query options that are used. Either provide a timezone or a + time offset but not both, + + otherwise the query fails. + properties: + timeOffset: + description: The time offset to apply to the query in seconds. + format: int64 + type: integer + timezone: + default: UTC + description: >- + The timezone can be specified as GMT, UTC, an offset from UTC (like + UTC+1), or as a Timezone Database identifier (like + America/New_York). + example: GMT + type: string + type: object + EventsRequestPage: + description: Pagination settings. + properties: + cursor: + description: The returned paging point to use to get the next results. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + limit: + default: 10 + description: The maximum number of logs in the response. + example: 25 + format: int32 + maximum: 1000 + type: integer + type: object + V2Event: + description: An event object. + properties: + attributes: + $ref: '#/components/schemas/V2EventAttributes' + id: + description: The event's ID. + example: '' + type: string + type: + description: Entity type. + example: event + type: string + type: object + IncidentRelatedObject: + description: Object related to an incident. + enum: + - users + - attachments + type: string + x-enum-varnames: + - USERS + - ATTACHMENTS + IncidentResponseData: + description: Incident data from a response. + properties: + attributes: + $ref: '#/components/schemas/IncidentResponseAttributes' + id: + description: The incident's ID. + example: 00000000-0000-0000-1234-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentResponseRelationships' + type: + $ref: '#/components/schemas/IncidentType' + required: + - id + - type + type: object + IncidentResponseIncludedItem: + description: An object related to an incident that is included in the response. + oneOf: + - $ref: '#/components/schemas/IncidentUserData' + - $ref: '#/components/schemas/IncidentAttachmentData' + IncidentResponseMeta: + description: The metadata object containing pagination metadata. + properties: + pagination: + $ref: '#/components/schemas/IncidentResponseMetaPagination' + readOnly: true + type: object + IncidentCreateData: + description: Incident data for a create request. + properties: + attributes: + $ref: '#/components/schemas/IncidentCreateAttributes' + relationships: + $ref: '#/components/schemas/IncidentCreateRelationships' + type: + $ref: '#/components/schemas/IncidentType' + required: + - type + - attributes + type: object + IncidentNotificationRuleResponseData: + description: Notification rule data from a response. + properties: + attributes: + $ref: '#/components/schemas/IncidentNotificationRuleAttributes' + id: + description: The unique identifier of the notification rule. + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + relationships: + $ref: '#/components/schemas/IncidentNotificationRuleRelationships' + type: + $ref: '#/components/schemas/IncidentNotificationRuleType' + required: + - id + - type + type: object + IncidentNotificationRuleIncludedItems: + description: Objects related to a notification rule. + oneOf: + - $ref: '#/components/schemas/User' + - $ref: '#/components/schemas/IncidentTypeObject' + - $ref: '#/components/schemas/IncidentNotificationTemplateObject' + IncidentNotificationRuleArrayMeta: + description: Response metadata. + properties: + pagination: + $ref: '#/components/schemas/IncidentNotificationRuleArrayMetaPage' + type: object + IncidentNotificationRuleCreateData: + description: Notification rule data for a create request. + properties: + attributes: + $ref: '#/components/schemas/IncidentNotificationRuleCreateAttributes' + relationships: + $ref: '#/components/schemas/IncidentNotificationRuleCreateDataRelationships' + type: + $ref: '#/components/schemas/IncidentNotificationRuleType' + required: + - type + - attributes + type: object + IncidentNotificationRuleUpdateData: + description: Notification rule data for an update request. + properties: + attributes: + $ref: '#/components/schemas/IncidentNotificationRuleCreateAttributes' + id: + description: The unique identifier of the notification rule. + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + relationships: + $ref: '#/components/schemas/IncidentNotificationRuleCreateDataRelationships' + type: + $ref: '#/components/schemas/IncidentNotificationRuleType' + required: + - id + - type + - attributes + type: object + IncidentNotificationTemplateResponseData: + description: Notification template data from a response. + properties: + attributes: + $ref: '#/components/schemas/IncidentNotificationTemplateAttributes' + id: + description: The unique identifier of the notification template. + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + relationships: + $ref: '#/components/schemas/IncidentNotificationTemplateRelationships' + type: + $ref: '#/components/schemas/IncidentNotificationTemplateType' + required: + - id + - type + type: object + IncidentNotificationTemplateIncludedItems: + description: Objects related to a notification template. + oneOf: + - $ref: '#/components/schemas/User' + - $ref: '#/components/schemas/IncidentTypeObject' + IncidentNotificationTemplateArrayMeta: + description: Response metadata. + properties: + page: + $ref: '#/components/schemas/IncidentNotificationTemplateArrayMetaPage' + type: object + IncidentNotificationTemplateCreateData: + description: Notification template data for a create request. + properties: + attributes: + $ref: '#/components/schemas/IncidentNotificationTemplateCreateAttributes' + relationships: + $ref: >- + #/components/schemas/IncidentNotificationTemplateCreateDataRelationships + type: + $ref: '#/components/schemas/IncidentNotificationTemplateType' + required: + - type + - attributes + type: object + IncidentNotificationTemplateUpdateData: + description: Notification template data for an update request. + properties: + attributes: + $ref: '#/components/schemas/IncidentNotificationTemplateUpdateAttributes' + id: + description: The unique identifier of the notification template. + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + type: + $ref: '#/components/schemas/IncidentNotificationTemplateType' + required: + - id + - type + type: object + IncidentTypeObject: + description: Incident type response data. + properties: + attributes: + $ref: '#/components/schemas/IncidentTypeAttributes' + id: + description: The incident type's ID. + example: 00000000-0000-0000-0000-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentTypeRelationships' + type: + $ref: '#/components/schemas/IncidentTypeType' + required: + - id + - type + type: object + IncidentTypeCreateData: + description: Incident type data for a create request. + properties: + attributes: + $ref: '#/components/schemas/IncidentTypeAttributes' + type: + $ref: '#/components/schemas/IncidentTypeType' + required: + - type + - attributes + type: object + IncidentTypePatchData: + description: Incident type data for a patch request. + properties: + attributes: + $ref: '#/components/schemas/IncidentTypeUpdateAttributes' + id: + description: The incident type's ID. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentTypeType' + required: + - id + - type + - attributes + type: object + IncidentSearchSortOrder: + description: The ways searched incidents can be sorted. + enum: + - created + - '-created' + type: string + x-enum-varnames: + - CREATED_ASCENDING + - CREATED_DESCENDING + IncidentSearchResponseData: + description: Data returned by an incident search. + properties: + attributes: + $ref: '#/components/schemas/IncidentSearchResponseAttributes' + type: + $ref: '#/components/schemas/IncidentSearchResultsType' + type: object + IncidentSearchResponseMeta: + description: The metadata object containing pagination metadata. + properties: + pagination: + $ref: '#/components/schemas/IncidentResponseMetaPagination' + readOnly: true + type: object + IncidentUpdateData: + description: Incident data for an update request. + properties: + attributes: + $ref: '#/components/schemas/IncidentUpdateAttributes' + id: + description: The incident's ID. + example: 00000000-0000-0000-4567-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentUpdateRelationships' + type: + $ref: '#/components/schemas/IncidentType' + required: + - id + - type + type: object + IncidentAttachmentRelatedObject: + description: The object related to an incident attachment. + enum: + - users + type: string + x-enum-varnames: + - USERS + IncidentAttachmentAttachmentType: + description: The type of the incident attachment attributes. + enum: + - link + - postmortem + example: link + type: string + x-enum-varnames: + - LINK + - POSTMORTEM + IncidentAttachmentData: + description: A single incident attachment. + example: + attributes: + attachment: + documentUrl: '' + title: Postmortem IR-123 + attachment_type: postmortem + id: 00000000-abcd-0002-0000-000000000000 + relationships: + last_modified_by_user: + data: + id: 00000000-0000-0000-cccc-000000000000 + type: users + type: incident_attachments + properties: + attributes: + $ref: '#/components/schemas/IncidentAttachmentAttributes' + id: + description: A unique identifier that represents the incident attachment. + example: 00000000-abcd-0001-0000-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentAttachmentRelationships' + type: + $ref: '#/components/schemas/IncidentAttachmentType' + required: + - type + - attributes + - id + - relationships + type: object + IncidentAttachmentsResponseIncludedItem: + description: An object related to an attachment that is included in the response. + oneOf: + - $ref: '#/components/schemas/User' + IncidentAttachmentUpdateData: + description: A single incident attachment. + properties: + attributes: + $ref: '#/components/schemas/IncidentAttachmentUpdateAttributes' + id: + description: A unique identifier that represents the incident attachment. + example: 00000000-abcd-0001-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentAttachmentType' + required: + - type + type: object + IncidentIntegrationMetadataResponseData: + description: Incident integration metadata from a response. + properties: + attributes: + $ref: '#/components/schemas/IncidentIntegrationMetadataAttributes' + id: + description: The incident integration metadata's ID. + example: 00000000-0000-0000-1234-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentIntegrationRelationships' + type: + $ref: '#/components/schemas/IncidentIntegrationMetadataType' + required: + - id + - type + type: object + IncidentIntegrationMetadataResponseIncludedItem: + description: >- + An object related to an incident integration metadata that is included + in the response. + oneOf: + - $ref: '#/components/schemas/User' + IncidentIntegrationMetadataCreateData: + description: Incident integration metadata data for a create request. + properties: + attributes: + $ref: '#/components/schemas/IncidentIntegrationMetadataAttributes' + type: + $ref: '#/components/schemas/IncidentIntegrationMetadataType' + required: + - type + - attributes + type: object + IncidentIntegrationMetadataPatchData: + description: Incident integration metadata data for a patch request. + properties: + attributes: + $ref: '#/components/schemas/IncidentIntegrationMetadataAttributes' + type: + $ref: '#/components/schemas/IncidentIntegrationMetadataType' + required: + - type + - attributes + type: object + IncidentTodoResponseData: + description: Incident todo response data. + properties: + attributes: + $ref: '#/components/schemas/IncidentTodoAttributes' + id: + description: The incident todo's ID. + example: 00000000-0000-0000-1234-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentTodoRelationships' + type: + $ref: '#/components/schemas/IncidentTodoType' + required: + - id + - type + type: object + IncidentTodoResponseIncludedItem: + description: An object related to an incident todo that is included in the response. + oneOf: + - $ref: '#/components/schemas/User' + IncidentTodoCreateData: + description: Incident todo data for a create request. + properties: + attributes: + $ref: '#/components/schemas/IncidentTodoAttributes' + type: + $ref: '#/components/schemas/IncidentTodoType' + required: + - type + - attributes + type: object + IncidentTodoPatchData: + description: Incident todo data for a patch request. + properties: + attributes: + $ref: '#/components/schemas/IncidentTodoAttributes' + type: + $ref: '#/components/schemas/IncidentTodoType' + required: + - type + - attributes + type: object + EscalationPolicyCreateRequestData: + description: >- + Represents the data for creating an escalation policy, including its + attributes, relationships, and resource type. + properties: + attributes: + $ref: '#/components/schemas/EscalationPolicyCreateRequestDataAttributes' + relationships: + $ref: '#/components/schemas/EscalationPolicyCreateRequestDataRelationships' + type: + $ref: '#/components/schemas/EscalationPolicyCreateRequestDataType' + required: + - type + - attributes + type: object + EscalationPolicyData: + description: >- + Represents the data for a single escalation policy, including its + attributes, ID, relationships, and resource type. + properties: + attributes: + $ref: '#/components/schemas/EscalationPolicyDataAttributes' + id: + description: Specifies the unique identifier of the escalation policy. + example: ab000000-0000-0000-0000-000000000000 + type: string + relationships: + $ref: '#/components/schemas/EscalationPolicyDataRelationships' + type: + $ref: '#/components/schemas/EscalationPolicyDataType' + required: + - type + type: object + EscalationPolicyIncluded: + description: >- + Represents included related resources when retrieving an escalation + policy, such as teams, steps, or targets. + oneOf: + - $ref: '#/components/schemas/TeamReference' + - $ref: '#/components/schemas/EscalationPolicyStep' + - $ref: '#/components/schemas/EscalationPolicyUser' + - $ref: '#/components/schemas/ScheduleData' + EscalationPolicyUpdateRequestData: + description: >- + Represents the data for updating an existing escalation policy, + including its ID, attributes, relationships, and resource type. + properties: + attributes: + $ref: '#/components/schemas/EscalationPolicyUpdateRequestDataAttributes' + id: + description: >- + Specifies the unique identifier of the escalation policy being + updated. + example: 00000000-aba1-0000-0000-000000000000 + type: string + relationships: + $ref: '#/components/schemas/EscalationPolicyUpdateRequestDataRelationships' + type: + $ref: '#/components/schemas/EscalationPolicyUpdateRequestDataType' + required: + - type + - id + - attributes + type: object + CreatePageRequestData: + description: The main request body, including attributes and resource type. + properties: + attributes: + $ref: '#/components/schemas/CreatePageRequestDataAttributes' + type: + $ref: '#/components/schemas/CreatePageRequestDataType' + required: + - type + type: object + CreatePageResponseData: + description: The information returned after successfully creating a page. + properties: + id: + description: The unique ID of the created page. + type: string + type: + $ref: '#/components/schemas/CreatePageResponseDataType' + required: + - type + type: object + ScheduleCreateRequestData: + description: >- + The core data wrapper for creating a schedule, encompassing attributes, + relationships, and the resource type. + properties: + attributes: + $ref: '#/components/schemas/ScheduleCreateRequestDataAttributes' + relationships: + $ref: '#/components/schemas/ScheduleCreateRequestDataRelationships' + type: + $ref: '#/components/schemas/ScheduleCreateRequestDataType' + required: + - type + - attributes + type: object + ScheduleData: + description: >- + Represents the primary data object for a schedule, linking attributes + and relationships. + properties: + attributes: + $ref: '#/components/schemas/ScheduleDataAttributes' + id: + description: The schedule's unique identifier. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + relationships: + $ref: '#/components/schemas/ScheduleDataRelationships' + type: + $ref: '#/components/schemas/ScheduleDataType' + required: + - type + type: object + ScheduleDataIncludedItem: + description: >- + Any additional resources related to this schedule, such as teams and + layers. + oneOf: + - $ref: '#/components/schemas/TeamReference' + - $ref: '#/components/schemas/Layer' + - $ref: '#/components/schemas/ScheduleMember' + - $ref: '#/components/schemas/ScheduleUser' + ScheduleUpdateRequestData: + description: >- + Contains all data needed to update an existing schedule, including its + attributes (such as name and time zone) and any relationships to teams. + properties: + attributes: + $ref: '#/components/schemas/ScheduleUpdateRequestDataAttributes' + id: + description: The ID of the schedule to be updated. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + relationships: + $ref: '#/components/schemas/ScheduleUpdateRequestDataRelationships' + type: + $ref: '#/components/schemas/ScheduleUpdateRequestDataType' + required: + - type + - id + - attributes + type: object + ShiftData: + description: Data for an on-call shift. + properties: + attributes: + $ref: '#/components/schemas/ShiftDataAttributes' + id: + description: The `ShiftData` `id`. + type: string + relationships: + $ref: '#/components/schemas/ShiftDataRelationships' + type: + $ref: '#/components/schemas/ShiftDataType' + required: + - type + type: object + ShiftIncluded: + description: Included data for shift operations. + oneOf: + - $ref: '#/components/schemas/ScheduleUser' + TeamOnCallRespondersData: + description: >- + Defines the main on-call responder object for a team, including + relationships and metadata. + properties: + id: + description: Unique identifier of the on-call responder configuration. + type: string + relationships: + $ref: '#/components/schemas/TeamOnCallRespondersDataRelationships' + type: + $ref: '#/components/schemas/TeamOnCallRespondersDataType' + required: + - type + type: object + TeamOnCallRespondersIncluded: + description: >- + Represents an union of related resources included in the response, such + as users and escalation steps. + oneOf: + - $ref: '#/components/schemas/User' + - $ref: '#/components/schemas/Escalation' + TeamRoutingRulesData: + description: >- + Represents the top-level data object for team routing rules, containing + the ID, relationships, and resource type. + properties: + id: + description: Specifies the unique identifier of this team routing rules record. + type: string + relationships: + $ref: '#/components/schemas/TeamRoutingRulesDataRelationships' + type: + $ref: '#/components/schemas/TeamRoutingRulesDataType' + required: + - type + type: object + TeamRoutingRulesIncluded: + description: >- + Represents additional included resources for team routing rules, such as + associated routing rules. + oneOf: + - $ref: '#/components/schemas/RoutingRule' + TeamRoutingRulesRequestData: + description: >- + Holds the data necessary to create or update team routing rules, + including attributes, ID, and resource type. + properties: + attributes: + $ref: '#/components/schemas/TeamRoutingRulesRequestDataAttributes' + id: + description: Specifies the unique identifier for this set of team routing rules. + type: string + type: + $ref: '#/components/schemas/TeamRoutingRulesRequestDataType' + required: + - type + type: object + IncidentServiceResponseData: + description: Incident Service data from responses. + properties: + attributes: + $ref: '#/components/schemas/IncidentServiceResponseAttributes' + id: + description: The incident service's ID. + example: 00000000-0000-0000-0000-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentServiceRelationships' + type: + $ref: '#/components/schemas/IncidentServiceType' + required: + - id + - type + type: object + IncidentServiceIncludedItems: + description: >- + An object related to an incident service which is present in the + included payload. + oneOf: + - $ref: '#/components/schemas/User' + IncidentServiceCreateData: + description: Incident Service payload for create requests. + properties: + attributes: + $ref: '#/components/schemas/IncidentServiceCreateAttributes' + relationships: + $ref: '#/components/schemas/IncidentServiceRelationships' + type: + $ref: '#/components/schemas/IncidentServiceType' + required: + - type + type: object + ServiceDefinitionSchemaVersions: + description: Schema versions + enum: + - v1 + - v2 + - v2.1 + - v2.2 + type: string + x-enum-varnames: + - V1 + - V2 + - V2_1 + - V2_2 + ServiceDefinitionData: + description: Service definition data. + properties: + attributes: + $ref: '#/components/schemas/ServiceDefinitionDataAttributes' + id: + description: Service definition id. + type: string + type: + description: Service definition type. + type: string + type: object + ServiceDefinitionV2Dot2: + description: Service definition v2.2 for providing service metadata and integrations. + properties: + application: + description: >- + Identifier for a group of related services serving a product + feature, which the service is a part of. + example: my-app + type: string + ci-pipeline-fingerprints: + description: A set of CI fingerprints. + example: + - j88xdEy0J5lc + - eZ7LMljCk8vo + items: + type: string + type: array + contacts: + description: A list of contacts related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV2Dot2Contact' + type: array + dd-service: + description: >- + Unique identifier of the service. Must be unique across all services + and is used to match with a service in Datadog. + example: my-service + type: string + description: + description: A short description of the service. + example: My service description + type: string + extensions: + additionalProperties: {} + description: Extensions to v2.2 schema. + example: + myorg/extension: extensionValue + type: object + integrations: + $ref: '#/components/schemas/ServiceDefinitionV2Dot2Integrations' + languages: + description: >- + The service's programming language. Datadog recognizes the following + languages: `dotnet`, `go`, `java`, `js`, `php`, `python`, `ruby`, + and `c++`. + example: + - dotnet + - go + - java + - js + - php + - python + - ruby + - c++ + items: + type: string + type: array + lifecycle: + description: The current life cycle phase of the service. + example: sandbox + type: string + links: + description: A list of links related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV2Dot2Link' + type: array + schema-version: + $ref: '#/components/schemas/ServiceDefinitionV2Dot2Version' + tags: + description: A set of custom tags. + example: + - my:tag + - service:tag + items: + type: string + type: array + team: + description: >- + Team that owns the service. It is used to locate a team defined in + Datadog Teams if it exists. + example: my-team + type: string + tier: + description: Importance of the service. + example: High + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2Dot2Type' + required: + - schema-version + - dd-service + type: object + ServiceDefinitionV2Dot1: + description: Service definition v2.1 for providing service metadata and integrations. + properties: + application: + description: >- + Identifier for a group of related services serving a product + feature, which the service is a part of. + example: my-app + type: string + contacts: + description: A list of contacts related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1Contact' + type: array + dd-service: + description: >- + Unique identifier of the service. Must be unique across all services + and is used to match with a service in Datadog. + example: my-service + type: string + description: + description: A short description of the service. + example: My service description + type: string + extensions: + additionalProperties: {} + description: Extensions to v2.1 schema. + example: + myorg/extension: extensionValue + type: object + integrations: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1Integrations' + lifecycle: + description: The current life cycle phase of the service. + example: sandbox + type: string + links: + description: A list of links related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1Link' + type: array + schema-version: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1Version' + tags: + description: A set of custom tags. + example: + - my:tag + - service:tag + items: + type: string + type: array + team: + description: >- + Team that owns the service. It is used to locate a team defined in + Datadog Teams if it exists. + example: my-team + type: string + tier: + description: Importance of the service. + example: High + type: string + required: + - schema-version + - dd-service + type: object + ServiceDefinitionV2: + description: Service definition V2 for providing service metadata and integrations. + properties: + contacts: + description: A list of contacts related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV2Contact' + type: array + dd-service: + description: >- + Unique identifier of the service. Must be unique across all services + and is used to match with a service in Datadog. + example: my-service + type: string + dd-team: + description: >- + Experimental feature. A Team handle that matches a Team in the + Datadog Teams product. + example: my-team + type: string + docs: + description: A list of documentation related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV2Doc' + type: array + extensions: + additionalProperties: {} + description: Extensions to V2 schema. + example: + myorg/extension: extensionValue + type: object + integrations: + $ref: '#/components/schemas/ServiceDefinitionV2Integrations' + links: + description: A list of links related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV2Link' + type: array + repos: + description: A list of code repositories related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV2Repo' + type: array + schema-version: + $ref: '#/components/schemas/ServiceDefinitionV2Version' + tags: + description: A set of custom tags. + example: + - my:tag + - service:tag + items: + type: string + type: array + team: + description: Team that owns the service. + example: my-team + type: string + required: + - schema-version + - dd-service + type: object + ServiceDefinitionRaw: + description: Service Definition in raw JSON/YAML representation. + example: | + --- + schema-version: v2 + dd-service: my-service + type: string + IncidentServiceUpdateData: + description: Incident Service payload for update requests. + properties: + attributes: + $ref: '#/components/schemas/IncidentServiceUpdateAttributes' + id: + description: The incident service's ID. + example: 00000000-0000-0000-0000-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentServiceRelationships' + type: + $ref: '#/components/schemas/IncidentServiceType' + required: + - type + type: object + SloReportCreateRequestData: + description: The data portion of the SLO report request. + properties: + attributes: + $ref: '#/components/schemas/SloReportCreateRequestAttributes' + required: + - attributes + type: object + SLOReportPostResponseData: + description: The data portion of the SLO report response. + properties: + id: + description: The ID of the report job. + example: dc8d92aa-e0af-11ee-af21-1feeaccaa3a3 + type: string + type: + description: The type of ID. + example: report_id + type: string + type: object + SLOReportStatusGetResponseData: + description: The data portion of the SLO report status response. + properties: + attributes: + $ref: '#/components/schemas/SLOReportStatusGetResponseAttributes' + id: + description: The ID of the report job. + example: dc8d92aa-e0af-11ee-af21-1feeaccaa3a3 + type: string + type: + description: The type of ID. + example: report_id + type: string + type: object + IncidentTeamResponseData: + description: Incident Team data from a response. + properties: + attributes: + $ref: '#/components/schemas/IncidentTeamResponseAttributes' + id: + description: The incident team's ID. + example: 00000000-7ea3-0000-000a-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentTeamRelationships' + type: + $ref: '#/components/schemas/IncidentTeamType' + type: object + IncidentTeamIncludedItems: + description: >- + An object related to an incident team which is present in the included + payload. + oneOf: + - $ref: '#/components/schemas/User' + IncidentTeamCreateData: + description: Incident Team data for a create request. + properties: + attributes: + $ref: '#/components/schemas/IncidentTeamCreateAttributes' + relationships: + $ref: '#/components/schemas/IncidentTeamRelationships' + type: + $ref: '#/components/schemas/IncidentTeamType' + required: + - type + type: object + IncidentTeamUpdateData: + description: Incident Team data for an update request. + properties: + attributes: + $ref: '#/components/schemas/IncidentTeamUpdateAttributes' + id: + description: The incident team's ID. + example: 00000000-7ea3-0000-0001-000000000000 + type: string + relationships: + $ref: '#/components/schemas/IncidentTeamRelationships' + type: + $ref: '#/components/schemas/IncidentTeamType' + required: + - type + type: object + CaseAttributes: + description: Case resource attributes + properties: + archived_at: + description: Timestamp of when the case was archived + format: date-time + nullable: true + readOnly: true + type: string + attributes: + $ref: '#/components/schemas/CaseObjectAttributes' + closed_at: + description: Timestamp of when the case was closed + format: date-time + nullable: true + readOnly: true + type: string + created_at: + description: Timestamp of when the case was created + format: date-time + readOnly: true + type: string + description: + description: Description + type: string + jira_issue: + $ref: '#/components/schemas/JiraIssue' + key: + description: Key + example: CASEM-4523 + type: string + modified_at: + description: Timestamp of when the case was last modified + format: date-time + nullable: true + readOnly: true + type: string + priority: + $ref: '#/components/schemas/CasePriority' + service_now_ticket: + $ref: '#/components/schemas/ServiceNowTicket' + status: + $ref: '#/components/schemas/CaseStatus' + title: + description: Title + example: Memory leak investigation on API + type: string + type: + $ref: '#/components/schemas/CaseType' + type: object + CaseRelationships: + description: Resources related to a case + properties: + assignee: + $ref: '#/components/schemas/NullableUserRelationship' + created_by: + $ref: '#/components/schemas/NullableUserRelationship' + modified_by: + $ref: '#/components/schemas/NullableUserRelationship' + project: + $ref: '#/components/schemas/ProjectRelationship' + type: object + CaseResourceType: + default: case + description: Case resource type + enum: + - case + example: case + type: string + x-enum-varnames: + - CASE + CasesResponseMetaPagination: + description: Pagination metadata + properties: + current: + description: Current page number + format: int64 + type: integer + size: + description: Number of cases in current page + format: int64 + type: integer + total: + description: Total number of pages + format: int64 + type: integer + type: object + CaseCreateAttributes: + description: Case creation attributes + properties: + description: + description: Description + type: string + priority: + $ref: '#/components/schemas/CasePriority' + title: + description: Title + example: Security breach investigation + type: string + type: + $ref: '#/components/schemas/CaseType' + required: + - title + - type + type: object + CaseCreateRelationships: + description: Relationships formed with the case on creation + properties: + assignee: + $ref: '#/components/schemas/NullableUserRelationship' + project: + $ref: '#/components/schemas/ProjectRelationship' + required: + - project + type: object + ProjectAttributes: + description: Project attributes + properties: + key: + description: The project's key + example: CASEM + type: string + name: + description: Project's name + type: string + type: object + ProjectRelationships: + description: Project relationships + properties: + member_team: + $ref: '#/components/schemas/RelationshipToTeamLinks' + member_user: + $ref: '#/components/schemas/UsersRelationship' + type: object + ProjectResourceType: + default: project + description: Project resource type + enum: + - project + example: project + type: string + x-enum-varnames: + - PROJECT + ProjectCreateAttributes: + description: Project creation attributes + properties: + key: + description: Project's key. Cannot be "CASE" + example: SEC + type: string + name: + description: name + example: Security Investigation + type: string + required: + - name + - key + type: object + CaseAssignAttributes: + description: Case assign attributes + properties: + assignee_id: + description: Assignee's UUID + example: f98a5a5b-e0ff-45d4-b2f5-afe6e74de504 + type: string + required: + - assignee_id + type: object + CaseUpdateAttributesAttributes: + description: Case update attributes attributes + properties: + attributes: + $ref: '#/components/schemas/CaseObjectAttributes' + required: + - attributes + type: object + CaseUpdatePriorityAttributes: + description: Case update priority attributes + properties: + priority: + $ref: '#/components/schemas/CasePriority' + required: + - priority + type: object + CaseUpdateStatusAttributes: + description: Case update status attributes + properties: + status: + $ref: '#/components/schemas/CaseStatus' + required: + - status + type: object + DowntimeResponseAttributes: + description: Downtime details. + properties: + canceled: + description: Time that the downtime was canceled. + example: 2020-01-02T03:04:05.282979+0000 + format: date-time + nullable: true + type: string + created: + description: Creation time of the downtime. + example: 2020-01-02T03:04:05.282979+0000 + format: date-time + type: string + display_timezone: + $ref: '#/components/schemas/DowntimeDisplayTimezone' + message: + $ref: '#/components/schemas/DowntimeMessage' + modified: + description: Time that the downtime was last modified. + example: 2020-01-02T03:04:05.282979+0000 + format: date-time + type: string + monitor_identifier: + $ref: '#/components/schemas/DowntimeMonitorIdentifier' + mute_first_recovery_notification: + $ref: '#/components/schemas/DowntimeMuteFirstRecoveryNotification' + notify_end_states: + $ref: '#/components/schemas/DowntimeNotifyEndStates' + notify_end_types: + $ref: '#/components/schemas/DowntimeNotifyEndTypes' + schedule: + $ref: '#/components/schemas/DowntimeScheduleResponse' + scope: + $ref: '#/components/schemas/DowntimeScope' + status: + $ref: '#/components/schemas/DowntimeStatus' + type: object + DowntimeRelationships: + description: All relationships associated with downtime. + properties: + created_by: + $ref: '#/components/schemas/DowntimeRelationshipsCreatedBy' + monitor: + $ref: '#/components/schemas/DowntimeRelationshipsMonitor' + type: object + DowntimeResourceType: + default: downtime + description: Downtime resource type. + enum: + - downtime + example: downtime + type: string + x-enum-varnames: + - DOWNTIME + User: + description: User object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/UserAttributes' + id: + description: ID of the user. + type: string + relationships: + $ref: '#/components/schemas/UserResponseRelationships' + type: + $ref: '#/components/schemas/UsersType' + type: object + DowntimeMonitorIncludedItem: + description: Information about the monitor identified by the downtime. + properties: + attributes: + $ref: '#/components/schemas/DowntimeMonitorIncludedAttributes' + id: + description: ID of the monitor identified by the downtime. + example: 12345 + format: int64 + type: integer + type: + $ref: '#/components/schemas/DowntimeIncludedMonitorType' + type: object + DowntimeMetaPage: + description: Object containing the total filtered count. + properties: + total_filtered_count: + description: Total count of elements matched by the filter. + format: int64 + type: integer + type: object + DowntimeCreateRequestAttributes: + description: Downtime details. + properties: + display_timezone: + $ref: '#/components/schemas/DowntimeDisplayTimezone' + message: + $ref: '#/components/schemas/DowntimeMessage' + monitor_identifier: + $ref: '#/components/schemas/DowntimeMonitorIdentifier' + mute_first_recovery_notification: + $ref: '#/components/schemas/DowntimeMuteFirstRecoveryNotification' + notify_end_states: + $ref: '#/components/schemas/DowntimeNotifyEndStates' + notify_end_types: + $ref: '#/components/schemas/DowntimeNotifyEndTypes' + schedule: + $ref: '#/components/schemas/DowntimeScheduleCreateRequest' + scope: + $ref: '#/components/schemas/DowntimeScope' + required: + - scope + - monitor_identifier + type: object + DowntimeUpdateRequestAttributes: + description: Attributes of the downtime to update. + properties: + display_timezone: + $ref: '#/components/schemas/DowntimeDisplayTimezone' + message: + $ref: '#/components/schemas/DowntimeMessage' + monitor_identifier: + $ref: '#/components/schemas/DowntimeMonitorIdentifier' + mute_first_recovery_notification: + $ref: '#/components/schemas/DowntimeMuteFirstRecoveryNotification' + notify_end_states: + $ref: '#/components/schemas/DowntimeNotifyEndStates' + notify_end_types: + $ref: '#/components/schemas/DowntimeNotifyEndTypes' + schedule: + $ref: '#/components/schemas/DowntimeScheduleUpdateRequest' + scope: + $ref: '#/components/schemas/DowntimeScope' + type: object + IssuesSearchRequestDataAttributes: + description: Object describing a search issue request. + properties: + from: + description: >- + Start date (inclusive) of the query in milliseconds since the Unix + epoch. + example: 1671612804000 + format: int64 + type: integer + order_by: + $ref: '#/components/schemas/IssuesSearchRequestDataAttributesOrderBy' + persona: + $ref: '#/components/schemas/IssuesSearchRequestDataAttributesPersona' + query: + description: Search query following the event search syntax. + example: service:orders-* AND @language:go + type: string + to: + description: >- + End date (exclusive) of the query in milliseconds since the Unix + epoch. + example: 1671620004000 + format: int64 + type: integer + track: + $ref: '#/components/schemas/IssuesSearchRequestDataAttributesTrack' + required: + - query + - from + - to + type: object + IssuesSearchRequestDataType: + description: Type of the object. + enum: + - search_request + example: search_request + type: string + x-enum-varnames: + - SEARCH_REQUEST + IssuesSearchResultAttributes: + description: Object containing the information of a search result. + properties: + impacted_sessions: + description: >- + Count of sessions impacted by the issue over the queried time + window. + example: 12 + format: int64 + type: integer + impacted_users: + description: Count of users impacted by the issue over the queried time window. + example: 4 + format: int64 + type: integer + total_count: + description: >- + Total count of errors that match the issue over the queried time + window. + example: 82 + format: int64 + type: integer + type: object + IssuesSearchResultRelationships: + description: Relationships between the search result and other resources. + properties: + issue: + $ref: '#/components/schemas/IssuesSearchResultIssueRelationship' + type: object + IssuesSearchResultType: + description: Type of the object. + enum: + - error_tracking_search_result + example: error_tracking_search_result + type: string + x-enum-varnames: + - ERROR_TRACKING_SEARCH_RESULT + IssueUser: + description: The user to whom the issue is assigned. + properties: + attributes: + $ref: '#/components/schemas/IssueUserAttributes' + id: + description: User identifier. + example: 87cb11a0-278c-440a-99fe-701223c80296 + type: string + type: + $ref: '#/components/schemas/IssueUserType' + required: + - id + - type + - attributes + type: object + IssueTeam: + description: A team that owns an issue. + properties: + attributes: + $ref: '#/components/schemas/IssueTeamAttributes' + id: + description: Team identifier. + example: 221b0179-6447-4d03-91c3-3ca98bf60e8a + type: string + type: + $ref: '#/components/schemas/IssueTeamType' + required: + - id + - type + - attributes + type: object + IssueAttributes: + description: Object containing the information of an issue. + properties: + error_message: + description: Error message associated with the issue. + example: object of type 'NoneType' has no len() + type: string + error_type: + description: Type of the error that matches the issue. + example: builtins.TypeError + type: string + file_path: + description: Path of the file where the issue occurred. + example: /django-email/conduit/apps/core/utils.py + type: string + first_seen: + description: >- + Timestamp of the first seen error in milliseconds since the Unix + epoch. + example: 1671612804001 + format: int64 + type: integer + first_seen_version: + description: >- + The application version (for example, git commit hash) where the + issue was first observed. + example: aaf65cd0 + type: string + function_name: + description: Name of the function where the issue occurred. + example: filter_forbidden_tags + type: string + is_crash: + description: Error is a crash. + example: false + type: boolean + languages: + description: Array of programming languages associated with the issue. + example: + - PYTHON + - GO + items: + $ref: '#/components/schemas/IssueLanguage' + type: array + last_seen: + description: >- + Timestamp of the last seen error in milliseconds since the Unix + epoch. + example: 1671620003100 + format: int64 + type: integer + last_seen_version: + description: >- + The application version (for example, git commit hash) where the + issue was last observed. + example: b6199f80 + type: string + platform: + $ref: '#/components/schemas/IssuePlatform' + service: + description: Service name. + example: email-api-py + type: string + state: + $ref: '#/components/schemas/IssueState' + type: object + IssueRelationships: + description: Relationship between the issue and an assignee, case and/or teams. + properties: + assignee: + $ref: '#/components/schemas/IssueAssigneeRelationship' + case: + $ref: '#/components/schemas/IssueCaseRelationship' + team_owners: + $ref: '#/components/schemas/IssueTeamOwnersRelationship' + type: object + IssueType: + description: Type of the object. + enum: + - issue + example: issue + type: string + x-enum-varnames: + - ISSUE + IssueCase: + description: The case attached to the issue. + properties: + attributes: + $ref: '#/components/schemas/IssueCaseAttributes' + id: + description: Case identifier. + example: 2841440d-e780-4fe2-96cd-6a8c1d194da5 + type: string + relationships: + $ref: '#/components/schemas/IssueCaseRelationships' + type: + $ref: '#/components/schemas/IssueCaseResourceType' + required: + - id + - type + - attributes + type: object + IssueUpdateAssigneeRequestDataType: + description: Type of the object. + enum: + - assignee + example: assignee + type: string + x-enum-varnames: + - ASSIGNEE + IssueUpdateStateRequestDataAttributes: + description: Object describing an issue state update request. + properties: + state: + $ref: '#/components/schemas/IssueState' + required: + - state + type: object + IssueUpdateStateRequestDataType: + description: Type of the object. + enum: + - error_tracking_issue + example: error_tracking_issue + type: string + x-enum-varnames: + - ERROR_TRACKING_ISSUE + EventResponseAttributes: + description: The object description of an event response attribute. + properties: + attributes: + $ref: '#/components/schemas/EventAttributes' + message: + description: The message of the event. + type: string + tags: + description: An array of tags associated with the event. + example: + - team:A + items: + description: The tag associated with the event. + type: string + type: array + timestamp: + description: The timestamp of the event. + example: '2019-01-02T09:42:36.320Z' + format: date-time + type: string + type: object + EventType: + default: event + description: Type of the event. + enum: + - event + example: event + type: string + x-enum-varnames: + - EVENT + EventsResponseMetadataPage: + description: Pagination attributes. + properties: + after: + description: >- + The cursor to use to get the next results, if any. To make the next + request, use the same + + parameters with the addition of the `page[cursor]`. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + EventsWarning: + description: A warning message indicating something is wrong with the query. + properties: + code: + description: A unique code for this type of warning. + example: unknown_index + type: string + detail: + description: A detailed explanation of this specific warning. + example: 'indexes: foo, bar' + type: string + title: + description: A short human-readable summary of the warning. + example: >- + One or several indexes are missing or invalid. Results hold data + from the other indexes. + type: string + type: object + EventPayload: + additionalProperties: false + description: Event attributes. + properties: + aggregation_key: + description: >- + A string used for aggregation when + [correlating](https://docs.datadoghq.com/service_management/events/correlation/) + events. If you specify a key, events are deduplicated to alerts + based on this key. Limited to 100 characters. + example: aggregation_key_123 + maxLength: 100 + minLength: 1 + type: string + attributes: + $ref: '#/components/schemas/EventPayloadAttributes' + category: + $ref: '#/components/schemas/EventCategory' + integration_id: + $ref: '#/components/schemas/EventPayloadIntegrationId' + message: + description: >- + Free formed text associated with the event. It's suggested to use + `data.attributes.attributes.custom` for well-structured attributes. + Limited to 4000 characters. + example: payment_processed feature flag has been enabled + maxLength: 4000 + minLength: 1 + type: string + tags: + description: >- + A list of tags associated with the event. Maximum of 100 tags + allowed. + + Refer to [Tags + docs](https://docs.datadoghq.com/getting_started/tagging/). + example: + - env:api_client_test + items: + description: A tag. + maxLength: 200 + minLength: 1 + type: string + maxItems: 100 + minItems: 1 + type: array + timestamp: + description: >- + Timestamp when the event occurred. Must follow [ISO + 8601](https://www.iso.org/iso-8601-date-and-time-format.html) + format. + + For example `"2017-01-15T01:30:15.010000Z"`. + + Defaults to the timestamp of receipt. Limited to values no older + than 18 hours. + type: string + title: + description: The title of the event. Limited to 500 characters. + example: payment_processed feature flag updated + maxLength: 500 + minLength: 1 + type: string + required: + - title + - category + - attributes + type: object + EventCreateRequestType: + description: Entity type. + enum: + - event + example: event + type: string + x-enum-varnames: + - EVENT + EventCreateResponseAttributes: + description: Event attributes. + properties: + attributes: + $ref: '#/components/schemas/EventCreateResponseAttributesAttributes' + type: object + JSONAPIErrorItemSource: + description: References to the source of the error. + properties: + header: + description: >- + A string indicating the name of a single request header which caused + the error. + example: Authorization + type: string + parameter: + description: A string indicating which URI query parameter caused the error. + example: limit + type: string + pointer: + description: >- + A JSON pointer to the value in the request document that caused the + error. + example: /data/attributes/title + type: string + type: object + V2EventAttributes: + description: Event attributes. + properties: + attributes: + $ref: '#/components/schemas/V2EventAttributesAttributes' + message: + description: Free-form text associated with the event. + example: The event message + type: string + tags: + description: A list of tags associated with the event. + example: + - env:api_client_test + items: + description: A tag. + type: string + type: array + timestamp: + description: Timestamp when the event occurred. + example: '2017-01-15T01:30:15.010000Z' + type: string + type: object + IncidentResponseAttributes: + description: The incident's attributes from a response. + properties: + archived: + description: Timestamp of when the incident was archived. + format: date-time + nullable: true + readOnly: true + type: string + case_id: + description: The incident case id. + format: int64 + nullable: true + type: integer + created: + description: Timestamp when the incident was created. + format: date-time + readOnly: true + type: string + customer_impact_duration: + description: >- + Length of the incident's customer impact in seconds. + + Equals the difference between `customer_impact_start` and + `customer_impact_end`. + format: int64 + readOnly: true + type: integer + customer_impact_end: + description: Timestamp when customers were no longer impacted by the incident. + format: date-time + nullable: true + type: string + customer_impact_scope: + description: A summary of the impact customers experienced during the incident. + example: An example customer impact scope + nullable: true + type: string + customer_impact_start: + description: Timestamp when customers began being impacted by the incident. + format: date-time + nullable: true + type: string + customer_impacted: + description: A flag indicating whether the incident caused customer impact. + example: false + type: boolean + detected: + description: Timestamp when the incident was detected. + format: date-time + nullable: true + type: string + fields: + additionalProperties: + $ref: '#/components/schemas/IncidentFieldAttributes' + description: A condensed view of the user-defined fields attached to incidents. + example: + severity: + type: dropdown + value: SEV-5 + type: object + incident_type_uuid: + description: A unique identifier that represents an incident type. + example: 00000000-0000-0000-0000-000000000000 + type: string + is_test: + description: A flag indicating whether the incident is a test incident. + example: false + type: boolean + modified: + description: Timestamp when the incident was last modified. + format: date-time + readOnly: true + type: string + non_datadog_creator: + $ref: '#/components/schemas/IncidentNonDatadogCreator' + notification_handles: + description: >- + Notification handles that will be notified of the incident during + update. + example: + - display_name: Jane Doe + handle: '@user@email.com' + - display_name: Slack Channel + handle: '@slack-channel' + - display_name: Incident Workflow + handle: '@workflow-from-incident' + items: + $ref: '#/components/schemas/IncidentNotificationHandle' + nullable: true + type: array + public_id: + description: The monotonically increasing integer ID for the incident. + example: 1 + format: int64 + type: integer + resolved: + description: >- + Timestamp when the incident's state was last changed from active or + stable to resolved or completed. + format: date-time + nullable: true + type: string + severity: + $ref: '#/components/schemas/IncidentSeverity' + state: + description: The state incident. + nullable: true + type: string + time_to_detect: + description: >- + The amount of time in seconds to detect the incident. + + Equals the difference between `customer_impact_start` and + `detected`. + format: int64 + readOnly: true + type: integer + time_to_internal_response: + description: >- + The amount of time in seconds to call incident after detection. + Equals the difference of `detected` and `created`. + format: int64 + readOnly: true + type: integer + time_to_repair: + description: >- + The amount of time in seconds to resolve customer impact after + detecting the issue. Equals the difference between + `customer_impact_end` and `detected`. + format: int64 + readOnly: true + type: integer + time_to_resolve: + description: >- + The amount of time in seconds to resolve the incident after it was + created. Equals the difference between `created` and `resolved`. + format: int64 + readOnly: true + type: integer + title: + description: The title of the incident, which summarizes what happened. + example: A test incident title + type: string + visibility: + description: The incident visibility status. + nullable: true + type: string + required: + - title + type: object + IncidentResponseRelationships: + description: The incident's relationships from a response. + properties: + attachments: + $ref: '#/components/schemas/RelationshipToIncidentAttachment' + commander_user: + $ref: '#/components/schemas/NullableRelationshipToUser' + created_by_user: + $ref: '#/components/schemas/RelationshipToUser' + impacts: + $ref: '#/components/schemas/RelationshipToIncidentImpacts' + integrations: + $ref: '#/components/schemas/RelationshipToIncidentIntegrationMetadatas' + last_modified_by_user: + $ref: '#/components/schemas/RelationshipToUser' + responders: + $ref: '#/components/schemas/RelationshipToIncidentResponders' + user_defined_fields: + $ref: '#/components/schemas/RelationshipToIncidentUserDefinedFields' + type: object + IncidentType: + default: incidents + description: Incident resource type. + enum: + - incidents + example: incidents + type: string + x-enum-varnames: + - INCIDENTS + IncidentUserData: + description: User object returned by the API. + properties: + attributes: + $ref: '#/components/schemas/IncidentUserAttributes' + id: + description: ID of the user. + type: string + type: + $ref: '#/components/schemas/UsersType' + type: object + IncidentResponseMetaPagination: + description: Pagination properties. + properties: + next_offset: + description: >- + The index of the first element in the next page of results. Equal to + page size added to the current offset. + example: 1000 + format: int64 + type: integer + offset: + description: The index of the first element in the results. + example: 10 + format: int64 + type: integer + size: + description: Maximum size of pages to return. + example: 1000 + format: int64 + type: integer + type: object + IncidentCreateAttributes: + description: The incident's attributes for a create request. + properties: + customer_impact_scope: + description: >- + Required if `customer_impacted:"true"`. A summary of the impact + customers experienced during the incident. + example: Example customer impact scope + type: string + customer_impacted: + description: A flag indicating whether the incident caused customer impact. + example: false + type: boolean + fields: + additionalProperties: + $ref: '#/components/schemas/IncidentFieldAttributes' + description: >- + A condensed view of the user-defined fields for which to create + initial selections. + example: + severity: + type: dropdown + value: SEV-5 + type: object + incident_type_uuid: + description: >- + A unique identifier that represents an incident type. The default + incident type will be used if this property is not provided. + example: 00000000-0000-0000-0000-000000000000 + type: string + initial_cells: + description: >- + An array of initial timeline cells to be placed at the beginning of + the incident timeline. + items: + $ref: '#/components/schemas/IncidentTimelineCellCreateAttributes' + type: array + is_test: + description: A flag indicating whether the incident is a test incident. + example: false + type: boolean + notification_handles: + description: >- + Notification handles that will be notified of the incident at + creation. + example: + - display_name: Jane Doe + handle: '@user@email.com' + - display_name: Slack Channel + handle: '@slack-channel' + - display_name: Incident Workflow + handle: '@workflow-from-incident' + items: + $ref: '#/components/schemas/IncidentNotificationHandle' + type: array + title: + description: The title of the incident, which summarizes what happened. + example: A test incident title + type: string + required: + - title + - customer_impacted + type: object + IncidentCreateRelationships: + description: >- + The relationships the incident will have with other resources once + created. + properties: + commander_user: + $ref: '#/components/schemas/NullableRelationshipToUser' + required: + - commander_user + type: object + IncidentNotificationRuleAttributes: + description: The notification rule's attributes. + properties: + conditions: + $ref: '#/components/schemas/IncidentNotificationRuleConditions' + created: + description: Timestamp when the notification rule was created. + example: '2025-01-15T10:30:00Z' + format: date-time + readOnly: true + type: string + enabled: + description: Whether the notification rule is enabled. + example: true + type: boolean + handles: + $ref: '#/components/schemas/IncidentNotificationRuleHandles' + modified: + description: Timestamp when the notification rule was last modified. + example: '2025-01-15T14:45:00Z' + format: date-time + readOnly: true + type: string + renotify_on: + $ref: '#/components/schemas/IncidentNotificationRuleRenotifyOn' + trigger: + description: The trigger event for this notification rule. + example: incident_created_trigger + type: string + visibility: + $ref: '#/components/schemas/IncidentNotificationRuleAttributesVisibility' + required: + - conditions + - handles + - visibility + - trigger + - enabled + - created + - modified + type: object + IncidentNotificationRuleRelationships: + description: The notification rule's resource relationships. + properties: + created_by_user: + $ref: '#/components/schemas/RelationshipToUser' + incident_type: + $ref: '#/components/schemas/RelationshipToIncidentType' + last_modified_by_user: + $ref: '#/components/schemas/RelationshipToUser' + notification_template: + $ref: '#/components/schemas/RelationshipToIncidentNotificationTemplate' + type: object + IncidentNotificationRuleType: + description: Notification rules resource type. + enum: + - incident_notification_rules + example: incident_notification_rules + type: string + x-enum-varnames: + - INCIDENT_NOTIFICATION_RULES + IncidentNotificationTemplateObject: + description: A notification template object for inclusion in other resources. + properties: + attributes: + $ref: '#/components/schemas/IncidentNotificationTemplateAttributes' + id: + description: The unique identifier of the notification template. + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + relationships: + $ref: '#/components/schemas/IncidentNotificationTemplateRelationships' + type: + $ref: '#/components/schemas/IncidentNotificationTemplateType' + required: + - id + - type + type: object + IncidentNotificationRuleArrayMetaPage: + description: Pagination metadata. + properties: + next_offset: + description: The offset for the next page of results. + example: 15 + format: int64 + type: integer + offset: + description: The current offset in the results. + example: 0 + format: int64 + type: integer + size: + description: The number of results returned per page. + example: 15 + format: int64 + type: integer + type: object + IncidentNotificationRuleCreateAttributes: + description: The attributes for creating a notification rule. + properties: + conditions: + $ref: '#/components/schemas/IncidentNotificationRuleConditions' + enabled: + default: false + description: Whether the notification rule is enabled. + example: true + type: boolean + handles: + $ref: '#/components/schemas/IncidentNotificationRuleHandles' + renotify_on: + $ref: '#/components/schemas/IncidentNotificationRuleRenotifyOn' + trigger: + description: The trigger event for this notification rule. + example: incident_created_trigger + type: string + visibility: + $ref: >- + #/components/schemas/IncidentNotificationRuleCreateAttributesVisibility + required: + - conditions + - handles + - trigger + type: object + IncidentNotificationRuleCreateDataRelationships: + description: The definition of `NotificationRuleCreateDataRelationships` object. + properties: + incident_type: + $ref: '#/components/schemas/RelationshipToIncidentType' + notification_template: + $ref: '#/components/schemas/RelationshipToIncidentNotificationTemplate' + type: object + IncidentNotificationTemplateAttributes: + description: The notification template's attributes. + properties: + category: + description: The category of the notification template. + example: alert + type: string + content: + description: The content body of the notification template. + example: |- + An incident has been declared. + + Title: {{incident.title}} + Severity: {{incident.severity}} + Affected Services: {{incident.services}} + Status: {{incident.state}} + + Please join the incident channel for updates. + type: string + created: + description: Timestamp when the notification template was created. + example: '2025-01-15T10:30:00Z' + format: date-time + readOnly: true + type: string + modified: + description: Timestamp when the notification template was last modified. + example: '2025-01-15T14:45:00Z' + format: date-time + readOnly: true + type: string + name: + description: The name of the notification template. + example: Incident Alert Template + type: string + subject: + description: The subject line of the notification template. + example: '{{incident.severity}} Incident: {{incident.title}}' + type: string + required: + - name + - subject + - content + - category + - created + - modified + type: object + IncidentNotificationTemplateRelationships: + description: The notification template's resource relationships. + properties: + created_by_user: + $ref: '#/components/schemas/RelationshipToUser' + incident_type: + $ref: '#/components/schemas/RelationshipToIncidentType' + last_modified_by_user: + $ref: '#/components/schemas/RelationshipToUser' + type: object + IncidentNotificationTemplateType: + description: Notification templates resource type. + enum: + - notification_templates + example: notification_templates + type: string + x-enum-varnames: + - NOTIFICATION_TEMPLATES + IncidentNotificationTemplateArrayMetaPage: + description: Pagination metadata. + properties: + total_count: + description: Total number of notification templates. + example: 42 + format: int64 + type: integer + total_filtered_count: + description: Total number of notification templates matching the filter. + example: 15 + format: int64 + type: integer + type: object + IncidentNotificationTemplateCreateAttributes: + description: The attributes for creating a notification template. + properties: + category: + description: The category of the notification template. + example: alert + type: string + content: + description: The content body of the notification template. + example: |- + An incident has been declared. + + Title: {{incident.title}} + Severity: {{incident.severity}} + Affected Services: {{incident.services}} + Status: {{incident.state}} + + Please join the incident channel for updates. + type: string + name: + description: The name of the notification template. + example: Incident Alert Template + type: string + subject: + description: The subject line of the notification template. + example: '{{incident.severity}} Incident: {{incident.title}}' + type: string + required: + - name + - subject + - content + - category + type: object + IncidentNotificationTemplateCreateDataRelationships: + description: The definition of `NotificationTemplateCreateDataRelationships` object. + properties: + incident_type: + $ref: '#/components/schemas/RelationshipToIncidentType' + type: object + IncidentNotificationTemplateUpdateAttributes: + description: The attributes to update on a notification template. + properties: + category: + description: The category of the notification template. + example: update + type: string + content: + description: The content body of the notification template. + example: |- + Incident Status Update: + + Title: {{incident.title}} + New Status: {{incident.state}} + Severity: {{incident.severity}} + Services: {{incident.services}} + Commander: {{incident.commander}} + + For more details, visit the incident page. + type: string + name: + description: The name of the notification template. + example: Incident Status Update Template + type: string + subject: + description: The subject line of the notification template. + example: 'Incident Update: {{incident.title}} - {{incident.state}}' + type: string + type: object + IncidentTypeAttributes: + description: Incident type's attributes. + properties: + createdAt: + description: Timestamp when the incident type was created. + format: date-time + readOnly: true + type: string + createdBy: + description: >- + A unique identifier that represents the user that created the + incident type. + example: 00000000-0000-0000-0000-000000000000 + readOnly: true + type: string + description: + description: Text that describes the incident type. + example: >- + Any incidents that harm (or have the potential to) the + confidentiality, integrity, or availability of our data. + type: string + is_default: + default: false + description: >- + If true, this incident type will be used as the default incident + type if a type is not specified during the creation of incident + resources. + example: false + type: boolean + lastModifiedBy: + description: >- + A unique identifier that represents the user that last modified the + incident type. + example: 00000000-0000-0000-0000-000000000000 + readOnly: true + type: string + modifiedAt: + description: Timestamp when the incident type was last modified. + format: date-time + readOnly: true + type: string + name: + description: The name of the incident type. + example: Security Incident + type: string + prefix: + description: >- + The string that will be prepended to the incident title across the + Datadog app. + example: IR + readOnly: true + type: string + required: + - name + type: object + IncidentTypeRelationships: + additionalProperties: {} + description: The incident type's resource relationships. + properties: + created_by_user: + $ref: '#/components/schemas/RelationshipToUser' + google_meet_configuration: + $ref: '#/components/schemas/GoogleMeetConfigurationReference' + last_modified_by_user: + $ref: '#/components/schemas/RelationshipToUser' + microsoft_teams_configuration: + $ref: '#/components/schemas/MicrosoftTeamsConfigurationReference' + zoom_configuration: + $ref: '#/components/schemas/ZoomConfigurationReference' + type: object + IncidentTypeType: + default: incident_types + description: Incident type resource type. + enum: + - incident_types + example: incident_types + type: string + x-enum-varnames: + - INCIDENT_TYPES + IncidentTypeUpdateAttributes: + description: Incident type's attributes for updates. + properties: + createdAt: + description: Timestamp when the incident type was created. + format: date-time + readOnly: true + type: string + createdBy: + description: >- + A unique identifier that represents the user that created the + incident type. + example: 00000000-0000-0000-0000-000000000000 + readOnly: true + type: string + description: + description: Text that describes the incident type. + example: >- + Any incidents that harm (or have the potential to) the + confidentiality, integrity, or availability of our data. Note: This + will notify the security team. + type: string + is_default: + description: >- + When true, this incident type will be used as the default type when + an incident type is not specified. + example: false + type: boolean + lastModifiedBy: + description: >- + A unique identifier that represents the user that last modified the + incident type. + example: 00000000-0000-0000-0000-000000000000 + readOnly: true + type: string + modifiedAt: + description: Timestamp when the incident type was last modified. + format: date-time + readOnly: true + type: string + name: + description: The name of the incident type. + example: Security Incident + type: string + prefix: + description: >- + The string that will be prepended to the incident title across the + Datadog app. + example: IR + readOnly: true + type: string + type: object + IncidentSearchResponseAttributes: + description: Attributes returned by an incident search. + properties: + facets: + $ref: '#/components/schemas/IncidentSearchResponseFacetsData' + incidents: + description: Incidents returned by the search. + items: + $ref: '#/components/schemas/IncidentSearchResponseIncidentsData' + type: array + total: + description: Number of incidents returned by the search. + example: 10 + format: int32 + maximum: 2147483647 + type: integer + required: + - facets + - incidents + - total + type: object + IncidentSearchResultsType: + default: incidents_search_results + description: Incident search result type. + enum: + - incidents_search_results + example: incidents_search_results + type: string + x-enum-varnames: + - INCIDENTS_SEARCH_RESULTS + IncidentUpdateAttributes: + description: The incident's attributes for an update request. + properties: + customer_impact_end: + description: Timestamp when customers were no longer impacted by the incident. + format: date-time + nullable: true + type: string + customer_impact_scope: + description: A summary of the impact customers experienced during the incident. + example: Example customer impact scope + type: string + customer_impact_start: + description: Timestamp when customers began being impacted by the incident. + format: date-time + nullable: true + type: string + customer_impacted: + description: A flag indicating whether the incident caused customer impact. + example: false + type: boolean + detected: + description: Timestamp when the incident was detected. + format: date-time + nullable: true + type: string + fields: + additionalProperties: + $ref: '#/components/schemas/IncidentFieldAttributes' + description: >- + A condensed view of the user-defined fields for which to update + selections. + example: + severity: + type: dropdown + value: SEV-5 + type: object + notification_handles: + description: >- + Notification handles that will be notified of the incident during + update. + example: + - display_name: Jane Doe + handle: '@user@email.com' + - display_name: Slack Channel + handle: '@slack-channel' + - display_name: Incident Workflow + handle: '@workflow-from-incident' + items: + $ref: '#/components/schemas/IncidentNotificationHandle' + type: array + title: + description: The title of the incident, which summarizes what happened. + example: A test incident title + type: string + type: object + IncidentUpdateRelationships: + description: The incident's relationships for an update request. + properties: + commander_user: + $ref: '#/components/schemas/NullableRelationshipToUser' + integrations: + $ref: '#/components/schemas/RelationshipToIncidentIntegrationMetadatas' + postmortem: + $ref: '#/components/schemas/RelationshipToIncidentPostmortem' + type: object + IncidentAttachmentAttributes: + description: The attributes object for an attachment. + oneOf: + - $ref: '#/components/schemas/IncidentAttachmentPostmortemAttributes' + - $ref: '#/components/schemas/IncidentAttachmentLinkAttributes' + IncidentAttachmentRelationships: + description: The incident attachment's relationships. + properties: + last_modified_by_user: + $ref: '#/components/schemas/RelationshipToUser' + type: object + IncidentAttachmentType: + default: incident_attachments + description: The incident attachment resource type. + enum: + - incident_attachments + example: incident_attachments + type: string + x-enum-varnames: + - INCIDENT_ATTACHMENTS + IncidentAttachmentUpdateAttributes: + description: Incident attachment attributes. + oneOf: + - $ref: '#/components/schemas/IncidentAttachmentPostmortemAttributes' + - $ref: '#/components/schemas/IncidentAttachmentLinkAttributes' + IncidentIntegrationMetadataAttributes: + description: Incident integration metadata's attributes for a create request. + properties: + created: + description: Timestamp when the incident todo was created. + format: date-time + readOnly: true + type: string + incident_id: + description: UUID of the incident this integration metadata is connected to. + example: 00000000-aaaa-0000-0000-000000000000 + type: string + integration_type: + description: >- + A number indicating the type of integration this metadata is for. 1 + indicates Slack; + + 8 indicates Jira. + example: 1 + format: int32 + maximum: 9 + type: integer + metadata: + $ref: '#/components/schemas/IncidentIntegrationMetadataMetadata' + modified: + description: Timestamp when the incident todo was last modified. + format: date-time + readOnly: true + type: string + status: + description: >- + A number indicating the status of this integration metadata. 0 + indicates unknown; + + 1 indicates pending; 2 indicates complete; 3 indicates manually + created; + + 4 indicates manually updated; 5 indicates failed. + format: int32 + maximum: 5 + type: integer + required: + - integration_type + - metadata + type: object + IncidentIntegrationRelationships: + description: The incident's integration relationships from a response. + properties: + created_by_user: + $ref: '#/components/schemas/RelationshipToUser' + last_modified_by_user: + $ref: '#/components/schemas/RelationshipToUser' + type: object + IncidentIntegrationMetadataType: + default: incident_integrations + description: Integration metadata resource type. + enum: + - incident_integrations + example: incident_integrations + type: string + x-enum-varnames: + - INCIDENT_INTEGRATIONS + IncidentTodoAttributes: + description: Incident todo's attributes. + properties: + assignees: + $ref: '#/components/schemas/IncidentTodoAssigneeArray' + completed: + description: Timestamp when the todo was completed. + example: '2023-03-06T22:00:00.000000+00:00' + nullable: true + type: string + content: + description: The follow-up task's content. + example: Restore lost data. + type: string + created: + description: Timestamp when the incident todo was created. + format: date-time + readOnly: true + type: string + due_date: + description: Timestamp when the todo should be completed by. + example: '2023-07-10T05:00:00.000000+00:00' + nullable: true + type: string + incident_id: + description: UUID of the incident this todo is connected to. + example: 00000000-aaaa-0000-0000-000000000000 + type: string + modified: + description: Timestamp when the incident todo was last modified. + format: date-time + readOnly: true + type: string + required: + - content + - assignees + type: object + IncidentTodoRelationships: + description: The incident's relationships from a response. + properties: + created_by_user: + $ref: '#/components/schemas/RelationshipToUser' + last_modified_by_user: + $ref: '#/components/schemas/RelationshipToUser' + type: object + IncidentTodoType: + default: incident_todos + description: Todo resource type. + enum: + - incident_todos + example: incident_todos + type: string + x-enum-varnames: + - INCIDENT_TODOS + EscalationPolicyCreateRequestDataAttributes: + description: >- + Defines the attributes for creating an escalation policy, including its + description, name, resolution behavior, retries, and steps. + properties: + name: + description: Specifies the name for the new escalation policy. + example: On-Call Escalation Policy + type: string + resolve_page_on_policy_end: + description: >- + Indicates whether the page is automatically resolved when the policy + ends. + type: boolean + retries: + description: >- + Specifies how many times the escalation sequence is retried if there + is no response. + format: int64 + type: integer + steps: + description: >- + A list of escalation steps, each defining assignment, escalation + timeout, and targets for the new policy. + items: + $ref: >- + #/components/schemas/EscalationPolicyCreateRequestDataAttributesStepsItems + type: array + required: + - name + - steps + type: object + EscalationPolicyCreateRequestDataRelationships: + description: >- + Represents relationships in an escalation policy creation request, + including references to teams. + properties: + teams: + $ref: '#/components/schemas/DataRelationshipsTeams' + type: object + EscalationPolicyCreateRequestDataType: + default: policies + description: Indicates that the resource is of type `policies`. + enum: + - policies + example: policies + type: string + x-enum-varnames: + - POLICIES + EscalationPolicyDataAttributes: + description: >- + Defines the main attributes of an escalation policy, such as its name + and behavior on policy end. + properties: + name: + description: Specifies the name of the escalation policy. + example: On-Call Escalation Policy + type: string + resolve_page_on_policy_end: + description: >- + Indicates whether the page is automatically resolved when the policy + ends. + type: boolean + retries: + description: >- + Specifies how many times the escalation sequence is retried if there + is no response. + format: int64 + type: integer + required: + - name + type: object + EscalationPolicyDataRelationships: + description: >- + Represents the relationships for an escalation policy, including + references to steps and teams. + properties: + steps: + $ref: '#/components/schemas/EscalationPolicyDataRelationshipsSteps' + teams: + $ref: '#/components/schemas/DataRelationshipsTeams' + required: + - steps + type: object + EscalationPolicyDataType: + default: policies + description: Indicates that the resource is of type `policies`. + enum: + - policies + example: policies + type: string + x-enum-varnames: + - POLICIES + TeamReference: + description: >- + Provides a reference to a team, including ID, type, and basic + attributes/relationships. + properties: + attributes: + $ref: '#/components/schemas/TeamReferenceAttributes' + id: + description: The team's unique identifier. + type: string + type: + $ref: '#/components/schemas/TeamReferenceType' + required: + - type + type: object + EscalationPolicyStep: + description: >- + Represents a single step in an escalation policy, including its + attributes, relationships, and resource type. + properties: + attributes: + $ref: '#/components/schemas/EscalationPolicyStepAttributes' + id: + description: Specifies the unique identifier of this escalation policy step. + type: string + relationships: + $ref: '#/components/schemas/EscalationPolicyStepRelationships' + type: + $ref: '#/components/schemas/EscalationPolicyStepType' + required: + - type + type: object + EscalationPolicyUser: + description: >- + Represents a user object in the context of an escalation policy, + including their `id`, type, and basic attributes. + properties: + attributes: + $ref: '#/components/schemas/EscalationPolicyUserAttributes' + id: + description: The unique user identifier. + type: string + type: + $ref: '#/components/schemas/EscalationPolicyUserType' + required: + - type + type: object + EscalationPolicyUpdateRequestDataAttributes: + description: >- + Defines the attributes that can be updated for an escalation policy, + such as description, name, resolution behavior, retries, and steps. + properties: + name: + description: Specifies the name of the escalation policy. + example: On-Call Escalation Policy + type: string + resolve_page_on_policy_end: + description: >- + Indicates whether the page is automatically resolved when the policy + ends. + type: boolean + retries: + description: >- + Specifies how many times the escalation sequence is retried if there + is no response. + format: int64 + type: integer + steps: + description: >- + A list of escalation steps, each defining assignment, escalation + timeout, and targets. + items: + $ref: >- + #/components/schemas/EscalationPolicyUpdateRequestDataAttributesStepsItems + type: array + required: + - name + - steps + type: object + EscalationPolicyUpdateRequestDataRelationships: + description: >- + Represents relationships in an escalation policy update request, + including references to teams. + properties: + teams: + $ref: '#/components/schemas/DataRelationshipsTeams' + type: object + EscalationPolicyUpdateRequestDataType: + default: policies + description: Indicates that the resource is of type `policies`. + enum: + - policies + example: policies + type: string + x-enum-varnames: + - POLICIES + CreatePageRequestDataAttributes: + description: Details about the On-Call Page you want to create. + properties: + description: + description: A short summary of the issue or context. + type: string + tags: + description: Tags to help categorize or filter the page. + items: + type: string + type: array + target: + $ref: '#/components/schemas/CreatePageRequestDataAttributesTarget' + title: + description: The title of the page. + example: 'Service: Test is down' + type: string + urgency: + $ref: '#/components/schemas/PageUrgency' + required: + - target + - title + - urgency + type: object + CreatePageRequestDataType: + default: pages + description: The type of resource used when creating an On-Call Page. + enum: + - pages + example: pages + type: string + x-enum-varnames: + - PAGES + CreatePageResponseDataType: + default: pages + description: The type of resource used when creating an On-Call Page. + enum: + - pages + example: pages + type: string + x-enum-varnames: + - PAGES + ScheduleCreateRequestDataAttributes: + description: >- + Describes the main attributes for creating a new schedule, including + name, layers, and time zone. + properties: + layers: + description: >- + The layers of On-Call coverage that define rotation intervals and + restrictions. + items: + $ref: >- + #/components/schemas/ScheduleCreateRequestDataAttributesLayersItems + type: array + name: + description: A human-readable name for the new schedule. + example: Team A On-Call + type: string + time_zone: + description: The time zone in which the schedule is defined. + example: America/New_York + type: string + required: + - name + - time_zone + - layers + type: object + ScheduleCreateRequestDataRelationships: + description: >- + Gathers relationship objects for the schedule creation request, + including the teams to associate. + properties: + teams: + $ref: '#/components/schemas/DataRelationshipsTeams' + type: object + ScheduleCreateRequestDataType: + default: schedules + description: Schedules resource type. + enum: + - schedules + example: schedules + type: string + x-enum-varnames: + - SCHEDULES + ScheduleDataAttributes: + description: >- + Provides core properties of a schedule object such as its name and time + zone. + properties: + name: + description: A short name for the schedule. + example: Primary On-Call + type: string + time_zone: + description: The time zone in which this schedule operates. + example: America/New_York + type: string + type: object + ScheduleDataRelationships: + description: >- + Groups the relationships for a schedule object, referencing layers and + teams. + properties: + layers: + $ref: '#/components/schemas/ScheduleDataRelationshipsLayers' + teams: + $ref: '#/components/schemas/DataRelationshipsTeams' + type: object + ScheduleDataType: + default: schedules + description: Schedules resource type. + enum: + - schedules + example: schedules + type: string + x-enum-varnames: + - SCHEDULES + Layer: + description: >- + Encapsulates a layer resource, holding attributes like rotation details, + plus relationships to the members covering that layer. + properties: + attributes: + $ref: '#/components/schemas/LayerAttributes' + id: + description: A unique identifier for this layer. + type: string + relationships: + $ref: '#/components/schemas/LayerRelationships' + type: + $ref: '#/components/schemas/LayerType' + required: + - type + type: object + ScheduleMember: + description: >- + Represents a single member entry in a schedule, referencing a specific + user. + properties: + id: + description: The unique identifier for this schedule member. + type: string + relationships: + $ref: '#/components/schemas/ScheduleMemberRelationships' + type: + $ref: '#/components/schemas/ScheduleMemberType' + required: + - type + type: object + ScheduleUser: + description: >- + Represents a user object in the context of a schedule, including their + `id`, type, and basic attributes. + properties: + attributes: + $ref: '#/components/schemas/ScheduleUserAttributes' + id: + description: The unique user identifier. + type: string + type: + $ref: '#/components/schemas/ScheduleUserType' + required: + - type + type: object + ScheduleUpdateRequestDataAttributes: + description: >- + Defines the updatable attributes for a schedule, such as name, time + zone, and layers. + properties: + layers: + description: The updated list of layers (rotations) for this schedule. + items: + $ref: >- + #/components/schemas/ScheduleUpdateRequestDataAttributesLayersItems + type: array + name: + description: A short name for the schedule. + example: Primary On-Call + type: string + time_zone: + description: The time zone used when interpreting rotation times. + example: America/New_York + type: string + required: + - name + - time_zone + - layers + type: object + ScheduleUpdateRequestDataRelationships: + description: >- + Houses relationships for the schedule update, typically referencing + teams. + properties: + teams: + $ref: '#/components/schemas/DataRelationshipsTeams' + type: object + ScheduleUpdateRequestDataType: + default: schedules + description: Schedules resource type. + enum: + - schedules + example: schedules + type: string + x-enum-varnames: + - SCHEDULES + ShiftDataAttributes: + description: Attributes for an on-call shift. + properties: + end: + description: The end time of the shift. + format: date-time + type: string + start: + description: The start time of the shift. + format: date-time + type: string + type: object + ShiftDataRelationships: + description: Relationships for an on-call shift. + properties: + user: + $ref: '#/components/schemas/ShiftDataRelationshipsUser' + type: object + ShiftDataType: + default: shifts + description: Indicates that the resource is of type 'shifts'. + enum: + - shifts + example: shifts + type: string + x-enum-varnames: + - SHIFTS + TeamOnCallRespondersDataRelationships: + description: >- + Relationship objects linked to a team's on-call responder configuration, + including escalations and responders. + properties: + escalations: + $ref: >- + #/components/schemas/TeamOnCallRespondersDataRelationshipsEscalations + responders: + $ref: '#/components/schemas/TeamOnCallRespondersDataRelationshipsResponders' + type: object + TeamOnCallRespondersDataType: + default: team_oncall_responders + description: >- + Represents the resource type for a group of users assigned to handle + on-call duties within a team. + enum: + - team_oncall_responders + example: team_oncall_responders + type: string + x-enum-varnames: + - TEAM_ONCALL_RESPONDERS + Escalation: + description: Represents an escalation policy step. + properties: + id: + description: Unique identifier of the escalation step. + type: string + relationships: + $ref: '#/components/schemas/EscalationRelationships' + type: + $ref: '#/components/schemas/EscalationType' + required: + - type + type: object + TeamRoutingRulesDataRelationships: + description: >- + Specifies relationships for team routing rules, including rule + references. + properties: + rules: + $ref: '#/components/schemas/TeamRoutingRulesDataRelationshipsRules' + type: object + TeamRoutingRulesDataType: + default: team_routing_rules + description: Team routing rules resource type. + enum: + - team_routing_rules + example: team_routing_rules + type: string + x-enum-varnames: + - TEAM_ROUTING_RULES + RoutingRule: + description: >- + Represents a routing rule, including its attributes, relationships, and + unique identifier. + properties: + attributes: + $ref: '#/components/schemas/RoutingRuleAttributes' + id: + description: Specifies the unique identifier of this routing rule. + type: string + relationships: + $ref: '#/components/schemas/RoutingRuleRelationships' + type: + $ref: '#/components/schemas/RoutingRuleType' + required: + - type + type: object + TeamRoutingRulesRequestDataAttributes: + description: >- + Represents the attributes of a request to update or create team routing + rules. + properties: + rules: + description: >- + A list of routing rule items that define how incoming pages should + be handled. + items: + $ref: '#/components/schemas/TeamRoutingRulesRequestRule' + type: array + type: object + TeamRoutingRulesRequestDataType: + default: team_routing_rules + description: Team routing rules resource type. + enum: + - team_routing_rules + example: team_routing_rules + type: string + x-enum-varnames: + - TEAM_ROUTING_RULES + IncidentServiceResponseAttributes: + description: The incident service's attributes from a response. + properties: + created: + description: Timestamp of when the incident service was created. + format: date-time + readOnly: true + type: string + modified: + description: Timestamp of when the incident service was modified. + format: date-time + readOnly: true + type: string + name: + description: Name of the incident service. + example: service name + type: string + type: object + IncidentServiceRelationships: + description: The incident service's relationships. + properties: + created_by: + $ref: '#/components/schemas/RelationshipToUser' + last_modified_by: + $ref: '#/components/schemas/RelationshipToUser' + readOnly: true + type: object + IncidentServiceType: + default: services + description: Incident service resource type. + enum: + - services + example: services + type: string + x-enum-varnames: + - SERVICES + IncidentServiceCreateAttributes: + description: The incident service's attributes for a create request. + properties: + name: + description: Name of the incident service. + example: an example service name + type: string + required: + - name + type: object + ServiceDefinitionDataAttributes: + description: Service definition attributes. + properties: + meta: + $ref: '#/components/schemas/ServiceDefinitionMeta' + schema: + $ref: '#/components/schemas/ServiceDefinitionSchema' + type: object + ServiceDefinitionV2Dot2Contact: + description: Service owner's contacts information. + properties: + contact: + description: Contact value. + example: https://teams.microsoft.com/myteam + type: string + name: + description: Contact Name. + example: My team channel + type: string + type: + description: >- + Contact type. Datadog recognizes the following types: `email`, + `slack`, and `microsoft-teams`. + example: slack + type: string + required: + - type + - contact + type: object + ServiceDefinitionV2Dot2Integrations: + description: Third party integrations that Datadog supports. + properties: + opsgenie: + $ref: '#/components/schemas/ServiceDefinitionV2Dot2Opsgenie' + pagerduty: + $ref: '#/components/schemas/ServiceDefinitionV2Dot2Pagerduty' + type: object + ServiceDefinitionV2Dot2Link: + description: Service's external links. + properties: + name: + description: Link name. + example: Runbook + type: string + provider: + description: Link provider. + example: Github + type: string + type: + description: >- + Link type. Datadog recognizes the following types: `runbook`, `doc`, + `repo`, `dashboard`, and `other`. + example: runbook + type: string + url: + description: Link URL. + example: https://my-runbook + type: string + required: + - name + - type + - url + type: object + ServiceDefinitionV2Dot2Version: + default: v2.2 + description: Schema version being used. + enum: + - v2.2 + example: v2.2 + type: string + x-enum-varnames: + - V2_2 + ServiceDefinitionV2Dot2Type: + description: The type of service. + example: web + type: string + ServiceDefinitionV2Dot1Contact: + description: Service owner's contacts information. + oneOf: + - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Email' + - $ref: '#/components/schemas/ServiceDefinitionV2Dot1Slack' + - $ref: '#/components/schemas/ServiceDefinitionV2Dot1MSTeams' + ServiceDefinitionV2Dot1Integrations: + description: Third party integrations that Datadog supports. + properties: + opsgenie: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1Opsgenie' + pagerduty: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1Pagerduty' + type: object + ServiceDefinitionV2Dot1Link: + description: Service's external links. + properties: + name: + description: Link name. + example: Runbook + type: string + provider: + description: Link provider. + example: Github + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1LinkType' + url: + description: Link URL. + example: https://my-runbook + type: string + required: + - name + - type + - url + type: object + ServiceDefinitionV2Dot1Version: + default: v2.1 + description: Schema version being used. + enum: + - v2.1 + example: v2.1 + type: string + x-enum-varnames: + - V2_1 + ServiceDefinitionV2Contact: + description: Service owner's contacts information. + oneOf: + - $ref: '#/components/schemas/ServiceDefinitionV2Email' + - $ref: '#/components/schemas/ServiceDefinitionV2Slack' + - $ref: '#/components/schemas/ServiceDefinitionV2MSTeams' + ServiceDefinitionV2Doc: + description: Service documents. + properties: + name: + description: Document name. + example: Architecture + type: string + provider: + description: Document provider. + example: google drive + type: string + url: + description: Document URL. + example: https://gdrive/mydoc + type: string + required: + - name + - url + type: object + ServiceDefinitionV2Integrations: + description: Third party integrations that Datadog supports. + properties: + opsgenie: + $ref: '#/components/schemas/ServiceDefinitionV2Opsgenie' + pagerduty: + $ref: '#/components/schemas/ServiceDefinitionV2Pagerduty' + type: object + ServiceDefinitionV2Link: + description: Service's external links. + properties: + name: + description: Link name. + example: Runbook + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2LinkType' + url: + description: Link URL. + example: https://my-runbook + type: string + required: + - name + - type + - url + type: object + ServiceDefinitionV2Repo: + description: Service code repositories. + properties: + name: + description: Repository name. + example: Source Code + type: string + provider: + description: Repository provider. + example: GitHub + type: string + url: + description: Repository URL. + example: https://github.com/DataDog/schema + type: string + required: + - name + - url + type: object + ServiceDefinitionV2Version: + default: v2 + description: Schema version being used. + enum: + - v2 + example: v2 + type: string + x-enum-varnames: + - V2 + IncidentServiceUpdateAttributes: + description: The incident service's attributes for an update request. + properties: + name: + description: Name of the incident service. + example: an example service name + type: string + required: + - name + type: object + SloReportCreateRequestAttributes: + description: The attributes portion of the SLO report request. + properties: + from_ts: + description: The `from` timestamp for the report in epoch seconds. + example: 1690901870 + format: int64 + type: integer + interval: + $ref: '#/components/schemas/SLOReportInterval' + query: + description: >- + The query string used to filter SLO results. Some examples of + queries include `service:` and `slo-name`. + example: slo_type:metric + type: string + timezone: + description: >- + The timezone used to determine the start and end of each interval. + For example, weekly intervals start at 12am on Sunday in the + specified timezone. + example: America/New_York + type: string + to_ts: + description: The `to` timestamp for the report in epoch seconds. + example: 1706803070 + format: int64 + type: integer + required: + - query + - from_ts + - to_ts + type: object + SLOReportStatusGetResponseAttributes: + description: The attributes portion of the SLO report status response. + properties: + status: + $ref: '#/components/schemas/SLOReportStatus' + type: object + IncidentTeamResponseAttributes: + description: The incident team's attributes from a response. + properties: + created: + description: Timestamp of when the incident team was created. + format: date-time + readOnly: true + type: string + modified: + description: Timestamp of when the incident team was modified. + format: date-time + readOnly: true + type: string + name: + description: Name of the incident team. + example: team name + type: string + type: object + IncidentTeamRelationships: + description: The incident team's relationships. + properties: + created_by: + $ref: '#/components/schemas/RelationshipToUser' + last_modified_by: + $ref: '#/components/schemas/RelationshipToUser' + readOnly: true + type: object + IncidentTeamType: + default: teams + description: Incident Team resource type. + enum: + - teams + example: teams + type: string + x-enum-varnames: + - TEAMS + IncidentTeamCreateAttributes: + description: The incident team's attributes for a create request. + properties: + name: + description: Name of the incident team. + example: team name + type: string + required: + - name + type: object + IncidentTeamUpdateAttributes: + description: The incident team's attributes for an update request. + properties: + name: + description: Name of the incident team. + example: team name + type: string + required: + - name + type: object + CaseObjectAttributes: + additionalProperties: + items: + type: string + type: array + description: The definition of `CaseObjectAttributes` object. + type: object + JiraIssue: + description: Jira issue attached to case + nullable: true + properties: + result: + $ref: '#/components/schemas/JiraIssueResult' + status: + $ref: '#/components/schemas/Case3rdPartyTicketStatus' + readOnly: true + type: object + CasePriority: + default: NOT_DEFINED + description: Case priority + enum: + - NOT_DEFINED + - P1 + - P2 + - P3 + - P4 + - P5 + example: NOT_DEFINED + type: string + x-enum-varnames: + - NOT_DEFINED + - P1 + - P2 + - P3 + - P4 + - P5 + ServiceNowTicket: + description: ServiceNow ticket attached to case + nullable: true + properties: + result: + $ref: '#/components/schemas/ServiceNowTicketResult' + status: + $ref: '#/components/schemas/Case3rdPartyTicketStatus' + readOnly: true + type: object + CaseStatus: + description: Case status + enum: + - OPEN + - IN_PROGRESS + - CLOSED + example: OPEN + type: string + x-enum-varnames: + - OPEN + - IN_PROGRESS + - CLOSED + CaseType: + description: Case type + enum: + - STANDARD + example: STANDARD + type: string + x-enum-varnames: + - STANDARD + NullableUserRelationship: + description: Relationship to user. + nullable: true + properties: + data: + $ref: '#/components/schemas/NullableUserRelationshipData' + required: + - data + type: object + ProjectRelationship: + description: Relationship to project + properties: + data: + $ref: '#/components/schemas/ProjectRelationshipData' + required: + - data + type: object + RelationshipToTeamLinks: + description: Relationship between a team and a team link + properties: + data: + description: Related team links + items: + $ref: '#/components/schemas/RelationshipToTeamLinkData' + type: array + links: + $ref: '#/components/schemas/TeamRelationshipsLinks' + type: object + UsersRelationship: + description: Relationship to users. + properties: + data: + description: Relationships to user objects. + example: [] + items: + $ref: '#/components/schemas/UserRelationshipData' + type: array + required: + - data + type: object + DowntimeDisplayTimezone: + default: UTC + description: >- + The timezone in which to display the downtime's start and end times in + Datadog applications. This is not used + + as an offset for scheduling. + example: America/New_York + nullable: true + type: string + DowntimeMessage: + description: >- + A message to include with notifications for this downtime. Email + notifications can be sent to specific users + + by using the same `@username` notation as events. + example: Message about the downtime + nullable: true + type: string + DowntimeMonitorIdentifier: + description: Monitor identifier for the downtime. + oneOf: + - $ref: '#/components/schemas/DowntimeMonitorIdentifierId' + - $ref: '#/components/schemas/DowntimeMonitorIdentifierTags' + DowntimeMuteFirstRecoveryNotification: + description: If the first recovery notification during a downtime should be muted. + example: false + type: boolean + DowntimeNotifyEndStates: + description: >- + States that will trigger a monitor notification when the + `notify_end_types` action occurs. + example: + - alert + - warn + items: + $ref: '#/components/schemas/DowntimeNotifyEndStateTypes' + type: array + DowntimeNotifyEndTypes: + description: >- + Actions that will trigger a monitor notification if the downtime is in + the `notify_end_types` state. + example: + - canceled + - expired + items: + $ref: '#/components/schemas/DowntimeNotifyEndStateActions' + type: array + DowntimeScheduleResponse: + description: >- + The schedule that defines when the monitor starts, stops, and recurs. + There are two types of schedules: + + one-time and recurring. Recurring schedules may have up to five + RRULE-based recurrences. If no schedules are + + provided, the downtime will begin immediately and never end. + oneOf: + - $ref: '#/components/schemas/DowntimeScheduleRecurrencesResponse' + - $ref: '#/components/schemas/DowntimeScheduleOneTimeResponse' + DowntimeScope: + description: >- + The scope to which the downtime applies. Must follow the [common search + syntax](https://docs.datadoghq.com/logs/explorer/search_syntax/). + example: env:(staging OR prod) AND datacenter:us-east-1 + type: string + DowntimeStatus: + description: The current status of the downtime. + enum: + - active + - canceled + - ended + - scheduled + example: active + type: string + x-enum-varnames: + - ACTIVE + - CANCELED + - ENDED + - SCHEDULED + DowntimeRelationshipsCreatedBy: + description: The user who created the downtime. + properties: + data: + $ref: '#/components/schemas/DowntimeRelationshipsCreatedByData' + type: object + DowntimeRelationshipsMonitor: + description: The monitor identified by the downtime. + properties: + data: + $ref: '#/components/schemas/DowntimeRelationshipsMonitorData' + type: object + UserAttributes: + description: Attributes of user object returned by the API. + properties: + created_at: + description: Creation time of the user. + format: date-time + type: string + disabled: + description: Whether the user is disabled. + type: boolean + email: + description: Email of the user. + type: string + handle: + description: Handle of the user. + type: string + icon: + description: URL of the user's icon. + type: string + mfa_enabled: + description: If user has MFA enabled. + readOnly: true + type: boolean + modified_at: + description: Time that the user was last modified. + format: date-time + type: string + name: + description: Name of the user. + nullable: true + type: string + service_account: + description: Whether the user is a service account. + type: boolean + status: + description: Status of the user. + type: string + title: + description: Title of the user. + nullable: true + type: string + verified: + description: Whether the user is verified. + type: boolean + type: object + UserResponseRelationships: + description: Relationships of the user object returned by the API. + properties: + org: + $ref: '#/components/schemas/RelationshipToOrganization' + other_orgs: + $ref: '#/components/schemas/RelationshipToOrganizations' + other_users: + $ref: '#/components/schemas/RelationshipToUsers' + roles: + $ref: '#/components/schemas/RelationshipToRoles' + type: object + UsersType: + default: users + description: Users resource type. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + DowntimeMonitorIncludedAttributes: + description: Attributes of the monitor identified by the downtime. + properties: + name: + description: The name of the monitor identified by the downtime. + example: A monitor name + type: string + type: object + DowntimeIncludedMonitorType: + default: monitors + description: Monitor resource type. + enum: + - monitors + example: monitors + type: string + x-enum-varnames: + - MONITORS + DowntimeScheduleCreateRequest: + description: Schedule for the downtime. + oneOf: + - $ref: '#/components/schemas/DowntimeScheduleRecurrencesCreateRequest' + - $ref: '#/components/schemas/DowntimeScheduleOneTimeCreateUpdateRequest' + DowntimeScheduleUpdateRequest: + description: Schedule for the downtime. + oneOf: + - $ref: '#/components/schemas/DowntimeScheduleRecurrencesUpdateRequest' + - $ref: '#/components/schemas/DowntimeScheduleOneTimeCreateUpdateRequest' + IssuesSearchRequestDataAttributesOrderBy: + description: The attribute to sort the search results by. + enum: + - TOTAL_COUNT + - FIRST_SEEN + - IMPACTED_SESSIONS + - PRIORITY + example: IMPACTED_SESSIONS + type: string + x-enum-varnames: + - TOTAL_COUNT + - FIRST_SEEN + - IMPACTED_SESSIONS + - PRIORITY + IssuesSearchRequestDataAttributesPersona: + description: Persona for the search. Either track(s) or persona(s) must be specified. + enum: + - ALL + - BROWSER + - MOBILE + - BACKEND + example: BACKEND + type: string + x-enum-varnames: + - ALL + - BROWSER + - MOBILE + - BACKEND + IssuesSearchRequestDataAttributesTrack: + description: >- + Track of the events to query. Either track(s) or persona(s) must be + specified. + enum: + - trace + - logs + - rum + example: trace + type: string + x-enum-varnames: + - TRACE + - LOGS + - RUM + IssuesSearchResultIssueRelationship: + description: Relationship between the search result and the corresponding issue. + properties: + data: + $ref: '#/components/schemas/IssueReference' + required: + - data + type: object + IssueUserAttributes: + description: Object containing the information of a user. + properties: + email: + description: Email of the user. + example: user@company.com + type: string + handle: + description: Handle of the user. + example: User Handle + type: string + name: + description: Name of the user. + example: User Name + type: string + type: object + IssueUserType: + description: Type of the object + enum: + - user + example: user + type: string + x-enum-varnames: + - USER + IssueTeamAttributes: + description: Object containing the information of a team. + properties: + handle: + description: The team's identifier. + example: team-handle + type: string + name: + description: The name of the team. + example: Team Name + type: string + summary: + description: A brief summary of the team, derived from its description. + example: This is a team. + type: string + type: object + IssueTeamType: + description: Type of the object. + enum: + - team + example: team + type: string + x-enum-varnames: + - TEAM + IssueLanguage: + description: Programming language associated with the issue. + enum: + - BRIGHTSCRIPT + - C + - C_PLUS_PLUS + - C_SHARP + - CLOJURE + - DOT_NET + - ELIXIR + - ERLANG + - GO + - GROOVY + - HASKELL + - HCL + - JAVA + - JAVASCRIPT + - JVM + - KOTLIN + - OBJECTIVE_C + - PERL + - PHP + - PYTHON + - RUBY + - RUST + - SCALA + - SWIFT + - TERRAFORM + - TYPESCRIPT + - UNKNOWN + example: PYTHON + type: string + x-enum-varnames: + - BRIGHTSCRIPT + - C + - C_PLUS_PLUS + - C_SHARP + - CLOJURE + - DOT_NET + - ELIXIR + - ERLANG + - GO + - GROOVY + - HASKELL + - HCL + - JAVA + - JAVASCRIPT + - JVM + - KOTLIN + - OBJECTIVE_C + - PERL + - PHP + - PYTHON + - RUBY + - RUST + - SCALA + - SWIFT + - TERRAFORM + - TYPESCRIPT + - UNKNOWN + IssuePlatform: + description: Platform associated with the issue. + enum: + - ANDROID + - BACKEND + - BROWSER + - FLUTTER + - IOS + - REACT_NATIVE + - ROKU + - UNKNOWN + example: BACKEND + type: string + x-enum-varnames: + - ANDROID + - BACKEND + - BROWSER + - FLUTTER + - IOS + - REACT_NATIVE + - ROKU + - UNKNOWN + IssueState: + description: State of the issue + enum: + - OPEN + - ACKNOWLEDGED + - RESOLVED + - IGNORED + - EXCLUDED + example: RESOLVED + type: string + x-enum-varnames: + - OPEN + - ACKNOWLEDGED + - RESOLVED + - IGNORED + - EXCLUDED + IssueAssigneeRelationship: + description: Relationship between the issue and assignee. + properties: + data: + $ref: '#/components/schemas/IssueUserReference' + required: + - data + type: object + IssueCaseRelationship: + description: Relationship between the issue and case. + properties: + data: + $ref: '#/components/schemas/IssueCaseReference' + required: + - data + type: object + IssueTeamOwnersRelationship: + description: Relationship between the issue and teams. + properties: + data: + description: Array of teams that are owners of the issue. + items: + $ref: '#/components/schemas/IssueTeamReference' + type: array + required: + - data + type: object + IssueCaseAttributes: + description: Object containing the information of a case. + properties: + archived_at: + description: Timestamp of when the case was archived. + example: '2025-01-01T00:00:00Z' + format: date-time + type: string + closed_at: + description: Timestamp of when the case was closed. + example: '2025-01-01T00:00:00Z' + format: date-time + type: string + created_at: + description: Timestamp of when the case was created. + example: '2025-01-01T00:00:00Z' + format: date-time + type: string + creation_source: + description: Source of the case creation. + example: ERROR_TRACKING + type: string + description: + description: Description of the case. + type: string + due_date: + description: Due date of the case. + example: '2025-01-01' + type: string + insights: + description: Insights of the case. + items: + $ref: '#/components/schemas/IssueCaseInsight' + type: array + jira_issue: + $ref: '#/components/schemas/IssueCaseJiraIssue' + key: + description: Key of the case. + example: ET-123 + type: string + modified_at: + description: Timestamp of when the case was last modified. + example: '2025-01-01T00:00:00Z' + format: date-time + type: string + priority: + $ref: '#/components/schemas/CasePriority' + status: + $ref: '#/components/schemas/CaseStatus' + title: + description: Title of the case. + example: 'Error: HTTP error' + type: string + type: + description: Type of the case. + example: ERROR_TRACKING_ISSUE + type: string + type: object + IssueCaseRelationships: + description: Resources related to a case. + properties: + assignee: + $ref: '#/components/schemas/NullableUserRelationship' + created_by: + $ref: '#/components/schemas/NullableUserRelationship' + modified_by: + $ref: '#/components/schemas/NullableUserRelationship' + project: + $ref: '#/components/schemas/ProjectRelationship' + type: object + IssueCaseResourceType: + description: Type of the object. + enum: + - case + example: case + type: string + x-enum-varnames: + - CASE + EventAttributes: + description: Object description of attributes from your event. + properties: + aggregation_key: + description: Aggregation key of the event. + type: string + date_happened: + description: >- + POSIX timestamp of the event. Must be sent as an integer (no + quotation marks). + + Limited to events no older than 18 hours. + format: int64 + type: integer + device_name: + description: A device name. + type: string + duration: + description: >- + The duration between the triggering of the event and its recovery in + nanoseconds. + format: int64 + type: integer + event_object: + description: The event title. + example: Did you hear the news today? + type: string + evt: + $ref: '#/components/schemas/Event' + hostname: + description: |- + Host name to associate with the event. + Any tags associated with the host are also applied to this event. + type: string + monitor: + $ref: '#/components/schemas/MonitorType' + monitor_groups: + description: List of groups referred to in the event. + items: + description: Group referred to in the event. + type: string + nullable: true + type: array + monitor_id: + description: >- + ID of the monitor that triggered the event. When an event isn't + related to a monitor, this field is empty. + format: int64 + nullable: true + type: integer + priority: + $ref: '#/components/schemas/EventPriority' + related_event_id: + description: Related event ID. + format: int64 + type: integer + service: + description: Service that triggered the event. + example: datadog-api + type: string + source_type_name: + description: >- + The type of event being posted. + + For example, `nagios`, `hudson`, `jenkins`, `my_apps`, `chef`, + `puppet`, `git` or `bitbucket`. + + The list of standard source attribute values is [available + here](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). + type: string + sourcecategory: + description: >- + Identifier for the source of the event, such as a monitor alert, an + externally-submitted event, or an integration. + type: string + status: + $ref: '#/components/schemas/EventStatusType' + tags: + description: A list of tags to apply to the event. + example: + - environment:test + items: + description: A tag. + type: string + type: array + timestamp: + description: POSIX timestamp of your event in milliseconds. + example: 1652274265000 + format: int64 + type: integer + title: + description: The event title. + example: Oh boy! + type: string + type: object + EventPayloadAttributes: + description: >- + JSON object for category-specific attributes. Schema is different per + event category. + oneOf: + - $ref: '#/components/schemas/ChangeEventCustomAttributes' + - $ref: '#/components/schemas/AlertEventCustomAttributes' + EventCategory: + description: Event category identifying the type of event. + enum: + - change + - alert + example: change + type: string + x-enum-varnames: + - CHANGE + - ALERT + EventPayloadIntegrationId: + description: Integration ID sourced from integration manifests. + enum: + - custom-events + example: custom-events + type: string + x-enum-varnames: + - CUSTOM_EVENTS + EventCreateResponseAttributesAttributes: + description: JSON object for category-specific attributes. + properties: + evt: + $ref: '#/components/schemas/EventCreateResponseAttributesAttributesEvt' + type: object + V2EventAttributesAttributes: + description: JSON object for category-specific attributes. + oneOf: + - $ref: '#/components/schemas/ChangeEventAttributes' + - $ref: '#/components/schemas/AlertEventAttributes' + IncidentFieldAttributes: + description: >- + Dynamic fields for which selections can be made, with field names as + keys. + oneOf: + - $ref: '#/components/schemas/IncidentFieldAttributesSingleValue' + - $ref: '#/components/schemas/IncidentFieldAttributesMultipleValue' + IncidentNonDatadogCreator: + description: Incident's non Datadog creator. + nullable: true + properties: + image_48_px: + description: Non Datadog creator `48px` image. + type: string + name: + description: Non Datadog creator name. + type: string + type: object + IncidentNotificationHandle: + description: A notification handle that will be notified at incident creation. + properties: + display_name: + description: The name of the notified handle. + example: Jane Doe + type: string + handle: + description: >- + The handle used for the notification. This includes an email + address, Slack channel, or workflow. + example: '@test.user@test.com' + type: string + type: object + IncidentSeverity: + description: The incident severity. + enum: + - UNKNOWN + - SEV-0 + - SEV-1 + - SEV-2 + - SEV-3 + - SEV-4 + - SEV-5 + example: UNKNOWN + type: string + x-enum-varnames: + - UNKNOWN + - SEV_0 + - SEV_1 + - SEV_2 + - SEV_3 + - SEV_4 + - SEV_5 + RelationshipToIncidentAttachment: + description: A relationship reference for attachments. + properties: + data: + description: An array of incident attachments. + items: + $ref: '#/components/schemas/RelationshipToIncidentAttachmentData' + type: array + required: + - data + type: object + NullableRelationshipToUser: + description: Relationship to user. + nullable: true + properties: + data: + $ref: '#/components/schemas/NullableRelationshipToUserData' + required: + - data + type: object + RelationshipToUser: + description: Relationship to user. + properties: + data: + $ref: '#/components/schemas/RelationshipToUserData' + required: + - data + type: object + RelationshipToIncidentImpacts: + description: Relationship to impacts. + properties: + data: + description: An array of incident impacts. + items: + $ref: '#/components/schemas/RelationshipToIncidentImpactData' + type: array + required: + - data + type: object + RelationshipToIncidentIntegrationMetadatas: + description: A relationship reference for multiple integration metadata objects. + example: + data: + - id: 00000000-abcd-0005-0000-000000000000 + type: incident_integrations + - id: 00000000-abcd-0006-0000-000000000000 + type: incident_integrations + properties: + data: + description: Integration metadata relationship array + example: + - id: 00000000-abcd-0003-0000-000000000000 + type: incident_integrations + - id: 00000000-abcd-0004-0000-000000000000 + type: incident_integrations + items: + $ref: '#/components/schemas/RelationshipToIncidentIntegrationMetadataData' + type: array + required: + - data + type: object + RelationshipToIncidentResponders: + description: Relationship to incident responders. + properties: + data: + description: An array of incident responders. + items: + $ref: '#/components/schemas/RelationshipToIncidentResponderData' + type: array + required: + - data + type: object + RelationshipToIncidentUserDefinedFields: + description: Relationship to incident user defined fields. + properties: + data: + description: An array of user defined fields. + items: + $ref: '#/components/schemas/RelationshipToIncidentUserDefinedFieldData' + type: array + required: + - data + type: object + IncidentUserAttributes: + description: Attributes of user object returned by the API. + properties: + email: + description: Email of the user. + type: string + handle: + description: Handle of the user. + type: string + icon: + description: URL of the user's icon. + type: string + name: + description: Name of the user. + nullable: true + type: string + uuid: + description: UUID of the user. + type: string + type: object + IncidentTimelineCellCreateAttributes: + description: The timeline cell's attributes for a create request. + oneOf: + - $ref: '#/components/schemas/IncidentTimelineCellMarkdownCreateAttributes' + IncidentNotificationRuleConditions: + description: The conditions that trigger this notification rule. + example: + - field: severity + values: + - SEV-1 + - SEV-2 + items: + $ref: '#/components/schemas/IncidentNotificationRuleConditionsItems' + type: array + IncidentNotificationRuleHandles: + description: The notification handles (targets) for this rule. + example: + - '@team-email@company.com' + - '@slack-channel' + items: + description: A notification handle (email, Slack channel, etc.). + type: string + type: array + IncidentNotificationRuleRenotifyOn: + description: List of incident fields that trigger re-notification when changed. + example: + - status + - severity + items: + description: An incident field name. + type: string + type: array + IncidentNotificationRuleAttributesVisibility: + description: The visibility of the notification rule. + enum: + - all + - organization + - private + example: organization + type: string + x-enum-varnames: + - ALL + - ORGANIZATION + - PRIVATE + RelationshipToIncidentType: + description: Relationship to an incident type. + properties: + data: + $ref: '#/components/schemas/RelationshipToIncidentTypeData' + required: + - data + type: object + RelationshipToIncidentNotificationTemplate: + description: A relationship reference to a notification template. + properties: + data: + $ref: '#/components/schemas/RelationshipToIncidentNotificationTemplateData' + required: + - data + type: object + IncidentNotificationRuleCreateAttributesVisibility: + description: The visibility of the notification rule. + enum: + - all + - organization + - private + example: organization + type: string + x-enum-varnames: + - ALL + - ORGANIZATION + - PRIVATE + GoogleMeetConfigurationReference: + description: A reference to a Google Meet Configuration resource. + nullable: true + properties: + data: + $ref: '#/components/schemas/GoogleMeetConfigurationReferenceData' + required: + - data + type: object + MicrosoftTeamsConfigurationReference: + description: A reference to a Microsoft Teams Configuration resource. + nullable: true + properties: + data: + $ref: '#/components/schemas/MicrosoftTeamsConfigurationReferenceData' + required: + - data + type: object + ZoomConfigurationReference: + description: A reference to a Zoom configuration resource. + nullable: true + properties: + data: + $ref: '#/components/schemas/ZoomConfigurationReferenceData' + required: + - data + type: object + IncidentSearchResponseFacetsData: + description: Facet data for incidents returned by a search query. + properties: + commander: + description: Facet data for incident commander users. + items: + $ref: '#/components/schemas/IncidentSearchResponseUserFacetData' + type: array + created_by: + description: Facet data for incident creator users. + items: + $ref: '#/components/schemas/IncidentSearchResponseUserFacetData' + type: array + fields: + description: Facet data for incident property fields. + items: + $ref: '#/components/schemas/IncidentSearchResponsePropertyFieldFacetData' + type: array + impact: + description: Facet data for incident impact attributes. + items: + $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' + type: array + last_modified_by: + description: Facet data for incident last modified by users. + items: + $ref: '#/components/schemas/IncidentSearchResponseUserFacetData' + type: array + postmortem: + description: Facet data for incident postmortem existence. + items: + $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' + type: array + responder: + description: Facet data for incident responder users. + items: + $ref: '#/components/schemas/IncidentSearchResponseUserFacetData' + type: array + severity: + description: Facet data for incident severity attributes. + items: + $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' + type: array + state: + description: Facet data for incident state attributes. + items: + $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' + type: array + time_to_repair: + description: Facet data for incident time to repair metrics. + items: + $ref: '#/components/schemas/IncidentSearchResponseNumericFacetData' + type: array + time_to_resolve: + description: Facet data for incident time to resolve metrics. + items: + $ref: '#/components/schemas/IncidentSearchResponseNumericFacetData' + type: array + type: object + IncidentSearchResponseIncidentsData: + description: Incident returned by the search. + properties: + data: + $ref: '#/components/schemas/IncidentResponseData' + required: + - data + type: object + RelationshipToIncidentPostmortem: + description: A relationship reference for postmortems. + example: + data: + id: 00000000-0000-abcd-3000-000000000000 + type: incident_postmortems + properties: + data: + $ref: '#/components/schemas/RelationshipToIncidentPostmortemData' + required: + - data + type: object + IncidentAttachmentPostmortemAttributes: + description: The attributes object for a postmortem attachment. + properties: + attachment: + $ref: >- + #/components/schemas/IncidentAttachmentsPostmortemAttributesAttachmentObject + attachment_type: + $ref: '#/components/schemas/IncidentAttachmentPostmortemAttachmentType' + required: + - attachment_type + - attachment + type: object + IncidentAttachmentLinkAttributes: + description: The attributes object for a link attachment. + properties: + attachment: + $ref: >- + #/components/schemas/IncidentAttachmentLinkAttributesAttachmentObject + attachment_type: + $ref: '#/components/schemas/IncidentAttachmentLinkAttachmentType' + modified: + description: Timestamp when the incident attachment link was last modified. + format: date-time + readOnly: true + type: string + required: + - attachment_type + - attachment + type: object + IncidentIntegrationMetadataMetadata: + description: Incident integration metadata's metadata attribute. + oneOf: + - $ref: '#/components/schemas/SlackIntegrationMetadata' + - $ref: '#/components/schemas/JiraIntegrationMetadata' + - $ref: '#/components/schemas/MSTeamsIntegrationMetadata' + IncidentTodoAssigneeArray: + description: Array of todo assignees. + example: + - '@test.user@test.com' + items: + $ref: '#/components/schemas/IncidentTodoAssignee' + type: array + EscalationPolicyCreateRequestDataAttributesStepsItems: + description: >- + Defines a single escalation step within an escalation policy creation + request. Contains assignment strategy, escalation timeout, and a list of + targets. + properties: + assignment: + $ref: '#/components/schemas/EscalationPolicyStepAttributesAssignment' + escalate_after_seconds: + description: Defines how many seconds to wait before escalating to the next step. + example: 3600 + format: int64 + type: integer + targets: + description: Specifies the collection of escalation targets for this step. + example: + - users + items: + $ref: '#/components/schemas/EscalationPolicyStepTarget' + type: array + required: + - targets + type: object + DataRelationshipsTeams: + description: Associates teams with this schedule in a data structure. + properties: + data: + description: An array of team references for this schedule. + items: + $ref: '#/components/schemas/DataRelationshipsTeamsDataItems' + type: array + type: object + EscalationPolicyDataRelationshipsSteps: + description: >- + Defines the relationship to a collection of steps within an escalation + policy. Contains an array of step data references. + properties: + data: + description: >- + An array of references to the steps defined in this escalation + policy. + items: + $ref: >- + #/components/schemas/EscalationPolicyDataRelationshipsStepsDataItems + type: array + type: object + TeamReferenceAttributes: + description: >- + Encapsulates the basic attributes of a Team reference, such as name, + handle, and an optional avatar or description. + properties: + avatar: + description: URL or reference for the team's avatar (if available). + type: string + description: + description: A short text describing the team. + type: string + handle: + description: A unique handle/slug for the team. + type: string + name: + description: The full, human-readable name of the team. + type: string + type: object + TeamReferenceType: + default: teams + description: Teams resource type. + enum: + - teams + example: teams + type: string + x-enum-varnames: + - TEAMS + EscalationPolicyStepAttributes: + description: >- + Defines attributes for an escalation policy step, such as assignment + strategy and escalation timeout. + properties: + assignment: + $ref: '#/components/schemas/EscalationPolicyStepAttributesAssignment' + escalate_after_seconds: + description: >- + Specifies how many seconds to wait before escalating to the next + step. + format: int64 + type: integer + type: object + EscalationPolicyStepRelationships: + description: Represents the relationship of an escalation policy step to its targets. + properties: + targets: + $ref: '#/components/schemas/EscalationTargets' + type: object + EscalationPolicyStepType: + default: steps + description: Indicates that the resource is of type `steps`. + enum: + - steps + example: steps + type: string + x-enum-varnames: + - STEPS + EscalationPolicyUserAttributes: + description: >- + Provides basic user information for an escalation policy, including a + name and email address. + properties: + email: + description: The user's email address. + example: jane.doe@example.com + type: string + name: + description: The user's name. + example: Jane Doe + type: string + status: + $ref: '#/components/schemas/UserAttributesStatus' + type: object + EscalationPolicyUserType: + default: users + description: Users resource type. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + EscalationPolicyUpdateRequestDataAttributesStepsItems: + description: >- + Defines a single escalation step within an escalation policy update + request. Contains assignment strategy, escalation timeout, an optional + step ID, and a list of targets. + properties: + assignment: + $ref: '#/components/schemas/EscalationPolicyStepAttributesAssignment' + escalate_after_seconds: + description: Defines how many seconds to wait before escalating to the next step. + example: 3600 + format: int64 + type: integer + id: + description: Specifies the unique identifier of this step. + example: 00000000-aba1-0000-0000-000000000000 + type: string + targets: + description: Specifies the collection of escalation targets for this step. + items: + $ref: '#/components/schemas/EscalationPolicyStepTarget' + type: array + required: + - targets + type: object + CreatePageRequestDataAttributesTarget: + description: Information about the target to notify (such as a team or user). + properties: + identifier: + description: Identifier for the target (for example, team handle or user ID). + type: string + type: + $ref: '#/components/schemas/OnCallPageTargetType' + type: object + PageUrgency: + default: high + description: On-Call Page urgency level. + enum: + - low + - high + example: high + type: string + x-enum-varnames: + - LOW + - HIGH + ScheduleCreateRequestDataAttributesLayersItems: + description: >- + Describes a schedule layer, including rotation intervals, members, + restrictions, and timeline settings. + properties: + effective_date: + description: The date/time when this layer becomes active (in ISO 8601). + example: '2025-01-01T00:00:00Z' + format: date-time + type: string + end_date: + description: >- + The date/time after which this layer no longer applies (in ISO + 8601). + format: date-time + type: string + interval: + $ref: '#/components/schemas/LayerAttributesInterval' + members: + description: A list of members who participate in this layer's rotation. + items: + $ref: >- + #/components/schemas/ScheduleRequestDataAttributesLayersItemsMembersItems + type: array + name: + description: The name of this layer. + example: Primary On-Call Layer + type: string + restrictions: + description: >- + Zero or more time-based restrictions (for example, only weekdays, + during business hours). + items: + $ref: '#/components/schemas/TimeRestriction' + type: array + rotation_start: + description: The date/time when the rotation for this layer starts (in ISO 8601). + example: '2025-01-01T00:00:00Z' + format: date-time + type: string + required: + - name + - interval + - rotation_start + - effective_date + - members + type: object + ScheduleDataRelationshipsLayers: + description: Associates layers with this schedule in a data structure. + properties: + data: + description: An array of layer references for this schedule. + items: + $ref: '#/components/schemas/ScheduleDataRelationshipsLayersDataItems' + type: array + type: object + LayerAttributes: + description: >- + Describes key properties of a Layer, including rotation details, name, + start/end times, and any restrictions. + properties: + effective_date: + description: When the layer becomes active (ISO 8601). + format: date-time + type: string + end_date: + description: When the layer ceases to be active (ISO 8601). + format: date-time + type: string + interval: + $ref: '#/components/schemas/LayerAttributesInterval' + name: + description: The name of this layer. + example: Weekend Layer + type: string + restrictions: + description: >- + An optional list of time restrictions for when this layer is in + effect. + items: + $ref: '#/components/schemas/TimeRestriction' + type: array + rotation_start: + description: The date/time when the rotation starts (ISO 8601). + format: date-time + type: string + type: object + LayerRelationships: + description: >- + Holds references to objects related to the Layer entity, such as its + members. + properties: + members: + $ref: '#/components/schemas/LayerRelationshipsMembers' + type: object + LayerType: + default: layers + description: Layers resource type. + enum: + - layers + example: layers + type: string + x-enum-varnames: + - LAYERS + ScheduleMemberRelationships: + description: >- + Defines relationships for a schedule member, primarily referencing a + single user. + properties: + user: + $ref: '#/components/schemas/ScheduleMemberRelationshipsUser' + type: object + ScheduleMemberType: + default: members + description: Schedule Members resource type. + enum: + - members + example: members + type: string + x-enum-varnames: + - MEMBERS + ScheduleUserAttributes: + description: >- + Provides basic user information for a schedule, including a name and + email address. + properties: + email: + description: The user's email address. + example: jane.doe@example.com + type: string + name: + description: The user's name. + example: Jane Doe + type: string + status: + $ref: '#/components/schemas/UserAttributesStatus' + type: object + ScheduleUserType: + default: users + description: Users resource type. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + ScheduleUpdateRequestDataAttributesLayersItems: + description: >- + Represents a layer within a schedule update, including rotation details, + members, + + and optional restrictions. + properties: + effective_date: + description: When this updated layer takes effect (ISO 8601 format). + example: '2025-02-03T05:00:00Z' + format: date-time + type: string + end_date: + description: When this updated layer should stop being active (ISO 8601 format). + example: '2025-12-31T00:00:00Z' + format: date-time + type: string + id: + description: A unique identifier for the layer being updated. + example: 00000000-0000-0000-0000-000000000001 + type: string + interval: + $ref: '#/components/schemas/LayerAttributesInterval' + members: + description: The members assigned to this layer. + items: + $ref: >- + #/components/schemas/ScheduleRequestDataAttributesLayersItemsMembersItems + type: array + name: + description: The name for this layer (for example, "Secondary Coverage"). + example: Primary On-Call Layer + type: string + restrictions: + description: Any time restrictions that define when this layer is active. + items: + $ref: '#/components/schemas/TimeRestriction' + type: array + rotation_start: + description: The date/time at which the rotation begins (ISO 8601 format). + example: '2025-02-01T00:00:00Z' + format: date-time + type: string + required: + - effective_date + - interval + - members + - name + - rotation_start + type: object + ShiftDataRelationshipsUser: + description: >- + Defines the relationship between a shift and the user who is working + that shift. + properties: + data: + $ref: '#/components/schemas/ShiftDataRelationshipsUserData' + required: + - data + type: object + TeamOnCallRespondersDataRelationshipsEscalations: + description: >- + Defines the escalation policy steps linked to the team's on-call + configuration. + properties: + data: + description: Array of escalation step references. + items: + $ref: >- + #/components/schemas/TeamOnCallRespondersDataRelationshipsEscalationsDataItems + type: array + type: object + TeamOnCallRespondersDataRelationshipsResponders: + description: Defines the list of users assigned as on-call responders for the team. + properties: + data: + description: Array of user references associated as responders. + items: + $ref: >- + #/components/schemas/TeamOnCallRespondersDataRelationshipsRespondersDataItems + type: array + type: object + EscalationRelationships: + description: >- + Contains the relationships of an escalation object, including its + responders. + properties: + responders: + $ref: '#/components/schemas/EscalationRelationshipsResponders' + type: object + EscalationType: + default: escalation_policy_steps + description: >- + Represents the resource type for individual steps in an escalation + policy used during incident response. + enum: + - escalation_policy_steps + example: escalation_policy_steps + type: string + x-enum-varnames: + - ESCALATION_POLICY_STEPS + TeamRoutingRulesDataRelationshipsRules: + description: Holds references to a set of routing rules in a relationship. + properties: + data: + description: >- + An array of references to the routing rules associated with this + team. + items: + $ref: >- + #/components/schemas/TeamRoutingRulesDataRelationshipsRulesDataItems + type: array + type: object + RoutingRuleAttributes: + description: >- + Defines the configurable attributes of a routing rule, such as actions, + query, time restriction, and urgency. + properties: + actions: + description: >- + Specifies the list of actions to perform when the routing rule + matches. + items: + $ref: '#/components/schemas/RoutingRuleAction' + type: array + query: + description: Defines the query or condition that triggers this routing rule. + type: string + time_restriction: + $ref: '#/components/schemas/TimeRestrictions' + nullable: true + urgency: + $ref: '#/components/schemas/Urgency' + type: object + RoutingRuleRelationships: + description: >- + Specifies relationships for a routing rule, linking to associated policy + resources. + properties: + policy: + $ref: '#/components/schemas/RoutingRuleRelationshipsPolicy' + type: object + RoutingRuleType: + default: team_routing_rules + description: Team routing rules resource type. + enum: + - team_routing_rules + example: team_routing_rules + type: string + x-enum-varnames: + - TEAM_ROUTING_RULES + TeamRoutingRulesRequestRule: + description: >- + Defines an individual routing rule item that contains the rule data for + the request. + properties: + actions: + description: >- + Specifies the list of actions to perform when the routing rule is + matched. + items: + $ref: '#/components/schemas/RoutingRuleAction' + type: array + policy_id: + description: Identifies the policy to be applied when this routing rule matches. + type: string + query: + description: Defines the query or condition that triggers this routing rule. + type: string + time_restriction: + $ref: '#/components/schemas/TimeRestrictions' + urgency: + $ref: '#/components/schemas/Urgency' + type: object + ServiceDefinitionMeta: + description: Metadata about a service definition. + properties: + github-html-url: + description: GitHub HTML URL. + type: string + ingested-schema-version: + description: Ingestion schema version. + type: string + ingestion-source: + description: Ingestion source of the service definition. + type: string + last-modified-time: + description: Last modified time of the service definition. + type: string + origin: + description: User defined origin of the service definition. + type: string + origin-detail: + description: User defined origin's detail of the service definition. + type: string + warnings: + description: A list of schema validation warnings. + items: + $ref: '#/components/schemas/ServiceDefinitionMetaWarnings' + type: array + type: object + ServiceDefinitionSchema: + description: Service definition schema. + oneOf: + - $ref: '#/components/schemas/ServiceDefinitionV1' + - $ref: '#/components/schemas/ServiceDefinitionV2' + - $ref: '#/components/schemas/ServiceDefinitionV2Dot1' + - $ref: '#/components/schemas/ServiceDefinitionV2Dot2' + ServiceDefinitionV2Dot2Opsgenie: + description: Opsgenie integration for the service. + properties: + region: + $ref: '#/components/schemas/ServiceDefinitionV2Dot2OpsgenieRegion' + service-url: + description: Opsgenie service url. + example: >- + https://my-org.opsgenie.com/service/123e4567-e89b-12d3-a456-426614174000 + type: string + required: + - service-url + type: object + ServiceDefinitionV2Dot2Pagerduty: + description: PagerDuty integration for the service. + properties: + service-url: + description: PagerDuty service url. + example: https://my-org.pagerduty.com/service-directory/PMyService + type: string + type: object + ServiceDefinitionV2Dot1Email: + description: Service owner's email. + properties: + contact: + description: Contact value. + example: contact@datadoghq.com + type: string + name: + description: Contact email. + example: Team Email + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1EmailType' + required: + - type + - contact + type: object + ServiceDefinitionV2Dot1Slack: + description: Service owner's Slack channel. + properties: + contact: + description: Slack Channel. + example: https://yourcompany.slack.com/archives/channel123 + type: string + name: + description: Contact Slack. + example: Team Slack + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1SlackType' + required: + - type + - contact + type: object + ServiceDefinitionV2Dot1MSTeams: + description: Service owner's Microsoft Teams. + properties: + contact: + description: Contact value. + example: https://teams.microsoft.com/myteam + type: string + name: + description: Contact Microsoft Teams. + example: My team channel + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1MSTeamsType' + required: + - type + - contact + type: object + ServiceDefinitionV2Dot1Opsgenie: + description: Opsgenie integration for the service. + properties: + region: + $ref: '#/components/schemas/ServiceDefinitionV2Dot1OpsgenieRegion' + service-url: + description: Opsgenie service url. + example: >- + https://my-org.opsgenie.com/service/123e4567-e89b-12d3-a456-426614174000 + type: string + required: + - service-url + type: object + ServiceDefinitionV2Dot1Pagerduty: + description: PagerDuty integration for the service. + properties: + service-url: + description: PagerDuty service url. + example: https://my-org.pagerduty.com/service-directory/PMyService + type: string + type: object + ServiceDefinitionV2Dot1LinkType: + description: Link type. + enum: + - doc + - repo + - runbook + - dashboard + - other + example: runbook + type: string + x-enum-varnames: + - DOC + - REPO + - RUNBOOK + - DASHBOARD + - OTHER + ServiceDefinitionV2Email: + description: Service owner's email. + properties: + contact: + description: Contact value. + example: contact@datadoghq.com + type: string + name: + description: Contact email. + example: Team Email + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2EmailType' + required: + - type + - contact + type: object + ServiceDefinitionV2Slack: + description: Service owner's Slack channel. + properties: + contact: + description: Slack Channel. + example: https://yourcompany.slack.com/archives/channel123 + type: string + name: + description: Contact Slack. + example: Team Slack + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2SlackType' + required: + - type + - contact + type: object + ServiceDefinitionV2MSTeams: + description: Service owner's Microsoft Teams. + properties: + contact: + description: Contact value. + example: https://teams.microsoft.com/myteam + type: string + name: + description: Contact Microsoft Teams. + example: My team channel + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV2MSTeamsType' + required: + - type + - contact + type: object + ServiceDefinitionV2Opsgenie: + description: Opsgenie integration for the service. + properties: + region: + $ref: '#/components/schemas/ServiceDefinitionV2OpsgenieRegion' + service-url: + description: Opsgenie service url. + example: >- + https://my-org.opsgenie.com/service/123e4567-e89b-12d3-a456-426614174000 + type: string + required: + - service-url + type: object + ServiceDefinitionV2Pagerduty: + description: PagerDuty service URL for the service. + example: https://my-org.pagerduty.com/service-directory/PMyService + type: string + ServiceDefinitionV2LinkType: + description: Link type. + enum: + - doc + - wiki + - runbook + - url + - repo + - dashboard + - oncall + - code + - link + example: runbook + type: string + x-enum-varnames: + - DOC + - WIKI + - RUNBOOK + - URL + - REPO + - DASHBOARD + - ONCALL + - CODE + - LINK + SLOReportInterval: + description: The frequency at which report data is to be generated. + enum: + - daily + - weekly + - monthly + example: weekly + type: string + x-enum-varnames: + - DAILY + - WEEKLY + - MONTHLY + SLOReportStatus: + description: The status of the SLO report job. + enum: + - in_progress + - completed + - completed_with_errors + - failed + example: completed + type: string + x-enum-varnames: + - IN_PROGRESS + - COMPLETED + - COMPLETED_WITH_ERRORS + - FAILED + JiraIssueResult: + description: Jira issue information + properties: + issue_id: + description: Jira issue ID + type: string + issue_key: + description: Jira issue key + type: string + issue_url: + description: Jira issue URL + type: string + project_key: + description: Jira project key + type: string + type: object + Case3rdPartyTicketStatus: + default: IN_PROGRESS + description: Case status + enum: + - IN_PROGRESS + - COMPLETED + - FAILED + example: COMPLETED + readOnly: true + type: string + x-enum-varnames: + - IN_PROGRESS + - COMPLETED + - FAILED + ServiceNowTicketResult: + description: ServiceNow ticket information + properties: + sys_target_link: + description: Link to the Incident created on ServiceNow + type: string + type: object + NullableUserRelationshipData: + description: Relationship to user object. + nullable: true + properties: + id: + description: A unique identifier that represents the user. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/UserResourceType' + required: + - id + - type + type: object + ProjectRelationshipData: + description: Relationship to project object + properties: + id: + description: A unique identifier that represents the project + example: e555e290-ed65-49bd-ae18-8acbfcf18db7 + type: string + type: + $ref: '#/components/schemas/ProjectResourceType' + required: + - id + - type + type: object + RelationshipToTeamLinkData: + description: Relationship between a link and a team + properties: + id: + description: The team link's identifier + example: f9bb8444-af7f-11ec-ac2c-da7ad0900001 + type: string + type: + $ref: '#/components/schemas/TeamLinkType' + required: + - id + - type + type: object + TeamRelationshipsLinks: + description: Links attributes. + properties: + related: + description: Related link. + example: /api/v2/team/c75a4a8e-20c7-11ee-a3a5-da7ad0900002/links + type: string + type: object + UserRelationshipData: + description: Relationship to user object. + properties: + id: + description: A unique identifier that represents the user. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/UserResourceType' + required: + - id + - type + type: object + DowntimeMonitorIdentifierId: + additionalProperties: {} + description: Object of the monitor identifier. + properties: + monitor_id: + description: ID of the monitor to prevent notifications. + example: 123 + format: int64 + type: integer + required: + - monitor_id + type: object + DowntimeMonitorIdentifierTags: + additionalProperties: {} + description: Object of the monitor tags. + properties: + monitor_tags: + description: >- + A list of monitor tags. For example, tags that are applied directly + to monitors, + + not tags that are used in monitor queries (which are filtered by the + scope parameter), to which the downtime applies. + + The resulting downtime applies to monitors that match **all** + provided monitor tags. Setting `monitor_tags` + + to `[*]` configures the downtime to mute all monitors for the given + scope. + example: + - service:postgres + - team:frontend + items: + description: A list of monitor tags. + example: service:postgres + type: string + minItems: 1 + type: array + required: + - monitor_tags + type: object + DowntimeNotifyEndStateTypes: + description: >- + State that will trigger a monitor notification when the + `notify_end_types` action occurs. + enum: + - alert + - no data + - warn + example: alert + type: string + x-enum-varnames: + - ALERT + - NO_DATA + - WARN + DowntimeNotifyEndStateActions: + description: >- + Action that will trigger a monitor notification if the downtime is in + the `notify_end_types` state. + enum: + - canceled + - expired + example: canceled + type: string + x-enum-varnames: + - CANCELED + - EXPIRED + DowntimeScheduleRecurrencesResponse: + description: A recurring downtime schedule definition. + properties: + current_downtime: + $ref: '#/components/schemas/DowntimeScheduleCurrentDowntimeResponse' + recurrences: + description: A list of downtime recurrences. + items: + $ref: '#/components/schemas/DowntimeScheduleRecurrenceResponse' + maxItems: 5 + minItems: 1 + type: array + timezone: + default: UTC + description: >- + The timezone in which to schedule the downtime. This affects + recurring start and end dates. + + Must match `display_timezone`. + example: America/New_York + type: string + required: + - recurrences + type: object + DowntimeScheduleOneTimeResponse: + description: A one-time downtime definition. + properties: + end: + description: ISO-8601 Datetime to end the downtime. + example: '2020-01-02T03:04:00.000Z' + format: date-time + nullable: true + type: string + start: + description: ISO-8601 Datetime to start the downtime. + example: '2020-01-02T03:04:00.000Z' + format: date-time + type: string + required: + - start + type: object + DowntimeRelationshipsCreatedByData: + description: Data for the user who created the downtime. + nullable: true + properties: + id: + description: User ID of the downtime creator. + example: 00000000-0000-1234-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + type: object + DowntimeRelationshipsMonitorData: + description: Data for the monitor. + nullable: true + properties: + id: + description: Monitor ID of the downtime. + example: '12345' + type: string + type: + $ref: '#/components/schemas/DowntimeIncludedMonitorType' + type: object + RelationshipToOrganization: + description: Relationship to an organization. + properties: + data: + $ref: '#/components/schemas/RelationshipToOrganizationData' + required: + - data + type: object + RelationshipToOrganizations: + description: Relationship to organizations. + properties: + data: + description: Relationships to organization objects. + example: [] + items: + $ref: '#/components/schemas/RelationshipToOrganizationData' + type: array + required: + - data + type: object + RelationshipToUsers: + description: Relationship to users. + properties: + data: + description: Relationships to user objects. + example: [] + items: + $ref: '#/components/schemas/RelationshipToUserData' + type: array + required: + - data + type: object + RelationshipToRoles: + description: Relationship to roles. + properties: + data: + description: An array containing type and the unique identifier of a role. + items: + $ref: '#/components/schemas/RelationshipToRoleData' + type: array + type: object + DowntimeScheduleRecurrencesCreateRequest: + description: A recurring downtime schedule definition. + properties: + recurrences: + description: A list of downtime recurrences. + items: + $ref: '#/components/schemas/DowntimeScheduleRecurrenceCreateUpdateRequest' + type: array + timezone: + default: UTC + description: The timezone in which to schedule the downtime. + example: America/New_York + type: string + required: + - recurrences + type: object + DowntimeScheduleOneTimeCreateUpdateRequest: + additionalProperties: false + description: A one-time downtime definition. + properties: + end: + description: >- + ISO-8601 Datetime to end the downtime. Must include a UTC offset of + zero. If not provided, the + + downtime continues forever. + example: '2020-01-02T03:04:00.000Z' + format: date-time + nullable: true + type: string + start: + description: >- + ISO-8601 Datetime to start the downtime. Must include a UTC offset + of zero. If not provided, the + + downtime starts the moment it is created. + example: '2020-01-02T03:04:00.000Z' + format: date-time + nullable: true + type: string + type: object + DowntimeScheduleRecurrencesUpdateRequest: + additionalProperties: false + description: A recurring downtime schedule definition. + properties: + recurrences: + description: A list of downtime recurrences. + items: + $ref: '#/components/schemas/DowntimeScheduleRecurrenceCreateUpdateRequest' + type: array + timezone: + default: UTC + description: The timezone in which to schedule the downtime. + example: America/New_York + type: string + type: object + IssueReference: + description: The issue the search result corresponds to. + properties: + id: + description: Issue identifier. + example: c1726a66-1f64-11ee-b338-da7ad0900002 + type: string + type: + $ref: '#/components/schemas/IssueType' + required: + - id + - type + type: object + IssueUserReference: + description: The user the issue is assigned to. + properties: + id: + description: User identifier. + example: 87cb11a0-278c-440a-99fe-701223c80296 + type: string + type: + $ref: '#/components/schemas/IssueUserType' + required: + - id + - type + type: object + IssueCaseReference: + description: The case the issue is attached to. + properties: + id: + description: Case identifier. + example: 2841440d-e780-4fe2-96cd-6a8c1d194da5 + type: string + type: + $ref: '#/components/schemas/IssueCaseResourceType' + required: + - id + - type + type: object + IssueTeamReference: + description: A team that owns the issue. + properties: + id: + description: Team identifier. + example: 221b0179-6447-4d03-91c3-3ca98bf60e8a + type: string + type: + $ref: '#/components/schemas/IssueTeamType' + required: + - id + - type + type: object + IssueCaseInsight: + description: Insight of the case. + properties: + ref: + description: Reference of the insight. + example: /error-tracking?issueId=2841440d-e780-4fe2-96cd-6a8c1d194da5 + type: string + resource_id: + description: Insight identifier. + example: 2841440d-e780-4fe2-96cd-6a8c1d194da5 + type: string + type: + description: Type of the insight. + example: ERROR_TRACKING + type: string + type: object + IssueCaseJiraIssue: + description: Jira issue of the case. + properties: + result: + $ref: '#/components/schemas/IssueCaseJiraIssueResult' + status: + description: Creation status of the Jira issue. + example: COMPLETED + type: string + type: object + Event: + description: The metadata associated with a request. + properties: + id: + description: Event ID. + example: '6509751066204996294' + type: string + name: + description: The event name. + type: string + source_id: + description: Event source ID. + example: 36 + format: int64 + type: integer + type: + description: Event type. + example: error_tracking_alert + type: string + type: object + MonitorType: + description: Attributes from the monitor that triggered the event. + nullable: true + properties: + created_at: + description: The POSIX timestamp of the monitor's creation in nanoseconds. + example: 1646318692000 + format: int64 + type: integer + group_status: + description: Monitor group status used when there is no `result_groups`. + format: int32 + maximum: 2147483647 + type: integer + groups: + description: Groups to which the monitor belongs. + items: + description: A group. + type: string + type: array + id: + description: The monitor ID. + format: int64 + type: integer + message: + description: The monitor message. + type: string + modified: + description: The monitor's last-modified timestamp. + format: int64 + type: integer + name: + description: The monitor name. + type: string + query: + description: The query that triggers the alert. + type: string + tags: + description: A list of tags attached to the monitor. + example: + - environment:test + items: + description: A tag. + type: string + type: array + templated_name: + description: >- + The templated name of the monitor before resolving any template + variables. + type: string + type: + description: The monitor type. + type: string + type: object + EventPriority: + description: The priority of the event's monitor. For example, `normal` or `low`. + enum: + - normal + - low + example: normal + nullable: true + type: string + x-enum-varnames: + - NORMAL + - LOW + EventStatusType: + description: |- + If an alert event is enabled, its status is one of the following: + `failure`, `error`, `warning`, `info`, `success`, `user_update`, + `recommendation`, or `snapshot`. + enum: + - failure + - error + - warning + - info + - success + - user_update + - recommendation + - snapshot + example: info + type: string + x-enum-varnames: + - FAILURE + - ERROR + - WARNING + - INFO + - SUCCESS + - USER_UPDATE + - RECOMMENDATION + - SNAPSHOT + ChangeEventCustomAttributes: + additionalProperties: false + description: Change event attributes. + properties: + author: + $ref: '#/components/schemas/ChangeEventCustomAttributesAuthor' + change_metadata: + additionalProperties: {} + description: >- + Free form JSON object with information related to the `change` + event. Supports up to 100 properties per object and a maximum + nesting depth of 10 levels. + example: + dd: + team: datadog_team + user_email: datadog@datadog.com + user_id: datadog_user_id + user_name: datadog_username + resource_link: datadog.com/feature/fallback_payments_test + type: object + changed_resource: + $ref: '#/components/schemas/ChangeEventCustomAttributesChangedResource' + impacted_resources: + description: >- + A list of resources impacted by this change. It is recommended to + provide an impacted resource to display + + the change event at the correct location. Only resources of type + `service` are supported. Maximum of 100 impacted resources allowed. + example: + - name: payments_api + type: service + items: + $ref: >- + #/components/schemas/ChangeEventCustomAttributesImpactedResourcesItems + maxItems: 100 + type: array + new_value: + additionalProperties: {} + description: >- + Free form JSON object representing the new state of the changed + resource. + example: + enabled: true + percentage: 50% + rule: + datacenter: devcycle.us1.prod + type: object + prev_value: + additionalProperties: {} + description: >- + Free form JSON object representing the previous state of the changed + resource. + example: + enabled: true + percentage: 10% + rule: + datacenter: devcycle.us1.prod + type: object + required: + - changed_resource + type: object + AlertEventCustomAttributes: + additionalProperties: false + description: Alert event attributes. + properties: + custom: + $ref: '#/components/schemas/AlertEventCustomAttributesCustom' + links: + $ref: '#/components/schemas/AlertEventCustomAttributesLinks' + priority: + $ref: '#/components/schemas/AlertEventCustomAttributesPriority' + status: + $ref: '#/components/schemas/AlertEventCustomAttributesStatus' + required: + - status + type: object + EventCreateResponseAttributesAttributesEvt: + description: JSON object of event system attributes. + properties: + id: + deprecated: true + description: >- + Event identifier. This field is deprecated and will be removed in a + future version. Use the `uid` field instead. + type: string + uid: + description: >- + A unique identifier for the event. You can use this identifier to + query or reference the event. + type: string + type: object + ChangeEventAttributes: + description: Change event attributes. + properties: + aggregation_key: + $ref: '#/components/schemas/V2EventAggregationKey' + author: + $ref: '#/components/schemas/ChangeEventAttributesAuthor' + change_metadata: + description: JSON object of change metadata. + example: + dd: + team: datadog_team + user_email: datadog@datadog.com + user_id: datadog_user_id + user_name: datadog_username + type: object + changed_resource: + $ref: '#/components/schemas/ChangeEventAttributesChangedResource' + evt: + $ref: '#/components/schemas/EventSystemAttributes' + impacted_resources: + description: A list of resources impacted by this change. + example: + - name: service-name + type: service + items: + $ref: '#/components/schemas/ChangeEventAttributesImpactedResourcesItem' + type: array + new_value: + description: The new state of the changed resource. + example: + enabled: true + percentage: 50% + rule: + datacenter: devcycle.us1.prod + type: object + prev_value: + description: The previous state of the changed resource. + example: + enabled: true + percentage: 10% + rule: + datacenter: devcycle.us1.prod + type: object + service: + $ref: '#/components/schemas/V2EventService' + timestamp: + $ref: '#/components/schemas/V2EventTimestamp' + title: + $ref: '#/components/schemas/V2EventTitle' + type: object + AlertEventAttributes: + description: Alert event attributes. + properties: + aggregation_key: + $ref: '#/components/schemas/V2EventAggregationKey' + custom: + description: JSON object of custom attributes. + example: {} + type: object + evt: + $ref: '#/components/schemas/EventSystemAttributes' + links: + description: The links related to the event. + example: + - category: runbook + title: Runbook Link + url: https://app.datadoghq.com/runbook + items: + $ref: '#/components/schemas/AlertEventAttributesLinksItem' + type: array + priority: + $ref: '#/components/schemas/AlertEventAttributesPriority' + service: + $ref: '#/components/schemas/V2EventService' + status: + $ref: '#/components/schemas/AlertEventAttributesStatus' + timestamp: + $ref: '#/components/schemas/V2EventTimestamp' + title: + $ref: '#/components/schemas/V2EventTitle' + type: object + IncidentFieldAttributesSingleValue: + description: A field with a single value selected. + properties: + type: + $ref: '#/components/schemas/IncidentFieldAttributesSingleValueType' + value: + description: The single value selected for this field. + example: SEV-1 + nullable: true + type: string + type: object + IncidentFieldAttributesMultipleValue: + description: A field with potentially multiple values selected. + properties: + type: + $ref: '#/components/schemas/IncidentFieldAttributesValueType' + value: + description: The multiple values selected for this field. + example: + - '1.0' + - '1.1' + items: + description: A value which has been selected for the parent field. + example: '1.1' + type: string + nullable: true + type: array + type: object + RelationshipToIncidentAttachmentData: + description: The attachment relationship data. + properties: + id: + description: A unique identifier that represents the attachment. + example: 00000000-0000-abcd-1000-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentAttachmentType' + required: + - id + - type + type: object + NullableRelationshipToUserData: + description: Relationship to user object. + nullable: true + properties: + id: + description: A unique identifier that represents the user. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + required: + - id + - type + type: object + RelationshipToUserData: + description: Relationship to user object. + properties: + id: + description: A unique identifier that represents the user. + example: 00000000-0000-0000-2345-000000000000 + type: string + type: + $ref: '#/components/schemas/UsersType' + required: + - id + - type + type: object + RelationshipToIncidentImpactData: + description: Relationship to impact object. + properties: + id: + description: A unique identifier that represents the impact. + example: 00000000-0000-0000-2345-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentImpactsType' + required: + - id + - type + type: object + RelationshipToIncidentIntegrationMetadataData: + description: A relationship reference for an integration metadata object. + example: + id: 00000000-abcd-0002-0000-000000000000 + type: incident_integrations + properties: + id: + description: A unique identifier that represents the integration metadata. + example: 00000000-abcd-0001-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentIntegrationMetadataType' + required: + - id + - type + type: object + RelationshipToIncidentResponderData: + description: Relationship to impact object. + properties: + id: + description: A unique identifier that represents the responder. + example: 00000000-0000-0000-2345-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentRespondersType' + required: + - id + - type + type: object + RelationshipToIncidentUserDefinedFieldData: + description: Relationship to impact object. + properties: + id: + description: A unique identifier that represents the responder. + example: 00000000-0000-0000-2345-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentUserDefinedFieldType' + required: + - id + - type + type: object + IncidentTimelineCellMarkdownCreateAttributes: + description: Timeline cell data for Markdown timeline cells for a create request. + properties: + cell_type: + $ref: '#/components/schemas/IncidentTimelineCellMarkdownContentType' + content: + $ref: >- + #/components/schemas/IncidentTimelineCellMarkdownCreateAttributesContent + important: + default: false + description: >- + A flag indicating whether the timeline cell is important and should + be highlighted. + example: false + type: boolean + required: + - content + - cell_type + type: object + IncidentNotificationRuleConditionsItems: + description: A condition that must be met to trigger the notification rule. + properties: + field: + description: The incident field to evaluate + example: severity + type: string + values: + description: >- + The value(s) to compare against. Multiple values are `ORed` + together. + example: + - SEV-1 + - SEV-2 + items: + type: string + type: array + required: + - field + - values + type: object + RelationshipToIncidentTypeData: + description: Relationship to incident type object. + properties: + id: + description: The incident type's ID. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentTypeType' + required: + - id + - type + type: object + RelationshipToIncidentNotificationTemplateData: + description: The notification template relationship data. + properties: + id: + description: The unique identifier of the notification template. + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + type: + $ref: '#/components/schemas/IncidentNotificationTemplateType' + required: + - id + - type + type: object + GoogleMeetConfigurationReferenceData: + description: The Google Meet configuration relationship data object. + nullable: true + properties: + id: + description: The unique identifier of the Google Meet configuration. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + description: The type of the Google Meet configuration. + example: google_meet_configurations + type: string + required: + - id + - type + type: object + MicrosoftTeamsConfigurationReferenceData: + description: The Microsoft Teams configuration relationship data object. + nullable: true + properties: + id: + description: The unique identifier of the Microsoft Teams configuration. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + description: The type of the Microsoft Teams configuration. + example: microsoft_teams_configurations + type: string + required: + - id + - type + type: object + ZoomConfigurationReferenceData: + description: The Zoom configuration relationship data object. + nullable: true + properties: + id: + description: The unique identifier of the Zoom configuration. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + description: The type of the Zoom configuration. + example: zoom_configurations + type: string + required: + - id + - type + type: object + IncidentSearchResponseUserFacetData: + description: Facet data for user attributes of an incident. + properties: + count: + $ref: '#/components/schemas/IncidentSearchResponseFacetCount' + email: + description: Email of the user. + example: datadog.user@example.com + type: string + handle: + description: Handle of the user. + example: '@datadog.user@example.com' + type: string + name: + description: Name of the user. + example: Datadog User + type: string + uuid: + description: ID of the user. + example: 773b045d-ccf8-4808-bd3b-955ef6a8c940 + type: string + type: object + IncidentSearchResponsePropertyFieldFacetData: + description: Facet data for the incident property fields. + properties: + aggregates: + $ref: >- + #/components/schemas/IncidentSearchResponseNumericFacetDataAggregates + facets: + description: Facet data for the property field of an incident. + items: + $ref: '#/components/schemas/IncidentSearchResponseFieldFacetData' + type: array + name: + description: Name of the incident property field. + example: Severity + type: string + required: + - facets + - name + type: object + IncidentSearchResponseFieldFacetData: + description: >- + Facet value and number of occurrences for a property field of an + incident. + properties: + count: + $ref: '#/components/schemas/IncidentSearchResponseFacetCount' + name: + description: The facet value appearing in search results. + example: SEV-2 + type: string + type: object + IncidentSearchResponseNumericFacetData: + description: Facet data numeric attributes of an incident. + properties: + aggregates: + $ref: >- + #/components/schemas/IncidentSearchResponseNumericFacetDataAggregates + name: + description: Name of the incident property field. + example: time_to_repair + type: string + required: + - name + - aggregates + type: object + RelationshipToIncidentPostmortemData: + description: The postmortem relationship data. + example: + id: 00000000-0000-abcd-2000-000000000000 + type: incident_postmortems + properties: + id: + description: A unique identifier that represents the postmortem. + example: 00000000-0000-abcd-1000-000000000000 + type: string + type: + $ref: '#/components/schemas/IncidentPostmortemType' + required: + - id + - type + type: object + IncidentAttachmentsPostmortemAttributesAttachmentObject: + description: The postmortem attachment. + properties: + documentUrl: + description: The URL of this notebook attachment. + example: https://app.datadoghq.com/notebook/123 + type: string + title: + description: The title of this postmortem attachment. + example: Postmortem IR-123 + type: string + required: + - documentUrl + - title + type: object + IncidentAttachmentPostmortemAttachmentType: + default: postmortem + description: The type of postmortem attachment attributes. + enum: + - postmortem + example: postmortem + type: string + x-enum-varnames: + - POSTMORTEM + IncidentAttachmentLinkAttributesAttachmentObject: + description: The link attachment. + properties: + documentUrl: + description: The URL of this link attachment. + example: https://www.example.com/webstore-failure-runbook + type: string + title: + description: The title of this link attachment. + example: Runbook for webstore service failures + type: string + required: + - documentUrl + - title + type: object + IncidentAttachmentLinkAttachmentType: + default: link + description: The type of link attachment attributes. + enum: + - link + example: link + type: string + x-enum-varnames: + - LINK + SlackIntegrationMetadata: + description: Incident integration metadata for the Slack integration. + properties: + channels: + description: Array of Slack channels in this integration metadata. + example: [] + items: + $ref: '#/components/schemas/SlackIntegrationMetadataChannelItem' + type: array + required: + - channels + type: object + JiraIntegrationMetadata: + description: Incident integration metadata for the Jira integration. + properties: + issues: + description: Array of Jira issues in this integration metadata. + example: [] + items: + $ref: '#/components/schemas/JiraIntegrationMetadataIssuesItem' + type: array + required: + - issues + type: object + MSTeamsIntegrationMetadata: + description: Incident integration metadata for the Microsoft Teams integration. + properties: + teams: + description: Array of Microsoft Teams in this integration metadata. + example: [] + items: + $ref: '#/components/schemas/MSTeamsIntegrationMetadataTeamsItem' + type: array + required: + - teams + type: object + IncidentTodoAssignee: + description: A todo assignee. + example: '@test.user@test.com' + oneOf: + - $ref: '#/components/schemas/IncidentTodoAssigneeHandle' + - $ref: '#/components/schemas/IncidentTodoAnonymousAssignee' + EscalationPolicyStepAttributesAssignment: + description: >- + Specifies how this escalation step will assign targets (example + `default` or `round-robin`). + enum: + - default + - round-robin + type: string + x-enum-varnames: + - DEFAULT + - ROUND_ROBIN + EscalationPolicyStepTarget: + description: >- + Defines a single escalation target within a step for an escalation + policy creation request. Contains `id` and `type`. + properties: + id: + description: Specifies the unique identifier for this target. + example: 00000000-aba1-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/EscalationPolicyStepTargetType' + type: object + DataRelationshipsTeamsDataItems: + description: >- + Relates a team to this schedule, identified by `id` and `type` (must be + `teams`). + properties: + id: + description: The unique identifier of the team in this relationship. + example: 00000000-da3a-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/DataRelationshipsTeamsDataItemsType' + required: + - type + - id + type: object + EscalationPolicyDataRelationshipsStepsDataItems: + description: >- + Defines a relationship to a single step within an escalation policy. + Contains the step's `id` and `type`. + properties: + id: + description: Specifies the unique identifier for the step resource. + example: 00000000-aba1-0000-0000-000000000000 + type: string + type: + $ref: >- + #/components/schemas/EscalationPolicyDataRelationshipsStepsDataItemsType + required: + - type + - id + type: object + EscalationTargets: + description: A list of escalation targets for a step + properties: + data: + description: The `EscalationTargets` `data`. + items: + $ref: '#/components/schemas/EscalationTarget' + type: array + type: object + UserAttributesStatus: + description: The user's status. + enum: + - active + - deactivated + - pending + type: string + x-enum-varnames: + - ACTIVE + - DEACTIVATED + - PENDING + OnCallPageTargetType: + description: The kind of target, `team_id` | `team_handle` | `user_id`. + enum: + - team_id + - team_handle + - user_id + example: team_id + type: string + x-enum-varnames: + - TEAM_ID + - TEAM_HANDLE + - USER_ID + LayerAttributesInterval: + description: >- + Defines how often the rotation repeats, using a combination of days and + optional seconds. Should be at least 1 hour. + properties: + days: + description: The number of days in each rotation cycle. + example: 1 + format: int32 + maximum: 400 + type: integer + seconds: + description: Any additional seconds for the rotation cycle (up to 30 days). + example: 300 + format: int64 + maximum: 2592000 + type: integer + type: object + ScheduleRequestDataAttributesLayersItemsMembersItems: + description: >- + Defines a single member within a schedule layer, including the reference + to the underlying user. + properties: + user: + $ref: >- + #/components/schemas/ScheduleRequestDataAttributesLayersItemsMembersItemsUser + type: object + TimeRestriction: + description: >- + Defines a single time restriction rule with start and end times and the + applicable weekdays. + properties: + end_day: + $ref: '#/components/schemas/Weekday' + end_time: + description: Specifies the ending time for this restriction. + type: string + start_day: + $ref: '#/components/schemas/Weekday' + start_time: + description: Specifies the starting time for this restriction. + type: string + type: object + ScheduleDataRelationshipsLayersDataItems: + description: >- + Relates a layer to this schedule, identified by `id` and `type` (must be + `layers`). + properties: + id: + description: The unique identifier of the layer in this relationship. + example: 00000000-0000-0000-0000-000000000001 + type: string + type: + $ref: '#/components/schemas/ScheduleDataRelationshipsLayersDataItemsType' + required: + - type + - id + type: object + LayerRelationshipsMembers: + description: >- + Holds an array of references to the members of a Layer, each containing + member IDs. + properties: + data: + description: The list of members who belong to this layer. + items: + $ref: '#/components/schemas/LayerRelationshipsMembersDataItems' + type: array + type: object + ScheduleMemberRelationshipsUser: + description: Wraps the user data reference for a schedule member. + properties: + data: + $ref: '#/components/schemas/ScheduleMemberRelationshipsUserData' + required: + - data + type: object + ShiftDataRelationshipsUserData: + description: >- + Represents a reference to the user assigned to this shift, containing + the user's ID and resource type. + properties: + id: + description: Specifies the unique identifier of the user. + example: 00000000-0000-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/ShiftDataRelationshipsUserDataType' + required: + - type + - id + type: object + TeamOnCallRespondersDataRelationshipsEscalationsDataItems: + description: >- + Represents a link to a specific escalation policy step associated with + the on-call team. + properties: + id: + description: Unique identifier of the escalation step. + example: '' + type: string + type: + $ref: >- + #/components/schemas/TeamOnCallRespondersDataRelationshipsEscalationsDataItemsType + required: + - type + - id + type: object + TeamOnCallRespondersDataRelationshipsRespondersDataItems: + description: Represents a user responder associated with the on-call team. + properties: + id: + description: Unique identifier of the responder. + example: '' + type: string + type: + $ref: >- + #/components/schemas/TeamOnCallRespondersDataRelationshipsRespondersDataItemsType + required: + - type + - id + type: object + EscalationRelationshipsResponders: + description: Lists the users involved in a specific step of the escalation policy. + properties: + data: + description: >- + Array of user references assigned as responders for this escalation + step. + items: + $ref: '#/components/schemas/EscalationRelationshipsRespondersDataItems' + type: array + type: object + TeamRoutingRulesDataRelationshipsRulesDataItems: + description: Defines a relationship item to link a routing rule by its ID and type. + properties: + id: + description: Specifies the unique identifier for the related routing rule. + example: '' + type: string + type: + $ref: >- + #/components/schemas/TeamRoutingRulesDataRelationshipsRulesDataItemsType + required: + - type + - id + type: object + RoutingRuleAction: + description: >- + Defines an action that is executed when a routing rule matches certain + criteria. + oneOf: + - $ref: '#/components/schemas/SendSlackMessageAction' + - $ref: '#/components/schemas/SendTeamsMessageAction' + TimeRestrictions: + description: >- + Holds time zone information and a list of time restrictions for a + routing rule. + properties: + restrictions: + description: Defines the list of time-based restrictions. + items: + $ref: '#/components/schemas/TimeRestriction' + type: array + time_zone: + description: Specifies the time zone applicable to the restrictions. + example: '' + type: string + required: + - time_zone + - restrictions + type: object + Urgency: + description: >- + Specifies the level of urgency for a routing rule (low, high, or + dynamic). + enum: + - low + - high + - dynamic + example: low + type: string + x-enum-varnames: + - LOW + - HIGH + - DYNAMIC + RoutingRuleRelationshipsPolicy: + description: Defines the relationship that links a routing rule to a policy. + properties: + data: + $ref: '#/components/schemas/RoutingRuleRelationshipsPolicyData' + nullable: true + type: object + ServiceDefinitionMetaWarnings: + description: Schema validation warnings. + properties: + instance-location: + description: The warning instance location. + type: string + keyword-location: + description: The warning keyword location. + type: string + message: + description: The warning message. + type: string + type: object + ServiceDefinitionV1: + deprecated: true + description: >- + Deprecated - Service definition V1 for providing additional service + metadata and integrations. + properties: + contact: + $ref: '#/components/schemas/ServiceDefinitionV1Contact' + extensions: + additionalProperties: {} + description: Extensions to V1 schema. + example: + myorg/extension: extensionValue + type: object + external-resources: + description: A list of external links related to the services. + items: + $ref: '#/components/schemas/ServiceDefinitionV1Resource' + type: array + info: + $ref: '#/components/schemas/ServiceDefinitionV1Info' + integrations: + $ref: '#/components/schemas/ServiceDefinitionV1Integrations' + org: + $ref: '#/components/schemas/ServiceDefinitionV1Org' + schema-version: + $ref: '#/components/schemas/ServiceDefinitionV1Version' + tags: + description: A set of custom tags. + example: + - my:tag + - service:tag + items: + type: string + type: array + required: + - schema-version + - info + type: object + ServiceDefinitionV2Dot2OpsgenieRegion: + description: Opsgenie instance region. + enum: + - US + - EU + example: US + type: string + x-enum-varnames: + - US + - EU + ServiceDefinitionV2Dot1EmailType: + description: Contact type. + enum: + - email + example: email + type: string + x-enum-varnames: + - EMAIL + ServiceDefinitionV2Dot1SlackType: + description: Contact type. + enum: + - slack + example: slack + type: string + x-enum-varnames: + - SLACK + ServiceDefinitionV2Dot1MSTeamsType: + description: Contact type. + enum: + - microsoft-teams + example: microsoft-teams + type: string + x-enum-varnames: + - MICROSOFT_TEAMS + ServiceDefinitionV2Dot1OpsgenieRegion: + description: Opsgenie instance region. + enum: + - US + - EU + example: US + type: string + x-enum-varnames: + - US + - EU + ServiceDefinitionV2EmailType: + description: Contact type. + enum: + - email + example: email + type: string + x-enum-varnames: + - EMAIL + ServiceDefinitionV2SlackType: + description: Contact type. + enum: + - slack + example: slack + type: string + x-enum-varnames: + - SLACK + ServiceDefinitionV2MSTeamsType: + description: Contact type. + enum: + - microsoft-teams + example: microsoft-teams + type: string + x-enum-varnames: + - MICROSOFT_TEAMS + ServiceDefinitionV2OpsgenieRegion: + description: Opsgenie instance region. + enum: + - US + - EU + example: US + type: string + x-enum-varnames: + - US + - EU + UserResourceType: + default: user + description: User resource type. + enum: + - user + example: user + type: string + x-enum-varnames: + - USER + TeamLinkType: + default: team_links + description: Team link type + enum: + - team_links + example: team_links + type: string + x-enum-varnames: + - TEAM_LINKS + DowntimeScheduleCurrentDowntimeResponse: + description: >- + The most recent actual start and end dates for a recurring downtime. For + a canceled downtime, + + this is the previously occurring downtime. For active downtimes, this is + the ongoing downtime, and for scheduled + + downtimes it is the upcoming downtime. + properties: + end: + description: The end of the current downtime. + example: '2020-01-02T03:04:00.000Z' + format: date-time + nullable: true + type: string + start: + description: The start of the current downtime. + example: '2020-01-02T03:04:00.000Z' + format: date-time + type: string + type: object + DowntimeScheduleRecurrenceResponse: + description: An RRULE-based recurring downtime. + properties: + duration: + $ref: '#/components/schemas/DowntimeScheduleRecurrenceDuration' + rrule: + $ref: '#/components/schemas/DowntimeScheduleRecurrenceRrule' + start: + description: >- + ISO-8601 Datetime to start the downtime. Must not include a UTC + offset. If not provided, the + + downtime starts the moment it is created. + example: 2020-01-02T03:04 + type: string + type: object + RelationshipToOrganizationData: + description: Relationship to organization object. + properties: + id: + description: ID of the organization. + example: 00000000-0000-beef-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/OrganizationsType' + required: + - id + - type + type: object + RelationshipToRoleData: + description: Relationship to role object. + properties: + id: + description: The unique identifier of the role. + example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d + type: string + type: + $ref: '#/components/schemas/RolesType' + type: object + DowntimeScheduleRecurrenceCreateUpdateRequest: + additionalProperties: {} + description: An object defining the recurrence of the downtime. + properties: + duration: + $ref: '#/components/schemas/DowntimeScheduleRecurrenceDuration' + rrule: + $ref: '#/components/schemas/DowntimeScheduleRecurrenceRrule' + start: + description: >- + ISO-8601 Datetime to start the downtime. Must not include a UTC + offset. If not provided, the + + downtime starts the moment it is created. + example: 2020-01-02T03:04 + nullable: true + type: string + required: + - duration + - rrule + type: object + IssueCaseJiraIssueResult: + description: Contains the identifiers and URL for a successfully created Jira issue. + properties: + issue_id: + description: Jira issue identifier. + example: '1904866' + type: string + issue_key: + description: Jira issue key. + example: ET-123 + type: string + issue_url: + description: Jira issue URL. + example: https://your-jira-instance.atlassian.net/browse/ET-123 + type: string + project_key: + description: Jira project key. + example: ET + type: string + type: object + ChangeEventCustomAttributesAuthor: + additionalProperties: false + description: >- + The entity that made the change. Optional, if provided it must include + `type` and `name`. + properties: + name: + description: >- + The name of the user or system that made the change. Limited to 128 + characters. + example: example@datadog.com + maxLength: 128 + minLength: 1 + type: string + type: + $ref: '#/components/schemas/ChangeEventCustomAttributesAuthorType' + required: + - name + - type + type: object + ChangeEventCustomAttributesChangedResource: + additionalProperties: false + description: A uniquely identified resource. + properties: + name: + description: >- + The name of the resource that was changed. Limited to 128 + characters. + example: fallback_payments_test + maxLength: 128 + minLength: 1 + type: string + type: + $ref: '#/components/schemas/ChangeEventCustomAttributesChangedResourceType' + required: + - type + - name + type: object + ChangeEventCustomAttributesImpactedResourcesItems: + additionalProperties: false + description: Object representing a uniquely identified resource. + properties: + name: + description: The name of the impacted resource. Limited to 128 characters. + example: payments_api + maxLength: 128 + minLength: 1 + type: string + type: + $ref: >- + #/components/schemas/ChangeEventCustomAttributesImpactedResourcesItemsType + required: + - type + - name + type: object + AlertEventCustomAttributesCustom: + additionalProperties: {} + description: >- + Free form JSON object for arbitrary data. Supports up to 100 properties + per object and a maximum nesting depth of 10 levels. + example: {} + type: object + AlertEventCustomAttributesLinks: + description: The links related to the event. Maximum of 20 links allowed. + items: + $ref: '#/components/schemas/AlertEventCustomAttributesLinksItems' + maxItems: 20 + minItems: 1 + type: array + AlertEventCustomAttributesPriority: + default: '5' + description: The priority of the alert. + enum: + - '1' + - '2' + - '3' + - '4' + - '5' + example: '5' + type: string + x-enum-varnames: + - PRIORITY_ONE + - PRIORITY_TWO + - PRIORITY_THREE + - PRIORITY_FOUR + - PRIORITY_FIVE + AlertEventCustomAttributesStatus: + description: The status of the alert. + enum: + - warn + - error + - ok + example: warn + type: string + x-enum-varnames: + - WARN + - ERROR + - OK + V2EventAggregationKey: + description: Aggregation key of the event. + example: aggregation-key + type: string + ChangeEventAttributesAuthor: + description: The entity that made the change. + properties: + name: + description: The name of the user or system that made the change. + example: example@datadog.com + type: string + type: + $ref: '#/components/schemas/ChangeEventAttributesAuthorType' + type: object + ChangeEventAttributesChangedResource: + description: A uniquely identified resource. + properties: + name: + description: The name of the changed resource. + type: string + type: + $ref: '#/components/schemas/ChangeEventAttributesChangedResourceType' + type: object + EventSystemAttributes: + description: JSON object of event system attributes. + properties: + category: + $ref: '#/components/schemas/EventSystemAttributesCategory' + id: + description: >- + Event identifier. This field is deprecated and will be removed in a + future version. Use the `uid` field instead. + type: string + integration_id: + $ref: '#/components/schemas/EventSystemAttributesIntegrationId' + source_id: + description: The source type ID of the event. + format: int64 + type: integer + uid: + description: >- + A unique identifier for the event. You can use this identifier to + query or reference the event. + type: string + type: object + ChangeEventAttributesImpactedResourcesItem: + description: A uniquely identified resource. + properties: + name: + description: The name of the impacted resource. + type: string + type: + $ref: '#/components/schemas/ChangeEventAttributesImpactedResourcesItemType' + type: object + V2EventService: + description: Service that triggered the event. + example: service-name + type: string + V2EventTimestamp: + description: POSIX timestamp of the event. + example: 175019386627 + format: int64 + type: integer + V2EventTitle: + description: The title of the event. + example: The event title + type: string + AlertEventAttributesLinksItem: + description: A link. + properties: + category: + $ref: '#/components/schemas/AlertEventAttributesLinksItemCategory' + title: + description: The display text of the link. + type: string + url: + description: The URL of the link. + type: string + type: object + AlertEventAttributesPriority: + description: The priority of the alert. + enum: + - '1' + - '2' + - '3' + - '4' + - '5' + example: '5' + type: string + x-enum-varnames: + - PRIORITY_ONE + - PRIORITY_TWO + - PRIORITY_THREE + - PRIORITY_FOUR + - PRIORITY_FIVE + AlertEventAttributesStatus: + description: The status of the alert. + enum: + - warn + - error + - ok + example: error + type: string + x-enum-varnames: + - WARN + - ERROR + - OK + IncidentFieldAttributesSingleValueType: + default: dropdown + description: Type of the single value field definitions. + enum: + - dropdown + - textbox + example: dropdown + type: string + x-enum-varnames: + - DROPDOWN + - TEXTBOX + IncidentFieldAttributesValueType: + default: multiselect + description: Type of the multiple value field definitions. + enum: + - multiselect + - textarray + - metrictag + - autocomplete + example: multiselect + type: string + x-enum-varnames: + - MULTISELECT + - TEXTARRAY + - METRICTAG + - AUTOCOMPLETE + IncidentImpactsType: + description: The incident impacts type. + enum: + - incident_impacts + example: incident_impacts + type: string + x-enum-varnames: + - INCIDENT_IMPACTS + IncidentRespondersType: + description: The incident responders type. + enum: + - incident_responders + example: incident_responders + type: string + x-enum-varnames: + - INCIDENT_RESPONDERS + IncidentUserDefinedFieldType: + description: The incident user defined fields type. + enum: + - user_defined_field + example: user_defined_field + type: string + x-enum-varnames: + - USER_DEFINED_FIELD + IncidentTimelineCellMarkdownContentType: + default: markdown + description: Type of the Markdown timeline cell. + enum: + - markdown + example: markdown + type: string + x-enum-varnames: + - MARKDOWN + IncidentTimelineCellMarkdownCreateAttributesContent: + description: The Markdown timeline cell contents. + properties: + content: + description: The Markdown content of the cell. + example: An example timeline cell message. + nullable: false + type: string + type: object + IncidentSearchResponseFacetCount: + description: Count of the facet value appearing in search results. + example: 5 + format: int32 + maximum: 2147483647 + type: integer + IncidentSearchResponseNumericFacetDataAggregates: + description: Aggregate information for numeric incident data. + properties: + max: + description: Maximum value of the numeric aggregates. + example: 1234 + format: double + nullable: true + type: number + min: + description: Minimum value of the numeric aggregates. + example: 20 + format: double + nullable: true + type: number + type: object + IncidentPostmortemType: + default: incident_postmortems + description: Incident postmortem resource type. + enum: + - incident_postmortems + example: incident_postmortems + type: string + x-enum-varnames: + - INCIDENT_POSTMORTEMS + SlackIntegrationMetadataChannelItem: + description: Item in the Slack integration metadata channel array. + properties: + channel_id: + description: Slack channel ID. + example: C0123456789 + type: string + channel_name: + description: Name of the Slack channel. + example: '#example-channel-name' + type: string + redirect_url: + description: URL redirecting to the Slack channel. + example: https://slack.com/app_redirect?channel=C0123456789&team=T01234567 + type: string + team_id: + description: Slack team ID. + example: T01234567 + type: string + required: + - channel_id + - channel_name + - redirect_url + type: object + JiraIntegrationMetadataIssuesItem: + description: Item in the Jira integration metadata issue array. + properties: + account: + description: URL of issue's Jira account. + example: https://example.atlassian.net + type: string + issue_key: + description: Jira issue's issue key. + example: PROJ-123 + type: string + issuetype_id: + description: Jira issue's issue type. + example: '1000' + type: string + project_key: + description: Jira issue's project keys. + example: PROJ + type: string + redirect_url: + description: URL redirecting to the Jira issue. + example: https://example.atlassian.net/browse/PROJ-123 + type: string + required: + - project_key + - account + type: object + MSTeamsIntegrationMetadataTeamsItem: + description: Item in the Microsoft Teams integration metadata teams array. + properties: + ms_channel_id: + description: Microsoft Teams channel ID. + example: 19:abc00abcdef00a0abcdef0abcdef0a@thread.tacv2 + type: string + ms_channel_name: + description: Microsoft Teams channel name. + example: incident-0001-example + type: string + ms_tenant_id: + description: Microsoft Teams tenant ID. + example: 00000000-abcd-0005-0000-000000000000 + type: string + redirect_url: + description: URL redirecting to the Microsoft Teams channel. + example: >- + https://teams.microsoft.com/l/channel/19%3Aabc00abcdef00a0abcdef0abcdef0a%40thread.tacv2/conversations?groupId=12345678-abcd-dcba-abcd-1234567890ab&tenantId=00000000-abcd-0005-0000-000000000000 + type: string + required: + - ms_tenant_id + - ms_channel_id + - ms_channel_name + - redirect_url + type: object + IncidentTodoAssigneeHandle: + description: Assignee's @-handle. + example: '@test.user@test.com' + type: string + IncidentTodoAnonymousAssignee: + description: Anonymous assignee entity. + properties: + icon: + description: URL for assignee's icon. + example: https://a.slack-edge.com/80588/img/slackbot_48.png + type: string + id: + description: Anonymous assignee's ID. + example: USLACKBOT + type: string + name: + description: Assignee's name. + example: Slackbot + type: string + source: + $ref: '#/components/schemas/IncidentTodoAnonymousAssigneeSource' + required: + - id + - icon + - name + - source + type: object + EscalationPolicyStepTargetType: + description: >- + Specifies the type of escalation target (example `users`, `schedules`, + or `teams`). + enum: + - users + - schedules + - teams + example: users + type: string + x-enum-varnames: + - USERS + - SCHEDULES + - TEAMS + DataRelationshipsTeamsDataItemsType: + default: teams + description: Teams resource type. + enum: + - teams + example: teams + type: string + x-enum-varnames: + - TEAMS + EscalationPolicyDataRelationshipsStepsDataItemsType: + default: steps + description: Indicates that the resource is of type `steps`. + enum: + - steps + example: steps + type: string + x-enum-varnames: + - STEPS + EscalationTarget: + description: Represents an escalation target, which can be a team, user, or schedule. + oneOf: + - $ref: '#/components/schemas/TeamTarget' + - $ref: '#/components/schemas/UserTarget' + - $ref: '#/components/schemas/ScheduleTarget' + ScheduleRequestDataAttributesLayersItemsMembersItemsUser: + description: >- + Identifies the user participating in this layer as a single object with + an `id`. + properties: + id: + description: The user's ID. + example: 00000000-aba1-0000-0000-000000000000 + type: string + type: object + Weekday: + description: A day of the week. + enum: + - monday + - tuesday + - wednesday + - thursday + - friday + - saturday + - sunday + type: string + x-enum-varnames: + - MONDAY + - TUESDAY + - WEDNESDAY + - THURSDAY + - FRIDAY + - SATURDAY + - SUNDAY + ScheduleDataRelationshipsLayersDataItemsType: + default: layers + description: Layers resource type. + enum: + - layers + example: layers + type: string + x-enum-varnames: + - LAYERS + LayerRelationshipsMembersDataItems: + description: >- + Represents a single member object in a layer's `members` array, + referencing + + a unique Datadog user ID. + properties: + id: + description: The unique user ID of the layer member. + example: 00000000-0000-0000-0000-000000000002 + type: string + type: + $ref: '#/components/schemas/LayerRelationshipsMembersDataItemsType' + required: + - type + - id + type: object + ScheduleMemberRelationshipsUserData: + description: >- + Points to the user data associated with this schedule member, including + an ID and type. + properties: + id: + description: The user's unique identifier. + example: 00000000-aba1-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/ScheduleMemberRelationshipsUserDataType' + required: + - type + - id + type: object + ShiftDataRelationshipsUserDataType: + default: users + description: Indicates that the related resource is of type 'users'. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + TeamOnCallRespondersDataRelationshipsEscalationsDataItemsType: + default: escalation_policy_steps + description: >- + Identifies the resource type for escalation policy steps linked to a + team's on-call configuration. + enum: + - escalation_policy_steps + example: escalation_policy_steps + type: string + x-enum-varnames: + - ESCALATION_POLICY_STEPS + TeamOnCallRespondersDataRelationshipsRespondersDataItemsType: + default: users + description: >- + Identifies the resource type for individual user entities associated + with on-call response. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + EscalationRelationshipsRespondersDataItems: + description: Represents a user assigned to an escalation step. + properties: + id: + description: Unique identifier of the user assigned to the escalation step. + example: '' + type: string + type: + $ref: '#/components/schemas/EscalationRelationshipsRespondersDataItemsType' + required: + - type + - id + type: object + TeamRoutingRulesDataRelationshipsRulesDataItemsType: + default: team_routing_rules + description: Indicates that the resource is of type 'team_routing_rules'. + enum: + - team_routing_rules + example: team_routing_rules + type: string + x-enum-varnames: + - TEAM_ROUTING_RULES + SendSlackMessageAction: + description: Sends a message to a Slack channel. + properties: + channel: + description: The channel ID. + example: CHANNEL + type: string + type: + $ref: '#/components/schemas/SendSlackMessageActionType' + workspace: + description: The workspace ID. + example: WORKSPACE + type: string + required: + - type + - channel + - workspace + type: object + SendTeamsMessageAction: + description: Sends a message to a Microsoft Teams channel. + properties: + channel: + description: The channel ID. + example: CHANNEL + type: string + team: + description: The team ID. + example: TEAM + type: string + tenant: + description: The tenant ID. + example: TENANT + type: string + type: + $ref: '#/components/schemas/SendTeamsMessageActionType' + required: + - type + - channel + - tenant + - team + type: object + RoutingRuleRelationshipsPolicyData: + description: >- + Represents the policy data reference, containing the policy's ID and + resource type. + properties: + id: + description: Specifies the unique identifier of the policy. + example: '' + type: string + type: + $ref: '#/components/schemas/RoutingRuleRelationshipsPolicyDataType' + required: + - type + - id + type: object + ServiceDefinitionV1Contact: + description: Contact information about the service. + properties: + email: + description: Service owner’s email. + example: contact@datadoghq.com + type: string + slack: + description: Service owner’s Slack channel. + example: https://yourcompany.slack.com/archives/channel123 + type: string + type: object + ServiceDefinitionV1Resource: + description: Service's external links. + properties: + name: + description: Link name. + example: Runbook + type: string + type: + $ref: '#/components/schemas/ServiceDefinitionV1ResourceType' + url: + description: Link URL. + example: https://my-runbook + type: string + required: + - name + - type + - url + type: object + ServiceDefinitionV1Info: + description: Basic information about a service. + properties: + dd-service: + description: >- + Unique identifier of the service. Must be unique across all services + and is used to match with a service in Datadog. + example: myservice + type: string + description: + description: A short description of the service. + example: A shopping cart service + type: string + display-name: + description: A friendly name of the service. + example: My Service + type: string + service-tier: + description: Service tier. + example: Tier 1 + type: string + required: + - dd-service + type: object + ServiceDefinitionV1Integrations: + description: Third party integrations that Datadog supports. + properties: + pagerduty: + $ref: '#/components/schemas/ServiceDefinitionV1Pagerduty' + type: object + ServiceDefinitionV1Org: + description: Org related information about the service. + properties: + application: + description: App feature this service supports. + example: E-Commerce + type: string + team: + description: Team that owns the service. + example: my-team + type: string + type: object + ServiceDefinitionV1Version: + default: v1 + description: Schema version being used. + enum: + - v1 + example: v1 + type: string + x-enum-varnames: + - V1 + DowntimeScheduleRecurrenceDuration: + description: >- + The length of the downtime. Must begin with an integer and end with one + of 'm', 'h', d', or 'w'. + example: 123d + type: string + DowntimeScheduleRecurrenceRrule: + description: >- + The `RRULE` standard for defining recurring events. + + For example, to have a recurring event on the first day of each month, + set the type to `rrule` and set the `FREQ` to `MONTHLY` and `BYMONTHDAY` + to `1`. + + Most common `rrule` options from the [iCalendar + Spec](https://tools.ietf.org/html/rfc5545) are supported. + + + **Note**: Attributes specifying the duration in `RRULE` are not + supported (for example, `DTSTART`, `DTEND`, `DURATION`). + + More examples available in this [downtime + guide](https://docs.datadoghq.com/monitors/guide/suppress-alert-with-downtimes/?tab=api). + example: FREQ=MONTHLY;BYSETPOS=3;BYDAY=WE;INTERVAL=1 + type: string + OrganizationsType: + default: orgs + description: Organizations resource type. + enum: + - orgs + example: orgs + type: string + x-enum-varnames: + - ORGS + RolesType: + default: roles + description: Roles type. + enum: + - roles + example: roles + type: string + x-enum-varnames: + - ROLES + ChangeEventCustomAttributesAuthorType: + description: Author's type. + enum: + - user + - system + - api + - automation + example: user + type: string + x-enum-varnames: + - USER + - SYSTEM + - API + - AUTOMATION + ChangeEventCustomAttributesChangedResourceType: + description: The type of the resource that was changed. + enum: + - feature_flag + - configuration + example: feature_flag + type: string + x-enum-varnames: + - FEATURE_FLAG + - CONFIGURATION + ChangeEventCustomAttributesImpactedResourcesItemsType: + description: The type of the impacted resource. + enum: + - service + example: service + type: string + x-enum-varnames: + - SERVICE + AlertEventCustomAttributesLinksItems: + additionalProperties: false + description: A link. + properties: + category: + $ref: '#/components/schemas/AlertEventCustomAttributesLinksItemsCategory' + title: + description: The display text of the link. Limited to 300 characters. + example: Runbook Link + maxLength: 300 + minLength: 1 + type: string + url: + description: The URL of the link. Limited to 2048 characters. + example: https://app.datadoghq.com/runbook + maxLength: 2048 + minLength: 1 + type: string + required: + - url + - category + type: object + ChangeEventAttributesAuthorType: + description: The type of the author. + enum: + - user + - system + - api + - automation + example: user + type: string + x-enum-varnames: + - USER + - SYSTEM + - API + - AUTOMATION + ChangeEventAttributesChangedResourceType: + description: The type of the changed resource. + enum: + - feature_flag + - configuration + example: feature_flag + type: string + x-enum-varnames: + - FEATURE_FLAG + - CONFIGURATION + EventSystemAttributesCategory: + description: Event category identifying the type of event. + enum: + - change + - alert + example: change + type: string + x-enum-varnames: + - CHANGE + - ALERT + EventSystemAttributesIntegrationId: + description: Integration ID sourced from integration manifests. + enum: + - custom-events + example: custom-events + type: string + x-enum-varnames: + - CUSTOM_EVENTS + ChangeEventAttributesImpactedResourcesItemType: + description: The type of the impacted resource. + enum: + - service + type: string + x-enum-varnames: + - SERVICE + AlertEventAttributesLinksItemCategory: + description: The category of the link. + enum: + - runbook + - documentation + - dashboard + type: string + x-enum-varnames: + - RUNBOOK + - DOCUMENTATION + - DASHBOARD + IncidentTodoAnonymousAssigneeSource: + default: slack + description: The source of the anonymous assignee. + enum: + - slack + - microsoft_teams + example: slack + type: string + x-enum-varnames: + - SLACK + - MICROSOFT_TEAMS + TeamTarget: + description: >- + Represents a team target for an escalation policy step, including the + team's ID and resource type. + properties: + id: + description: Specifies the unique identifier of the team resource. + example: 00000000-aba1-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/TeamTargetType' + required: + - type + - id + type: object + UserTarget: + description: >- + Represents a user target for an escalation policy step, including the + user's ID and resource type. + properties: + id: + description: Specifies the unique identifier of the user resource. + example: 00000000-aba1-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/UserTargetType' + required: + - type + - id + type: object + ScheduleTarget: + description: >- + Represents a schedule target for an escalation policy step, including + its ID and resource type. + properties: + id: + description: Specifies the unique identifier of the schedule resource. + example: 00000000-aba1-0000-0000-000000000000 + type: string + type: + $ref: '#/components/schemas/ScheduleTargetType' + required: + - type + - id + type: object + LayerRelationshipsMembersDataItemsType: + default: members + description: Members resource type. + enum: + - members + example: members + type: string + x-enum-varnames: + - MEMBERS + ScheduleMemberRelationshipsUserDataType: + default: users + description: Users resource type. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + EscalationRelationshipsRespondersDataItemsType: + default: users + description: >- + Represents the resource type for users assigned as responders in an + escalation step. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + SendSlackMessageActionType: + default: send_slack_message + description: Indicates that the action is a send Slack message action. + enum: + - send_slack_message + example: send_slack_message + type: string + x-enum-varnames: + - SEND_SLACK_MESSAGE + SendTeamsMessageActionType: + default: send_teams_message + description: Indicates that the action is a send Microsoft Teams message action. + enum: + - send_teams_message + example: send_teams_message + type: string + x-enum-varnames: + - SEND_TEAMS_MESSAGE + RoutingRuleRelationshipsPolicyDataType: + default: policies + description: Indicates that the resource is of type 'policies'. + enum: + - policies + example: policies + type: string + x-enum-varnames: + - POLICIES + ServiceDefinitionV1ResourceType: + description: Link type. + enum: + - doc + - wiki + - runbook + - url + - repo + - dashboard + - oncall + - code + - link + example: runbook + type: string + x-enum-varnames: + - DOC + - WIKI + - RUNBOOK + - URL + - REPO + - DASHBOARD + - ONCALL + - CODE + - LINK + ServiceDefinitionV1Pagerduty: + description: PagerDuty service URL for the service. + example: https://my-org.pagerduty.com/service-directory/PMyService + type: string + AlertEventCustomAttributesLinksItemsCategory: + description: The category of the link. + enum: + - runbook + - documentation + - dashboard + example: runbook + type: string + x-enum-varnames: + - RUNBOOK + - DOCUMENTATION + - DASHBOARD + TeamTargetType: + default: teams + description: Indicates that the resource is of type `teams`. + enum: + - teams + example: teams + type: string + x-enum-varnames: + - TEAMS + UserTargetType: + default: users + description: Indicates that the resource is of type `users`. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + ScheduleTargetType: + default: schedules + description: Indicates that the resource is of type `schedules`. + enum: + - schedules + example: schedules + type: string + x-enum-varnames: + - SCHEDULES + responses: + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + UnauthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Unauthorized + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + ConflictResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Conflict + parameters: + PageSize: + description: Size for a given page. The maximum allowed value is 100. + in: query + name: page[size] + required: false + schema: + default: 10 + example: 10 + format: int64 + type: integer + PageNumber: + description: Specific page number to return. + in: query + name: page[number] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + CaseSortableFieldParameter: + description: Specify which field to sort + in: query + name: sort[field] + required: false + schema: + $ref: '#/components/schemas/CaseSortableField' + ProjectIDPathParameter: + description: Project UUID + example: e555e290-ed65-49bd-ae18-8acbfcf18db7 + in: path + name: project_id + required: true + schema: + type: string + CaseIDPathParameter: + description: Case's UUID or key + example: f98a5a5b-e0ff-45d4-b2f5-afe6e74de504 + in: path + name: case_id + required: true + schema: + type: string + PageOffset: + description: Specific offset to use as the beginning of the returned page. + in: query + name: page[offset] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + SearchIssuesIncludeQueryParameter: + description: >- + Comma-separated list of relationship objects that should be included in + the response. + explode: false + in: query + name: include + required: false + schema: + items: + $ref: '#/components/schemas/SearchIssuesIncludeQueryParameterItem' + type: array + IssueIDPathParameter: + description: The identifier of the issue. + example: c1726a66-1f64-11ee-b338-da7ad0900002 + in: path + name: issue_id + required: true + schema: + type: string + GetIssueIncludeQueryParameter: + description: >- + Comma-separated list of relationship objects that should be included in + the response. + explode: false + in: query + name: include + required: false + schema: + items: + $ref: '#/components/schemas/GetIssueIncludeQueryParameterItem' + type: array + IncidentIncludeQueryParameter: + description: >- + Specifies which types of related objects should be included in the + response. + explode: false + in: query + name: include + required: false + schema: + items: + $ref: '#/components/schemas/IncidentRelatedObject' + type: array + IncidentNotificationRuleIncludeQueryParameter: + description: > + Comma-separated list of resources to include. Supported values: + `created_by_user`, `last_modified_by_user`, `incident_type`, + `notification_template` + explode: false + in: query + name: include + required: false + schema: + example: created_by_user,incident_type,notification_template + type: string + IncidentNotificationRuleIDPathParameter: + description: The ID of the notification rule. + in: path + name: id + required: true + schema: + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + IncidentNotificationTemplateIncidentTypeFilterQueryParameter: + description: Optional incident type ID filter. + explode: false + in: query + name: filter[incident-type] + required: false + schema: + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + IncidentNotificationTemplateIncludeQueryParameter: + description: > + Comma-separated list of relationships to include. Supported values: + `created_by_user`, `last_modified_by_user`, `incident_type` + explode: false + in: query + name: include + required: false + schema: + example: created_by_user,incident_type + type: string + IncidentNotificationTemplateIDPathParameter: + description: The ID of the notification template. + in: path + name: id + required: true + schema: + example: 00000000-0000-0000-0000-000000000001 + format: uuid + type: string + IncidentTypeIncludeDeletedParameter: + description: Include deleted incident types in the response. + in: query + name: include_deleted + schema: + default: false + type: boolean + IncidentTypeIDPathParameter: + description: The UUID of the incident type. + in: path + name: incident_type_id + required: true + schema: + type: string + IncidentSearchIncludeQueryParameter: + description: >- + Specifies which types of related objects should be included in the + response. + in: query + name: include + required: false + schema: + $ref: '#/components/schemas/IncidentRelatedObject' + IncidentSearchQueryQueryParameter: + description: >- + Specifies which incidents should be returned. The query can contain any + number of incident facets + + joined by `ANDs`, along with multiple values for each of those facets + joined by `OR`s. For + + example: `state:active AND severity:(SEV-2 OR SEV-1)`. + explode: false + in: query + name: query + required: true + schema: + type: string + IncidentSearchSortQueryParameter: + description: Specifies the order of returned incidents. + explode: false + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/IncidentSearchSortOrder' + IncidentIDPathParameter: + description: The UUID of the incident. + in: path + name: incident_id + required: true + schema: + type: string + IncidentAttachmentIncludeQueryParameter: + description: Specifies which types of related objects are included in the response. + explode: false + in: query + name: include + required: false + schema: + items: + $ref: '#/components/schemas/IncidentAttachmentRelatedObject' + type: array + IncidentAttachmentFilterQueryParameter: + description: Specifies which types of attachments are included in the response. + explode: false + in: query + name: filter[attachment_type] + required: false + schema: + items: + $ref: '#/components/schemas/IncidentAttachmentAttachmentType' + type: array + IncidentIntegrationMetadataIDPathParameter: + description: The UUID of the incident integration metadata. + in: path + name: integration_metadata_id + required: true + schema: + type: string + IncidentTodoIDPathParameter: + description: The UUID of the incident todo. + in: path + name: todo_id + required: true + schema: + type: string + IncidentServiceIncludeQueryParameter: + description: >- + Specifies which types of related objects should be included in the + response. + in: query + name: include + required: false + schema: + $ref: '#/components/schemas/IncidentRelatedObject' + IncidentServiceSearchQueryParameter: + description: A search query that filters services by name. + in: query + name: filter + required: false + schema: + example: ExampleServiceName + type: string + SchemaVersion: + description: The schema version desired in the response. + in: query + name: schema_version + required: false + schema: + $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' + ServiceName: + description: The name of the service. + in: path + name: service_name + required: true + schema: + example: my-service + type: string + IncidentServiceIDPathParameter: + description: The ID of the incident service. + in: path + name: service_id + required: true + schema: + type: string + ReportID: + description: The ID of the report job. + in: path + name: report_id + required: true + schema: + type: string + IncidentTeamIncludeQueryParameter: + description: >- + Specifies which types of related objects should be included in the + response. + in: query + name: include + required: false + schema: + $ref: '#/components/schemas/IncidentRelatedObject' + IncidentTeamSearchQueryParameter: + description: A search query that filters teams by name. + in: query + name: filter + required: false + schema: + example: ExampleTeamName + type: string + IncidentTeamIDPathParameter: + description: The ID of the incident team. + in: path + name: team_id + required: true + schema: + type: string + x-stackQL-resources: + cases: + id: datadog.service_management.cases + name: cases + title: Cases + methods: + search_cases: + operation: + $ref: '#/paths/~1api~1v2~1cases/get' + response: + mediaType: application/json + openAPIDocKey: '200' + create_case: + operation: + $ref: '#/paths/~1api~1v2~1cases/post' + response: + mediaType: application/json + openAPIDocKey: '201' + get_case: + operation: + $ref: '#/paths/~1api~1v2~1cases~1{case_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + archive_case: + operation: + $ref: '#/paths/~1api~1v2~1cases~1{case_id}~1archive/post' + response: + mediaType: application/json + openAPIDocKey: '200' + assign_case: + operation: + $ref: '#/paths/~1api~1v2~1cases~1{case_id}~1assign/post' + response: + mediaType: application/json + openAPIDocKey: '200' + update_attributes: + operation: + $ref: '#/paths/~1api~1v2~1cases~1{case_id}~1attributes/post' + response: + mediaType: application/json + openAPIDocKey: '200' + update_priority: + operation: + $ref: '#/paths/~1api~1v2~1cases~1{case_id}~1priority/post' + response: + mediaType: application/json + openAPIDocKey: '200' + update_status: + operation: + $ref: '#/paths/~1api~1v2~1cases~1{case_id}~1status/post' + response: + mediaType: application/json + openAPIDocKey: '200' + unarchive_case: + operation: + $ref: '#/paths/~1api~1v2~1cases~1{case_id}~1unarchive/post' + response: + mediaType: application/json + openAPIDocKey: '200' + unassign_case: + operation: + $ref: '#/paths/~1api~1v2~1cases~1{case_id}~1unassign/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/cases/methods/get_case' + insert: + - $ref: '#/components/x-stackQL-resources/cases/methods/create_case' + update: [] + delete: [] + replace: [] + projects: + id: datadog.service_management.projects + name: projects + title: Projects + methods: + get_projects: + operation: + $ref: '#/paths/~1api~1v2~1cases~1projects/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_project: + operation: + $ref: '#/paths/~1api~1v2~1cases~1projects/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_project: + operation: + $ref: '#/paths/~1api~1v2~1cases~1projects~1{project_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_project: + operation: + $ref: '#/paths/~1api~1v2~1cases~1projects~1{project_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/projects/methods/get_project' + - $ref: '#/components/x-stackQL-resources/projects/methods/get_projects' + insert: + - $ref: '#/components/x-stackQL-resources/projects/methods/create_project' + update: [] + delete: + - $ref: '#/components/x-stackQL-resources/projects/methods/delete_project' + replace: [] + downtimes: + id: datadog.service_management.downtimes + name: downtimes + title: Downtimes + methods: + list_downtimes: + operation: + $ref: '#/paths/~1api~1v2~1downtime/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_downtime: + operation: + $ref: '#/paths/~1api~1v2~1downtime/post' + response: + mediaType: application/json + openAPIDocKey: '200' + cancel_downtime: + operation: + $ref: '#/paths/~1api~1v2~1downtime~1{downtime_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_downtime: + operation: + $ref: '#/paths/~1api~1v2~1downtime~1{downtime_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_downtime: + operation: + $ref: '#/paths/~1api~1v2~1downtime~1{downtime_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/downtimes/methods/get_downtime' + - $ref: '#/components/x-stackQL-resources/downtimes/methods/list_downtimes' + insert: + - $ref: '#/components/x-stackQL-resources/downtimes/methods/create_downtime' + update: + - $ref: '#/components/x-stackQL-resources/downtimes/methods/update_downtime' + delete: + - $ref: '#/components/x-stackQL-resources/downtimes/methods/cancel_downtime' + replace: [] + issues: + id: datadog.service_management.issues + name: issues + title: Issues + methods: + search_issues: + operation: + $ref: '#/paths/~1api~1v2~1error-tracking~1issues~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + get_issue: + operation: + $ref: '#/paths/~1api~1v2~1error-tracking~1issues~1{issue_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_issue_assignee: + operation: + $ref: >- + #/paths/~1api~1v2~1error-tracking~1issues~1{issue_id}~1assignee/put + response: + mediaType: application/json + openAPIDocKey: '200' + update_issue_state: + operation: + $ref: '#/paths/~1api~1v2~1error-tracking~1issues~1{issue_id}~1state/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/issues/methods/get_issue' + insert: + - $ref: '#/components/x-stackQL-resources/issues/methods/search_issues' + update: [] + delete: [] + replace: [] + events: + id: datadog.service_management.events + name: events + title: Events + methods: + list_events: + operation: + $ref: '#/paths/~1api~1v2~1events/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_event: + operation: + $ref: '#/paths/~1api~1v2~1events/post' + response: + mediaType: application/json + openAPIDocKey: '202' + search_events: + operation: + $ref: '#/paths/~1api~1v2~1events~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + get_event: + operation: + $ref: '#/paths/~1api~1v2~1events~1{event_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/events/methods/get_event' + - $ref: '#/components/x-stackQL-resources/events/methods/list_events' + insert: + - $ref: '#/components/x-stackQL-resources/events/methods/create_event' + - $ref: '#/components/x-stackQL-resources/events/methods/search_events' + update: [] + delete: [] + replace: [] + incidents: + id: datadog.service_management.incidents + name: incidents + title: Incidents + methods: + list_incidents: + operation: + $ref: '#/paths/~1api~1v2~1incidents/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_incident: + operation: + $ref: '#/paths/~1api~1v2~1incidents/post' + response: + mediaType: application/json + openAPIDocKey: '201' + search_incidents: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1search/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + delete_incident: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_incident: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/incidents/methods/get_incident' + - $ref: '#/components/x-stackQL-resources/incidents/methods/list_incidents' + - $ref: >- + #/components/x-stackQL-resources/incidents/methods/search_incidents + insert: + - $ref: '#/components/x-stackQL-resources/incidents/methods/create_incident' + update: + - $ref: '#/components/x-stackQL-resources/incidents/methods/update_incident' + delete: + - $ref: '#/components/x-stackQL-resources/incidents/methods/delete_incident' + replace: [] + incident_notification_rules: + id: datadog.service_management.incident_notification_rules + name: incident_notification_rules + title: Incident Notification Rules + methods: + list_incident_notification_rules: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1config~1notification-rules/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_incident_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1config~1notification-rules/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_incident_notification_rule: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1config~1notification-rules~1{id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_incident_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1config~1notification-rules~1{id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident_notification_rule: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1config~1notification-rules~1{id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/incident_notification_rules/methods/get_incident_notification_rule + - $ref: >- + #/components/x-stackQL-resources/incident_notification_rules/methods/list_incident_notification_rules + insert: + - $ref: >- + #/components/x-stackQL-resources/incident_notification_rules/methods/create_incident_notification_rule + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/incident_notification_rules/methods/delete_incident_notification_rule + replace: + - $ref: >- + #/components/x-stackQL-resources/incident_notification_rules/methods/update_incident_notification_rule + incident_notification_templates: + id: datadog.service_management.incident_notification_templates + name: incident_notification_templates + title: Incident Notification Templates + methods: + list_incident_notification_templates: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1config~1notification-templates/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_incident_notification_template: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1config~1notification-templates/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_incident_notification_template: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1config~1notification-templates~1{id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_incident_notification_template: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1config~1notification-templates~1{id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident_notification_template: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1config~1notification-templates~1{id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/incident_notification_templates/methods/get_incident_notification_template + - $ref: >- + #/components/x-stackQL-resources/incident_notification_templates/methods/list_incident_notification_templates + insert: + - $ref: >- + #/components/x-stackQL-resources/incident_notification_templates/methods/create_incident_notification_template + update: + - $ref: >- + #/components/x-stackQL-resources/incident_notification_templates/methods/update_incident_notification_template + delete: + - $ref: >- + #/components/x-stackQL-resources/incident_notification_templates/methods/delete_incident_notification_template + replace: [] + incident_types: + id: datadog.service_management.incident_types + name: incident_types + title: Incident Types + methods: + list_incident_types: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1config~1types/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_incident_type: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1config~1types/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_incident_type: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1config~1types~1{incident_type_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_incident_type: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1config~1types~1{incident_type_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident_type: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1config~1types~1{incident_type_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/incident_types/methods/get_incident_type + - $ref: >- + #/components/x-stackQL-resources/incident_types/methods/list_incident_types + insert: + - $ref: >- + #/components/x-stackQL-resources/incident_types/methods/create_incident_type + update: + - $ref: >- + #/components/x-stackQL-resources/incident_types/methods/update_incident_type + delete: + - $ref: >- + #/components/x-stackQL-resources/incident_types/methods/delete_incident_type + replace: [] + incident_attachments: + id: datadog.service_management.incident_attachments + name: incident_attachments + title: Incident Attachments + methods: + list_incident_attachments: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1attachments/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident_attachments: + operation: + $ref: '#/paths/~1api~1v2~1incidents~1{incident_id}~1attachments/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/incident_attachments/methods/list_incident_attachments + insert: [] + update: + - $ref: >- + #/components/x-stackQL-resources/incident_attachments/methods/update_incident_attachments + delete: [] + replace: [] + incident_integrations: + id: datadog.service_management.incident_integrations + name: incident_integrations + title: Incident Integrations + methods: + list_incident_integrations: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_incident_integration: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_incident_integration: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations~1{integration_metadata_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_incident_integration: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations~1{integration_metadata_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident_integration: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1integrations~1{integration_metadata_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/incident_integrations/methods/get_incident_integration + - $ref: >- + #/components/x-stackQL-resources/incident_integrations/methods/list_incident_integrations + insert: + - $ref: >- + #/components/x-stackQL-resources/incident_integrations/methods/create_incident_integration + update: + - $ref: >- + #/components/x-stackQL-resources/incident_integrations/methods/update_incident_integration + delete: + - $ref: >- + #/components/x-stackQL-resources/incident_integrations/methods/delete_incident_integration + replace: [] + incident_todos: + id: datadog.service_management.incident_todos + name: incident_todos + title: Incident Todos + methods: + list_incident_todos: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_incident_todo: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos/post + response: + mediaType: application/json + openAPIDocKey: '201' + delete_incident_todo: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos~1{todo_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_incident_todo: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos~1{todo_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident_todo: + operation: + $ref: >- + #/paths/~1api~1v2~1incidents~1{incident_id}~1relationships~1todos~1{todo_id}/patch + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/incident_todos/methods/get_incident_todo + - $ref: >- + #/components/x-stackQL-resources/incident_todos/methods/list_incident_todos + insert: + - $ref: >- + #/components/x-stackQL-resources/incident_todos/methods/create_incident_todo + update: + - $ref: >- + #/components/x-stackQL-resources/incident_todos/methods/update_incident_todo + delete: + - $ref: >- + #/components/x-stackQL-resources/incident_todos/methods/delete_incident_todo + replace: [] + on_call_escalation_policies: + id: datadog.service_management.on_call_escalation_policies + name: on_call_escalation_policies + title: On Call Escalation Policies + methods: + create_on_call_escalation_policy: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1escalation-policies/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_on_call_escalation_policy: + operation: + $ref: >- + #/paths/~1api~1v2~1on-call~1escalation-policies~1{policy_id}/delete + response: + mediaType: application/json + openAPIDocKey: '204' + get_on_call_escalation_policy: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1escalation-policies~1{policy_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_on_call_escalation_policy: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1escalation-policies~1{policy_id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/on_call_escalation_policies/methods/get_on_call_escalation_policy + insert: + - $ref: >- + #/components/x-stackQL-resources/on_call_escalation_policies/methods/create_on_call_escalation_policy + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/on_call_escalation_policies/methods/delete_on_call_escalation_policy + replace: + - $ref: >- + #/components/x-stackQL-resources/on_call_escalation_policies/methods/update_on_call_escalation_policy + on_call_page: + id: datadog.service_management.on_call_page + name: on_call_page + title: On Call Page + methods: + create_on_call_page: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1pages/post' + response: + mediaType: application/json + openAPIDocKey: '200' + acknowledge_on_call_page: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1pages~1{page_id}~1acknowledge/post' + response: + mediaType: application/json + openAPIDocKey: '202' + escalate_on_call_page: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1pages~1{page_id}~1escalate/post' + response: + mediaType: application/json + openAPIDocKey: '202' + resolve_on_call_page: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1pages~1{page_id}~1resolve/post' + response: + mediaType: application/json + openAPIDocKey: '202' + sqlVerbs: + select: [] + insert: + - $ref: >- + #/components/x-stackQL-resources/on_call_page/methods/create_on_call_page + update: [] + delete: [] + replace: [] + on_call_schedule: + id: datadog.service_management.on_call_schedule + name: on_call_schedule + title: On Call Schedule + methods: + create_on_call_schedule: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1schedules/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_on_call_schedule: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1schedules~1{schedule_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_on_call_schedule: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1schedules~1{schedule_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_on_call_schedule: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1schedules~1{schedule_id}/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/on_call_schedule/methods/get_on_call_schedule + insert: + - $ref: >- + #/components/x-stackQL-resources/on_call_schedule/methods/create_on_call_schedule + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/on_call_schedule/methods/delete_on_call_schedule + replace: + - $ref: >- + #/components/x-stackQL-resources/on_call_schedule/methods/update_on_call_schedule + on_call_user_schedule: + id: datadog.service_management.on_call_user_schedule + name: on_call_user_schedule + title: On Call User Schedule + methods: + get_schedule_on_call_user: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1schedules~1{schedule_id}~1on-call/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/on_call_user_schedule/methods/get_schedule_on_call_user + insert: [] + update: [] + delete: [] + replace: [] + team_on_call_users: + id: datadog.service_management.team_on_call_users + name: team_on_call_users + title: Team On Call Users + methods: + get_team_on_call_users: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1teams~1{team_id}~1on-call/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/team_on_call_users/methods/get_team_on_call_users + insert: [] + update: [] + delete: [] + replace: [] + on_call_team_routing_rules: + id: datadog.service_management.on_call_team_routing_rules + name: on_call_team_routing_rules + title: On Call Team Routing Rules + methods: + get_on_call_team_routing_rules: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1teams~1{team_id}~1routing-rules/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + set_on_call_team_routing_rules: + operation: + $ref: '#/paths/~1api~1v2~1on-call~1teams~1{team_id}~1routing-rules/put' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/on_call_team_routing_rules/methods/get_on_call_team_routing_rules + insert: [] + update: [] + delete: [] + replace: + - $ref: >- + #/components/x-stackQL-resources/on_call_team_routing_rules/methods/set_on_call_team_routing_rules + incident_services: + id: datadog.service_management.incident_services + name: incident_services + title: Incident Services + methods: + list_incident_services: + operation: + $ref: '#/paths/~1api~1v2~1services/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_incident_service: + operation: + $ref: '#/paths/~1api~1v2~1services/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_incident_service: + operation: + $ref: '#/paths/~1api~1v2~1services~1{service_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_incident_service: + operation: + $ref: '#/paths/~1api~1v2~1services~1{service_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident_service: + operation: + $ref: '#/paths/~1api~1v2~1services~1{service_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/incident_services/methods/get_incident_service + - $ref: >- + #/components/x-stackQL-resources/incident_services/methods/list_incident_services + insert: + - $ref: >- + #/components/x-stackQL-resources/incident_services/methods/create_incident_service + update: + - $ref: >- + #/components/x-stackQL-resources/incident_services/methods/update_incident_service + delete: + - $ref: >- + #/components/x-stackQL-resources/incident_services/methods/delete_incident_service + replace: [] + service_definitions: + id: datadog.service_management.service_definitions + name: service_definitions + title: Service Definitions + methods: + list_service_definitions: + operation: + $ref: '#/paths/~1api~1v2~1services~1definitions/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_or_update_service_definitions: + operation: + $ref: '#/paths/~1api~1v2~1services~1definitions/post' + response: + mediaType: application/json + openAPIDocKey: '200' + delete_service_definition: + operation: + $ref: '#/paths/~1api~1v2~1services~1definitions~1{service_name}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_service_definition: + operation: + $ref: '#/paths/~1api~1v2~1services~1definitions~1{service_name}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/service_definitions/methods/get_service_definition + - $ref: >- + #/components/x-stackQL-resources/service_definitions/methods/list_service_definitions + insert: + - $ref: >- + #/components/x-stackQL-resources/service_definitions/methods/create_or_update_service_definitions + update: [] + delete: + - $ref: >- + #/components/x-stackQL-resources/service_definitions/methods/delete_service_definition + replace: [] + slo_report_job: + id: datadog.service_management.slo_report_job + name: slo_report_job + title: Slo Report Job + methods: + create_sloreport_job: + operation: + $ref: '#/paths/~1api~1v2~1slo~1report/post' + response: + mediaType: application/json + openAPIDocKey: '200' + get_sloreport: + operation: + $ref: '#/paths/~1api~1v2~1slo~1report~1{report_id}~1download/get' + response: + mediaType: text/csv + openAPIDocKey: '200' + get_sloreport_job_status: + operation: + $ref: '#/paths/~1api~1v2~1slo~1report~1{report_id}~1status/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/slo_report_job/methods/get_sloreport_job_status + insert: + - $ref: >- + #/components/x-stackQL-resources/slo_report_job/methods/create_sloreport_job + update: [] + delete: [] + replace: [] + incident_teams: + id: datadog.service_management.incident_teams + name: incident_teams + title: Incident Teams + methods: + list_incident_teams: + operation: + $ref: '#/paths/~1api~1v2~1teams/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_incident_team: + operation: + $ref: '#/paths/~1api~1v2~1teams/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_incident_team: + operation: + $ref: '#/paths/~1api~1v2~1teams~1{team_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_incident_team: + operation: + $ref: '#/paths/~1api~1v2~1teams~1{team_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_incident_team: + operation: + $ref: '#/paths/~1api~1v2~1teams~1{team_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/incident_teams/methods/get_incident_team + - $ref: >- + #/components/x-stackQL-resources/incident_teams/methods/list_incident_teams + insert: + - $ref: >- + #/components/x-stackQL-resources/incident_teams/methods/create_incident_team + update: + - $ref: >- + #/components/x-stackQL-resources/incident_teams/methods/update_incident_team + delete: + - $ref: >- + #/components/x-stackQL-resources/incident_teams/methods/delete_incident_team + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/service_scorecards.yaml b/providers/src/datadog/v00.00.00000/services/service_scorecards.yaml deleted file mode 100644 index f6825f61..00000000 --- a/providers/src/datadog/v00.00.00000/services/service_scorecards.yaml +++ /dev/null @@ -1,1593 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - service_scorecards - description: Service_Scorecards -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - OutcomesResponse: - description: Scorecard outcomes - the result of a rule for a service. - properties: - data: - $ref: '#/components/schemas/OutcomesResponseData' - included: - $ref: '#/components/schemas/OutcomesResponseIncluded' - links: - $ref: '#/components/schemas/OutcomesResponseLinks' - type: object - OutcomesResponseData: - description: List of rule outcomes. - items: - $ref: '#/components/schemas/OutcomesResponseDataItem' - type: array - OutcomesResponseIncluded: - description: Array of rule details. - items: - $ref: '#/components/schemas/OutcomesResponseIncludedItem' - type: array - OutcomesResponseLinks: - description: Links attributes. - properties: - next: - description: Link for the next set of results. - example: /api/v2/scorecard/outcomes?include=rule&page%5Blimit%5D=100&page%5Boffset%5D=100 - type: string - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - OutcomesResponseDataItem: - description: A single rule outcome. - properties: - attributes: - $ref: '#/components/schemas/OutcomesBatchResponseAttributes' - id: - description: The unique ID for a rule outcome. - type: string - relationships: - $ref: '#/components/schemas/RuleOutcomeRelationships' - type: - $ref: '#/components/schemas/OutcomeType' - type: object - OutcomesResponseIncludedItem: - description: Attributes of the included rule. - properties: - attributes: - $ref: '#/components/schemas/OutcomesResponseIncludedRuleAttributes' - id: - $ref: '#/components/schemas/RuleId' - type: - $ref: '#/components/schemas/RuleType' - type: object - OutcomesBatchResponseAttributes: - description: 'The JSON:API attributes for an outcome.' - properties: - created_at: - description: Creation time of the rule outcome. - format: date-time - type: string - modified_at: - description: Time of last rule outcome modification. - format: date-time - type: string - remarks: - description: 'Any remarks regarding the scorecard rule''s evaluation, and supports HTML hyperlinks.' - example: 'See: Services' - type: string - service_name: - description: The unique name for a service in the catalog. - example: my-service - type: string - state: - $ref: '#/components/schemas/State' - type: object - RuleOutcomeRelationships: - description: 'The JSON:API relationship to a scorecard rule.' - properties: - rule: - $ref: '#/components/schemas/RelationshipToOutcome' - type: object - OutcomeType: - default: outcome - description: 'The JSON:API type for an outcome.' - enum: - - outcome - example: outcome - type: string - x-enum-varnames: - - OUTCOME - OutcomesResponseIncludedRuleAttributes: - description: Details of a rule. - properties: - name: - description: Name of the rule. - example: Team Defined - type: string - scorecard_name: - description: The scorecard name to which this rule must belong. - example: Observability Best Practices - type: string - type: object - RuleId: - description: The unique ID for a scorecard rule. - example: 00000000-0000-beef-0000-000000000000 - type: string - RuleType: - default: rule - description: 'The JSON:API type for scorecard rules.' - enum: - - rule - example: rule - type: string - x-enum-varnames: - - RULE - State: - description: The state of the rule evaluation. - enum: - - pass - - fail - - skip - example: pass - type: string - x-enum-varnames: - - PASS - - FAIL - - SKIP - RelationshipToOutcome: - description: 'The JSON:API relationship to a scorecard outcome.' - properties: - data: - $ref: '#/components/schemas/RelationshipToOutcomeData' - type: object - RelationshipToOutcomeData: - description: 'The JSON:API relationship to an outcome, which returns the related rule id.' - properties: - id: - $ref: '#/components/schemas/RuleId' - type: - $ref: '#/components/schemas/RuleType' - type: object - OutcomesBatchRequest: - description: Scorecard outcomes batch request. - properties: - data: - $ref: '#/components/schemas/OutcomesBatchRequestData' - type: object - OutcomesBatchResponse: - description: Scorecard outcomes batch response. - properties: - data: - $ref: '#/components/schemas/OutcomesBatchResponseData' - meta: - $ref: '#/components/schemas/OutcomesBatchResponseMeta' - required: - - data - - meta - type: object - OutcomesBatchRequestData: - description: Scorecard outcomes batch request data. - properties: - attributes: - $ref: '#/components/schemas/OutcomesBatchAttributes' - type: - $ref: '#/components/schemas/OutcomesBatchType' - type: object - OutcomesBatchResponseData: - description: List of rule outcomes which were affected during the bulk operation. - items: - $ref: '#/components/schemas/OutcomesResponseDataItem' - type: array - OutcomesBatchResponseMeta: - description: Metadata pertaining to the bulk operation. - properties: - total_received: - description: Total number of scorecard results received during the bulk operation. - format: int64 - type: integer - total_updated: - description: Total number of scorecard results modified during the bulk operation. - format: int64 - type: integer - type: object - OutcomesBatchAttributes: - description: 'The JSON:API attributes for a batched set of scorecard outcomes.' - properties: - results: - description: Set of scorecard outcomes to update. - items: - $ref: '#/components/schemas/OutcomesBatchRequestItem' - type: array - type: object - OutcomesBatchType: - default: batched-outcome - description: 'The JSON:API type for scorecard outcomes.' - enum: - - batched-outcome - example: batched-outcome - type: string - x-enum-varnames: - - BATCHED_OUTCOME - OutcomesBatchRequestItem: - description: 'Scorecard outcome for a specific rule, for a given service within a batched update.' - properties: - remarks: - description: 'Any remarks regarding the scorecard rule''s evaluation, and supports HTML hyperlinks.' - example: 'See: Services' - type: string - rule_id: - $ref: '#/components/schemas/RuleId' - service_name: - description: The unique name for a service in the catalog. - example: my-service - type: string - state: - $ref: '#/components/schemas/State' - required: - - rule_id - - service_name - - state - type: object - ListRulesResponse: - description: Scorecard rules response. - properties: - data: - $ref: '#/components/schemas/ListRulesResponseData' - links: - $ref: '#/components/schemas/ListRulesResponseLinks' - type: object - ListRulesResponseData: - description: Array of rule details. - items: - $ref: '#/components/schemas/ListRulesResponseDataItem' - type: array - ListRulesResponseLinks: - description: Links attributes. - properties: - next: - description: Link for the next set of rules. - example: /api/v2/scorecard/rules?page%5Blimit%5D=2&page%5Boffset%5D=2&page%5Bsize%5D=2 - type: string - type: object - ListRulesResponseDataItem: - description: Rule details. - properties: - attributes: - $ref: '#/components/schemas/RuleAttributes' - id: - $ref: '#/components/schemas/RuleId' - relationships: - $ref: '#/components/schemas/RelationshipToRule' - type: - $ref: '#/components/schemas/RuleType' - type: object - RuleAttributes: - description: Details of a rule. - properties: - category: - deprecated: true - description: The scorecard name to which this rule must belong. - type: string - created_at: - description: Creation time of the rule outcome. - format: date-time - type: string - custom: - description: Defines if the rule is a custom rule. - type: boolean - description: - description: Explanation of the rule. - type: string - enabled: - description: 'If enabled, the rule is calculated as part of the score.' - example: true - type: boolean - modified_at: - description: Time of the last rule outcome modification. - format: date-time - type: string - name: - description: Name of the rule. - example: Team Defined - type: string - owner: - description: Owner of the rule. - type: string - scorecard_name: - description: The scorecard name to which this rule must belong. - example: Deployments automated via Deployment Trains - type: string - type: object - RelationshipToRule: - description: Scorecard create rule response relationship. - properties: - scorecard: - $ref: '#/components/schemas/RelationshipToRuleData' - type: object - RelationshipToRuleData: - description: Relationship data for a rule. - properties: - data: - $ref: '#/components/schemas/RelationshipToRuleDataObject' - type: object - RelationshipToRuleDataObject: - description: Rule relationship data. - properties: - id: - description: The unique ID for a scorecard. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/ScorecardType' - type: object - ScorecardType: - default: scorecard - description: 'The JSON:API type for scorecard.' - enum: - - scorecard - example: scorecard - type: string - x-enum-varnames: - - SCORECARD - CreateRuleRequest: - description: Scorecard create rule request. - properties: - data: - $ref: '#/components/schemas/CreateRuleRequestData' - type: object - CreateRuleResponse: - description: Created rule in response. - properties: - data: - $ref: '#/components/schemas/CreateRuleResponseData' - type: object - CreateRuleRequestData: - description: Scorecard create rule request data. - properties: - attributes: - $ref: '#/components/schemas/RuleAttributes' - type: - $ref: '#/components/schemas/RuleType' - type: object - CreateRuleResponseData: - description: Create rule response data. - properties: - attributes: - $ref: '#/components/schemas/RuleAttributes' - id: - $ref: '#/components/schemas/RuleId' - relationships: - $ref: '#/components/schemas/RelationshipToRule' - type: - $ref: '#/components/schemas/RuleType' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - scorecard_outcomes: - id: datadog.service_scorecards.scorecard_outcomes - name: scorecard_outcomes - title: Scorecard Outcomes - methods: - list_scorecard_outcomes: - operation: - $ref: '#/paths/~1api~1v2~1scorecard~1outcomes/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_scorecard_outcomes: - operation: - $ref: '#/paths/~1api~1v2~1scorecard~1outcomes/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_scorecard_outcomes_batch: - operation: - $ref: '#/paths/~1api~1v2~1scorecard~1outcomes~1batch/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/scorecard_outcomes/methods/list_scorecard_outcomes' - insert: - - $ref: '#/components/x-stackQL-resources/scorecard_outcomes/methods/create_scorecard_outcomes_batch' - update: [] - delete: [] - scorecard_rules: - id: datadog.service_scorecards.scorecard_rules - name: scorecard_rules - title: Scorecard Rules - methods: - list_scorecard_rules: - operation: - $ref: '#/paths/~1api~1v2~1scorecard~1rules/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_scorecard_rules: - operation: - $ref: '#/paths/~1api~1v2~1scorecard~1rules/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_scorecard_rule: - operation: - $ref: '#/paths/~1api~1v2~1scorecard~1rules/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_scorecard_rule: - operation: - $ref: '#/paths/~1api~1v2~1scorecard~1rules~1{rule_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/scorecard_rules/methods/list_scorecard_rules' - insert: - - $ref: '#/components/x-stackQL-resources/scorecard_rules/methods/create_scorecard_rule' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/scorecard_rules/methods/delete_scorecard_rule' -paths: - /api/v2/scorecard/outcomes: - get: - description: Fetches all rule outcomes. - operationId: ListScorecardOutcomes - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageOffset' - - description: Include related rule details in the response. - in: query - name: include - required: false - schema: - example: rule - type: string - - description: Return only specified values in the outcome attributes. - in: query - name: 'fields[outcome]' - required: false - schema: - example: 'state, service_name' - type: string - - description: Return only specified values in the included rule details. - in: query - name: 'fields[rule]' - required: false - schema: - example: name - type: string - - description: Filter the outcomes on a specific service name. - in: query - name: 'filter[outcome][service_name]' - required: false - schema: - example: web-store - type: string - - description: Filter the outcomes by a specific state. - in: query - name: 'filter[outcome][state]' - required: false - schema: - example: fail - type: string - - description: Filter outcomes on whether a rule is enabled/disabled. - in: query - name: 'filter[rule][enabled]' - required: false - schema: - example: true - type: boolean - - description: Filter outcomes based on rule ID. - in: query - name: 'filter[rule][id]' - required: false - schema: - example: f4485c79-0762-449c-96cf-c31e54a659f6 - type: string - - description: Filter outcomes based on rule name. - in: query - name: 'filter[rule][name]' - required: false - schema: - example: SLOs Defined - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OutcomesResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_read - summary: List all rule outcomes - tags: - - Service Scorecards - x-pagination: - limitParam: 'page[size]' - pageOffsetParam: 'page[offset]' - resultsPath: data - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/scorecard/outcomes/batch: - post: - description: Sets multiple service-rule outcomes in a single batched request. - operationId: CreateScorecardOutcomesBatch - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/OutcomesBatchRequest' - description: Set of scorecard outcomes. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OutcomesBatchResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_write - summary: Create outcomes batch - tags: - - Service Scorecards - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in private beta. To request access, fill out this [sign-up form](https://forms.gle/CcEyp1uJmZpxRv8U8), - and we will be in touch. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/scorecard/rules: - get: - description: Fetch all rules. - operationId: ListScorecardRules - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageOffset' - - description: Include related scorecard details in the response. - in: query - name: include - required: false - schema: - example: scorecard - type: string - - description: Filter the rules on a rule ID. - in: query - name: 'filter[rule][id]' - required: false - schema: - example: 37d2f990-c885-4972-949b-8b798213a166 - type: string - - description: Filter for enabled rules only. - in: query - name: 'filter[rule][enabled]' - required: false - schema: - example: true - type: boolean - - description: Filter for custom rules only. - in: query - name: 'filter[rule][custom]' - required: false - schema: - example: true - type: boolean - - description: Filter rules on the rule name. - in: query - name: 'filter[rule][name]' - required: false - schema: - example: Code Repos Defined - type: string - - description: Filter rules on the rule description. - in: query - name: 'filter[rule][description]' - required: false - schema: - example: Identifying - type: string - - description: Return only specific fields in the response for rule attributes. - in: query - name: 'fields[rule]' - required: false - schema: - example: 'name, description' - type: string - - description: Return only specific fields in the included response for scorecard attributes. - in: query - name: 'fields[scorecard]' - required: false - schema: - example: name - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/ListRulesResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_read - summary: List all rules - tags: - - Service Scorecards - x-pagination: - limitParam: 'page[size]' - pageOffsetParam: 'page[offset]' - resultsPath: data - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - post: - description: Creates a new rule. - operationId: CreateScorecardRule - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/CreateRuleRequest' - description: Rule attributes. - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/CreateRuleResponse' - description: Created - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_write - summary: Create a new rule - tags: - - Service Scorecards - x-codegen-request-body-name: body - x-unstable: |- - **Note**: This endpoint is in private beta. To request access, fill out this [sign-up form](https://forms.gle/CcEyp1uJmZpxRv8U8), - and we will be in touch. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - '/api/v2/scorecard/rules/{rule_id}': - delete: - description: Deletes a single rule. - operationId: DeleteScorecardRule - parameters: - - $ref: '#/components/parameters/RuleId' - responses: - '204': - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - apm_service_catalog_write - summary: Delete a rule - tags: - - Service Scorecards - x-unstable: |- - **Note**: This endpoint is in private beta. To request access, fill out this [sign-up form](https://forms.gle/CcEyp1uJmZpxRv8U8), - and we will be in touch. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). diff --git a/providers/src/datadog/v00.00.00000/services/software_delivery.yaml b/providers/src/datadog/v00.00.00000/services/software_delivery.yaml new file mode 100644 index 00000000..4949c57e --- /dev/null +++ b/providers/src/datadog/v00.00.00000/services/software_delivery.yaml @@ -0,0 +1,4550 @@ +openapi: 3.0.0 +info: + title: software_delivery API + description: datadog software_delivery API + version: '1.0' +paths: + /api/v2/ci/pipeline: + post: + description: >- + Send your pipeline event to your Datadog platform over HTTP. For details + about how pipeline executions are modeled and what execution types we + support, see [Pipeline Data Model And Execution + Types](https://docs.datadoghq.com/continuous_integration/guides/pipeline_data_model/). + + + Multiple events can be sent in an array (up to 1000). + + + Pipeline events can be submitted with a timestamp that is up to 18 hours + in the past. + operationId: CreateCIAppPipelineEvent + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppCreatePipelineEventRequest' + required: true + responses: + '202': + content: + application/json: + schema: + type: object + description: Request accepted for processing + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPCIAppErrors' + description: Bad Request + '401': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPCIAppErrors' + description: Unauthorized + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPCIAppErrors' + description: Forbidden + '408': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPCIAppErrors' + description: Request Timeout + '413': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPCIAppErrors' + description: Payload Too Large + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPCIAppErrors' + description: Too Many Requests + '500': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPCIAppErrors' + description: Internal Server Error + '503': + content: + application/json: + schema: + $ref: '#/components/schemas/HTTPCIAppErrors' + description: Service Unavailable + security: + - apiKeyAuth: [] + summary: Send pipeline event + tags: + - CI Visibility Pipelines + x-codegen-request-body-name: body + /api/v2/ci/pipelines/analytics/aggregate: + post: + description: >- + Use this API endpoint to aggregate CI Visibility pipeline events into + buckets of computed metrics and timeseries. + operationId: AggregateCIAppPipelineEvents + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppPipelinesAggregateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppPipelinesAnalyticsAggregateResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - ci_visibility_read + summary: Aggregate pipelines events + tags: + - CI Visibility Pipelines + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - ci_visibility_read + /api/v2/ci/pipelines/events: + get: + description: >- + List endpoint returns CI Visibility pipeline events that match a [search + query](https://docs.datadoghq.com/continuous_integration/explorer/search_syntax/). + + [Results are paginated similarly to + logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). + + + Use this endpoint to see your latest pipeline events. + operationId: ListCIAppPipelineEvents + parameters: + - description: Search query following log syntax. + example: '@ci.provider.name:github @ci.pipeline.name:Pull Request Labeler' + in: query + name: filter[query] + required: false + schema: + type: string + - description: Minimum timestamp for requested events. + example: '2019-01-02T09:42:36.320Z' + in: query + name: filter[from] + required: false + schema: + format: date-time + type: string + - description: Maximum timestamp for requested events. + example: '2019-01-03T09:42:36.320Z' + in: query + name: filter[to] + required: false + schema: + format: date-time + type: string + - description: Order of events in results. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/CIAppSort' + - description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + in: query + name: page[cursor] + required: false + schema: + type: string + - description: Maximum number of events in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 10 + format: int32 + maximum: 1000 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppPipelineEventsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - ci_visibility_read + summary: Get a list of pipelines events + tags: + - CI Visibility Pipelines + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + x-permission: + operator: OR + permissions: + - ci_visibility_read + /api/v2/ci/pipelines/events/search: + post: + description: >- + List endpoint returns CI Visibility pipeline events that match a [search + query](https://docs.datadoghq.com/continuous_integration/explorer/search_syntax/). + + [Results are paginated similarly to + logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). + + + Use this endpoint to build complex events filtering and search. + operationId: SearchCIAppPipelineEvents + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppPipelineEventsRequest' + required: false + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppPipelineEventsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - ci_visibility_read + summary: Search pipelines events + tags: + - CI Visibility Pipelines + x-codegen-request-body-name: body + x-pagination: + cursorParam: body.page.cursor + cursorPath: meta.page.after + limitParam: body.page.limit + resultsPath: data + x-permission: + operator: OR + permissions: + - ci_visibility_read + /api/v2/ci/tests/analytics/aggregate: + post: + description: >- + The API endpoint to aggregate CI Visibility test events into buckets of + computed metrics and timeseries. + operationId: AggregateCIAppTestEvents + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppTestsAggregateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppTestsAnalyticsAggregateResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - ci_visibility_read + - AuthZ: + - test_optimization_read + summary: Aggregate tests events + tags: + - CI Visibility Tests + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - ci_visibility_read + - test_optimization_read + /api/v2/ci/tests/events: + get: + description: >- + List endpoint returns CI Visibility test events that match a [search + query](https://docs.datadoghq.com/continuous_integration/explorer/search_syntax/). + + [Results are paginated similarly to + logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). + + + Use this endpoint to see your latest test events. + operationId: ListCIAppTestEvents + parameters: + - description: Search query following log syntax. + example: '@test.name:test_foo @test.suite:github.com/DataDog/dd-go/model' + in: query + name: filter[query] + required: false + schema: + type: string + - description: Minimum timestamp for requested events. + example: '2019-01-02T09:42:36.320Z' + in: query + name: filter[from] + required: false + schema: + format: date-time + type: string + - description: Maximum timestamp for requested events. + example: '2019-01-03T09:42:36.320Z' + in: query + name: filter[to] + required: false + schema: + format: date-time + type: string + - description: Order of events in results. + in: query + name: sort + required: false + schema: + $ref: '#/components/schemas/CIAppSort' + - description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + in: query + name: page[cursor] + required: false + schema: + type: string + - description: Maximum number of events in the response. + example: 25 + in: query + name: page[limit] + required: false + schema: + default: 10 + format: int32 + maximum: 1000 + type: integer + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppTestEventsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - ci_visibility_read + - AuthZ: + - test_optimization_read + summary: Get a list of tests events + tags: + - CI Visibility Tests + x-pagination: + cursorParam: page[cursor] + cursorPath: meta.page.after + limitParam: page[limit] + resultsPath: data + x-permission: + operator: OR + permissions: + - ci_visibility_read + - test_optimization_read + /api/v2/ci/tests/events/search: + post: + description: >- + List endpoint returns CI Visibility test events that match a [search + query](https://docs.datadoghq.com/continuous_integration/explorer/search_syntax/). + + [Results are paginated similarly to + logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination). + + + Use this endpoint to build complex events filtering and search. + operationId: SearchCIAppTestEvents + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppTestEventsRequest' + required: false + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/CIAppTestEventsResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - ci_visibility_read + - AuthZ: + - test_optimization_read + summary: Search tests events + tags: + - CI Visibility Tests + x-codegen-request-body-name: body + x-pagination: + cursorParam: body.page.cursor + cursorPath: meta.page.after + limitParam: body.page.limit + resultsPath: data + x-permission: + operator: OR + permissions: + - ci_visibility_read + - test_optimization_read + /api/v2/dora/deployment: + post: + description: >- + Use this API endpoint to provide data about deployments for DORA + metrics. + + + This is necessary for: + + - Deployment Frequency + + - Change Lead Time + + - Change Failure Rate + operationId: CreateDORADeployment + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DORADeploymentRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DORADeploymentResponse' + description: OK + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/DORADeploymentResponse' + description: OK - but delayed due to incident + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + summary: Send a deployment event for DORA Metrics + tags: + - DORA Metrics + x-codegen-request-body-name: body + /api/v2/dora/deployments: + post: + description: Use this API endpoint to get a list of deployment events. + operationId: ListDORADeployments + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DORAListDeploymentsRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DORAListResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Get a list of deployment events + tags: + - DORA Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - dora_metrics_read + /api/v2/dora/deployments/{deployment_id}: + get: + description: Use this API endpoint to get a deployment event. + operationId: GetDORADeployment + parameters: + - description: The ID of the deployment event. + in: path + name: deployment_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DORAFetchResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + - appKeyAuth: [] + summary: Get a deployment event + tags: + - DORA Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - dora_metrics_read + /api/v2/dora/failure: + post: + description: |- + Use this API endpoint to provide failure data for DORA metrics. + + This is necessary for: + - Change Failure Rate + - Time to Restore + operationId: CreateDORAFailure + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DORAFailureRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DORAFailureResponse' + description: OK + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/DORAFailureResponse' + description: OK - but delayed due to incident + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + summary: Send a failure event for DORA Metrics + tags: + - DORA Metrics + x-codegen-request-body-name: body + /api/v2/dora/failures: + post: + description: Use this API endpoint to get a list of failure events. + operationId: ListDORAFailures + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DORAListFailuresRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DORAListResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + summary: Get a list of failure events + tags: + - DORA Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - dora_metrics_read + /api/v2/dora/failures/{failure_id}: + get: + description: Use this API endpoint to get a failure event. + operationId: GetDORAFailure + parameters: + - description: The ID of the failure event. + in: path + name: failure_id + required: true + schema: + type: string + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DORAFetchResponse' + description: OK + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + - appKeyAuth: [] + summary: Get a failure event + tags: + - DORA Metrics + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - dora_metrics_read + /api/v2/dora/incident: + post: + deprecated: true + description: >- + **Note**: This endpoint is deprecated. Please use `/api/v2/dora/failure` + instead. + + + Use this API endpoint to provide failure data for DORA metrics. + + + This is necessary for: + + - Change Failure Rate + + - Time to Restore + operationId: CreateDORAIncident + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/DORAFailureRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/DORAFailureResponse' + description: OK + '202': + content: + application/json: + schema: + $ref: '#/components/schemas/DORAFailureResponse' + description: OK - but delayed due to incident + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad Request + '403': + $ref: '#/components/responses/NotAuthorizedResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + summary: Send an incident event for DORA Metrics + tags: + - DORA Metrics + x-codegen-request-body-name: body + /api/v2/workflows: + post: + description: >- + Create a new workflow, returning the workflow ID. This API requires a + [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: CreateWorkflow + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/CreateWorkflowRequest' + required: true + responses: + '201': + content: + application/json: + schema: + $ref: '#/components/schemas/CreateWorkflowResponse' + description: Successfully created a workflow. + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too many requests + summary: Create a Workflow + tags: + - Workflow Automation + x-permission: + operator: OR + permissions: + - workflows_write + /api/v2/workflows/{workflow_id}: + delete: + description: >- + Delete a workflow by ID. This API requires a [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: DeleteWorkflow + parameters: + - $ref: '#/components/parameters/WorkflowId' + responses: + '204': + description: Successfully deleted a workflow. + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too many requests + summary: Delete an existing Workflow + tags: + - Workflow Automation + x-permission: + operator: OR + permissions: + - workflows_write + get: + description: >- + Get a workflow by ID. This API requires a [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: GetWorkflow + parameters: + - $ref: '#/components/parameters/WorkflowId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/GetWorkflowResponse' + description: Successfully got a workflow. + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too many requests + summary: Get an existing Workflow + tags: + - Workflow Automation + x-permission: + operator: OR + permissions: + - workflows_read + patch: + description: >- + Update a workflow by ID. This API requires a [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: UpdateWorkflow + parameters: + - $ref: '#/components/parameters/WorkflowId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateWorkflowRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/UpdateWorkflowResponse' + description: Successfully updated a workflow. + '400': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Bad request + '403': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Forbidden + '404': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Not found + '429': + content: + application/json: + schema: + $ref: '#/components/schemas/JSONAPIErrorResponse' + description: Too many requests + summary: Update an existing Workflow + tags: + - Workflow Automation + x-permission: + operator: OR + permissions: + - workflows_write + /api/v2/workflows/{workflow_id}/instances: + get: + description: >- + List all instances of a given workflow. This API requires a [registered + application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: ListWorkflowInstances + parameters: + - $ref: '#/components/parameters/WorkflowId' + - $ref: '#/components/parameters/PageSize' + - $ref: '#/components/parameters/PageNumber' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/WorkflowListInstancesResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - workflows_read + summary: List workflow instances + tags: + - Workflow Automation + x-permission: + operator: OR + permissions: + - workflows_read + post: + description: >- + Execute the given workflow. This API requires a [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: CreateWorkflowInstance + parameters: + - $ref: '#/components/parameters/WorkflowId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/WorkflowInstanceCreateRequest' + required: true + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/WorkflowInstanceCreateResponse' + description: Created + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - workflows_run + summary: Execute a workflow + tags: + - Workflow Automation + x-codegen-request-body-name: body + x-permission: + operator: OR + permissions: + - workflows_run + /api/v2/workflows/{workflow_id}/instances/{instance_id}: + get: + description: >- + Get a specific execution of a given workflow. This API requires a + [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: GetWorkflowInstance + parameters: + - $ref: '#/components/parameters/WorkflowId' + - $ref: '#/components/parameters/InstanceId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/WorklflowGetInstanceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + security: + - apiKeyAuth: [] + appKeyAuth: [] + - AuthZ: + - workflows_read + summary: Get a workflow instance + tags: + - Workflow Automation + x-permission: + operator: OR + permissions: + - workflows_read + /api/v2/workflows/{workflow_id}/instances/{instance_id}/cancel: + put: + description: >- + Cancels a specific execution of a given workflow. This API requires a + [registered application + key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). + Alternatively, you can configure these permissions [in the + UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). + operationId: CancelWorkflowInstance + parameters: + - $ref: '#/components/parameters/WorkflowId' + - $ref: '#/components/parameters/InstanceId' + responses: + '200': + content: + application/json: + schema: + $ref: '#/components/schemas/WorklflowCancelInstanceResponse' + description: OK + '400': + $ref: '#/components/responses/BadRequestResponse' + '403': + $ref: '#/components/responses/ForbiddenResponse' + '404': + $ref: '#/components/responses/NotFoundResponse' + '429': + $ref: '#/components/responses/TooManyRequestsResponse' + summary: Cancel a workflow instance + tags: + - Workflow Automation + x-permission: + operator: OR + permissions: + - workflows_run +components: + schemas: + CIAppCreatePipelineEventRequest: + description: Request object. + properties: + data: + $ref: >- + #/components/schemas/CIAppCreatePipelineEventRequestDataSingleOrArray + type: object + HTTPCIAppErrors: + description: Errors occurred. + properties: + errors: + description: Structured errors. + items: + $ref: '#/components/schemas/HTTPCIAppError' + type: array + type: object + CIAppPipelinesAggregateRequest: + description: >- + The object sent with the request to retrieve aggregation buckets of + pipeline events from your organization. + properties: + compute: + description: >- + The list of metrics or timeseries to compute for the retrieved + buckets. + items: + $ref: '#/components/schemas/CIAppCompute' + type: array + filter: + $ref: '#/components/schemas/CIAppPipelinesQueryFilter' + group_by: + description: The rules for the group-by. + items: + $ref: '#/components/schemas/CIAppPipelinesGroupBy' + type: array + options: + $ref: '#/components/schemas/CIAppQueryOptions' + type: object + CIAppPipelinesAnalyticsAggregateResponse: + description: The response object for the pipeline events aggregate API endpoint. + properties: + data: + $ref: '#/components/schemas/CIAppPipelinesAggregationBucketsResponse' + links: + $ref: '#/components/schemas/CIAppResponseLinks' + meta: + $ref: '#/components/schemas/CIAppResponseMetadata' + type: object + CIAppSort: + description: Sort parameters when querying events. + enum: + - timestamp + - '-timestamp' + type: string + x-enum-varnames: + - TIMESTAMP_ASCENDING + - TIMESTAMP_DESCENDING + CIAppPipelineEventsResponse: + description: >- + Response object with all pipeline events matching the request and + pagination information. + properties: + data: + description: Array of events matching the request. + items: + $ref: '#/components/schemas/CIAppPipelineEvent' + type: array + links: + $ref: '#/components/schemas/CIAppResponseLinks' + meta: + $ref: '#/components/schemas/CIAppResponseMetadataWithPagination' + type: object + CIAppPipelineEventsRequest: + description: The request for a pipelines search. + properties: + filter: + $ref: '#/components/schemas/CIAppPipelinesQueryFilter' + options: + $ref: '#/components/schemas/CIAppQueryOptions' + page: + $ref: '#/components/schemas/CIAppQueryPageOptions' + sort: + $ref: '#/components/schemas/CIAppSort' + type: object + CIAppTestsAggregateRequest: + description: >- + The object sent with the request to retrieve aggregation buckets of test + events from your organization. + properties: + compute: + description: >- + The list of metrics or timeseries to compute for the retrieved + buckets. + items: + $ref: '#/components/schemas/CIAppCompute' + type: array + filter: + $ref: '#/components/schemas/CIAppTestsQueryFilter' + group_by: + description: The rules for the group-by. + items: + $ref: '#/components/schemas/CIAppTestsGroupBy' + type: array + options: + $ref: '#/components/schemas/CIAppQueryOptions' + type: object + CIAppTestsAnalyticsAggregateResponse: + description: The response object for the test events aggregate API endpoint. + properties: + data: + $ref: '#/components/schemas/CIAppTestsAggregationBucketsResponse' + links: + $ref: '#/components/schemas/CIAppResponseLinks' + meta: + $ref: '#/components/schemas/CIAppResponseMetadataWithPagination' + type: object + CIAppTestEventsResponse: + description: >- + Response object with all test events matching the request and pagination + information. + properties: + data: + description: Array of events matching the request. + items: + $ref: '#/components/schemas/CIAppTestEvent' + type: array + links: + $ref: '#/components/schemas/CIAppResponseLinks' + meta: + $ref: '#/components/schemas/CIAppResponseMetadataWithPagination' + type: object + CIAppTestEventsRequest: + description: The request for a tests search. + properties: + filter: + $ref: '#/components/schemas/CIAppTestsQueryFilter' + options: + $ref: '#/components/schemas/CIAppQueryOptions' + page: + $ref: '#/components/schemas/CIAppQueryPageOptions' + sort: + $ref: '#/components/schemas/CIAppSort' + type: object + DORADeploymentRequest: + description: Request to create a DORA deployment event. + properties: + data: + $ref: '#/components/schemas/DORADeploymentRequestData' + required: + - data + type: object + DORADeploymentResponse: + description: Response after receiving a DORA deployment event. + properties: + data: + $ref: '#/components/schemas/DORADeploymentResponseData' + required: + - data + type: object + JSONAPIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + items: + $ref: '#/components/schemas/JSONAPIErrorItem' + type: array + required: + - errors + type: object + DORAListDeploymentsRequest: + description: Request to get a list of deployments. + properties: + data: + $ref: '#/components/schemas/DORAListDeploymentsRequestData' + required: + - data + type: object + DORAListResponse: + description: Response for the DORA list endpoints. + properties: + data: + description: The list of DORA events. + items: + $ref: '#/components/schemas/DORAEvent' + type: array + type: object + DORAFetchResponse: + description: Response for the DORA fetch endpoints. + properties: + data: + $ref: '#/components/schemas/DORAEvent' + type: object + DORAFailureRequest: + description: Request to create a DORA failure event. + properties: + data: + $ref: '#/components/schemas/DORAFailureRequestData' + required: + - data + type: object + DORAFailureResponse: + description: Response after receiving a DORA failure event. + properties: + data: + $ref: '#/components/schemas/DORAFailureResponseData' + required: + - data + type: object + DORAListFailuresRequest: + description: Request to get a list of failures. + properties: + data: + $ref: '#/components/schemas/DORAListFailuresRequestData' + required: + - data + type: object + CreateWorkflowRequest: + description: A request object for creating a new workflow. + example: + data: + attributes: + description: A sample workflow. + name: Example Workflow + published: true + spec: + annotations: + - display: + bounds: + height: 150 + width: 300 + x: -375 + 'y': -0.5 + id: 99999999-9999-9999-9999-999999999999 + markdownTextAnnotation: + text: Example annotation. + connectionEnvs: + - connections: + - connectionId: 11111111-1111-1111-1111-111111111111 + label: INTEGRATION_DATADOG + env: default + handle: my-handle + inputSchema: + parameters: + - defaultValue: default + name: input + type: STRING + outputSchema: + parameters: + - name: output + type: ARRAY_OBJECT + value: '{{ Steps.Step1 }}' + steps: + - actionId: com.datadoghq.dd.monitor.listMonitors + connectionLabel: INTEGRATION_DATADOG + name: Step1 + outboundEdges: + - branchName: main + nextStepName: Step2 + parameters: + - name: tags + value: service:monitoring + - actionId: com.datadoghq.core.noop + name: Step2 + triggers: + - monitorTrigger: + rateLimit: + count: 1 + interval: 3600s + startStepNames: + - Step1 + - githubWebhookTrigger: {} + startStepNames: + - Step1 + tags: + - team:infra + - service:monitoring + - foo:bar + type: workflows + properties: + data: + $ref: '#/components/schemas/WorkflowData' + required: + - data + type: object + CreateWorkflowResponse: + description: The response object after creating a new workflow. + properties: + data: + $ref: '#/components/schemas/WorkflowData' + required: + - data + type: object + GetWorkflowResponse: + description: The response object after getting a workflow. + properties: + data: + $ref: '#/components/schemas/WorkflowData' + type: object + UpdateWorkflowRequest: + description: A request object for updating an existing workflow. + example: + data: + attributes: + description: A sample workflow. + name: Example Workflow + published: true + spec: + annotations: + - display: + bounds: + height: 150 + width: 300 + x: -375 + 'y': -0.5 + id: 99999999-9999-9999-9999-999999999999 + markdownTextAnnotation: + text: Example annotation. + connectionEnvs: + - connections: + - connectionId: 11111111-1111-1111-1111-111111111111 + label: INTEGRATION_DATADOG + env: default + handle: my-handle + inputSchema: + parameters: + - defaultValue: default + name: input + type: STRING + outputSchema: + parameters: + - name: output + type: ARRAY_OBJECT + value: '{{ Steps.Step1 }}' + steps: + - actionId: com.datadoghq.dd.monitor.listMonitors + connectionLabel: INTEGRATION_DATADOG + name: Step1 + outboundEdges: + - branchName: main + nextStepName: Step2 + parameters: + - name: tags + value: service:monitoring + - actionId: com.datadoghq.core.noop + name: Step2 + triggers: + - monitorTrigger: + rateLimit: + count: 1 + interval: 3600s + startStepNames: + - Step1 + - githubWebhookTrigger: {} + startStepNames: + - Step1 + tags: + - team:infra + - service:monitoring + - foo:bar + id: 22222222-2222-2222-2222-222222222222 + type: workflows + properties: + data: + $ref: '#/components/schemas/WorkflowDataUpdate' + required: + - data + type: object + UpdateWorkflowResponse: + description: The response object after updating a workflow. + properties: + data: + $ref: '#/components/schemas/WorkflowDataUpdate' + type: object + WorkflowListInstancesResponse: + additionalProperties: {} + description: Response returned when listing workflow instances. + properties: + data: + description: A list of workflow instances. + items: + $ref: '#/components/schemas/WorkflowInstanceListItem' + type: array + meta: + $ref: '#/components/schemas/WorkflowListInstancesResponseMeta' + type: object + WorkflowInstanceCreateRequest: + description: Request used to create a workflow instance. + properties: + meta: + $ref: '#/components/schemas/WorkflowInstanceCreateMeta' + type: object + WorkflowInstanceCreateResponse: + additionalProperties: {} + description: Response returned upon successful workflow instance creation. + properties: + data: + $ref: '#/components/schemas/WorkflowInstanceCreateResponseData' + type: object + WorklflowGetInstanceResponse: + additionalProperties: {} + description: The state of the given workflow instance. + properties: + data: + $ref: '#/components/schemas/WorklflowGetInstanceResponseData' + type: object + WorklflowCancelInstanceResponse: + description: Information about the canceled instance. + properties: + data: + $ref: '#/components/schemas/WorklflowCancelInstanceResponseData' + type: object + CIAppCreatePipelineEventRequestDataSingleOrArray: + description: Data of the pipeline events to create. + oneOf: + - $ref: '#/components/schemas/CIAppCreatePipelineEventRequestData' + - $ref: '#/components/schemas/CIAppCreatePipelineEventRequestDataArray' + HTTPCIAppError: + description: List of errors. + properties: + detail: + description: Error message. + example: Malformed payload + type: string + status: + description: Error code. + example: '400' + type: string + title: + description: Error title. + example: Bad Request + type: string + type: object + CIAppCompute: + description: A compute rule to compute metrics or timeseries. + properties: + aggregation: + $ref: '#/components/schemas/CIAppAggregationFunction' + interval: + description: |- + The time buckets' size (only used for type=timeseries) + Defaults to a resolution of 150 points. + example: 5m + type: string + metric: + description: The metric to use. + example: '@duration' + type: string + type: + $ref: '#/components/schemas/CIAppComputeType' + required: + - aggregation + type: object + CIAppPipelinesQueryFilter: + description: The search and filter query settings. + properties: + from: + default: now-15m + description: >- + The minimum time for the requested events; supports date, math, and + regular timestamps (in milliseconds). + example: now-15m + type: string + query: + default: '*' + description: The search query following the CI Visibility Explorer search syntax. + example: '@ci.provider.name:github AND @ci.status:error' + type: string + to: + default: now + description: >- + The maximum time for the requested events, supports date, math, and + regular timestamps (in milliseconds). + example: now + type: string + type: object + CIAppPipelinesGroupBy: + description: A group-by rule. + properties: + facet: + description: The name of the facet to use (required). + example: '@ci.status' + type: string + histogram: + $ref: '#/components/schemas/CIAppGroupByHistogram' + limit: + default: 10 + description: The maximum buckets to return for this group-by. + format: int64 + type: integer + missing: + $ref: '#/components/schemas/CIAppGroupByMissing' + sort: + $ref: '#/components/schemas/CIAppAggregateSort' + total: + $ref: '#/components/schemas/CIAppGroupByTotal' + required: + - facet + type: object + CIAppQueryOptions: + description: >- + Global query options that are used during the query. + + Only supply timezone or time offset, not both. Otherwise, the query + fails. + properties: + time_offset: + description: The time offset (in seconds) to apply to the query. + format: int64 + type: integer + timezone: + default: UTC + description: >- + The timezone can be specified as GMT, UTC, an offset from UTC (like + UTC+1), or as a Timezone Database identifier (like + America/New_York). + example: GMT + type: string + type: object + CIAppPipelinesAggregationBucketsResponse: + description: The query results. + properties: + buckets: + description: The list of matching buckets, one item per bucket. + items: + $ref: '#/components/schemas/CIAppPipelinesBucketResponse' + type: array + type: object + CIAppResponseLinks: + description: Links attributes. + properties: + next: + description: >- + Link for the next set of results. The request can also be made using + the + + POST endpoint. + example: >- + https://app.datadoghq.com/api/v2/ci/tests/events?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + CIAppResponseMetadata: + description: The metadata associated with a request. + properties: + elapsed: + description: The time elapsed in milliseconds. + example: 132 + format: int64 + type: integer + request_id: + description: The identifier of the request. + example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR + type: string + status: + $ref: '#/components/schemas/CIAppResponseStatus' + warnings: + description: >- + A list of warnings (non-fatal errors) encountered. Partial results + may return if + + warnings are present in the response. + items: + $ref: '#/components/schemas/CIAppWarning' + type: array + type: object + APIErrorResponse: + description: API error response. + properties: + errors: + description: A list of errors. + example: + - Bad Request + items: + description: A list of items. + example: Bad Request + type: string + type: array + required: + - errors + type: object + CIAppPipelineEvent: + description: >- + Object description of a pipeline event after being processed and stored + by Datadog. + properties: + attributes: + $ref: '#/components/schemas/CIAppPipelineEventAttributes' + id: + description: Unique ID of the event. + example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA + type: string + type: + $ref: '#/components/schemas/CIAppPipelineEventTypeName' + type: object + CIAppResponseMetadataWithPagination: + description: The metadata associated with a request. + properties: + elapsed: + description: The time elapsed in milliseconds. + example: 132 + format: int64 + type: integer + page: + $ref: '#/components/schemas/CIAppResponsePage' + request_id: + description: The identifier of the request. + example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR + type: string + status: + $ref: '#/components/schemas/CIAppResponseStatus' + warnings: + description: >- + A list of warnings (non-fatal errors) encountered. Partial results + may return if + + warnings are present in the response. + items: + $ref: '#/components/schemas/CIAppWarning' + type: array + type: object + CIAppQueryPageOptions: + description: Paging attributes for listing events. + properties: + cursor: + description: List following results with a cursor provided in the previous query. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + limit: + default: 10 + description: Maximum number of events in the response. + example: 25 + format: int32 + maximum: 1000 + type: integer + type: object + CIAppTestsQueryFilter: + description: The search and filter query settings. + properties: + from: + default: now-15m + description: >- + The minimum time for the requested events; supports date, math, and + regular timestamps (in milliseconds). + example: now-15m + type: string + query: + default: '*' + description: The search query following the CI Visibility Explorer search syntax. + example: '@test.service:web-ui-tests AND @test.status:fail' + type: string + to: + default: now + description: >- + The maximum time for the requested events, supports date, math, and + regular timestamps (in milliseconds). + example: now + type: string + type: object + CIAppTestsGroupBy: + description: A group-by rule. + properties: + facet: + description: The name of the facet to use (required). + example: '@test.service' + type: string + histogram: + $ref: '#/components/schemas/CIAppGroupByHistogram' + limit: + default: 10 + description: The maximum buckets to return for this group-by. + format: int64 + type: integer + missing: + $ref: '#/components/schemas/CIAppGroupByMissing' + sort: + $ref: '#/components/schemas/CIAppAggregateSort' + total: + $ref: '#/components/schemas/CIAppGroupByTotal' + required: + - facet + type: object + CIAppTestsAggregationBucketsResponse: + description: The query results. + properties: + buckets: + description: The list of matching buckets, one item per bucket. + items: + $ref: '#/components/schemas/CIAppTestsBucketResponse' + type: array + type: object + CIAppTestEvent: + description: >- + Object description of test event after being processed and stored by + Datadog. + properties: + attributes: + $ref: '#/components/schemas/CIAppEventAttributes' + id: + description: Unique ID of the event. + example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA + type: string + type: + $ref: '#/components/schemas/CIAppTestEventTypeName' + type: object + DORADeploymentRequestData: + description: The JSON:API data. + properties: + attributes: + $ref: '#/components/schemas/DORADeploymentRequestAttributes' + required: + - attributes + type: object + DORADeploymentResponseData: + description: The JSON:API data. + properties: + id: + description: The ID of the received DORA deployment event. + example: 4242fcdd31586083 + type: string + type: + $ref: '#/components/schemas/DORADeploymentType' + required: + - id + type: object + JSONAPIErrorItem: + description: API error response body + properties: + detail: + description: >- + A human-readable explanation specific to this occurrence of the + error. + example: Missing required attribute in body + type: string + meta: + additionalProperties: {} + description: Non-standard meta-information about the error + type: object + source: + $ref: '#/components/schemas/JSONAPIErrorItemSource' + status: + description: Status code of the response. + example: '400' + type: string + title: + description: Short human-readable summary of the error. + example: Bad Request + type: string + type: object + DORAListDeploymentsRequestData: + description: The JSON:API data. + properties: + attributes: + $ref: '#/components/schemas/DORAListDeploymentsRequestAttributes' + type: + $ref: '#/components/schemas/DORAListDeploymentsRequestDataType' + required: + - attributes + type: object + DORAEvent: + description: A DORA event. + properties: + attributes: + description: The attributes of the event. + type: object + id: + description: The ID of the event. + type: string + type: + description: The type of the event. + type: string + type: object + DORAFailureRequestData: + description: The JSON:API data. + properties: + attributes: + $ref: '#/components/schemas/DORAFailureRequestAttributes' + required: + - attributes + type: object + DORAFailureResponseData: + description: Response after receiving a DORA failure event. + properties: + id: + description: The ID of the received DORA failure event. + example: 4242fcdd31586083 + type: string + type: + $ref: '#/components/schemas/DORAFailureType' + required: + - id + type: object + DORAListFailuresRequestData: + description: The JSON:API data. + properties: + attributes: + $ref: '#/components/schemas/DORAListFailuresRequestAttributes' + type: + $ref: '#/components/schemas/DORAListFailuresRequestDataType' + required: + - attributes + type: object + WorkflowData: + description: Data related to the workflow. + properties: + attributes: + $ref: '#/components/schemas/WorkflowDataAttributes' + id: + description: The workflow identifier + readOnly: true + type: string + relationships: + $ref: '#/components/schemas/WorkflowDataRelationships' + type: + $ref: '#/components/schemas/WorkflowDataType' + required: + - type + - attributes + type: object + WorkflowDataUpdate: + description: Data related to the workflow being updated. + properties: + attributes: + $ref: '#/components/schemas/WorkflowDataUpdateAttributes' + id: + description: The workflow identifier + type: string + relationships: + $ref: '#/components/schemas/WorkflowDataRelationships' + type: + $ref: '#/components/schemas/WorkflowDataType' + required: + - type + - attributes + type: object + WorkflowInstanceListItem: + additionalProperties: {} + description: An item in the workflow instances list. + properties: + id: + description: The ID of the workflow instance + type: string + type: object + WorkflowListInstancesResponseMeta: + additionalProperties: {} + description: Metadata about the instances list + properties: + page: + $ref: '#/components/schemas/WorkflowListInstancesResponseMetaPage' + type: object + WorkflowInstanceCreateMeta: + description: Additional information for creating a workflow instance. + properties: + payload: + additionalProperties: {} + description: The input parameters to the workflow. + type: object + type: object + WorkflowInstanceCreateResponseData: + additionalProperties: {} + description: Data about the created workflow instance. + properties: + id: + description: >- + The ID of the workflow execution. It can be used to fetch the + execution status. + type: string + type: object + WorklflowGetInstanceResponseData: + additionalProperties: {} + description: The data of the instance response. + properties: + attributes: + $ref: '#/components/schemas/WorklflowGetInstanceResponseDataAttributes' + type: object + WorklflowCancelInstanceResponseData: + description: Data about the canceled instance. + properties: + id: + description: The id of the canceled instance + type: string + type: object + CIAppCreatePipelineEventRequestData: + description: Data of the pipeline event to create. + properties: + attributes: + $ref: '#/components/schemas/CIAppCreatePipelineEventRequestAttributes' + type: + $ref: '#/components/schemas/CIAppCreatePipelineEventRequestDataType' + type: object + CIAppCreatePipelineEventRequestDataArray: + description: Array of pipeline events to create in batch. + items: + $ref: '#/components/schemas/CIAppCreatePipelineEventRequestData' + type: array + CIAppAggregationFunction: + description: An aggregation function. + enum: + - count + - cardinality + - pc75 + - pc90 + - pc95 + - pc98 + - pc99 + - sum + - min + - max + - avg + - median + - latest + - earliest + - most_frequent + - delta + example: pc90 + type: string + x-enum-varnames: + - COUNT + - CARDINALITY + - PERCENTILE_75 + - PERCENTILE_90 + - PERCENTILE_95 + - PERCENTILE_98 + - PERCENTILE_99 + - SUM + - MIN + - MAX + - AVG + - MEDIAN + - LATEST + - EARLIEST + - MOST_FREQUENT + - DELTA + CIAppComputeType: + default: total + description: The type of compute. + enum: + - timeseries + - total + type: string + x-enum-varnames: + - TIMESERIES + - TOTAL + CIAppGroupByHistogram: + description: >- + Used to perform a histogram computation (only for measure facets). + + At most, 100 buckets are allowed, the number of buckets is `(max - + min)/interval`. + properties: + interval: + description: The bin size of the histogram buckets. + example: 10 + format: double + type: number + max: + description: |- + The maximum value for the measure used in the histogram + (values greater than this one are filtered out). + example: 100 + format: double + type: number + min: + description: |- + The minimum value for the measure used in the histogram + (values smaller than this one are filtered out). + example: 50 + format: double + type: number + required: + - interval + - min + - max + type: object + CIAppGroupByMissing: + description: The value to use for logs that don't have the facet used to group-by. + oneOf: + - $ref: '#/components/schemas/CIAppGroupByMissingString' + - $ref: '#/components/schemas/CIAppGroupByMissingNumber' + CIAppAggregateSort: + description: >- + A sort rule. The `aggregation` field is required when `type` is + `measure`. + example: + aggregation: count + order: asc + properties: + aggregation: + $ref: '#/components/schemas/CIAppAggregationFunction' + metric: + description: The metric to sort by (only used for `type=measure`). + example: '@duration' + type: string + order: + $ref: '#/components/schemas/CIAppSortOrder' + type: + $ref: '#/components/schemas/CIAppAggregateSortType' + type: object + CIAppGroupByTotal: + default: false + description: >- + A resulting object to put the given computes in over all the matching + records. + oneOf: + - $ref: '#/components/schemas/CIAppGroupByTotalBoolean' + - $ref: '#/components/schemas/CIAppGroupByTotalString' + - $ref: '#/components/schemas/CIAppGroupByTotalNumber' + CIAppPipelinesBucketResponse: + description: Bucket values. + properties: + by: + additionalProperties: + description: The values for each group-by. + description: The key-value pairs for each group-by. + example: + '@ci.provider.name': gitlab + '@ci.status': success + type: object + computes: + $ref: '#/components/schemas/CIAppComputes' + type: object + CIAppResponseStatus: + description: The status of the response. + enum: + - done + - timeout + example: done + type: string + x-enum-varnames: + - DONE + - TIMEOUT + CIAppWarning: + description: A warning message indicating something that went wrong with the query. + properties: + code: + description: A unique code for this type of warning. + example: unknown_index + type: string + detail: + description: A detailed explanation of this specific warning. + example: 'indexes: foo, bar' + type: string + title: + description: A short human-readable summary of the warning. + example: >- + One or several indexes are missing or invalid, results hold data + from the other indexes + type: string + type: object + CIAppPipelineEventAttributes: + description: JSON object containing all event attributes and their associated values. + properties: + attributes: + additionalProperties: {} + description: JSON object of attributes from CI Visibility pipeline events. + example: + customAttribute: 123 + duration: 2345 + type: object + ci_level: + $ref: '#/components/schemas/CIAppPipelineLevel' + tags: + $ref: '#/components/schemas/TagsEventAttribute' + type: object + CIAppPipelineEventTypeName: + description: Type of the event. + enum: + - cipipeline + example: cipipeline + type: string + x-enum-varnames: + - CIPIPELINE + CIAppResponsePage: + description: Paging attributes. + properties: + after: + description: >- + The cursor to use to get the next results, if any. To make the next + request, use the same parameters with the addition of + `page[cursor]`. + example: >- + eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== + type: string + type: object + CIAppTestsBucketResponse: + description: Bucket values. + properties: + by: + additionalProperties: + description: The values for each group-by. + description: The key-value pairs for each group-by. + example: + '@test.service': web-ui-tests + '@test.status': skip + type: object + computes: + $ref: '#/components/schemas/CIAppComputes' + type: object + CIAppEventAttributes: + description: JSON object containing all event attributes and their associated values. + properties: + attributes: + additionalProperties: {} + description: JSON object of attributes from CI Visibility test events. + example: + customAttribute: 123 + duration: 2345 + type: object + tags: + $ref: '#/components/schemas/TagsEventAttribute' + test_level: + $ref: '#/components/schemas/CIAppTestLevel' + type: object + CIAppTestEventTypeName: + description: Type of the event. + enum: + - citest + example: citest + type: string + x-enum-varnames: + - CITEST + DORADeploymentRequestAttributes: + description: Attributes to create a DORA deployment event. + properties: + custom_tags: + $ref: '#/components/schemas/DORACustomTags' + env: + description: Environment name to where the service was deployed. + example: staging + type: string + finished_at: + description: >- + Unix timestamp when the deployment finished. It must be in + nanoseconds, milliseconds, or seconds, and it should not be older + than 1 hour. + example: 1693491984000000000 + format: int64 + type: integer + git: + $ref: '#/components/schemas/DORAGitInfo' + id: + description: Deployment ID. + type: string + service: + description: Service name. + example: shopist + type: string + started_at: + description: >- + Unix timestamp when the deployment started. It must be in + nanoseconds, milliseconds, or seconds. + example: 1693491974000000000 + format: int64 + type: integer + team: + description: >- + Name of the team owning the deployed service. If not provided, this + is automatically populated with the team associated with the service + in the Service Catalog. + example: backend + type: string + version: + description: >- + Version to correlate with [APM Deployment + Tracking](https://docs.datadoghq.com/tracing/services/deployment_tracking/). + example: v1.12.07 + type: string + required: + - service + - started_at + - finished_at + type: object + DORADeploymentType: + default: dora_deployment + description: JSON:API type for DORA deployment events. + enum: + - dora_deployment + example: dora_deployment + type: string + x-enum-varnames: + - DORA_DEPLOYMENT + JSONAPIErrorItemSource: + description: References to the source of the error. + properties: + header: + description: >- + A string indicating the name of a single request header which caused + the error. + example: Authorization + type: string + parameter: + description: A string indicating which URI query parameter caused the error. + example: limit + type: string + pointer: + description: >- + A JSON pointer to the value in the request document that caused the + error. + example: /data/attributes/title + type: string + type: object + DORAListDeploymentsRequestAttributes: + description: Attributes to get a list of deployments. + properties: + from: + description: Minimum timestamp for requested events. + format: date-time + type: string + limit: + default: 10 + description: Maximum number of events in the response. + format: int32 + maximum: 1000 + type: integer + query: + description: Search query with event platform syntax. + type: string + sort: + description: Sort order (prefixed with `-` for descending). + type: string + to: + description: Maximum timestamp for requested events. + format: date-time + type: string + type: object + DORAListDeploymentsRequestDataType: + description: The definition of `DORAListDeploymentsRequestDataType` object. + enum: + - dora_deployments_list_request + type: string + x-enum-varnames: + - DORA_DEPLOYMENTS_LIST_REQUEST + DORAFailureRequestAttributes: + description: Attributes to create a DORA failure event. + properties: + custom_tags: + $ref: '#/components/schemas/DORACustomTags' + env: + description: Environment name that was impacted by the failure. + example: staging + type: string + finished_at: + description: >- + Unix timestamp when the failure finished. It must be in nanoseconds, + milliseconds, or seconds. + example: 1693491984000000000 + format: int64 + type: integer + git: + $ref: '#/components/schemas/DORAGitInfo' + id: + description: >- + Failure ID. Must have at least 16 characters. Required to update a + previously sent failure. + type: string + name: + description: Failure name. + example: Webserver is down failing all requests. + type: string + services: + description: >- + Service names impacted by the failure. If possible, use names + registered in the Service Catalog. Required when the team field is + not provided. + example: + - shopist + items: + type: string + type: array + severity: + description: Failure severity. + example: High + type: string + started_at: + description: >- + Unix timestamp when the failure started. It must be in nanoseconds, + milliseconds, or seconds. + example: 1693491974000000000 + format: int64 + type: integer + team: + description: >- + Name of the team owning the services impacted. If possible, use team + handles registered in Datadog. Required when the services field is + not provided. + example: backend + type: string + version: + description: >- + Version to correlate with [APM Deployment + Tracking](https://docs.datadoghq.com/tracing/services/deployment_tracking/). + example: v1.12.07 + type: string + required: + - started_at + type: object + DORAFailureType: + default: dora_failure + description: JSON:API type for DORA failure events. + enum: + - dora_failure + example: dora_failure + type: string + x-enum-varnames: + - DORA_FAILURE + DORAListFailuresRequestAttributes: + description: Attributes to get a list of failures. + properties: + from: + description: Minimum timestamp for requested events. + format: date-time + type: string + limit: + default: 10 + description: Maximum number of events in the response. + format: int32 + maximum: 1000 + type: integer + query: + description: Search query with event platform syntax. + type: string + sort: + description: Sort order (prefixed with `-` for descending). + type: string + to: + description: Maximum timestamp for requested events. + format: date-time + type: string + type: object + DORAListFailuresRequestDataType: + description: The definition of `DORAListFailuresRequestDataType` object. + enum: + - dora_failures_list_request + type: string + x-enum-varnames: + - DORA_FAILURES_LIST_REQUEST + WorkflowDataAttributes: + description: The definition of `WorkflowDataAttributes` object. + properties: + createdAt: + description: When the workflow was created. + format: date-time + readOnly: true + type: string + description: + description: Description of the workflow. + type: string + name: + description: Name of the workflow. + example: '' + type: string + published: + description: >- + Set the workflow to published or unpublished. Workflows in an + unpublished state will only be executable via manual runs. Automatic + triggers such as Schedule will not execute the workflow until it is + published. + type: boolean + spec: + $ref: '#/components/schemas/Spec' + tags: + description: Tags of the workflow. + items: + type: string + type: array + updatedAt: + description: When the workflow was last updated. + format: date-time + readOnly: true + type: string + webhookSecret: + description: >- + If a Webhook trigger is defined on this workflow, a webhookSecret is + required and should be provided here. + type: string + writeOnly: true + required: + - name + - spec + type: object + WorkflowDataRelationships: + description: The definition of `WorkflowDataRelationships` object. + properties: + creator: + $ref: '#/components/schemas/WorkflowUserRelationship' + owner: + $ref: '#/components/schemas/WorkflowUserRelationship' + readOnly: true + type: object + WorkflowDataType: + description: The definition of `WorkflowDataType` object. + enum: + - workflows + example: workflows + type: string + x-enum-varnames: + - WORKFLOWS + WorkflowDataUpdateAttributes: + description: The definition of `WorkflowDataUpdateAttributes` object. + properties: + createdAt: + description: When the workflow was created. + format: date-time + readOnly: true + type: string + description: + description: Description of the workflow. + type: string + name: + description: Name of the workflow. + type: string + published: + description: >- + Set the workflow to published or unpublished. Workflows in an + unpublished state will only be executable via manual runs. Automatic + triggers such as Schedule will not execute the workflow until it is + published. + type: boolean + spec: + $ref: '#/components/schemas/Spec' + tags: + description: Tags of the workflow. + items: + type: string + type: array + updatedAt: + description: When the workflow was last updated. + format: date-time + readOnly: true + type: string + webhookSecret: + description: >- + If a Webhook trigger is defined on this workflow, a webhookSecret is + required and should be provided here. + type: string + writeOnly: true + type: object + WorkflowListInstancesResponseMetaPage: + additionalProperties: {} + description: Page information for the list instances response. + properties: + totalCount: + description: The total count of items. + format: int64 + type: integer + type: object + WorklflowGetInstanceResponseDataAttributes: + additionalProperties: {} + description: The attributes of the instance response data. + properties: + id: + description: The id of the instance. + type: string + type: object + CIAppCreatePipelineEventRequestAttributes: + description: Attributes of the pipeline event to create. + properties: + env: + description: The Datadog environment. + type: string + provider_name: + description: The name of the CI provider. By default, this is "custom". + type: string + resource: + $ref: >- + #/components/schemas/CIAppCreatePipelineEventRequestAttributesResource + service: + description: >- + If the CI provider is SaaS, use this to differentiate between + instances. + type: string + required: + - resource + type: object + CIAppCreatePipelineEventRequestDataType: + default: cipipeline_resource_request + description: Type of the event. + enum: + - cipipeline_resource_request + example: cipipeline_resource_request + type: string + x-enum-varnames: + - CIPIPELINE_RESOURCE_REQUEST + CIAppGroupByMissingString: + description: The missing value to use if there is a string valued facet. + type: string + CIAppGroupByMissingNumber: + description: The missing value to use if there is a number valued facet. + format: double + type: number + CIAppSortOrder: + description: The order to use, ascending or descending. + enum: + - asc + - desc + example: asc + type: string + x-enum-varnames: + - ASCENDING + - DESCENDING + CIAppAggregateSortType: + default: alphabetical + description: The type of sorting algorithm. + enum: + - alphabetical + - measure + type: string + x-enum-varnames: + - ALPHABETICAL + - MEASURE + CIAppGroupByTotalBoolean: + description: If set to true, creates an additional bucket labeled "$facet_total". + type: boolean + CIAppGroupByTotalString: + description: A string to use as the key value for the total bucket. + type: string + CIAppGroupByTotalNumber: + description: A number to use as the key value for the total bucket. + format: double + type: number + CIAppComputes: + additionalProperties: + $ref: '#/components/schemas/CIAppAggregateBucketValue' + description: >- + A map of the metric name to value for regular compute, or a list of + values for a timeseries. + type: object + CIAppPipelineLevel: + description: Pipeline execution level. + enum: + - pipeline + - stage + - job + - step + - custom + example: pipeline + type: string + x-enum-varnames: + - PIPELINE + - STAGE + - JOB + - STEP + - CUSTOM + TagsEventAttribute: + description: Array of tags associated with your event. + example: + - team:A + items: + description: Tag associated with your event. + type: string + type: array + CIAppTestLevel: + description: Test run level. + enum: + - session + - module + - suite + - test + example: test + type: string + x-enum-varnames: + - SESSION + - MODULE + - SUITE + - TEST + DORACustomTags: + description: >- + A list of user-defined tags. The tags must follow the `key:value` + pattern. Up to 100 may be added per event. + example: + - language:java + - department:engineering + items: + description: Tags in the form of `key:value`. + type: string + nullable: true + type: array + DORAGitInfo: + description: Git info for DORA Metrics events. + properties: + commit_sha: + $ref: '#/components/schemas/GitCommitSHA' + repository_url: + $ref: '#/components/schemas/GitRepositoryURL' + required: + - repository_url + - commit_sha + type: object + Spec: + description: The spec defines what the workflow does. + properties: + annotations: + description: >- + A list of annotations used in the workflow. These are like sticky + notes for your workflow! + items: + $ref: '#/components/schemas/Annotation' + type: array + connectionEnvs: + description: A list of connections or connection groups used in the workflow. + items: + $ref: '#/components/schemas/ConnectionEnv' + type: array + handle: + description: >- + Unique identifier used to trigger workflows automatically in + Datadog. + type: string + inputSchema: + $ref: '#/components/schemas/InputSchema' + outputSchema: + $ref: '#/components/schemas/OutputSchema' + steps: + description: >- + A `Step` is a sub-component of a workflow. Each `Step` performs an + action. + items: + $ref: '#/components/schemas/Step' + type: array + triggers: + description: >- + The list of triggers that activate this workflow. At least one + trigger is required, and each trigger type may appear at most once. + items: + $ref: '#/components/schemas/Trigger' + type: array + type: object + WorkflowUserRelationship: + description: The definition of `WorkflowUserRelationship` object. + properties: + data: + $ref: '#/components/schemas/WorkflowUserRelationshipData' + type: object + CIAppCreatePipelineEventRequestAttributesResource: + description: Details of the CI pipeline event. + example: Details TBD + oneOf: + - $ref: '#/components/schemas/CIAppPipelineEventPipeline' + - $ref: '#/components/schemas/CIAppPipelineEventStage' + - $ref: '#/components/schemas/CIAppPipelineEventJob' + - $ref: '#/components/schemas/CIAppPipelineEventStep' + CIAppAggregateBucketValue: + description: A bucket value, can either be a timeseries or a single value. + oneOf: + - $ref: '#/components/schemas/CIAppAggregateBucketValueSingleString' + - $ref: '#/components/schemas/CIAppAggregateBucketValueSingleNumber' + - $ref: '#/components/schemas/CIAppAggregateBucketValueTimeseries' + GitCommitSHA: + description: Git Commit SHA. + example: 66adc9350f2cc9b250b69abddab733dd55e1a588 + pattern: ^[a-fA-F0-9]{40,}$ + type: string + GitRepositoryURL: + description: Git Repository URL + example: https://github.com/organization/example-repository + type: string + Annotation: + description: >- + A list of annotations used in the workflow. These are like sticky notes + for your workflow! + properties: + display: + $ref: '#/components/schemas/AnnotationDisplay' + id: + description: The `Annotation` `id`. + example: '' + type: string + markdownTextAnnotation: + $ref: '#/components/schemas/AnnotationMarkdownTextAnnotation' + required: + - id + - display + - markdownTextAnnotation + type: object + ConnectionEnv: + description: A list of connections or connection groups used in the workflow. + properties: + connectionGroups: + description: The `ConnectionEnv` `connectionGroups`. + items: + $ref: '#/components/schemas/ConnectionGroup' + type: array + connections: + description: The `ConnectionEnv` `connections`. + items: + $ref: '#/components/schemas/Connection' + type: array + env: + $ref: '#/components/schemas/ConnectionEnvEnv' + required: + - env + type: object + InputSchema: + description: >- + A list of input parameters for the workflow. These can be used as + dynamic runtime values in your workflow. + properties: + parameters: + description: The `InputSchema` `parameters`. + items: + $ref: '#/components/schemas/InputSchemaParameters' + type: array + type: object + OutputSchema: + description: A list of output parameters for the workflow. + properties: + parameters: + description: The `OutputSchema` `parameters`. + items: + $ref: '#/components/schemas/OutputSchemaParameters' + type: array + type: object + Step: + description: A Step is a sub-component of a workflow. Each Step performs an action. + properties: + actionId: + description: The unique identifier of an action. + example: '' + type: string + completionGate: + $ref: '#/components/schemas/CompletionGate' + connectionLabel: + description: The unique identifier of a connection defined in the spec. + type: string + display: + $ref: '#/components/schemas/StepDisplay' + errorHandlers: + description: The `Step` `errorHandlers`. + items: + $ref: '#/components/schemas/ErrorHandler' + type: array + name: + description: Name of the step. + example: '' + type: string + outboundEdges: + description: A list of subsequent actions to run. + items: + $ref: '#/components/schemas/OutboundEdge' + type: array + parameters: + description: A list of inputs for an action. + items: + $ref: '#/components/schemas/Parameter' + type: array + readinessGate: + $ref: '#/components/schemas/ReadinessGate' + required: + - name + - actionId + type: object + Trigger: + description: One of the triggers that can start the execution of a workflow. + oneOf: + - $ref: '#/components/schemas/APITriggerWrapper' + - $ref: '#/components/schemas/AppTriggerWrapper' + - $ref: '#/components/schemas/CaseTriggerWrapper' + - $ref: '#/components/schemas/ChangeEventTriggerWrapper' + - $ref: '#/components/schemas/DatabaseMonitoringTriggerWrapper' + - $ref: '#/components/schemas/DashboardTriggerWrapper' + - $ref: '#/components/schemas/GithubWebhookTriggerWrapper' + - $ref: '#/components/schemas/IncidentTriggerWrapper' + - $ref: '#/components/schemas/MonitorTriggerWrapper' + - $ref: '#/components/schemas/NotebookTriggerWrapper' + - $ref: '#/components/schemas/ScheduleTriggerWrapper' + - $ref: '#/components/schemas/SecurityTriggerWrapper' + - $ref: '#/components/schemas/SelfServiceTriggerWrapper' + - $ref: '#/components/schemas/SlackTriggerWrapper' + - $ref: '#/components/schemas/SoftwareCatalogTriggerWrapper' + - $ref: '#/components/schemas/WorkflowTriggerWrapper' + WorkflowUserRelationshipData: + description: The definition of `WorkflowUserRelationshipData` object. + properties: + id: + description: The user identifier + example: '' + type: string + type: + $ref: '#/components/schemas/WorkflowUserRelationshipType' + required: + - type + - id + type: object + CIAppPipelineEventPipeline: + description: Details of the top level pipeline, build, or workflow of your CI. + oneOf: + - $ref: '#/components/schemas/CIAppPipelineEventFinishedPipeline' + - $ref: '#/components/schemas/CIAppPipelineEventInProgressPipeline' + CIAppPipelineEventStage: + description: Details of a CI stage. + properties: + dependencies: + description: A list of stage IDs that this stage depends on. + example: + - f7e6a006-a029-46c3-b0cc-742c9d7d363b + - c8a69849-3c3b-4721-8b33-3e8ec2df1ebe + items: + description: A list of stage IDs. + type: string + nullable: true + type: array + end: + description: Time when the stage run finished. The time format must be RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + error: + $ref: '#/components/schemas/CIAppCIError' + git: + $ref: '#/components/schemas/CIAppGitInfo' + id: + description: >- + UUID for the stage. It has to be unique at least in the pipeline + scope. + example: 562bdbbb-7cab-48c8-851c-b24ca14628bf + type: string + level: + $ref: '#/components/schemas/CIAppPipelineEventStageLevel' + metrics: + $ref: '#/components/schemas/CIAppPipelineEventMetrics' + name: + description: The name for the stage. + example: build + type: string + node: + $ref: '#/components/schemas/CIAppHostInfo' + parameters: + $ref: '#/components/schemas/CIAppPipelineEventParameters' + pipeline_name: + description: The parent pipeline name. + example: Build + type: string + pipeline_unique_id: + description: The parent pipeline UUID. + example: 76b572af-a078-42b2-a08a-cc28f98b944f + type: string + queue_time: + description: The queue time in milliseconds, if applicable. + example: 1004 + format: int64 + minimum: 0 + nullable: true + type: integer + start: + description: >- + Time when the stage run started (it should not include any queue + time). The time format must be RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + status: + $ref: '#/components/schemas/CIAppPipelineEventStageStatus' + tags: + $ref: '#/components/schemas/CIAppPipelineEventTags' + required: + - level + - id + - name + - pipeline_unique_id + - pipeline_name + - start + - end + - status + type: object + CIAppPipelineEventJob: + description: Details of a CI job. + properties: + dependencies: + description: A list of job IDs that this job depends on. + example: + - f7e6a006-a029-46c3-b0cc-742c9d7d363b + - c8a69849-3c3b-4721-8b33-3e8ec2df1ebe + items: + description: A list of job IDs. + type: string + nullable: true + type: array + end: + description: Time when the job run finished. The time format must be RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + error: + $ref: '#/components/schemas/CIAppCIError' + git: + $ref: '#/components/schemas/CIAppGitInfo' + id: + description: >- + The UUID for the job. It has to be unique within each pipeline + execution. + example: c865bad4-de82-44b8-ade7-2c987528eb54 + type: string + level: + $ref: '#/components/schemas/CIAppPipelineEventJobLevel' + metrics: + $ref: '#/components/schemas/CIAppPipelineEventMetrics' + name: + description: The name for the job. + example: test + type: string + node: + $ref: '#/components/schemas/CIAppHostInfo' + parameters: + $ref: '#/components/schemas/CIAppPipelineEventParameters' + pipeline_name: + description: The parent pipeline name. + example: Build + type: string + pipeline_unique_id: + description: The parent pipeline UUID. + example: 76b572af-a078-42b2-a08a-cc28f98b944f + type: string + queue_time: + description: The queue time in milliseconds, if applicable. + example: 1004 + format: int64 + minimum: 0 + nullable: true + type: integer + stage_id: + description: The parent stage UUID (if applicable). + nullable: true + type: string + stage_name: + description: The parent stage name (if applicable). + nullable: true + type: string + start: + description: >- + Time when the job run instance started (it should not include any + queue time). The time format must be RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + status: + $ref: '#/components/schemas/CIAppPipelineEventJobStatus' + tags: + $ref: '#/components/schemas/CIAppPipelineEventTags' + url: + description: The URL to look at the job in the CI provider UI. + example: https://ci-platform.com/job/your-job-name/build/123 + type: string + required: + - level + - id + - name + - pipeline_unique_id + - pipeline_name + - start + - end + - status + - url + type: object + CIAppPipelineEventStep: + description: Details of a CI step. + properties: + end: + description: Time when the step run finished. The time format must be RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + error: + $ref: '#/components/schemas/CIAppCIError' + git: + $ref: '#/components/schemas/CIAppGitInfo' + id: + description: >- + UUID for the step. It has to be unique within each pipeline + execution. + example: c2d517a8-4f3a-4b41-b4ae-69df0c864c79 + type: string + job_id: + description: The parent job UUID (if applicable). + nullable: true + type: string + job_name: + description: The parent job name (if applicable). + nullable: true + type: string + level: + $ref: '#/components/schemas/CIAppPipelineEventStepLevel' + metrics: + $ref: '#/components/schemas/CIAppPipelineEventMetrics' + name: + description: The name for the step. + example: test-server + type: string + node: + $ref: '#/components/schemas/CIAppHostInfo' + parameters: + $ref: '#/components/schemas/CIAppPipelineEventParameters' + pipeline_name: + description: The parent pipeline name. + example: Build + type: string + pipeline_unique_id: + description: The parent pipeline UUID. + example: 76b572af-a078-42b2-a08a-cc28f98b944f + type: string + stage_id: + description: The parent stage UUID (if applicable). + nullable: true + type: string + stage_name: + description: The parent stage name (if applicable). + nullable: true + type: string + start: + description: Time when the step run started. The time format must be RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + status: + $ref: '#/components/schemas/CIAppPipelineEventStepStatus' + tags: + $ref: '#/components/schemas/CIAppPipelineEventTags' + url: + description: The URL to look at the step in the CI provider UI. + nullable: true + type: string + required: + - level + - id + - name + - pipeline_unique_id + - pipeline_name + - start + - end + - status + type: object + CIAppAggregateBucketValueSingleString: + description: A single string value. + type: string + CIAppAggregateBucketValueSingleNumber: + description: A single number value. + format: double + type: number + CIAppAggregateBucketValueTimeseries: + description: A timeseries array. + items: + $ref: '#/components/schemas/CIAppAggregateBucketValueTimeseriesPoint' + type: array + x-generate-alias-as-model: true + AnnotationDisplay: + description: The definition of `AnnotationDisplay` object. + properties: + bounds: + $ref: '#/components/schemas/AnnotationDisplayBounds' + type: object + AnnotationMarkdownTextAnnotation: + description: The definition of `AnnotationMarkdownTextAnnotation` object. + properties: + text: + description: The `markdownTextAnnotation` `text`. + type: string + type: object + ConnectionGroup: + description: The definition of `ConnectionGroup` object. + properties: + connectionGroupId: + description: The `ConnectionGroup` `connectionGroupId`. + example: '' + type: string + label: + description: The `ConnectionGroup` `label`. + example: '' + type: string + tags: + description: The `ConnectionGroup` `tags`. + example: + - '' + items: + type: string + type: array + required: + - connectionGroupId + - label + - tags + type: object + Connection: + description: The definition of `Connection` object. + properties: + connectionId: + description: The `Connection` `connectionId`. + example: '' + type: string + label: + description: The `Connection` `label`. + example: '' + type: string + required: + - connectionId + - label + type: object + ConnectionEnvEnv: + description: The definition of `ConnectionEnvEnv` object. + enum: + - default + example: default + type: string + x-enum-varnames: + - DEFAULT + InputSchemaParameters: + description: The definition of `InputSchemaParameters` object. + properties: + defaultValue: + description: The `InputSchemaParameters` `defaultValue`. + description: + description: The `InputSchemaParameters` `description`. + type: string + label: + description: The `InputSchemaParameters` `label`. + type: string + name: + description: The `InputSchemaParameters` `name`. + example: '' + type: string + type: + $ref: '#/components/schemas/InputSchemaParametersType' + required: + - name + - type + type: object + OutputSchemaParameters: + description: The definition of `OutputSchemaParameters` object. + properties: + defaultValue: + description: The `OutputSchemaParameters` `defaultValue`. + description: + description: The `OutputSchemaParameters` `description`. + type: string + label: + description: The `OutputSchemaParameters` `label`. + type: string + name: + description: The `OutputSchemaParameters` `name`. + example: '' + type: string + type: + $ref: '#/components/schemas/OutputSchemaParametersType' + value: + description: The `OutputSchemaParameters` `value`. + required: + - name + - type + type: object + CompletionGate: + description: Used to create conditions before running subsequent actions. + properties: + completionCondition: + $ref: '#/components/schemas/CompletionCondition' + retryStrategy: + $ref: '#/components/schemas/RetryStrategy' + required: + - completionCondition + - retryStrategy + type: object + StepDisplay: + description: The definition of `StepDisplay` object. + properties: + bounds: + $ref: '#/components/schemas/StepDisplayBounds' + type: object + ErrorHandler: + description: Used to handle errors in an action. + properties: + fallbackStepName: + description: The `ErrorHandler` `fallbackStepName`. + example: '' + type: string + retryStrategy: + $ref: '#/components/schemas/RetryStrategy' + required: + - retryStrategy + - fallbackStepName + type: object + OutboundEdge: + description: The definition of `OutboundEdge` object. + properties: + branchName: + description: The `OutboundEdge` `branchName`. + example: '' + type: string + nextStepName: + description: The `OutboundEdge` `nextStepName`. + example: '' + type: string + required: + - nextStepName + - branchName + type: object + Parameter: + description: The definition of `Parameter` object. + properties: + name: + description: The `Parameter` `name`. + example: '' + type: string + value: + description: The `Parameter` `value`. + required: + - name + - value + type: object + ReadinessGate: + description: Used to merge multiple branches into a single branch. + properties: + thresholdType: + $ref: '#/components/schemas/ReadinessGateThresholdType' + required: + - thresholdType + type: object + APITriggerWrapper: + description: Schema for an API-based trigger. + properties: + apiTrigger: + $ref: '#/components/schemas/APITrigger' + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - apiTrigger + type: object + AppTriggerWrapper: + description: Schema for an App-based trigger. + properties: + appTrigger: + description: Trigger a workflow from an App. + type: object + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - appTrigger + type: object + CaseTriggerWrapper: + description: Schema for a Case-based trigger. + properties: + caseTrigger: + $ref: '#/components/schemas/CaseTrigger' + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - caseTrigger + type: object + ChangeEventTriggerWrapper: + description: Schema for a Change Event-based trigger. + properties: + changeEventTrigger: + description: Trigger a workflow from a Change Event. + type: object + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - changeEventTrigger + type: object + DatabaseMonitoringTriggerWrapper: + description: Schema for a Database Monitoring-based trigger. + properties: + databaseMonitoringTrigger: + description: Trigger a workflow from Database Monitoring. + type: object + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - databaseMonitoringTrigger + type: object + DashboardTriggerWrapper: + description: Schema for a Dashboard-based trigger. + properties: + dashboardTrigger: + description: Trigger a workflow from a Dashboard. + type: object + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - dashboardTrigger + type: object + GithubWebhookTriggerWrapper: + description: Schema for a GitHub webhook-based trigger. + properties: + githubWebhookTrigger: + $ref: '#/components/schemas/GithubWebhookTrigger' + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - githubWebhookTrigger + type: object + IncidentTriggerWrapper: + description: Schema for an Incident-based trigger. + properties: + incidentTrigger: + $ref: '#/components/schemas/IncidentTrigger' + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - incidentTrigger + type: object + MonitorTriggerWrapper: + description: Schema for a Monitor-based trigger. + properties: + monitorTrigger: + $ref: '#/components/schemas/MonitorTrigger' + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - monitorTrigger + type: object + NotebookTriggerWrapper: + description: Schema for a Notebook-based trigger. + properties: + notebookTrigger: + description: Trigger a workflow from a Notebook. + type: object + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - notebookTrigger + type: object + ScheduleTriggerWrapper: + description: Schema for a Schedule-based trigger. + properties: + scheduleTrigger: + $ref: '#/components/schemas/ScheduleTrigger' + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - scheduleTrigger + type: object + SecurityTriggerWrapper: + description: Schema for a Security-based trigger. + properties: + securityTrigger: + $ref: '#/components/schemas/SecurityTrigger' + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - securityTrigger + type: object + SelfServiceTriggerWrapper: + description: Schema for a Self Service-based trigger. + properties: + selfServiceTrigger: + description: Trigger a workflow from Self Service. + type: object + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - selfServiceTrigger + type: object + SlackTriggerWrapper: + description: Schema for a Slack-based trigger. + properties: + slackTrigger: + description: Trigger a workflow from Slack. The workflow must be published. + type: object + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - slackTrigger + type: object + SoftwareCatalogTriggerWrapper: + description: Schema for a Software Catalog-based trigger. + properties: + softwareCatalogTrigger: + description: Trigger a workflow from Software Catalog. + type: object + startStepNames: + $ref: '#/components/schemas/StartStepNames' + required: + - softwareCatalogTrigger + type: object + WorkflowTriggerWrapper: + description: Schema for a Workflow-based trigger. + properties: + startStepNames: + $ref: '#/components/schemas/StartStepNames' + workflowTrigger: + description: >- + Trigger a workflow from the Datadog UI. Only required if no other + trigger exists. + type: object + required: + - workflowTrigger + type: object + WorkflowUserRelationshipType: + description: The definition of `WorkflowUserRelationshipType` object. + enum: + - users + example: users + type: string + x-enum-varnames: + - USERS + CIAppPipelineEventFinishedPipeline: + description: Details of a finished pipeline. + properties: + end: + description: >- + Time when the pipeline run finished. It cannot be older than 18 + hours in the past from the current time. The time format must be + RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + error: + $ref: '#/components/schemas/CIAppCIError' + git: + $ref: '#/components/schemas/CIAppGitInfo' + is_manual: + description: Whether or not the pipeline was triggered manually by the user. + example: false + nullable: true + type: boolean + is_resumed: + description: Whether or not the pipeline was resumed after being blocked. + example: false + nullable: true + type: boolean + level: + $ref: '#/components/schemas/CIAppPipelineEventPipelineLevel' + metrics: + $ref: '#/components/schemas/CIAppPipelineEventMetrics' + name: + description: >- + Name of the pipeline. All pipeline runs for the builds should have + the same name. + example: Deploy to AWS + type: string + node: + $ref: '#/components/schemas/CIAppHostInfo' + parameters: + $ref: '#/components/schemas/CIAppPipelineEventParameters' + parent_pipeline: + $ref: '#/components/schemas/CIAppPipelineEventParentPipeline' + partial_retry: + description: >- + Whether or not the pipeline was a partial retry of a previous + attempt. A partial retry is one + + which only runs a subset of the original jobs. + example: false + type: boolean + pipeline_id: + description: >- + Any ID used in the provider to identify the pipeline run even if it + is not unique across retries. + + If the `pipeline_id` is unique, then both `unique_id` and + `pipeline_id` can be set to the same value. + example: '#023' + type: string + previous_attempt: + $ref: '#/components/schemas/CIAppPipelineEventPreviousPipeline' + queue_time: + description: The queue time in milliseconds, if applicable. + example: 1004 + format: int64 + minimum: 0 + nullable: true + type: integer + start: + description: >- + Time when the pipeline run started (it should not include any queue + time). The time format must be RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + status: + $ref: '#/components/schemas/CIAppPipelineEventPipelineStatus' + tags: + $ref: '#/components/schemas/CIAppPipelineEventTags' + unique_id: + description: >- + UUID of the pipeline run. The ID has to be unique across retries and + pipelines, + + including partial retries. + example: 3eacb6f3-ff04-4e10-8a9c-46e6d054024a + type: string + url: + description: The URL to look at the pipeline in the CI provider UI. + example: https://my-ci-provider.example/pipelines/my-pipeline/run/1 + type: string + required: + - level + - unique_id + - name + - url + - start + - end + - status + - partial_retry + type: object + CIAppPipelineEventInProgressPipeline: + description: Details of a running pipeline. + properties: + error: + $ref: '#/components/schemas/CIAppCIError' + git: + $ref: '#/components/schemas/CIAppGitInfo' + is_manual: + description: Whether or not the pipeline was triggered manually by the user. + example: false + nullable: true + type: boolean + is_resumed: + description: Whether or not the pipeline was resumed after being blocked. + example: false + nullable: true + type: boolean + level: + $ref: '#/components/schemas/CIAppPipelineEventPipelineLevel' + metrics: + $ref: '#/components/schemas/CIAppPipelineEventMetrics' + name: + description: >- + Name of the pipeline. All pipeline runs for the builds should have + the same name. + example: Deploy to AWS + type: string + node: + $ref: '#/components/schemas/CIAppHostInfo' + parameters: + $ref: '#/components/schemas/CIAppPipelineEventParameters' + parent_pipeline: + $ref: '#/components/schemas/CIAppPipelineEventParentPipeline' + partial_retry: + description: >- + Whether or not the pipeline was a partial retry of a previous + attempt. A partial retry is one + + which only runs a subset of the original jobs. + example: false + type: boolean + pipeline_id: + description: >- + Any ID used in the provider to identify the pipeline run even if it + is not unique across retries. + + If the `pipeline_id` is unique, then both `unique_id` and + `pipeline_id` can be set to the same value. + example: '#023' + type: string + previous_attempt: + $ref: '#/components/schemas/CIAppPipelineEventPreviousPipeline' + queue_time: + description: The queue time in milliseconds, if applicable. + example: 1004 + format: int64 + minimum: 0 + nullable: true + type: integer + start: + description: >- + Time when the pipeline run started (it should not include any queue + time). The time format must be RFC3339. + example: '2023-05-31T15:30:00Z' + format: date-time + type: string + status: + $ref: '#/components/schemas/CIAppPipelineEventPipelineInProgressStatus' + tags: + $ref: '#/components/schemas/CIAppPipelineEventTags' + unique_id: + description: >- + UUID of the pipeline run. The ID has to be the same as the finished + pipeline. + example: 3eacb6f3-ff04-4e10-8a9c-46e6d054024a + type: string + url: + description: The URL to look at the pipeline in the CI provider UI. + example: https://my-ci-provider.example/pipelines/my-pipeline/run/1 + type: string + required: + - level + - unique_id + - name + - url + - start + - status + - partial_retry + type: object + CIAppCIError: + description: Contains information of the CI error. + nullable: true + properties: + domain: + $ref: '#/components/schemas/CIAppCIErrorDomain' + message: + description: Error message. + maxLength: 5000 + nullable: true + type: string + stack: + description: The stack trace of the reported errors. + nullable: true + type: string + type: + description: Short description of the error type. + maxLength: 100 + nullable: true + type: string + type: object + CIAppGitInfo: + description: >- + If pipelines are triggered due to actions to a Git repository, then all + payloads must contain this. + + Note that either `tag` or `branch` has to be provided, but not both. + nullable: true + properties: + author_email: + description: The commit author email. + example: author@example.com + type: string + author_name: + description: The commit author name. + example: John Doe + nullable: true + type: string + author_time: + description: The commit author timestamp in RFC3339 format. + example: '2023-05-31T15:30:00Z' + nullable: true + type: string + branch: + description: The branch name (if a tag use the tag parameter). + example: feature-1 + nullable: true + type: string + commit_time: + description: The commit timestamp in RFC3339 format. + example: '2023-05-31T15:30:00Z' + nullable: true + type: string + committer_email: + description: The committer email. + example: committer@example.com + nullable: true + type: string + committer_name: + description: The committer name. + nullable: true + type: string + default_branch: + description: The Git repository's default branch. + example: main + nullable: true + type: string + message: + description: The commit message. + example: Instrumenting tests with CI Visibility. + nullable: true + type: string + repository_url: + description: The URL of the repository. + example: https://github.com/username/repository + type: string + sha: + description: The git commit SHA. + example: da39a3ee5e6b4b0d3255bfef95601890afd80709 + pattern: ^[a-fA-F0-9]{40}$ + type: string + tag: + description: The tag name (if a branch use the branch parameter). + example: v1.0.0 + nullable: true + type: string + required: + - repository_url + - sha + - author_email + type: object + CIAppPipelineEventStageLevel: + default: stage + description: Used to distinguish between pipelines, stages, jobs and steps. + enum: + - stage + example: stage + type: string + x-enum-varnames: + - STAGE + CIAppPipelineEventMetrics: + description: >- + A list of user-defined metrics. The metrics must follow the `key:value` + pattern and the value must be numeric. + example: + - bundle_size:370 + - build_time:50021 + items: + description: Metrics in the form of `key:value`. The value needs to be numeric. + type: string + nullable: true + type: array + CIAppHostInfo: + description: >- + Contains information of the host running the pipeline, stage, job, or + step. + nullable: true + properties: + hostname: + description: FQDN of the host. + example: www.example.com + type: string + labels: + description: A list of labels used to select or identify the node. + example: + - ubuntu-18.04 + - n2.large + items: + type: string + type: array + name: + description: Name for the host. + type: string + workspace: + description: The path where the code is checked out. + example: /home/workspace/code/my-repo + type: string + type: object + CIAppPipelineEventParameters: + additionalProperties: + type: string + description: >- + A map of key-value parameters or environment variables that were defined + for the pipeline. + example: + LOG_LEVEL: debug + nullable: true + type: object + CIAppPipelineEventStageStatus: + description: The final status of the stage. + enum: + - success + - error + - canceled + - skipped + example: success + type: string + x-enum-varnames: + - SUCCESS + - ERROR + - CANCELED + - SKIPPED + CIAppPipelineEventTags: + description: >- + A list of user-defined tags. The tags must follow the `key:value` + pattern. + example: + - team:backend + - type:deployment + items: + description: Tags in the form of `key:value`. + type: string + nullable: true + type: array + CIAppPipelineEventJobLevel: + default: job + description: Used to distinguish between pipelines, stages, jobs, and steps. + enum: + - job + example: job + type: string + x-enum-varnames: + - JOB + CIAppPipelineEventJobStatus: + description: The final status of the job. + enum: + - success + - error + - canceled + - skipped + example: success + type: string + x-enum-varnames: + - SUCCESS + - ERROR + - CANCELED + - SKIPPED + CIAppPipelineEventStepLevel: + default: step + description: Used to distinguish between pipelines, stages, jobs and steps. + enum: + - step + example: step + type: string + x-enum-varnames: + - STEP + CIAppPipelineEventStepStatus: + description: The final status of the step. + enum: + - success + - error + example: success + type: string + x-enum-varnames: + - SUCCESS + - ERROR + CIAppAggregateBucketValueTimeseriesPoint: + description: A timeseries point. + properties: + time: + description: The time value for this point. + example: '2020-06-08T11:55:00.123Z' + format: date-time + type: string + value: + description: The value for this point. + example: 19 + format: double + type: number + type: object + AnnotationDisplayBounds: + description: The definition of `AnnotationDisplayBounds` object. + properties: + height: + description: The `bounds` `height`. + format: double + type: number + width: + description: The `bounds` `width`. + format: double + type: number + x: + description: The `bounds` `x`. + format: double + type: number + 'y': + description: The `bounds` `y`. + format: double + type: number + type: object + InputSchemaParametersType: + description: The definition of `InputSchemaParametersType` object. + enum: + - STRING + - NUMBER + - BOOLEAN + - OBJECT + - ARRAY_STRING + - ARRAY_NUMBER + - ARRAY_BOOLEAN + - ARRAY_OBJECT + example: STRING + type: string + x-enum-varnames: + - STRING + - NUMBER + - BOOLEAN + - OBJECT + - ARRAY_STRING + - ARRAY_NUMBER + - ARRAY_BOOLEAN + - ARRAY_OBJECT + OutputSchemaParametersType: + description: The definition of `OutputSchemaParametersType` object. + enum: + - STRING + - NUMBER + - BOOLEAN + - OBJECT + - ARRAY_STRING + - ARRAY_NUMBER + - ARRAY_BOOLEAN + - ARRAY_OBJECT + example: STRING + type: string + x-enum-varnames: + - STRING + - NUMBER + - BOOLEAN + - OBJECT + - ARRAY_STRING + - ARRAY_NUMBER + - ARRAY_BOOLEAN + - ARRAY_OBJECT + CompletionCondition: + description: The definition of `CompletionCondition` object. + properties: + operand1: + description: The `CompletionCondition` `operand1`. + operand2: + description: The `CompletionCondition` `operand2`. + operator: + $ref: '#/components/schemas/CompletionConditionOperator' + required: + - operand1 + - operator + type: object + RetryStrategy: + description: The definition of `RetryStrategy` object. + properties: + kind: + $ref: '#/components/schemas/RetryStrategyKind' + linear: + $ref: '#/components/schemas/RetryStrategyLinear' + required: + - kind + type: object + StepDisplayBounds: + description: The definition of `StepDisplayBounds` object. + properties: + x: + description: The `bounds` `x`. + format: double + type: number + 'y': + description: The `bounds` `y`. + format: double + type: number + type: object + ReadinessGateThresholdType: + description: The definition of `ReadinessGateThresholdType` object. + enum: + - ANY + - ALL + example: ANY + type: string + x-enum-varnames: + - ANY + - ALL + APITrigger: + description: Trigger a workflow from an API request. The workflow must be published. + properties: + rateLimit: + $ref: '#/components/schemas/TriggerRateLimit' + type: object + StartStepNames: + description: A list of steps that run first after a trigger fires. + example: + - '' + items: + description: The `StartStepNames` `items`. + type: string + type: array + CaseTrigger: + description: >- + Trigger a workflow from a Case. For automatic triggering a handle must + be configured and the workflow must be published. + properties: + rateLimit: + $ref: '#/components/schemas/TriggerRateLimit' + type: object + GithubWebhookTrigger: + description: >- + Trigger a workflow from a GitHub webhook. To trigger a workflow from + GitHub, you must set a `webhookSecret`. In your GitHub Webhook Settings, + set the Payload URL to + "base_url"/api/v2/workflows/"workflow_id"/webhook?orgId="org_id", select + application/json for the content type, and be highly recommend enabling + SSL verification for security. The workflow must be published. + properties: + rateLimit: + $ref: '#/components/schemas/TriggerRateLimit' + type: object + IncidentTrigger: + description: >- + Trigger a workflow from an Incident. For automatic triggering a handle + must be configured and the workflow must be published. + properties: + rateLimit: + $ref: '#/components/schemas/TriggerRateLimit' + type: object + MonitorTrigger: + description: >- + Trigger a workflow from a Monitor. For automatic triggering a handle + must be configured and the workflow must be published. + properties: + rateLimit: + $ref: '#/components/schemas/TriggerRateLimit' + type: object + ScheduleTrigger: + description: Trigger a workflow from a Schedule. The workflow must be published. + properties: + rruleExpression: + description: Recurrence rule expression for scheduling. + example: '' + type: string + required: + - rruleExpression + type: object + SecurityTrigger: + description: >- + Trigger a workflow from a Security Signal or Finding. For automatic + triggering a handle must be configured and the workflow must be + published. + properties: + rateLimit: + $ref: '#/components/schemas/TriggerRateLimit' + type: object + CIAppPipelineEventPipelineLevel: + default: pipeline + description: Used to distinguish between pipelines, stages, jobs, and steps. + enum: + - pipeline + example: pipeline + type: string + x-enum-varnames: + - PIPELINE + CIAppPipelineEventParentPipeline: + description: >- + If the pipeline is triggered as child of another pipeline, this should + contain the details of the parent pipeline. + nullable: true + properties: + id: + description: UUID of a pipeline. + example: 93bfeb70-af47-424d-908a-948d3f08e37f + type: string + url: + description: The URL to look at the pipeline in the CI provider UI. + example: https://ci-platform.com/pipelines/123456789 + type: string + required: + - id + type: object + CIAppPipelineEventPreviousPipeline: + description: >- + If the pipeline is a retry, this should contain the details of the + previous attempt. + nullable: true + properties: + id: + description: UUID of a pipeline. + example: 93bfeb70-af47-424d-908a-948d3f08e37f + type: string + url: + description: The URL to look at the pipeline in the CI provider UI. + example: https://ci-platform.com/pipelines/123456789 + type: string + required: + - id + type: object + CIAppPipelineEventPipelineStatus: + description: The final status of the pipeline. + enum: + - success + - error + - canceled + - skipped + - blocked + example: success + type: string + x-enum-varnames: + - SUCCESS + - ERROR + - CANCELED + - SKIPPED + - BLOCKED + CIAppPipelineEventPipelineInProgressStatus: + description: The in progress status of the pipeline. + enum: + - running + example: running + type: string + x-enum-varnames: + - RUNNING + CIAppCIErrorDomain: + description: >- + Error category used to differentiate between issues related to the + developer or provider environments. + enum: + - provider + - user + - unknown + type: string + x-enum-varnames: + - PROVIDER + - USER + - UNKNOWN + CompletionConditionOperator: + description: The definition of `CompletionConditionOperator` object. + enum: + - OPERATOR_EQUAL + - OPERATOR_NOT_EQUAL + - OPERATOR_GREATER_THAN + - OPERATOR_LESS_THAN + - OPERATOR_GREATER_THAN_OR_EQUAL_TO + - OPERATOR_LESS_THAN_OR_EQUAL_TO + - OPERATOR_CONTAINS + - OPERATOR_DOES_NOT_CONTAIN + - OPERATOR_IS_NULL + - OPERATOR_IS_NOT_NULL + - OPERATOR_IS_EMPTY + - OPERATOR_IS_NOT_EMPTY + example: OPERATOR_EQUAL + type: string + x-enum-varnames: + - OPERATOR_EQUAL + - OPERATOR_NOT_EQUAL + - OPERATOR_GREATER_THAN + - OPERATOR_LESS_THAN + - OPERATOR_GREATER_THAN_OR_EQUAL_TO + - OPERATOR_LESS_THAN_OR_EQUAL_TO + - OPERATOR_CONTAINS + - OPERATOR_DOES_NOT_CONTAIN + - OPERATOR_IS_NULL + - OPERATOR_IS_NOT_NULL + - OPERATOR_IS_EMPTY + - OPERATOR_IS_NOT_EMPTY + RetryStrategyKind: + description: The definition of `RetryStrategyKind` object. + enum: + - RETRY_STRATEGY_LINEAR + example: RETRY_STRATEGY_LINEAR + type: string + x-enum-varnames: + - RETRY_STRATEGY_LINEAR + RetryStrategyLinear: + description: The definition of `RetryStrategyLinear` object. + properties: + interval: + description: >- + The `RetryStrategyLinear` `interval`. The expected format is the + number of seconds ending with an s. For example, 1 day is 86400s + example: '' + type: string + maxRetries: + description: The `RetryStrategyLinear` `maxRetries`. + example: 0 + format: double + type: number + required: + - interval + - maxRetries + type: object + TriggerRateLimit: + description: Defines a rate limit for a trigger. + properties: + count: + description: The `TriggerRateLimit` `count`. + format: int64 + type: integer + interval: + description: >- + The `TriggerRateLimit` `interval`. The expected format is the number + of seconds ending with an s. For example, 1 day is 86400s + type: string + type: object + responses: + BadRequestResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Bad Request + NotAuthorizedResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Authorized + TooManyRequestsResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Too many requests + ForbiddenResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Forbidden + NotFoundResponse: + content: + application/json: + schema: + $ref: '#/components/schemas/APIErrorResponse' + description: Not Found + parameters: + WorkflowId: + description: The ID of the workflow. + in: path + name: workflow_id + required: true + schema: + type: string + PageSize: + description: Size for a given page. The maximum allowed value is 100. + in: query + name: page[size] + required: false + schema: + default: 10 + example: 10 + format: int64 + type: integer + PageNumber: + description: Specific page number to return. + in: query + name: page[number] + required: false + schema: + default: 0 + example: 0 + format: int64 + type: integer + InstanceId: + description: The ID of the workflow instance. + in: path + name: instance_id + required: true + schema: + type: string + x-stackQL-resources: + ci_app_pipeline_events: + id: datadog.software_delivery.ci_app_pipeline_events + name: ci_app_pipeline_events + title: Ci App Pipeline Events + methods: + create_ciapp_pipeline_event: + operation: + $ref: '#/paths/~1api~1v2~1ci~1pipeline/post' + response: + mediaType: application/json + openAPIDocKey: '202' + aggregate_ciapp_pipeline_events: + operation: + $ref: '#/paths/~1api~1v2~1ci~1pipelines~1analytics~1aggregate/post' + response: + mediaType: application/json + openAPIDocKey: '200' + list_ciapp_pipeline_events: + operation: + $ref: '#/paths/~1api~1v2~1ci~1pipelines~1events/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + search_ciapp_pipeline_events: + operation: + $ref: '#/paths/~1api~1v2~1ci~1pipelines~1events~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/ci_app_pipeline_events/methods/list_ciapp_pipeline_events + insert: + - $ref: >- + #/components/x-stackQL-resources/ci_app_pipeline_events/methods/create_ciapp_pipeline_event + update: [] + delete: [] + replace: [] + ci_app_test_events: + id: datadog.software_delivery.ci_app_test_events + name: ci_app_test_events + title: Ci App Test Events + methods: + aggregate_ciapp_test_events: + operation: + $ref: '#/paths/~1api~1v2~1ci~1tests~1analytics~1aggregate/post' + response: + mediaType: application/json + openAPIDocKey: '200' + list_ciapp_test_events: + operation: + $ref: '#/paths/~1api~1v2~1ci~1tests~1events/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + search_ciapp_test_events: + operation: + $ref: '#/paths/~1api~1v2~1ci~1tests~1events~1search/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/ci_app_test_events/methods/list_ciapp_test_events + insert: + - $ref: >- + #/components/x-stackQL-resources/ci_app_test_events/methods/search_ciapp_test_events + update: [] + delete: [] + replace: [] + dora_deployments: + id: datadog.software_delivery.dora_deployments + name: dora_deployments + title: Dora Deployments + methods: + create_doradeployment: + operation: + $ref: '#/paths/~1api~1v2~1dora~1deployment/post' + response: + mediaType: application/json + openAPIDocKey: '200' + list_doradeployments: + operation: + $ref: '#/paths/~1api~1v2~1dora~1deployments/post' + response: + mediaType: application/json + openAPIDocKey: '200' + get_doradeployment: + operation: + $ref: '#/paths/~1api~1v2~1dora~1deployments~1{deployment_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/dora_deployments/methods/get_doradeployment + - $ref: >- + #/components/x-stackQL-resources/dora_deployments/methods/list_doradeployments + insert: + - $ref: >- + #/components/x-stackQL-resources/dora_deployments/methods/create_doradeployment + update: [] + delete: [] + replace: [] + dora_failures: + id: datadog.software_delivery.dora_failures + name: dora_failures + title: Dora Failures + methods: + create_dorafailure: + operation: + $ref: '#/paths/~1api~1v2~1dora~1failure/post' + response: + mediaType: application/json + openAPIDocKey: '200' + list_dorafailures: + operation: + $ref: '#/paths/~1api~1v2~1dora~1failures/post' + response: + mediaType: application/json + openAPIDocKey: '200' + get_dorafailure: + operation: + $ref: '#/paths/~1api~1v2~1dora~1failures~1{failure_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/dora_failures/methods/get_dorafailure + - $ref: >- + #/components/x-stackQL-resources/dora_failures/methods/list_dorafailures + insert: + - $ref: >- + #/components/x-stackQL-resources/dora_failures/methods/create_dorafailure + update: [] + delete: [] + replace: [] + dora_incidents: + id: datadog.software_delivery.dora_incidents + name: dora_incidents + title: Dora Incidents + methods: + create_doraincident: + operation: + $ref: '#/paths/~1api~1v2~1dora~1incident/post' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: [] + insert: + - $ref: >- + #/components/x-stackQL-resources/dora_incidents/methods/create_doraincident + update: [] + delete: [] + replace: [] + workflows: + id: datadog.software_delivery.workflows + name: workflows + title: Workflows + methods: + create_workflow: + operation: + $ref: '#/paths/~1api~1v2~1workflows/post' + response: + mediaType: application/json + openAPIDocKey: '201' + delete_workflow: + operation: + $ref: '#/paths/~1api~1v2~1workflows~1{workflow_id}/delete' + response: + mediaType: application/json + openAPIDocKey: '204' + get_workflow: + operation: + $ref: '#/paths/~1api~1v2~1workflows~1{workflow_id}/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + update_workflow: + operation: + $ref: '#/paths/~1api~1v2~1workflows~1{workflow_id}/patch' + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: '#/components/x-stackQL-resources/workflows/methods/get_workflow' + insert: + - $ref: '#/components/x-stackQL-resources/workflows/methods/create_workflow' + update: + - $ref: '#/components/x-stackQL-resources/workflows/methods/update_workflow' + delete: + - $ref: '#/components/x-stackQL-resources/workflows/methods/delete_workflow' + replace: [] + workflow_instances: + id: datadog.software_delivery.workflow_instances + name: workflow_instances + title: Workflow Instances + methods: + list_workflow_instances: + operation: + $ref: '#/paths/~1api~1v2~1workflows~1{workflow_id}~1instances/get' + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + create_workflow_instance: + operation: + $ref: '#/paths/~1api~1v2~1workflows~1{workflow_id}~1instances/post' + response: + mediaType: application/json + openAPIDocKey: '200' + get_workflow_instance: + operation: + $ref: >- + #/paths/~1api~1v2~1workflows~1{workflow_id}~1instances~1{instance_id}/get + response: + mediaType: application/json + openAPIDocKey: '200' + objectKey: $.data + cancel_workflow_instance: + operation: + $ref: >- + #/paths/~1api~1v2~1workflows~1{workflow_id}~1instances~1{instance_id}~1cancel/put + response: + mediaType: application/json + openAPIDocKey: '200' + sqlVerbs: + select: + - $ref: >- + #/components/x-stackQL-resources/workflow_instances/methods/get_workflow_instance + - $ref: >- + #/components/x-stackQL-resources/workflow_instances/methods/list_workflow_instances + insert: + - $ref: >- + #/components/x-stackQL-resources/workflow_instances/methods/create_workflow_instance + update: [] + delete: [] + replace: [] +servers: + - url: >- + https://{region:^(?:[^\:/]+(?:\:[0-9]+)?|[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+(?:\:[0-9]+)?)$}/ + variables: + region: + default: datadoghq.com diff --git a/providers/src/datadog/v00.00.00000/services/span_metrics.yaml b/providers/src/datadog/v00.00.00000/services/span_metrics.yaml deleted file mode 100644 index 1295d6ab..00000000 --- a/providers/src/datadog/v00.00.00000/services/span_metrics.yaml +++ /dev/null @@ -1,1287 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - span_metrics - description: Spans_Metrics -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - SpansMetricsResponse: - description: All the available span-based metric objects. - properties: - data: - description: A list of span-based metric objects. - items: - $ref: '#/components/schemas/SpansMetricResponseData' - type: array - type: object - SpansMetricResponseData: - description: The span-based metric properties. - properties: - attributes: - $ref: '#/components/schemas/SpansMetricResponseAttributes' - id: - $ref: '#/components/schemas/SpansMetricID' - type: - $ref: '#/components/schemas/SpansMetricType' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - SpansMetricResponseAttributes: - description: The object describing a Datadog span-based metric. - properties: - compute: - $ref: '#/components/schemas/SpansMetricResponseCompute' - filter: - $ref: '#/components/schemas/SpansMetricResponseFilter' - group_by: - description: The rules for the group by. - items: - $ref: '#/components/schemas/SpansMetricResponseGroupBy' - type: array - type: object - SpansMetricID: - description: The name of the span-based metric. - example: my.metric - type: string - SpansMetricType: - default: spans_metrics - description: The type of resource. The value should always be spans_metrics. - enum: - - spans_metrics - example: spans_metrics - type: string - x-enum-varnames: - - SPANS_METRICS - SpansMetricResponseCompute: - description: The compute rule to compute the span-based metric. - properties: - aggregation_type: - $ref: '#/components/schemas/SpansMetricComputeAggregationType' - include_percentiles: - $ref: '#/components/schemas/SpansMetricComputeIncludePercentiles' - path: - description: The path to the value the span-based metric will aggregate on (only used if the aggregation type is a "distribution"). - example: '@duration' - type: string - type: object - SpansMetricResponseFilter: - description: The span-based metric filter. Spans matching this filter will be aggregated in this metric. - properties: - query: - description: The search query - following the span search syntax. - example: '@http.status_code:200 service:my-service' - type: string - type: object - SpansMetricResponseGroupBy: - description: A group by rule. - properties: - path: - description: The path to the value the span-based metric will be aggregated over. - example: resource_name - type: string - tag_name: - description: 'Eventual name of the tag that gets created. By default, the path attribute is used as the tag name.' - example: resource_name - type: string - type: object - SpansMetricComputeAggregationType: - description: The type of aggregation to use. - enum: - - count - - distribution - example: distribution - type: string - x-enum-varnames: - - COUNT - - DISTRIBUTION - SpansMetricComputeIncludePercentiles: - description: |- - Toggle to include or exclude percentile aggregations for distribution metrics. - Only present when the `aggregation_type` is `distribution`. - example: false - type: boolean - SpansMetricCreateRequest: - description: The new span-based metric body. - properties: - data: - $ref: '#/components/schemas/SpansMetricCreateData' - required: - - data - type: object - SpansMetricResponse: - description: The span-based metric object. - properties: - data: - $ref: '#/components/schemas/SpansMetricResponseData' - type: object - SpansMetricCreateData: - description: The new span-based metric properties. - properties: - attributes: - $ref: '#/components/schemas/SpansMetricCreateAttributes' - id: - $ref: '#/components/schemas/SpansMetricID' - type: - $ref: '#/components/schemas/SpansMetricType' - required: - - id - - type - - attributes - type: object - SpansMetricCreateAttributes: - description: The object describing the Datadog span-based metric to create. - properties: - compute: - $ref: '#/components/schemas/SpansMetricCompute' - filter: - $ref: '#/components/schemas/SpansMetricFilter' - group_by: - description: The rules for the group by. - items: - $ref: '#/components/schemas/SpansMetricGroupBy' - type: array - required: - - compute - type: object - SpansMetricCompute: - description: The compute rule to compute the span-based metric. - properties: - aggregation_type: - $ref: '#/components/schemas/SpansMetricComputeAggregationType' - include_percentiles: - $ref: '#/components/schemas/SpansMetricComputeIncludePercentiles' - path: - description: The path to the value the span-based metric will aggregate on (only used if the aggregation type is a "distribution"). - example: '@duration' - type: string - required: - - aggregation_type - type: object - SpansMetricFilter: - description: The span-based metric filter. Spans matching this filter will be aggregated in this metric. - properties: - query: - default: '*' - description: The search query - following the span search syntax. - example: '@http.status_code:200 service:my-service' - type: string - type: object - SpansMetricGroupBy: - description: A group by rule. - properties: - path: - description: The path to the value the span-based metric will be aggregated over. - example: resource_name - type: string - tag_name: - description: 'Eventual name of the tag that gets created. By default, the path attribute is used as the tag name.' - example: resource_name - type: string - required: - - path - type: object - SpansMetricUpdateRequest: - description: The new span-based metric body. - properties: - data: - $ref: '#/components/schemas/SpansMetricUpdateData' - required: - - data - type: object - SpansMetricUpdateData: - description: The new span-based metric properties. - properties: - attributes: - $ref: '#/components/schemas/SpansMetricUpdateAttributes' - type: - $ref: '#/components/schemas/SpansMetricType' - required: - - type - - attributes - type: object - SpansMetricUpdateAttributes: - description: The span-based metric properties that will be updated. - properties: - compute: - $ref: '#/components/schemas/SpansMetricUpdateCompute' - filter: - $ref: '#/components/schemas/SpansMetricFilter' - group_by: - description: The rules for the group by. - items: - $ref: '#/components/schemas/SpansMetricGroupBy' - type: array - type: object - SpansMetricUpdateCompute: - description: The compute rule to compute the span-based metric. - properties: - include_percentiles: - $ref: '#/components/schemas/SpansMetricComputeIncludePercentiles' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - NotAuthorizedResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Authorized - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ConflictResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Conflict - NotFoundResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not Found - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - span_metrics: - id: datadog.span_metrics.span_metrics - name: span_metrics - title: Span Metrics - methods: - list_spans_metrics: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1metrics/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_spans_metrics: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1metrics/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_spans_metric: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1metrics/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_spans_metric: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1metrics~1{metric_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_spans_metric: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1metrics~1{metric_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_spans_metric: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1metrics~1{metric_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_spans_metric: - operation: - $ref: '#/paths/~1api~1v2~1apm~1config~1metrics~1{metric_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/span_metrics/methods/get_spans_metric' - - $ref: '#/components/x-stackQL-resources/span_metrics/methods/list_spans_metrics' - insert: - - $ref: '#/components/x-stackQL-resources/span_metrics/methods/create_spans_metric' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/span_metrics/methods/delete_spans_metric' -paths: - /api/v2/apm/config/metrics: - get: - description: Get the list of configured span-based metrics with their definitions. - operationId: ListSpansMetrics - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SpansMetricsResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get all span-based metrics - tags: - - Spans Metrics - post: - description: |- - Create a metric based on your ingested spans in your organization. - Returns the span-based metric object from the request body when the request is successful. - operationId: CreateSpansMetric - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SpansMetricCreateRequest' - description: The definition of the new span-based metric. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SpansMetricResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '409': - $ref: '#/components/responses/ConflictResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Create a span-based metric - tags: - - Spans Metrics - x-codegen-request-body-name: body - '/api/v2/apm/config/metrics/{metric_id}': - delete: - description: Delete a specific span-based metric from your organization. - operationId: DeleteSpansMetric - parameters: - - $ref: '#/components/parameters/SpansMetricIDParameter' - responses: - '204': - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Delete a span-based metric - tags: - - Spans Metrics - get: - description: Get a specific span-based metric from your organization. - operationId: GetSpansMetric - parameters: - - $ref: '#/components/parameters/SpansMetricIDParameter' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SpansMetricResponse' - description: OK - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get a span-based metric - tags: - - Spans Metrics - patch: - description: |- - Update a specific span-based metric from your organization. - Returns the span-based metric object from the request body when the request is successful. - operationId: UpdateSpansMetric - parameters: - - $ref: '#/components/parameters/SpansMetricIDParameter' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SpansMetricUpdateRequest' - description: New definition of the span-based metric. - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SpansMetricResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/NotAuthorizedResponse' - '404': - $ref: '#/components/responses/NotFoundResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Update a span-based metric - tags: - - Spans Metrics - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/spans.yaml b/providers/src/datadog/v00.00.00000/services/spans.yaml deleted file mode 100644 index b5c85e1d..00000000 --- a/providers/src/datadog/v00.00.00000/services/spans.yaml +++ /dev/null @@ -1,1736 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - spans - description: Search and aggregate your spans from your Datadog platform over HTTP. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - SpansAggregateRequest: - description: The object sent with the request to retrieve a list of aggregated spans from your organization. - properties: - data: - $ref: '#/components/schemas/SpansAggregateData' - type: object - SpansAggregateResponse: - description: The response object for the spans aggregate API endpoint. - properties: - data: - description: 'The list of matching buckets, one item per bucket.' - items: - $ref: '#/components/schemas/SpansAggregateBucket' - type: array - meta: - $ref: '#/components/schemas/SpansAggregateResponseMetadata' - type: object - SpansAggregateData: - description: The object containing the query content. - properties: - attributes: - $ref: '#/components/schemas/SpansAggregateRequestAttributes' - type: - $ref: '#/components/schemas/SpansAggregateRequestType' - type: object - SpansAggregateBucket: - description: Spans aggregate. - properties: - attributes: - $ref: '#/components/schemas/SpansAggregateBucketAttributes' - id: - description: ID of the spans aggregate. - type: string - type: - $ref: '#/components/schemas/SpansAggregateBucketType' - type: object - SpansAggregateResponseMetadata: - description: The metadata associated with a request. - properties: - elapsed: - description: The time elapsed in milliseconds. - example: 132 - format: int64 - type: integer - request_id: - description: The identifier of the request. - example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR - type: string - status: - $ref: '#/components/schemas/SpansAggregateResponseStatus' - warnings: - description: |- - A list of warnings (non fatal errors) encountered, partial results might be returned if - warnings are present in the response. - items: - $ref: '#/components/schemas/SpansWarning' - type: array - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - SpansAggregateRequestAttributes: - description: The object containing all the query parameters. - properties: - compute: - description: The list of metrics or timeseries to compute for the retrieved buckets. - items: - $ref: '#/components/schemas/SpansCompute' - type: array - filter: - $ref: '#/components/schemas/SpansQueryFilter' - group_by: - description: The rules for the group by. - items: - $ref: '#/components/schemas/SpansGroupBy' - type: array - options: - $ref: '#/components/schemas/SpansQueryOptions' - type: object - SpansAggregateRequestType: - default: aggregate_request - description: The type of resource. The value should always be aggregate_request. - enum: - - aggregate_request - example: aggregate_request - type: string - x-enum-varnames: - - AGGREGATE_REQUEST - SpansAggregateBucketAttributes: - description: A bucket values. - properties: - by: - additionalProperties: - description: The values for each group by. - description: 'The key, value pairs for each group by.' - example: - '@state': success - '@version': abc - type: object - compute: - description: The compute data. - type: object - computes: - additionalProperties: - $ref: '#/components/schemas/SpansAggregateBucketValue' - description: A map of the metric name -> value for regular compute or list of values for a timeseries. - type: object - type: object - SpansAggregateBucketType: - description: The spans aggregate bucket type. - enum: - - bucket - example: bucket - type: string - x-enum-varnames: - - BUCKET - SpansAggregateResponseStatus: - description: The status of the response. - enum: - - done - - timeout - example: done - type: string - x-enum-varnames: - - DONE - - TIMEOUT - SpansWarning: - description: A warning message indicating something that went wrong with the query. - properties: - code: - description: A unique code for this type of warning. - example: unknown_index - type: string - detail: - description: A detailed explanation of this specific warning. - example: 'indexes: foo, bar' - type: string - title: - description: A short human-readable summary of the warning. - example: 'One or several indexes are missing or invalid, results hold data from the other indexes' - type: string - type: object - SpansCompute: - description: A compute rule to compute metrics or timeseries. - properties: - aggregation: - $ref: '#/components/schemas/SpansAggregationFunction' - interval: - description: |- - The time buckets' size (only used for type=timeseries) - Defaults to a resolution of 150 points. - example: 5m - type: string - metric: - description: The metric to use. - example: '@duration' - type: string - type: - $ref: '#/components/schemas/SpansComputeType' - required: - - aggregation - type: object - SpansQueryFilter: - description: The search and filter query settings. - properties: - from: - default: now-15m - description: 'The minimum time for the requested spans, supports date-time ISO8601, date math, and regular timestamps (milliseconds).' - example: now-15m - type: string - query: - default: '*' - description: The search query - following the span search syntax. - example: 'service:web* AND @http.status_code:[200 TO 299]' - type: string - to: - default: now - description: 'The maximum time for the requested spans, supports date-time ISO8601, date math, and regular timestamps (milliseconds).' - example: now - type: string - type: object - SpansGroupBy: - description: A group by rule. - properties: - facet: - description: The name of the facet to use (required). - example: host - type: string - histogram: - $ref: '#/components/schemas/SpansGroupByHistogram' - limit: - default: 10 - description: The maximum buckets to return for this group by. - format: int64 - type: integer - missing: - $ref: '#/components/schemas/SpansGroupByMissing' - sort: - $ref: '#/components/schemas/SpansAggregateSort' - total: - $ref: '#/components/schemas/SpansGroupByTotal' - required: - - facet - type: object - SpansQueryOptions: - description: |- - Global query options that are used during the query. - Note: You should only supply timezone or time offset but not both otherwise the query will fail. - properties: - timeOffset: - description: The time offset (in seconds) to apply to the query. - format: int64 - type: integer - timezone: - default: UTC - description: 'The timezone can be specified as GMT, UTC, an offset from UTC (like UTC+1), or as a Timezone Database identifier (like America/New_York).' - example: GMT - type: string - type: object - SpansAggregateBucketValue: - description: 'A bucket value, can be either a timeseries or a single value.' - oneOf: - - $ref: '#/components/schemas/SpansAggregateBucketValueSingleString' - - $ref: '#/components/schemas/SpansAggregateBucketValueSingleNumber' - - $ref: '#/components/schemas/SpansAggregateBucketValueTimeseries' - SpansAggregationFunction: - description: An aggregation function. - enum: - - count - - cardinality - - pc75 - - pc90 - - pc95 - - pc98 - - pc99 - - sum - - min - - max - - avg - - median - example: pc90 - type: string - x-enum-varnames: - - COUNT - - CARDINALITY - - PERCENTILE_75 - - PERCENTILE_90 - - PERCENTILE_95 - - PERCENTILE_98 - - PERCENTILE_99 - - SUM - - MIN - - MAX - - AVG - - MEDIAN - SpansComputeType: - default: total - description: The type of compute. - enum: - - timeseries - - total - type: string - x-enum-varnames: - - TIMESERIES - - TOTAL - SpansGroupByHistogram: - description: |- - Used to perform a histogram computation (only for measure facets). - Note: At most 100 buckets are allowed, the number of buckets is (max - min)/interval. - properties: - interval: - description: The bin size of the histogram buckets. - example: 10 - format: double - type: number - max: - description: |- - The maximum value for the measure used in the histogram - (values greater than this one are filtered out). - example: 100 - format: double - type: number - min: - description: |- - The minimum value for the measure used in the histogram - (values smaller than this one are filtered out). - example: 50 - format: double - type: number - required: - - interval - - min - - max - type: object - SpansGroupByMissing: - description: The value to use for spans that don't have the facet used to group by. - oneOf: - - $ref: '#/components/schemas/SpansGroupByMissingString' - - $ref: '#/components/schemas/SpansGroupByMissingNumber' - SpansAggregateSort: - description: A sort rule. - example: - aggregation: count - order: asc - properties: - aggregation: - $ref: '#/components/schemas/SpansAggregationFunction' - metric: - description: The metric to sort by (only used for `type=measure`). - example: '@duration' - type: string - order: - $ref: '#/components/schemas/SpansSortOrder' - type: - $ref: '#/components/schemas/SpansAggregateSortType' - type: object - SpansGroupByTotal: - default: false - description: A resulting object to put the given computes in over all the matching records. - oneOf: - - $ref: '#/components/schemas/SpansGroupByTotalBoolean' - - $ref: '#/components/schemas/SpansGroupByTotalString' - - $ref: '#/components/schemas/SpansGroupByTotalNumber' - SpansAggregateBucketValueSingleString: - description: A single string value. - type: string - SpansAggregateBucketValueSingleNumber: - description: A single number value. - format: double - type: number - SpansAggregateBucketValueTimeseries: - description: A timeseries array. - items: - $ref: '#/components/schemas/SpansAggregateBucketValueTimeseriesPoint' - type: array - x-generate-alias-as-model: true - SpansGroupByMissingString: - description: The missing value to use if there is string valued facet. - type: string - SpansGroupByMissingNumber: - description: The missing value to use if there is a number valued facet. - format: double - type: number - SpansSortOrder: - description: 'The order to use, ascending or descending.' - enum: - - asc - - desc - example: asc - type: string - x-enum-varnames: - - ASCENDING - - DESCENDING - SpansAggregateSortType: - default: alphabetical - description: The type of sorting algorithm. - enum: - - alphabetical - - measure - type: string - x-enum-varnames: - - ALPHABETICAL - - MEASURE - SpansGroupByTotalBoolean: - description: 'If set to true, creates an additional bucket labeled "$facet_total".' - type: boolean - SpansGroupByTotalString: - description: A string to use as the key value for the total bucket. - type: string - SpansGroupByTotalNumber: - description: A number to use as the key value for the total bucket. - format: double - type: number - SpansAggregateBucketValueTimeseriesPoint: - description: A timeseries point. - properties: - time: - description: The time value for this point. - example: '2023-06-08T11:55:00Z' - type: string - value: - description: The value for this point. - example: 19 - format: double - type: number - type: object - SpansSort: - description: Sort parameters when querying spans. - enum: - - timestamp - - '-timestamp' - type: string - x-enum-varnames: - - TIMESTAMP_ASCENDING - - TIMESTAMP_DESCENDING - SpansListResponse: - description: Response object with all spans matching the request and pagination information. - properties: - data: - description: Array of spans matching the request. - items: - $ref: '#/components/schemas/Span' - type: array - links: - $ref: '#/components/schemas/SpansListResponseLinks' - meta: - $ref: '#/components/schemas/SpansListResponseMetadata' - type: object - Span: - description: Object description of a spans after being processed and stored by Datadog. - properties: - attributes: - $ref: '#/components/schemas/SpansAttributes' - id: - description: Unique ID of the Span. - example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA - type: string - type: - $ref: '#/components/schemas/SpansType' - type: object - SpansListResponseLinks: - description: Links attributes. - properties: - next: - description: |- - Link for the next set of results. Note that the request can also be made using the - POST endpoint. - example: 'https://app.datadoghq.com/api/v2/spans/event?filter[query]=foo&page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==' - type: string - type: object - SpansListResponseMetadata: - description: The metadata associated with a request. - properties: - elapsed: - description: The time elapsed in milliseconds. - example: 132 - format: int64 - type: integer - page: - $ref: '#/components/schemas/SpansResponseMetadataPage' - request_id: - description: The identifier of the request. - example: MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR - type: string - status: - $ref: '#/components/schemas/SpansAggregateResponseStatus' - warnings: - description: |- - A list of warnings (non fatal errors) encountered, partial results might be returned if - warnings are present in the response. - items: - $ref: '#/components/schemas/SpansWarning' - type: array - type: object - JSONAPIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - $ref: '#/components/schemas/JSONAPIErrorItem' - type: array - required: - - errors - type: object - SpansAttributes: - description: JSON object containing all span attributes and their associated values. - properties: - attributes: - additionalProperties: {} - description: JSON object of attributes from your span. - example: - customAttribute: 123 - duration: 2345 - type: object - custom: - additionalProperties: {} - description: JSON object of custom spans data. - type: object - end_timestamp: - description: End timestamp of your span. - example: '2023-01-02T09:42:36.420Z' - format: date-time - type: string - env: - description: Name of the environment from where the spans are being sent. - example: prod - type: string - host: - description: Name of the machine from where the spans are being sent. - example: i-0123 - type: string - ingestion_reason: - description: The reason why the span was ingested. - example: rule - type: string - parent_id: - description: Id of the span that's parent of this span. - example: '0' - type: string - resource_hash: - description: Unique identifier of the resource. - example: a12345678b91c23d - type: string - resource_name: - description: The name of the resource. - example: agent - type: string - retained_by: - description: The reason why the span was indexed. - example: retention_filter - type: string - service: - description: |- - The name of the application or service generating the span events. - It is used to switch from APM to Logs, so make sure you define the same - value when you use both products. - example: agent - type: string - single_span: - description: Whether or not the span was collected as a stand-alone span. Always associated to "single_span" ingestion_reason if true. - example: true - type: boolean - span_id: - description: Id of the span. - example: '1234567890987654321' - type: string - start_timestamp: - description: Start timestamp of your span. - example: '2023-01-02T09:42:36.320Z' - format: date-time - type: string - tags: - description: Array of tags associated with your span. - example: - - 'team:A' - items: - description: Tag associated with your span. - type: string - type: array - trace_id: - description: Id of the trace to which the span belongs. - example: '1234567890987654321' - type: string - type: - description: The type of the span. - example: web - type: string - type: object - SpansType: - default: spans - description: Type of the span. - enum: - - spans - example: spans - type: string - x-enum-varnames: - - SPANS - SpansResponseMetadataPage: - description: Paging attributes. - properties: - after: - description: |- - The cursor to use to get the next results, if any. To make the next request, use the same - parameters with the addition of the `page[cursor]`. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - type: object - JSONAPIErrorItem: - description: API error response body - properties: - detail: - description: A human-readable explanation specific to this occurrence of the error. - example: Missing required attribute in body - type: string - status: - description: Status code of the response. - example: '400' - type: string - title: - description: Short human-readable summary of the error. - example: Bad Request - type: string - type: object - SpansListRequest: - description: The request for a spans list. - properties: - data: - $ref: '#/components/schemas/SpansListRequestData' - type: object - SpansListRequestData: - description: The object containing the query content. - properties: - attributes: - $ref: '#/components/schemas/SpansListRequestAttributes' - type: - $ref: '#/components/schemas/SpansListRequestType' - type: object - SpansListRequestAttributes: - description: The object containing all the query parameters. - properties: - filter: - $ref: '#/components/schemas/SpansQueryFilter' - options: - $ref: '#/components/schemas/SpansQueryOptions' - page: - $ref: '#/components/schemas/SpansListRequestPage' - sort: - $ref: '#/components/schemas/SpansSort' - type: object - SpansListRequestType: - default: search_request - description: The type of resource. The value should always be search_request. - enum: - - search_request - example: search_request - type: string - x-enum-varnames: - - SEARCH_REQUEST - SpansListRequestPage: - description: Paging attributes for listing spans. - properties: - cursor: - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - type: string - limit: - default: 10 - description: Maximum number of spans in the response. - example: 25 - format: int32 - maximum: 1000 - type: integer - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - BadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - SpansBadRequestResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: Bad Request. - SpansForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: 'Forbidden: Access denied.' - SpansUnprocessableEntityResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: Unprocessable Entity. - SpansTooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/JSONAPIErrorResponse' - description: 'Too many requests: The rate limit set by the API has been exceeded.' - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - spans: - id: datadog.spans.spans - name: spans - title: Spans - methods: - aggregate_spans: - operation: - $ref: '#/paths/~1api~1v2~1spans~1analytics~1aggregate/post' - response: - mediaType: application/json - openAPIDocKey: '200' - list_spans: - operation: - $ref: '#/paths/~1api~1v2~1spans~1events~1search/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/spans/methods/list_spans' - insert: [] - update: [] - delete: [] - span_query: - id: datadog.spans.span_query - name: span_query - title: Span Query - methods: - list_spans_get: - operation: - $ref: '#/paths/~1api~1v2~1spans~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_spans_get: - operation: - $ref: '#/paths/~1api~1v2~1spans~1events/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/span_query/methods/list_spans_get' - insert: [] - update: [] - delete: [] -paths: - /api/v2/spans/analytics/aggregate: - post: - description: |- - The API endpoint to aggregate spans into buckets and compute metrics and timeseries. - This endpoint is rate limited to `300` requests per hour. - operationId: AggregateSpans - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SpansAggregateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SpansAggregateResponse' - description: OK - '400': - $ref: '#/components/responses/BadRequestResponse' - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Aggregate spans - tags: - - Spans - x-codegen-request-body-name: body - /api/v2/spans/events: - get: - description: |- - List endpoint returns spans that match a span search query. - [Results are paginated][1]. - - Use this endpoint to see your latest spans. - This endpoint is rate limited to `300` requests per hour. - - [1]: /logs/guide/collect-multiple-logs-with-pagination?tab=v2api - operationId: ListSpansGet - parameters: - - description: Search query following spans syntax. - example: '@datacenter:us @role:db' - in: query - name: 'filter[query]' - required: false - schema: - type: string - - description: 'Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).' - example: '2023-01-02T09:42:36.320Z' - in: query - name: 'filter[from]' - required: false - schema: - type: string - - description: 'Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).' - example: '2023-01-03T09:42:36.320Z' - in: query - name: 'filter[to]' - required: false - schema: - type: string - - description: Order of spans in results. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/SpansSort' - - description: List following results with a cursor provided in the previous query. - example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ== - in: query - name: 'page[cursor]' - required: false - schema: - type: string - - description: Maximum number of spans in the response. - example: 25 - in: query - name: 'page[limit]' - required: false - schema: - default: 10 - format: int32 - maximum: 1000 - type: integer - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SpansListResponse' - description: OK - '400': - $ref: '#/components/responses/SpansBadRequestResponse' - '403': - $ref: '#/components/responses/SpansForbiddenResponse' - '422': - $ref: '#/components/responses/SpansUnprocessableEntityResponse' - '429': - $ref: '#/components/responses/SpansTooManyRequestsResponse' - summary: Get a list of spans - tags: - - Spans - x-pagination: - cursorParam: 'page[cursor]' - cursorPath: meta.page.after - limitParam: 'page[limit]' - resultsPath: data - /api/v2/spans/events/search: - post: - description: |- - List endpoint returns spans that match a span search query. - [Results are paginated][1]. - - Use this endpoint to build complex spans filtering and search. - This endpoint is rate limited to `300` requests per hour. - - [1]: /logs/guide/collect-multiple-logs-with-pagination?tab=v2api - operationId: ListSpans - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/SpansListRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/SpansListResponse' - description: OK - '400': - $ref: '#/components/responses/SpansBadRequestResponse' - '403': - $ref: '#/components/responses/SpansForbiddenResponse' - '422': - $ref: '#/components/responses/SpansUnprocessableEntityResponse' - '429': - $ref: '#/components/responses/SpansTooManyRequestsResponse' - summary: Search spans - tags: - - Spans - x-codegen-request-body-name: body - x-pagination: - cursorParam: body.data.attributes.page.cursor - cursorPath: meta.page.after - limitParam: body.data.attributes.page.limit - resultsPath: data diff --git a/providers/src/datadog/v00.00.00000/services/synthetics.yaml b/providers/src/datadog/v00.00.00000/services/synthetics.yaml deleted file mode 100644 index fa4f2108..00000000 --- a/providers/src/datadog/v00.00.00000/services/synthetics.yaml +++ /dev/null @@ -1,978 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - synthetics - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - OnDemandConcurrencyCapResponse: - description: On-demand concurrency cap response. - properties: - data: - $ref: '#/components/schemas/OnDemandConcurrencyCap' - type: object - OnDemandConcurrencyCap: - description: On-demand concurrency cap. - properties: - attributes: - $ref: '#/components/schemas/OnDemandConcurrencyCapAttributes' - type: - $ref: '#/components/schemas/OnDemandConcurrencyCapType' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - OnDemandConcurrencyCapAttributes: - description: On-demand concurrency cap attributes. - properties: - on_demand_concurrency_cap: - description: Value of the on-demand concurrency cap. - format: double - type: number - type: object - OnDemandConcurrencyCapType: - description: On-demand concurrency cap type. - enum: - - on_demand_concurrency_cap - type: string - x-enum-varnames: - - ON_DEMAND_CONCURRENCY_CAP - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - on_demand_concurrency_caps: - id: datadog.synthetics.on_demand_concurrency_caps - name: on_demand_concurrency_caps - title: On Demand Concurrency Caps - methods: - get_on_demand_concurrency_cap: - operation: - $ref: '#/paths/~1api~1v2~1synthetics~1settings~1on_demand_concurrency_cap/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_on_demand_concurrency_cap: - operation: - $ref: '#/paths/~1api~1v2~1synthetics~1settings~1on_demand_concurrency_cap/get' - response: - mediaType: application/json - openAPIDocKey: '200' - set_on_demand_concurrency_cap: - operation: - $ref: '#/paths/~1api~1v2~1synthetics~1settings~1on_demand_concurrency_cap/post' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/on_demand_concurrency_caps/methods/get_on_demand_concurrency_cap' - insert: [] - update: [] - delete: [] -paths: - /api/v2/synthetics/settings/on_demand_concurrency_cap: - get: - description: Get the on-demand concurrency cap. - operationId: GetOnDemandConcurrencyCap - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OnDemandConcurrencyCapResponse' - description: OK - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Get the on-demand concurrency cap - tags: - - Synthetics - post: - description: Save new value for on-demand concurrency cap. - operationId: SetOnDemandConcurrencyCap - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/OnDemandConcurrencyCapAttributes' - description: . - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/OnDemandConcurrencyCapResponse' - description: OK - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - summary: Save new value for on-demand concurrency cap - tags: - - Synthetics - x-codegen-request-body-name: body diff --git a/providers/src/datadog/v00.00.00000/services/teams.yaml b/providers/src/datadog/v00.00.00000/services/teams.yaml deleted file mode 100644 index 3312666d..00000000 --- a/providers/src/datadog/v00.00.00000/services/teams.yaml +++ /dev/null @@ -1,2837 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - teams - description: View and manage teams within Datadog. -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ListTeamsSort: - description: Specifies the order of the returned teams - enum: - - name - - '-name' - - user_count - - '-user_count' - type: string - x-enum-varnames: - - NAME - - _NAME - - USER_COUNT - - _USER_COUNT - ListTeamsInclude: - description: Included related resources optionally requested. - enum: - - team_links - - user_team_permissions - type: string - x-enum-varnames: - - TEAM_LINKS - - USER_TEAM_PERMISSIONS - TeamsField: - description: Supported teams field. - enum: - - id - - name - - handle - - summary - - description - - avatar - - banner - - visible_modules - - hidden_modules - - created_at - - modified_at - - user_count - - link_count - - team_links - - user_team_permissions - type: string - x-enum-varnames: - - ID - - NAME - - HANDLE - - SUMMARY - - DESCRIPTION - - AVATAR - - BANNER - - VISIBLE_MODULES - - HIDDEN_MODULES - - CREATED_AT - - MODIFIED_AT - - USER_COUNT - - LINK_COUNT - - TEAM_LINKS - - USER_TEAM_PERMISSIONS - TeamsResponse: - description: Response with multiple teams - properties: - data: - description: Teams response data - items: - $ref: '#/components/schemas/Team' - type: array - included: - description: Resources related to the team - items: - $ref: '#/components/schemas/TeamIncluded' - type: array - links: - $ref: '#/components/schemas/TeamsResponseLinks' - meta: - $ref: '#/components/schemas/TeamsResponseMeta' - type: object - Team: - description: A team - properties: - attributes: - $ref: '#/components/schemas/TeamAttributes' - id: - description: The team's identifier - example: aeadc05e-98a8-11ec-ac2c-da7ad0900001 - type: string - relationships: - $ref: '#/components/schemas/TeamRelationships' - type: - $ref: '#/components/schemas/TeamType' - required: - - attributes - - id - - type - type: object - TeamIncluded: - description: Included resources related to the team - oneOf: - - $ref: '#/components/schemas/User' - - $ref: '#/components/schemas/TeamLink' - - $ref: '#/components/schemas/UserTeamPermission' - TeamsResponseLinks: - description: Teams response links. - properties: - first: - description: First link. - type: string - last: - description: Last link. - nullable: true - type: string - next: - description: Next link. - type: string - prev: - description: Previous link. - nullable: true - type: string - self: - description: Current link. - type: string - type: object - TeamsResponseMeta: - description: Teams response metadata. - properties: - pagination: - $ref: '#/components/schemas/TeamsResponseMetaPagination' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - TeamAttributes: - description: Team attributes - properties: - avatar: - description: 'Unicode representation of the avatar for the team, limited to a single grapheme' - example: "\U0001F951" - nullable: true - type: string - banner: - description: Banner selection for the team - format: int64 - nullable: true - type: integer - created_at: - description: Creation date of the team - format: date-time - type: string - description: - description: Free-form markdown description/content for the team's homepage - nullable: true - type: string - handle: - description: The team's identifier - example: example-team - maxLength: 195 - type: string - hidden_modules: - description: Collection of hidden modules for the team - items: - description: String identifier of the module - type: string - type: array - link_count: - description: The number of links belonging to the team - format: int32 - maximum: 2147483647 - readOnly: true - type: integer - modified_at: - description: Modification date of the team - format: date-time - type: string - name: - description: The name of the team - example: Example Team - maxLength: 200 - type: string - summary: - description: 'A brief summary of the team, derived from the `description`' - maxLength: 120 - nullable: true - type: string - user_count: - description: The number of users belonging to the team - format: int32 - maximum: 2147483647 - readOnly: true - type: integer - visible_modules: - description: Collection of visible modules for the team - items: - description: String identifier of the module - type: string - type: array - required: - - handle - - name - type: object - TeamRelationships: - description: Resources related to a team - properties: - team_links: - $ref: '#/components/schemas/RelationshipToTeamLinks' - user_team_permissions: - $ref: '#/components/schemas/RelationshipToUserTeamPermission' - type: object - TeamType: - default: team - description: Team type - enum: - - team - example: team - type: string - x-enum-varnames: - - TEAM - User: - description: User object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserAttributes' - id: - description: ID of the user. - type: string - relationships: - $ref: '#/components/schemas/UserResponseRelationships' - type: - $ref: '#/components/schemas/UsersType' - type: object - TeamLink: - description: Team link - properties: - attributes: - $ref: '#/components/schemas/TeamLinkAttributes' - id: - description: The team link's identifier - example: b8626d7e-cedd-11eb-abf5-da7ad0900001 - type: string - type: - $ref: '#/components/schemas/TeamLinkType' - required: - - attributes - - id - - type - type: object - UserTeamPermission: - description: A user's permissions for a given team - properties: - attributes: - $ref: '#/components/schemas/UserTeamPermissionAttributes' - id: - description: The user team permission's identifier - example: UserTeamPermissions-aeadc05e-98a8-11ec-ac2c-da7ad0900001-416595 - type: string - type: - $ref: '#/components/schemas/UserTeamPermissionType' - required: - - id - - type - type: object - TeamsResponseMetaPagination: - description: Teams response metadata. - properties: - first_offset: - description: The first offset. - format: int64 - type: integer - last_offset: - description: The last offset. - format: int64 - type: integer - limit: - description: Pagination limit. - format: int64 - type: integer - next_offset: - description: The next offset. - format: int64 - type: integer - offset: - description: The offset. - format: int64 - type: integer - prev_offset: - description: The previous offset. - format: int64 - type: integer - total: - description: Total results. - format: int64 - type: integer - type: - description: Offset type. - type: string - type: object - RelationshipToTeamLinks: - description: Relationship between a team and a team link - properties: - data: - description: Related team links - items: - $ref: '#/components/schemas/RelationshipToTeamLinkData' - type: array - links: - $ref: '#/components/schemas/TeamRelationshipsLinks' - type: object - RelationshipToUserTeamPermission: - description: Relationship between a user team permission and a team - properties: - data: - $ref: '#/components/schemas/RelationshipToUserTeamPermissionData' - links: - $ref: '#/components/schemas/TeamRelationshipsLinks' - type: object - UserAttributes: - description: Attributes of user object returned by the API. - properties: - created_at: - description: Creation time of the user. - format: date-time - type: string - disabled: - description: Whether the user is disabled. - type: boolean - email: - description: Email of the user. - type: string - handle: - description: Handle of the user. - type: string - icon: - description: URL of the user's icon. - type: string - modified_at: - description: Time that the user was last modified. - format: date-time - type: string - name: - description: Name of the user. - nullable: true - type: string - service_account: - description: Whether the user is a service account. - type: boolean - status: - description: Status of the user. - type: string - title: - description: Title of the user. - nullable: true - type: string - verified: - description: Whether the user is verified. - type: boolean - type: object - UserResponseRelationships: - description: Relationships of the user object returned by the API. - properties: - org: - $ref: '#/components/schemas/RelationshipToOrganization' - other_orgs: - $ref: '#/components/schemas/RelationshipToOrganizations' - other_users: - $ref: '#/components/schemas/RelationshipToUsers' - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - UsersType: - default: users - description: Users resource type. - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - TeamLinkAttributes: - description: Team link attributes - properties: - label: - description: The link's label - example: Link label - maxLength: 256 - type: string - position: - description: 'The link''s position, used to sort links for the team' - format: int32 - maximum: 2147483647 - type: integer - team_id: - description: ID of the team the link is associated with - readOnly: true - type: string - url: - description: The URL for the link - example: 'https://example.com' - type: string - required: - - label - - url - type: object - TeamLinkType: - default: team_links - description: Team link type - enum: - - team_links - example: team_links - type: string - x-enum-varnames: - - TEAM_LINKS - UserTeamPermissionAttributes: - description: User team permission attributes - properties: - permissions: - description: Object of team permission actions and boolean values that a logged in user can perform on this team. - readOnly: true - type: object - type: object - UserTeamPermissionType: - default: user_team_permissions - description: User team permission type - enum: - - user_team_permissions - example: user_team_permissions - type: string - x-enum-varnames: - - USER_TEAM_PERMISSIONS - RelationshipToTeamLinkData: - description: Relationship between a link and a team - properties: - id: - description: The team link's identifier - example: f9bb8444-af7f-11ec-ac2c-da7ad0900001 - type: string - type: - $ref: '#/components/schemas/TeamLinkType' - required: - - id - - type - type: object - TeamRelationshipsLinks: - description: Links attributes. - properties: - related: - description: Related link. - example: /api/v2/team/c75a4a8e-20c7-11ee-a3a5-da7ad0900002/links - type: string - type: object - RelationshipToUserTeamPermissionData: - description: Related user team permission data - properties: - id: - description: The ID of the user team permission - example: UserTeamPermissions-aeadc05e-98a8-11ec-ac2c-da7ad0900001-416595 - type: string - type: - $ref: '#/components/schemas/UserTeamPermissionType' - required: - - id - - type - type: object - RelationshipToOrganization: - description: Relationship to an organization. - properties: - data: - $ref: '#/components/schemas/RelationshipToOrganizationData' - required: - - data - type: object - RelationshipToOrganizations: - description: Relationship to organizations. - properties: - data: - description: Relationships to organization objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToOrganizationData' - type: array - required: - - data - type: object - RelationshipToUsers: - description: Relationship to users. - properties: - data: - description: Relationships to user objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToUserData' - type: array - required: - - data - type: object - RelationshipToRoles: - description: Relationship to roles. - properties: - data: - description: An array containing type and the unique identifier of a role. - items: - $ref: '#/components/schemas/RelationshipToRoleData' - type: array - type: object - RelationshipToOrganizationData: - description: Relationship to organization object. - properties: - id: - description: ID of the organization. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - id - - type - type: object - RelationshipToUserData: - description: Relationship to user object. - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - OrganizationsType: - default: orgs - description: Organizations resource type. - enum: - - orgs - example: orgs - type: string - x-enum-varnames: - - ORGS - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - TeamCreateRequest: - description: Request to create a team - properties: - data: - $ref: '#/components/schemas/TeamCreate' - required: - - data - type: object - TeamResponse: - description: Response with a team - properties: - data: - $ref: '#/components/schemas/Team' - type: object - TeamCreate: - description: Team create - properties: - attributes: - $ref: '#/components/schemas/TeamCreateAttributes' - relationships: - $ref: '#/components/schemas/TeamCreateRelationships' - type: - $ref: '#/components/schemas/TeamType' - required: - - attributes - - type - type: object - TeamCreateAttributes: - description: Team creation attributes - properties: - avatar: - description: 'Unicode representation of the avatar for the team, limited to a single grapheme' - example: "\U0001F951" - nullable: true - type: string - banner: - description: Banner selection for the team - format: int64 - nullable: true - type: integer - description: - description: Free-form markdown description/content for the team's homepage - type: string - handle: - description: The team's identifier - example: example-team - maxLength: 195 - type: string - hidden_modules: - description: Collection of hidden modules for the team - items: - description: String identifier of the module - type: string - type: array - name: - description: The name of the team - example: Example Team - maxLength: 200 - type: string - visible_modules: - description: Collection of visible modules for the team - items: - description: String identifier of the module - type: string - type: array - required: - - handle - - name - type: object - TeamCreateRelationships: - description: Relationships formed with the team on creation - properties: - users: - $ref: '#/components/schemas/RelationshipToUsers' - type: object - TeamUpdateRequest: - description: Team update request - properties: - data: - $ref: '#/components/schemas/TeamUpdate' - required: - - data - type: object - TeamUpdate: - description: Team update request - properties: - attributes: - $ref: '#/components/schemas/TeamUpdateAttributes' - relationships: - $ref: '#/components/schemas/TeamUpdateRelationships' - type: - $ref: '#/components/schemas/TeamType' - required: - - attributes - - type - type: object - TeamUpdateAttributes: - description: Team update attributes - properties: - avatar: - description: 'Unicode representation of the avatar for the team, limited to a single grapheme' - example: "\U0001F951" - nullable: true - type: string - banner: - description: Banner selection for the team - format: int64 - nullable: true - type: integer - color: - description: An identifier for the color representing the team - format: int32 - maximum: 13 - minimum: 0 - type: integer - description: - description: Free-form markdown description/content for the team's homepage - type: string - handle: - description: The team's identifier - example: example-team - maxLength: 195 - type: string - hidden_modules: - description: Collection of hidden modules for the team - items: - description: String identifier of the module - type: string - type: array - name: - description: The name of the team - example: Example Team - maxLength: 200 - type: string - visible_modules: - description: Collection of visible modules for the team - items: - description: String identifier of the module - type: string - type: array - required: - - handle - - name - type: object - TeamUpdateRelationships: - description: Team update relationships - properties: - team_links: - $ref: '#/components/schemas/RelationshipToTeamLinks' - type: object - TeamLinksResponse: - description: Team links response - properties: - data: - description: Team links response data - items: - $ref: '#/components/schemas/TeamLink' - type: array - type: object - TeamLinkCreateRequest: - description: Team link create request - properties: - data: - $ref: '#/components/schemas/TeamLinkCreate' - required: - - data - type: object - TeamLinkResponse: - description: Team link response - properties: - data: - $ref: '#/components/schemas/TeamLink' - type: object - TeamLinkCreate: - description: Team link create - properties: - attributes: - $ref: '#/components/schemas/TeamLinkAttributes' - type: - $ref: '#/components/schemas/TeamLinkType' - required: - - attributes - - type - type: object - GetTeamMembershipsSort: - description: Specifies the order of returned team memberships - enum: - - manager_name - - '-manager_name' - - name - - '-name' - - handle - - '-handle' - - email - - '-email' - type: string - x-enum-varnames: - - MANAGER_NAME - - _MANAGER_NAME - - NAME - - _NAME - - HANDLE - - _HANDLE - - EMAIL - - _EMAIL - UserTeamsResponse: - description: Team memberships response - properties: - data: - description: Team memberships response data - items: - $ref: '#/components/schemas/UserTeam' - type: array - links: - $ref: '#/components/schemas/TeamsResponseLinks' - meta: - $ref: '#/components/schemas/TeamsResponseMeta' - type: object - UserTeam: - description: A user's relationship with a team - properties: - attributes: - $ref: '#/components/schemas/UserTeamAttributes' - id: - description: The ID of a user's relationship with a team - example: TeamMembership-aeadc05e-98a8-11ec-ac2c-da7ad0900001-38835 - type: string - relationships: - $ref: '#/components/schemas/UserTeamRelationships' - type: - $ref: '#/components/schemas/UserTeamType' - required: - - id - - type - type: object - UserTeamAttributes: - description: Team membership attributes - properties: - role: - $ref: '#/components/schemas/UserTeamRole' - type: object - UserTeamRelationships: - description: Relationship between membership and a user - properties: - user: - $ref: '#/components/schemas/RelationshipToUserTeamUser' - type: object - UserTeamType: - default: team_memberships - description: Team membership type - enum: - - team_memberships - example: team_memberships - type: string - x-enum-varnames: - - TEAM_MEMBERSHIPS - UserTeamRole: - description: The user's role within the team - enum: - - admin - nullable: true - type: string - x-enum-varnames: - - ADMIN - RelationshipToUserTeamUser: - description: Relationship between team membership and user - properties: - data: - $ref: '#/components/schemas/RelationshipToUserTeamUserData' - required: - - data - type: object - RelationshipToUserTeamUserData: - description: A user's relationship with a team - properties: - id: - description: The ID of the user associated with the team - example: b8626d7e-cedd-11eb-abf5-da7ad0900001 - type: string - type: - $ref: '#/components/schemas/UserTeamUserType' - required: - - id - - type - type: object - UserTeamUserType: - default: users - description: User team user type - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - UserTeamRequest: - description: Team membership request - properties: - data: - $ref: '#/components/schemas/UserTeamCreate' - required: - - data - type: object - UserTeamResponse: - description: Team membership response - properties: - data: - $ref: '#/components/schemas/UserTeam' - type: object - UserTeamCreate: - description: A user's relationship with a team - properties: - attributes: - $ref: '#/components/schemas/UserTeamAttributes' - relationships: - $ref: '#/components/schemas/UserTeamRelationships' - type: - $ref: '#/components/schemas/UserTeamType' - required: - - type - type: object - UserTeamUpdateRequest: - description: Team membership request - properties: - data: - $ref: '#/components/schemas/UserTeamUpdate' - required: - - data - type: object - UserTeamUpdate: - description: A user's relationship with a team - properties: - attributes: - $ref: '#/components/schemas/UserTeamAttributes' - type: - $ref: '#/components/schemas/UserTeamType' - required: - - type - type: object - TeamPermissionSettingsResponse: - description: Team permission settings response - properties: - data: - description: Team permission settings response data - items: - $ref: '#/components/schemas/TeamPermissionSetting' - type: array - type: object - TeamPermissionSetting: - description: Team permission setting - properties: - attributes: - $ref: '#/components/schemas/TeamPermissionSettingAttributes' - id: - description: The team permission setting's identifier - example: TeamPermission-aeadc05e-98a8-11ec-ac2c-da7ad0900001-edit - type: string - type: - $ref: '#/components/schemas/TeamPermissionSettingType' - required: - - id - - type - type: object - TeamPermissionSettingAttributes: - description: Team permission setting attributes - properties: - action: - $ref: '#/components/schemas/TeamPermissionSettingSerializerAction' - editable: - description: Whether or not the permission setting is editable by the current user - readOnly: true - type: boolean - options: - $ref: '#/components/schemas/TeamPermissionSettingValues' - title: - description: The team permission name - readOnly: true - type: string - value: - $ref: '#/components/schemas/TeamPermissionSettingValue' - type: object - TeamPermissionSettingType: - default: team_permission_settings - description: Team permission setting type - enum: - - team_permission_settings - example: team_permission_settings - type: string - x-enum-varnames: - - TEAM_PERMISSION_SETTINGS - TeamPermissionSettingSerializerAction: - description: The identifier for the action - enum: - - manage_membership - - edit - readOnly: true - type: string - x-enum-varnames: - - MANAGE_MEMBERSHIP - - EDIT - TeamPermissionSettingValues: - description: Possible values for action - items: - $ref: '#/components/schemas/TeamPermissionSettingValue' - readOnly: true - type: array - TeamPermissionSettingValue: - description: What type of user is allowed to perform the specified action - enum: - - admins - - members - - organization - - user_access_manage - - teams_manage - type: string - x-enum-varnames: - - ADMINS - - MEMBERS - - ORGANIZATION - - USER_ACCESS_MANAGE - - TEAMS_MANAGE - TeamPermissionSettingUpdateRequest: - description: Team permission setting update request - properties: - data: - $ref: '#/components/schemas/TeamPermissionSettingUpdate' - required: - - data - type: object - TeamPermissionSettingResponse: - description: Team permission setting response - properties: - data: - $ref: '#/components/schemas/TeamPermissionSetting' - type: object - TeamPermissionSettingUpdate: - description: Team permission setting update - properties: - attributes: - $ref: '#/components/schemas/TeamPermissionSettingUpdateAttributes' - type: - $ref: '#/components/schemas/TeamPermissionSettingType' - required: - - type - type: object - TeamPermissionSettingUpdateAttributes: - description: Team permission setting update attributes - properties: - value: - $ref: '#/components/schemas/TeamPermissionSettingValue' - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - ForbiddenResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - teams: - id: datadog.teams.teams - name: teams - title: Teams - methods: - list_teams: - operation: - $ref: '#/paths/~1api~1v2~1team/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_teams: - operation: - $ref: '#/paths/~1api~1v2~1team/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_team: - operation: - $ref: '#/paths/~1api~1v2~1team/post' - response: - mediaType: application/json - openAPIDocKey: '201' - delete_team: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_team: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_team: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_team: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/teams/methods/get_team' - - $ref: '#/components/x-stackQL-resources/teams/methods/list_teams' - insert: - - $ref: '#/components/x-stackQL-resources/teams/methods/create_team' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/teams/methods/delete_team' - team_links: - id: datadog.teams.team_links - name: team_links - title: Team Links - methods: - get_team_links: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_team_links: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_team_link: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_team_link: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links~1{link_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_team_link: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links~1{link_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_team_link: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links~1{link_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_team_link: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1links~1{link_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/team_links/methods/get_team_link' - - $ref: '#/components/x-stackQL-resources/team_links/methods/get_team_links' - insert: - - $ref: '#/components/x-stackQL-resources/team_links/methods/create_team_link' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/team_links/methods/delete_team_link' - team_memberships: - id: datadog.teams.team_memberships - name: team_memberships - title: Team Memberships - methods: - get_team_memberships: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_team_memberships: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_team_membership: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships/post' - response: - mediaType: application/json - openAPIDocKey: '200' - delete_team_membership: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships~1{user_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - update_team_membership: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1memberships~1{user_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/team_memberships/methods/get_team_memberships' - insert: - - $ref: '#/components/x-stackQL-resources/team_memberships/methods/create_team_membership' - update: [] - delete: - - $ref: '#/components/x-stackQL-resources/team_memberships/methods/delete_team_membership' - team_permission_settings: - id: datadog.teams.team_permission_settings - name: team_permission_settings - title: Team Permission Settings - methods: - get_team_permission_settings: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1permission-settings/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_team_permission_settings: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1permission-settings/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_team_permission_setting: - operation: - $ref: '#/paths/~1api~1v2~1team~1{team_id}~1permission-settings~1{action}/put' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/team_permission_settings/methods/get_team_permission_settings' - insert: [] - update: [] - delete: [] - user_memberships: - id: datadog.teams.user_memberships - name: user_memberships - title: User Memberships - methods: - get_user_memberships: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_uuid}~1memberships/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_user_memberships: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_uuid}~1memberships/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/user_memberships/methods/get_user_memberships' - insert: [] - update: [] - delete: [] -paths: - /api/v2/team: - get: - description: |- - Get all teams. - Can be used to search for teams using the `filter[keyword]` and `filter[me]` query parameters. - operationId: ListTeams - parameters: - - $ref: '#/components/parameters/PageNumber' - - $ref: '#/components/parameters/PageSize' - - description: Specifies the order of the returned teams - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ListTeamsSort' - - description: 'Included related resources optionally requested. Allowed enum values: `team_links, user_team_permissions`' - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/ListTeamsInclude' - type: array - - description: 'Search query. Can be team name, team handle, or email of team member' - in: query - name: 'filter[keyword]' - required: false - schema: - type: string - - description: 'When true, only returns teams the current user belongs to' - in: query - name: 'filter[me]' - required: false - schema: - type: boolean - - description: List of fields that need to be fetched. - explode: false - in: query - name: 'fields[team]' - required: false - schema: - items: - $ref: '#/components/schemas/TeamsField' - type: array - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamsResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Get all teams - tags: - - Teams - x-pagination: - limitParam: 'page[size]' - pageParam: 'page[number]' - resultsPath: data - post: - description: |- - Create a new team. - User IDs passed through the `users` relationship field are added to the team. - operationId: CreateTeam - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TeamCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamResponse' - description: CREATED - '403': - $ref: '#/components/responses/ForbiddenResponse' - '409': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - - teams_manage - summary: Create a team - tags: - - Teams - x-codegen-request-body-name: body - '/api/v2/team/{team_id}': - delete: - description: Remove a team using the team's `id`. - operationId: DeleteTeam - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - responses: - '204': - description: No Content - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - - teams_manage - summary: Remove a team - tags: - - Teams - get: - description: Get a single team using the team's `id`. - operationId: GetTeam - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Get a team - tags: - - Teams - patch: - description: |- - Update a team using the team's `id`. - If the `team_links` relationship is present, the associated links are updated to be in the order they appear in the array, and any existing team links not present are removed. - operationId: UpdateTeam - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TeamUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '409': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Update a team - tags: - - Teams - x-codegen-request-body-name: body - '/api/v2/team/{team_id}/links': - get: - description: Get all links for a given team. - operationId: GetTeamLinks - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamLinksResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Get links for a team - tags: - - Teams - post: - description: Add a new link to a team. - operationId: CreateTeamLink - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TeamLinkCreateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamLinkResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Create a team link - tags: - - Teams - x-codegen-request-body-name: body - '/api/v2/team/{team_id}/links/{link_id}': - delete: - description: Remove a link from a team. - operationId: DeleteTeamLink - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - - description: None - in: path - name: link_id - required: true - schema: - type: string - responses: - '204': - description: No Content - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Remove a team link - tags: - - Teams - get: - description: Get a single link for a team. - operationId: GetTeamLink - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - - description: None - in: path - name: link_id - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamLinkResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Get a team link - tags: - - Teams - patch: - description: Update a team link. - operationId: UpdateTeamLink - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - - description: None - in: path - name: link_id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TeamLinkCreateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamLinkResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Update a team link - tags: - - Teams - x-codegen-request-body-name: body - '/api/v2/team/{team_id}/memberships': - get: - description: Get a paginated list of members for a team - operationId: GetTeamMemberships - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - description: Specifies the order of returned team memberships - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/GetTeamMembershipsSort' - - description: 'Search query, can be user email or name' - in: query - name: 'filter[keyword]' - required: false - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UserTeamsResponse' - description: Represents a user's association to a team - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Get team memberships - tags: - - Teams - post: - description: Add a user to a team. - operationId: CreateTeamMembership - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/UserTeamRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UserTeamResponse' - description: Represents a user's association to a team - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '409': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Add a user to a team - tags: - - Teams - x-codegen-request-body-name: body - '/api/v2/team/{team_id}/memberships/{user_id}': - delete: - description: Remove a user from a team. - operationId: DeleteTeamMembership - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - - description: None - in: path - name: user_id - required: true - schema: - type: string - responses: - '204': - description: No Content - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Remove a user from a team - tags: - - Teams - patch: - description: Update a user's membership attributes on a team. - operationId: UpdateTeamMembership - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - - description: None - in: path - name: user_id - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/UserTeamUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UserTeamResponse' - description: Represents a user's association to a team - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Update a user's membership attributes on a team - tags: - - Teams - x-codegen-request-body-name: body - '/api/v2/team/{team_id}/permission-settings': - get: - description: Get all permission settings for a given team. - operationId: GetTeamPermissionSettings - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamPermissionSettingsResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Get permission settings for a team - tags: - - Teams - '/api/v2/team/{team_id}/permission-settings/{action}': - put: - description: Update a team permission setting for a given team. - operationId: UpdateTeamPermissionSetting - parameters: - - description: None - in: path - name: team_id - required: true - schema: - type: string - - description: None - in: path - name: action - required: true - schema: - type: string - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/TeamPermissionSettingUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/TeamPermissionSettingResponse' - description: OK - '403': - $ref: '#/components/responses/ForbiddenResponse' - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Update permission setting for team - tags: - - Teams - x-codegen-request-body-name: body - '/api/v2/users/{user_uuid}/memberships': - get: - description: Get a list of memberships for a user - operationId: GetUserMemberships - parameters: - - description: None - in: path - name: user_uuid - required: true - schema: - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UserTeamsResponse' - description: Represents a user's association to a team - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: API error response. - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - teams_read - summary: Get user memberships - tags: - - Teams diff --git a/providers/src/datadog/v00.00.00000/services/usage_metering.yaml b/providers/src/datadog/v00.00.00000/services/usage_metering.yaml deleted file mode 100644 index d791b7b8..00000000 --- a/providers/src/datadog/v00.00.00000/services/usage_metering.yaml +++ /dev/null @@ -1,2228 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - usage_metering - description: Usage_Metering -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - ActiveBillingDimensionsResponse: - description: Active billing dimensions response. - properties: - data: - $ref: '#/components/schemas/ActiveBillingDimensionsBody' - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - ActiveBillingDimensionsBody: - description: Active billing dimensions data. - properties: - attributes: - $ref: '#/components/schemas/ActiveBillingDimensionsAttributes' - id: - description: Unique ID of the response. - type: string - type: - $ref: '#/components/schemas/ActiveBillingDimensionsType' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - ActiveBillingDimensionsAttributes: - description: List of active billing dimensions. - properties: - month: - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`.' - format: date-time - type: string - values: - description: 'List of active billing dimensions. Example: `[infra_host, apm_host, serverless_infra]`.' - items: - description: A given billing dimension in a list. - example: infra_host - type: string - type: array - type: object - ActiveBillingDimensionsType: - default: billing_dimensions - description: Type of active billing dimensions data. - enum: - - billing_dimensions - type: string - x-enum-varnames: - - BILLING_DIMENSIONS - SortDirection: - default: desc - description: The direction to sort by. - enum: - - desc - - asc - type: string - x-enum-varnames: - - DESC - - ASC - MonthlyCostAttributionResponse: - description: Response containing the monthly cost attribution by tag(s). - properties: - data: - description: Response containing cost attribution. - items: - $ref: '#/components/schemas/MonthlyCostAttributionBody' - type: array - meta: - $ref: '#/components/schemas/MonthlyCostAttributionMeta' - type: object - MonthlyCostAttributionBody: - description: Cost data. - properties: - attributes: - $ref: '#/components/schemas/MonthlyCostAttributionAttributes' - id: - description: Unique ID of the response. - type: string - type: - $ref: '#/components/schemas/CostAttributionType' - type: object - MonthlyCostAttributionMeta: - description: The object containing document metadata. - properties: - aggregates: - $ref: '#/components/schemas/CostAttributionAggregates' - pagination: - $ref: '#/components/schemas/MonthlyCostAttributionPagination' - type: object - MonthlyCostAttributionAttributes: - description: Cost Attribution by Tag for a given organization. - properties: - month: - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`.' - format: date-time - type: string - org_name: - description: The name of the organization. - type: string - public_id: - description: The organization public ID. - type: string - tag_config_source: - description: 'The source of the cost attribution tag configuration and the selected tags in the format `::://////`.' - type: string - tags: - $ref: '#/components/schemas/CostAttributionTagNames' - updated_at: - description: Shows the most recent hour in the current months for all organizations for which all costs were calculated. - type: string - values: - description: 'Fields in Cost Attribution by tag(s). Example: `infra_host_on_demand_cost`, `infra_host_committed_cost`, `infra_host_total_cost`, `infra_host_percentage_in_org`, `infra_host_percentage_in_account`.' - type: object - type: object - CostAttributionType: - default: cost_by_tag - description: Type of cost attribution data. - enum: - - cost_by_tag - example: cost_by_tag - type: string - x-enum-varnames: - - COST_BY_TAG - CostAttributionAggregates: - description: An array of available aggregates. - items: - $ref: '#/components/schemas/CostAttributionAggregatesBody' - type: array - MonthlyCostAttributionPagination: - description: The metadata for the current pagination. - properties: - next_record_id: - description: 'The cursor to use to get the next results, if any. To make the next request, use the same parameters with the addition of the `next_record_id`.' - nullable: true - type: string - type: object - CostAttributionTagNames: - additionalProperties: - description: |- - A list of values that are associated with each tag key. - - An empty list means the resource use wasn't tagged with the respective tag. - - Multiple values means the respective tag was applied multiple times on the resource. - - An `` value means the resource was tagged with the respective tag but did not have a value. - items: - description: A given tag in a list. - example: datadog-integrations-lab - type: string - type: array - description: |- - Tag keys and values. - A `null` value here means that the requested tag breakdown cannot be applied because it does not match the [tags - configured for usage attribution](https://docs.datadoghq.com/account_management/billing/usage_attribution/#getting-started). - In this scenario the API returns the total cost, not broken down by tags. - nullable: true - type: object - CostAttributionAggregatesBody: - description: The object containing the aggregates. - properties: - agg_type: - description: The aggregate type. - example: sum - type: string - field: - description: The field. - example: infra_host_committed_cost - type: string - value: - description: The value for a given field. - format: double - type: number - type: object - UsageApplicationSecurityMonitoringResponse: - description: Application Security Monitoring usage response. - properties: - data: - description: Response containing Application Security Monitoring usage. - items: - $ref: '#/components/schemas/UsageDataObject' - type: array - type: object - UsageDataObject: - description: Usage data. - properties: - attributes: - $ref: '#/components/schemas/UsageAttributesObject' - id: - description: Unique ID of the response. - type: string - type: - $ref: '#/components/schemas/UsageTimeSeriesType' - type: object - UsageAttributesObject: - description: Usage attributes data. - properties: - org_name: - description: The organization name. - type: string - product_family: - description: The product for which usage is being reported. - type: string - public_id: - description: The organization public ID. - type: string - region: - description: The region of the Datadog instance that the organization belongs to. - type: string - timeseries: - description: List of usage data reported for each requested hour. - items: - $ref: '#/components/schemas/UsageTimeSeriesObject' - type: array - usage_type: - $ref: '#/components/schemas/HourlyUsageType' - type: object - UsageTimeSeriesType: - default: usage_timeseries - description: Type of usage data. - enum: - - usage_timeseries - example: usage_timeseries - type: string - x-enum-varnames: - - USAGE_TIMESERIES - UsageTimeSeriesObject: - description: Usage timeseries data. - properties: - timestamp: - description: 'Datetime in ISO-8601 format, UTC. The hour for the usage.' - format: date-time - type: string - value: - description: Contains the number measured for the given usage_type during the hour. - format: int64 - nullable: true - type: integer - type: object - HourlyUsageType: - description: Usage type that is being measured. - enum: - - app_sec_host_count - - observability_pipelines_bytes_processed - - lambda_traced_invocations_count - example: observability_pipelines_bytes_processed - type: string - x-enum-varnames: - - APP_SEC_HOST_COUNT - - OBSERVABILITY_PIPELINES_BYTES_PROCESSSED - - LAMBDA_TRACED_INVOCATIONS_COUNT - CostByOrgResponse: - description: Chargeback Summary response. - properties: - data: - description: Response containing Chargeback Summary. - items: - $ref: '#/components/schemas/CostByOrg' - type: array - type: object - CostByOrg: - description: Cost data. - properties: - attributes: - $ref: '#/components/schemas/CostByOrgAttributes' - id: - description: Unique ID of the response. - type: string - type: - $ref: '#/components/schemas/CostByOrgType' - type: object - CostByOrgAttributes: - description: Cost attributes data. - properties: - charges: - description: List of charges data reported for the requested month. - items: - $ref: '#/components/schemas/ChargebackBreakdown' - type: array - date: - description: The month requested. - format: date-time - type: string - org_name: - description: The organization name. - type: string - public_id: - description: The organization public ID. - type: string - region: - description: The region of the Datadog instance that the organization belongs to. - type: string - total_cost: - description: The total cost of products for the month. - format: double - type: number - type: object - CostByOrgType: - default: cost_by_org - description: Type of cost data. - enum: - - cost_by_org - example: cost_by_org - type: string - x-enum-varnames: - - COST_BY_ORG - ChargebackBreakdown: - description: Charges breakdown. - properties: - charge_type: - description: The type of charge for a particular product. - example: on_demand - type: string - cost: - description: The cost for a particular product and charge type during a given month. - format: double - type: number - product_name: - description: The product for which cost is being reported. - example: infra_host - type: string - type: object - HourlyUsageResponse: - description: Hourly usage response. - properties: - data: - description: Response containing hourly usage. - items: - $ref: '#/components/schemas/HourlyUsage' - type: array - meta: - $ref: '#/components/schemas/HourlyUsageMetadata' - type: object - HourlyUsage: - description: Hourly usage for a product family for an org. - properties: - attributes: - $ref: '#/components/schemas/HourlyUsageAttributes' - id: - description: Unique ID of the response. - type: string - type: - $ref: '#/components/schemas/UsageTimeSeriesType' - type: object - HourlyUsageMetadata: - description: The object containing document metadata. - properties: - pagination: - $ref: '#/components/schemas/HourlyUsagePagination' - type: object - HourlyUsageAttributes: - description: Attributes of hourly usage for a product family for an org for a time period. - properties: - measurements: - description: List of the measured usage values for the product family for the org for the time period. - items: - $ref: '#/components/schemas/HourlyUsageMeasurement' - type: array - org_name: - description: The organization name. - type: string - product_family: - description: The product for which usage is being reported. - type: string - public_id: - description: The organization public ID. - type: string - region: - description: The region of the Datadog instance that the organization belongs to. - type: string - timestamp: - description: 'Datetime in ISO-8601 format, UTC. The hour for the usage.' - format: date-time - type: string - type: object - HourlyUsagePagination: - description: The metadata for the current pagination. - properties: - next_record_id: - description: 'The cursor to get the next results (if any). To make the next request, use the same parameters and add `next_record_id`.' - nullable: true - type: string - type: object - HourlyUsageMeasurement: - description: Usage amount for a given usage type. - properties: - usage_type: - description: Type of usage. - type: string - value: - description: Contains the number measured for the given usage_type during the hour. - format: int64 - nullable: true - type: integer - type: object - UsageLambdaTracedInvocationsResponse: - description: Lambda Traced Invocations usage response. - properties: - data: - description: Response containing Lambda Traced Invocations usage. - items: - $ref: '#/components/schemas/UsageDataObject' - type: array - type: object - UsageObservabilityPipelinesResponse: - description: Observability Pipelines usage response. - properties: - data: - description: Response containing Observability Pipelines usage. - items: - $ref: '#/components/schemas/UsageDataObject' - type: array - type: object - ProjectedCostResponse: - description: Projected Cost response. - properties: - data: - description: Response containing Projected Cost. - items: - $ref: '#/components/schemas/ProjectedCost' - type: array - type: object - ProjectedCost: - description: Projected Cost data. - properties: - attributes: - $ref: '#/components/schemas/ProjectedCostAttributes' - id: - description: Unique ID of the response. - type: string - type: - $ref: '#/components/schemas/ProjectedCostType' - type: object - ProjectedCostAttributes: - description: Projected Cost attributes data. - properties: - charges: - description: List of charges data reported for the requested month. - items: - $ref: '#/components/schemas/ChargebackBreakdown' - type: array - date: - description: The month requested. - format: date-time - type: string - org_name: - description: The organization name. - type: string - projected_total_cost: - description: The total projected cost of products for the month. - format: double - type: number - public_id: - description: The organization public ID. - type: string - region: - description: The region of the Datadog instance that the organization belongs to. - type: string - type: object - ProjectedCostType: - default: projected_cost - description: Type of cost data. - enum: - - projected_cost - example: projected_cost - type: string - x-enum-varnames: - - PROJECt_COST - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: {} - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - active_billing_dimensions: - id: datadog.usage_metering.active_billing_dimensions - name: active_billing_dimensions - title: Active Billing Dimensions - methods: - get_active_billing_dimensions: - operation: - $ref: '#/paths/~1api~1v2~1cost_by_tag~1active_billing_dimensions/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_active_billing_dimensions: - operation: - $ref: '#/paths/~1api~1v2~1cost_by_tag~1active_billing_dimensions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/active_billing_dimensions/methods/get_active_billing_dimensions' - insert: [] - update: [] - delete: [] - monthly_cost_attributions: - id: datadog.usage_metering.monthly_cost_attributions - name: monthly_cost_attributions - title: Monthly Cost Attributions - methods: - get_monthly_cost_attribution: - operation: - $ref: '#/paths/~1api~1v2~1cost_by_tag~1monthly_cost_attribution/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_monthly_cost_attribution: - operation: - $ref: '#/paths/~1api~1v2~1cost_by_tag~1monthly_cost_attribution/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/monthly_cost_attributions/methods/get_monthly_cost_attribution' - insert: [] - update: [] - delete: [] - usage_application_security_monitorings: - id: datadog.usage_metering.usage_application_security_monitorings - name: usage_application_security_monitorings - title: Usage Application Security Monitorings - methods: - get_usage_application_security_monitoring: - operation: - $ref: '#/paths/~1api~1v2~1usage~1application_security/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_usage_application_security_monitoring: - operation: - $ref: '#/paths/~1api~1v2~1usage~1application_security/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/usage_application_security_monitorings/methods/get_usage_application_security_monitoring' - insert: [] - update: [] - delete: [] - cost_by_orgs: - id: datadog.usage_metering.cost_by_orgs - name: cost_by_orgs - title: Cost By Orgs - methods: - get_cost_by_org: - operation: - $ref: '#/paths/~1api~1v2~1usage~1cost_by_org/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_cost_by_org: - operation: - $ref: '#/paths/~1api~1v2~1usage~1cost_by_org/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/cost_by_orgs/methods/get_cost_by_org' - insert: [] - update: [] - delete: [] - estimated_cost_by_orgs: - id: datadog.usage_metering.estimated_cost_by_orgs - name: estimated_cost_by_orgs - title: Estimated Cost By Orgs - methods: - get_estimated_cost_by_org: - operation: - $ref: '#/paths/~1api~1v2~1usage~1estimated_cost/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_estimated_cost_by_org: - operation: - $ref: '#/paths/~1api~1v2~1usage~1estimated_cost/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/estimated_cost_by_orgs/methods/get_estimated_cost_by_org' - insert: [] - update: [] - delete: [] - historical_cost_by_orgs: - id: datadog.usage_metering.historical_cost_by_orgs - name: historical_cost_by_orgs - title: Historical Cost By Orgs - methods: - get_historical_cost_by_org: - operation: - $ref: '#/paths/~1api~1v2~1usage~1historical_cost/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_historical_cost_by_org: - operation: - $ref: '#/paths/~1api~1v2~1usage~1historical_cost/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/historical_cost_by_orgs/methods/get_historical_cost_by_org' - insert: [] - update: [] - delete: [] - hourly_usages: - id: datadog.usage_metering.hourly_usages - name: hourly_usages - title: Hourly Usages - methods: - get_hourly_usage: - operation: - $ref: '#/paths/~1api~1v2~1usage~1hourly_usage/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_hourly_usage: - operation: - $ref: '#/paths/~1api~1v2~1usage~1hourly_usage/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/hourly_usages/methods/get_hourly_usage' - insert: [] - update: [] - delete: [] - usage_lambda_traced_invocations: - id: datadog.usage_metering.usage_lambda_traced_invocations - name: usage_lambda_traced_invocations - title: Usage Lambda Traced Invocations - methods: - get_usage_lambda_traced_invocations: - operation: - $ref: '#/paths/~1api~1v2~1usage~1lambda_traced_invocations/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_usage_lambda_traced_invocations: - operation: - $ref: '#/paths/~1api~1v2~1usage~1lambda_traced_invocations/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/usage_lambda_traced_invocations/methods/get_usage_lambda_traced_invocations' - insert: [] - update: [] - delete: [] - usage_observability_pipelines: - id: datadog.usage_metering.usage_observability_pipelines - name: usage_observability_pipelines - title: Usage Observability Pipelines - methods: - get_usage_observability_pipelines: - operation: - $ref: '#/paths/~1api~1v2~1usage~1observability_pipelines/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_usage_observability_pipelines: - operation: - $ref: '#/paths/~1api~1v2~1usage~1observability_pipelines/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/usage_observability_pipelines/methods/get_usage_observability_pipelines' - insert: [] - update: [] - delete: [] - projected_costs: - id: datadog.usage_metering.projected_costs - name: projected_costs - title: Projected Costs - methods: - get_projected_cost: - operation: - $ref: '#/paths/~1api~1v2~1usage~1projected_cost/get' - response: - mediaType: application/json;datetime-format=rfc3339 - openAPIDocKey: '200' - objectKey: $.data - _get_projected_cost: - operation: - $ref: '#/paths/~1api~1v2~1usage~1projected_cost/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/projected_costs/methods/get_projected_cost' - insert: [] - update: [] - delete: [] -paths: - /api/v2/cost_by_tag/active_billing_dimensions: - get: - description: Get active billing dimensions for cost attribution. Cost data for a given month becomes available no later than the 17th of the following month. - operationId: GetActiveBillingDimensions - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/ActiveBillingDimensionsResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get active billing dimensions for cost attribution - tags: - - Usage Metering - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/cost_by_tag/monthly_cost_attribution: - get: - description: |- - Get monthly cost attribution by tag across multi-org and single root-org accounts. - Cost Attribution data for a given month becomes available no later than the 17th of the following month. - This API endpoint is paginated. To make sure you receive all records, check if the value of `next_record_id` is - set in the response. If it is, make another request and pass `next_record_id` as a parameter. - Pseudo code example: - ``` - response := GetMonthlyCostAttribution(start_month, end_month) - cursor := response.metadata.pagination.next_record_id - WHILE cursor != null BEGIN - sleep(5 seconds) # Avoid running into rate limit - response := GetMonthlyCostAttribution(start_month, end_month, next_record_id=cursor) - cursor := response.metadata.pagination.next_record_id - END - ``` - operationId: GetMonthlyCostAttribution - parameters: - - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning in this month.' - in: query - name: start_month - required: true - schema: - format: date-time - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month.' - in: query - name: end_month - required: true - schema: - format: date-time - type: string - - description: |- - Comma-separated list specifying cost types (e.g., `_on_demand_cost`, `_committed_cost`, `_total_cost`) and the - proportions (`_percentage_in_org`, `_percentage_in_account`). Use `*` to retrieve all fields. - Example: `infra_host_on_demand_cost,infra_host_percentage_in_account` - To obtain the complete list of active billing dimensions that can be used to replace - `` in the field names, make a request to the [Get active billing dimensions API](https://docs.datadoghq.com/api/latest/usage-metering/#get-active-billing-dimensions-for-cost-attribution). - in: query - name: fields - required: true - schema: - type: string - - description: 'The direction to sort by: `[desc, asc]`.' - in: query - name: sort_direction - required: false - schema: - $ref: '#/components/schemas/SortDirection' - - description: 'The billing dimension to sort by. Always sorted by total cost. Example: `infra_host`.' - in: query - name: sort_name - required: false - schema: - type: string - - description: |- - Comma separated list of tag keys used to group cost. If no value is provided the cost will not be broken down by tags. - To see which tags are available, look for the value of `tag_config_source` in the API response. - in: query - name: tag_breakdown_keys - required: false - schema: - type: string - - description: List following results with a next_record_id provided in the previous query. - in: query - name: next_record_id - required: false - schema: - type: string - - description: Include child org cost in the response. Defaults to `true`. - in: query - name: include_descendants - required: false - schema: - default: true - type: boolean - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/MonthlyCostAttributionResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get Monthly Cost Attribution - tags: - - Usage Metering - x-unstable: |- - **Note**: This endpoint is in public beta. - If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - /api/v2/usage/application_security: - get: - description: |- - Get hourly usage for application security . - **Note:** hourly usage data for all products is now available in the [Get hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family) - operationId: GetUsageApplicationSecurityMonitoring - parameters: - - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage beginning at this hour.' - in: query - name: start_hr - required: true - schema: - format: date-time - type: string - - description: |- - Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage ending - **before** this hour. - in: query - name: end_hr - required: false - schema: - format: date-time - type: string - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/UsageApplicationSecurityMonitoringResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - usage_read - summary: Get hourly usage for application security - tags: - - Usage Metering - /api/v2/usage/cost_by_org: - get: - deprecated: true - description: |- - Get cost across multi-org account. - Cost by org data for a given month becomes available no later than the 16th of the following month. - **Note:** This endpoint has been deprecated. Please use the new endpoint - [`/historical_cost`](https://docs.datadoghq.com/api/latest/usage-metering/#get-historical-cost-across-your-account) - instead. - operationId: GetCostByOrg - parameters: - - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month.' - in: query - name: start_month - required: true - schema: - format: date-time - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month.' - in: query - name: end_month - required: false - schema: - format: date-time - type: string - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/CostByOrgResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - usage_read - summary: Get cost across multi-org account - tags: - - Usage Metering - /api/v2/usage/estimated_cost: - get: - description: |- - Get estimated cost across multi-org and single root-org accounts. - Estimated cost data is only available for the current month and previous month - and is delayed by up to 72 hours from when it was incurred. - To access historical costs prior to this, use the `/historical_cost` endpoint. - operationId: GetEstimatedCostByOrg - parameters: - - description: String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`. - in: query - name: view - required: false - schema: - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. Either start_month or start_date should be specified, but not both. (start_month cannot go beyond two months in the past). Provide an `end_month` to view month-over-month cost.' - in: query - name: start_month - required: false - schema: - format: date-time - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month.' - in: query - name: end_month - required: false - schema: - format: date-time - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost beginning this day. Either start_month or start_date should be specified, but not both. (start_date cannot go beyond two months in the past). Provide an `end_date` to view day-over-day cumulative cost.' - in: query - name: start_date - required: false - schema: - format: date-time - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day.' - in: query - name: end_date - required: false - schema: - format: date-time - type: string - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/CostByOrgResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - usage_read - summary: Get estimated cost across your account - tags: - - Usage Metering - /api/v2/usage/historical_cost: - get: - description: |- - Get historical cost across multi-org and single root-org accounts. - Cost data for a given month becomes available no later than the 16th of the following month. - operationId: GetHistoricalCostByOrg - parameters: - - description: String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`. - in: query - name: view - required: false - schema: - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month.' - in: query - name: start_month - required: true - schema: - format: date-time - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month.' - in: query - name: end_month - required: false - schema: - format: date-time - type: string - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/CostByOrgResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - usage_read - summary: Get historical cost across your account - tags: - - Usage Metering - /api/v2/usage/hourly_usage: - get: - description: Get hourly usage by product family. - operationId: GetHourlyUsage - parameters: - - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] for usage beginning at this hour.' - in: query - name: 'filter[timestamp][start]' - required: true - schema: - format: date-time - type: string - - description: 'Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] for usage ending **before** this hour.' - in: query - name: 'filter[timestamp][end]' - required: false - schema: - format: date-time - type: string - - description: |- - Comma separated list of product families to retrieve. Available families are `all`, `analyzed_logs`, - `application_security`, `audit_trail`, `serverless`, `ci_app`, `cloud_cost_management`, - `csm_container_enterprise`, `csm_host_enterprise`, `cspm`, `custom_events`, `cws`, `dbm`, `fargate`, - `infra_hosts`, `incident_management`, `indexed_logs`, `indexed_spans`, `ingested_spans`, `iot`, - `lambda_traced_invocations`, `logs`, `network_flows`, `network_hosts`, `netflow_monitoring`, `observability_pipelines`, - `online_archive`, `profiling`, `rum`, `rum_browser_sessions`, `rum_mobile_sessions`, `sds`, `snmp`, - `synthetics_api`, `synthetics_browser`, `synthetics_mobile`, `synthetics_parallel_testing`, and `timeseries`. - The following product family has been **deprecated**: `audit_logs`. - in: query - name: 'filter[product_families]' - required: true - schema: - type: string - - description: Include child org usage in the response. Defaults to false. - in: query - name: 'filter[include_descendants]' - required: false - schema: - default: false - type: boolean - - description: Include breakdown of usage by subcategories where applicable (for product family logs only). Defaults to false. - in: query - name: 'filter[include_breakdown]' - required: false - schema: - default: false - type: boolean - - description: |- - Comma separated list of product family versions to use in the format `product_family:version`. For example, - `infra_hosts:1.0.0`. If this parameter is not used, the API will use the latest version of each requested - product family. Currently all families have one version `1.0.0`. - in: query - name: 'filter[versions]' - required: false - schema: - type: string - - description: Maximum number of results to return (between 1 and 500) - defaults to 500 if limit not specified. - in: query - name: 'page[limit]' - required: false - schema: - default: 500 - format: int32 - maximum: 500 - minimum: 1 - type: integer - - description: List following results with a next_record_id provided in the previous query. - in: query - name: 'page[next_record_id]' - required: false - schema: - type: string - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/HourlyUsageResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - usage_read - summary: Get hourly usage by product family - tags: - - Usage Metering - /api/v2/usage/lambda_traced_invocations: - get: - description: |- - Get hourly usage for lambda traced invocations. - **Note:** hourly usage data for all products is now available in the [Get hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family) - operationId: GetUsageLambdaTracedInvocations - parameters: - - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage beginning at this hour.' - in: query - name: start_hr - required: true - schema: - format: date-time - type: string - - description: |- - Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage ending - **before** this hour. - in: query - name: end_hr - required: false - schema: - format: date-time - type: string - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/UsageLambdaTracedInvocationsResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - usage_read - summary: Get hourly usage for lambda traced invocations - tags: - - Usage Metering - /api/v2/usage/observability_pipelines: - get: - description: |- - Get hourly usage for observability pipelines. - **Note:** hourly usage data for all products is now available in the [Get hourly usage by product family API](https://docs.datadoghq.com/api/latest/usage-metering/#get-hourly-usage-by-product-family) - operationId: GetUsageObservabilityPipelines - parameters: - - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage beginning at this hour.' - in: query - name: start_hr - required: true - schema: - format: date-time - type: string - - description: |- - Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]` for usage ending - **before** this hour. - in: query - name: end_hr - required: false - schema: - format: date-time - type: string - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/UsageObservabilityPipelinesResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - usage_read - summary: Get hourly usage for observability pipelines - tags: - - Usage Metering - /api/v2/usage/projected_cost: - get: - description: |- - Get projected cost across multi-org and single root-org accounts. - Projected cost data is only available for the current month and becomes available around the 12th of the month. - This endpoint requires the usage_read authorization scope. - operationId: GetProjectedCost - parameters: - - description: String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are `summary` and `sub-org`. Defaults to `summary`. - in: query - name: view - required: false - schema: - type: string - responses: - '200': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/ProjectedCostResponse' - description: OK - '400': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Forbidden - User is not authorized - '429': - content: - application/json;datetime-format=rfc3339: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - usage_read - summary: Get projected cost across your account - tags: - - Usage Metering diff --git a/providers/src/datadog/v00.00.00000/services/users.yaml b/providers/src/datadog/v00.00.00000/services/users.yaml deleted file mode 100644 index 432f2d88..00000000 --- a/providers/src/datadog/v00.00.00000/services/users.yaml +++ /dev/null @@ -1,2010 +0,0 @@ -openapi: 3.0.0 -servers: - - url: 'https://{dd_site:^(?:api\.datadoghq\.com|us3\.datadoghq\.com|us5\.datadoghq\.com|datadoghq\.eu|ddog-gov\.com)$}/' - variables: - dd_site: - default: api.datadoghq.com - description: The regional site for Datadog customers. -info: - contact: - email: support@datadoghq.com - name: Datadog Support - url: 'https://www.datadoghq.com/support/' - version: '1.0' - title: Datadog API V2 Collection - users - description: 'Create, edit, and disable users.' -security: - - apiKeyAuth: [] - appKeyAuth: [] -tags: - - description: 'Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/' - name: APM Retention Filters - - description: Search your Audit Logs events over HTTP. - name: Audit - - description: |- - [AuthN Mappings API](https://docs.datadoghq.com/account_management/authn_mapping/?tab=example) - is used to automatically map group of users to roles in Datadog using attributes - sent from Identity Providers. - name: AuthN Mappings - - description: Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. - name: CI Visibility Pipelines - - description: Search or aggregate your CI Visibility test events over HTTP. - name: CI Visibility Tests - - description: Workload activity security rules for generating events using the Datadog security Agent. - name: Cloud Workload Security - - description: Configure your Datadog Cloudflare integration directly through the Datadog API. - name: Cloudflare Integration - - description: Configure your Datadog Confluent Cloud integration directly through the Datadog API. - name: Confluent Cloud - - description: The Container Images API allows you to query Container Image data for your organization. - name: Container Images - - description: The Containers API allows you to query container data for your organization. - name: Containers - - description: Send events for DORA Metrics to measure and improve software delivery. - name: DORA Metrics - - description: |- - Interact with your dashboard lists through the API to - organize, find, and share all of your dashboards with your team and - organization. - name: Dashboard Lists - - description: |- - **Note**: Downtime V2 is currently in private beta. To request access, contact [Datadog support](https://docs.datadoghq.com/help/). - - [Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives - you greater control over monitor notifications by allowing you to globally exclude - scopes from alerting. Downtime settings, which can be scheduled with start and - end times, prevent all alerting related to specified Datadog tags. - name: Downtimes - - description: |- - The events service allows you to programmatically post events to the event stream - and fetch events from the event stream. Events are limited to 4000 characters. - If an event is sent out with a message containing more than 4000 characters, only the - first 4000 characters are displayed. - name: Events - - description: Configure your Datadog Fastly integration directly through the Datadog API. - name: Fastly Integration - - description: |- - Configure your Datadog-Google Cloud Platform (GCP) integration directly - through the Datadog API. Read more about the [Datadog-Google Cloud Platform integration](https://docs.datadoghq.com/integrations/google_cloud_platform). - externalDocs: - url: 'https://docs.datadoghq.com/integrations/google_cloud_platform' - name: GCP Integration - - description: |- - The IP allowlist API is used to manage the IP addresses that - can access the Datadog API and web UI. It does not block - access to intake APIs or public dashboards. - - This is an enterprise-only feature. Request access by - contacting Datadog support. - name: IP Allowlist - - description: 'Create, update, delete, and retrieve services which can be associated with incidents.' - name: Incident Services - - description: 'The Incident Teams endpoints are deprecated. See the [Teams API endpoints](https://docs.datadoghq.com/api/latest/teams/) to create, update, delete, and retrieve teams which can be associated with incidents.' - name: Incident Teams - - description: Manage incident response. - name: Incidents - - description: |- - Manage your Datadog API and application keys. You need an API key and - an application key for a user with the required permissions to interact - with these endpoints. The full list of API and application keys can be - seen on your [Datadog API page](https://app.datadoghq.com/account/settings#api). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/api-app-keys/' - name: Key Management - - description: Search your logs and send them to your Datadog platform over HTTP. - name: Logs - - description: |- - Archives forward all the logs ingested to a cloud storage system. - - See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in web UI. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/archives/' - name: Logs Archives - - description: 'Manage configuration of [log-based metrics](https://app.datadoghq.com/logs/pipelines/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/logs/logs_to_metrics/' - name: Logs Metrics - - description: |- - The metrics endpoint allows you to: - - - Post metrics data so it can be graphed on Datadog’s dashboards - - Query metrics from any time period (timeseries and scalar) - - Modify tag configurations for metrics - - View tags and volumes for metrics - - **Note**: A graph can only contain a set number of points - and as the timeframe over which a metric is viewed increases, - aggregation between points occurs to stay below that set number. - - The Post, Patch, and Delete `manage_tags` API methods can only be performed by - a user who has the `Manage Tags for Metrics` permission. - name: Metrics - - description: |- - [Monitors](https://docs.datadoghq.com/monitors) allow you to watch a metric or check that you care about and - notifies your team when a defined threshold has exceeded. - - For more information, see [Creating Monitors](https://docs.datadoghq.com/monitors/create/types/) and - [Tag Policies](https://docs.datadoghq.com/monitors/settings/). - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/monitors/create/types/' - name: Monitors - - description: Configure your Datadog Okta integration directly through the Datadog API. - name: Okta Integration - - description: |- - Configure your [Datadog Opsgenie integration](https://docs.datadoghq.com/integrations/opsgenie/) - directly through the Datadog API. - externalDocs: - url: 'https://docs.datadoghq.com/api/latest/opsgenie-integration' - name: Opsgenie Integration - - description: 'Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization).' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/multi_organization' - name: Organizations - - description: |- - The powerpack endpoints allow you to: - - - Get a powerpack - - Create a powerpack - - Delete a powerpack - - Get a list of all powerpacks - - The Patch and Delete API methods can only be performed on a powerpack by - a user who has the powerpack create permission for that specific powerpack. - name: Powerpack - - description: The processes API allows you to query processes data for your organization. - name: Processes - - description: Search or aggregate your RUM events over HTTP. - name: RUM - - description: |- - A restriction policy defines the access control rules for a resource, mapping a set of relations - (such as editor and viewer) to a set of allowed principals (such as roles, teams, or users). - The restriction policy determines who is authorized to perform what actions on the resource. - name: Restriction Policies - - description: |- - The Roles API is used to create and manage Datadog roles, what - [global permissions](https://docs.datadoghq.com/account_management/rbac/) - they grant, and which users belong to them. - - Permissions related to specific account assets can be granted to roles - in the Datadog application without using this API. For example, granting - read access on a specific log index to a role can be done in Datadog from the - [Pipelines page](https://app.datadoghq.com/logs/pipelines). - name: Roles - - description: |- - Detection rules for generating signals and listing of generated - signals. - name: Security Monitoring - - description: 'Create, update, delete, and retrieve sensitive data scanner groups and rules.' - name: Sensitive Data Scanner - - description: 'Create, edit, and disable service accounts.' - name: Service Accounts - - description: 'API to create, update, retrieve and delete service definitions.' - externalDocs: - url: 'https://docs.datadoghq.com/tracing/service_catalog/' - name: Service Definition - - description: |- - API to create, update scorecard rules and outcomes. - - This feature is currently in BETA. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). - name: Service Scorecards - - description: Search and aggregate your spans from your Datadog platform over HTTP. - name: Spans - - description: 'Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics) for your organization.' - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/tracing/metrics/metrics_namespace/' - name: Spans Metrics - - description: |- - Datadog Synthetics uses simulated user requests and browser rendering to help you ensure uptime, - identify regional issues, and track your application performance. Datadog Synthetics tests come in - two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/) - and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog’s API to - manage both test types programmatically. - - For more information about Synthetics, see the [Synthetics overview](https://docs.datadoghq.com/synthetics/). - name: Synthetics - - description: View and manage teams within Datadog. - name: Teams - - description: |- - The usage metering API allows you to get hourly, daily, and - monthly usage across multiple facets of Datadog. - This API is available to all Pro and Enterprise customers. - Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). - - **Note**: Usage data is delayed by up to 72 hours from when it was incurred. - It is retained for 15 months. - - You can retrieve up to 24 hours of hourly usage data for multiple organizations, - and up to two months of hourly usage data for a single organization in one request. - externalDocs: - description: Find out more at - url: 'https://docs.datadoghq.com/account_management/billing/usage_details/' - name: Usage Metering - - description: 'Create, edit, and disable users.' - externalDocs: - url: 'https://docs.datadoghq.com/account_management/users' - name: Users -components: - schemas: - UserInvitationsRequest: - description: Object to invite users to join the organization. - properties: - data: - description: List of user invitations. - example: [] - items: - $ref: '#/components/schemas/UserInvitationData' - type: array - required: - - data - type: object - UserInvitationsResponse: - description: User invitations as returned by the API. - properties: - data: - description: Array of user invitations. - items: - $ref: '#/components/schemas/UserInvitationResponseData' - type: array - type: object - APIErrorResponse: - description: API error response. - properties: - errors: - description: A list of errors. - items: - description: A list of items. - example: Bad Request - type: string - type: array - required: - - errors - type: object - UserInvitationData: - description: Object to create a user invitation. - properties: - relationships: - $ref: '#/components/schemas/UserInvitationRelationships' - type: - $ref: '#/components/schemas/UserInvitationsType' - required: - - type - - relationships - type: object - UserInvitationResponseData: - description: Object of a user invitation returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserInvitationDataAttributes' - id: - description: ID of the user invitation. - type: string - relationships: - $ref: '#/components/schemas/UserInvitationRelationships' - type: - $ref: '#/components/schemas/UserInvitationsType' - type: object - APIKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - modified_at - - '-modified_at' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - MODIFIED_AT_ASCENDING - - MODIFIED_AT_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - ApplicationKeysSort: - default: name - description: Sorting options - enum: - - created_at - - '-created_at' - - last4 - - '-last4' - - name - - '-name' - type: string - x-enum-varnames: - - CREATED_AT_ASCENDING - - CREATED_AT_DESCENDING - - LAST4_ASCENDING - - LAST4_DESCENDING - - NAME_ASCENDING - - NAME_DESCENDING - IncidentAttachmentAttachmentType: - description: The type of the incident attachment attributes. - enum: - - link - - postmortem - example: link - type: string - x-enum-varnames: - - LINK - - POSTMORTEM - IncidentAttachmentRelatedObject: - description: The object related to an incident attachment. - enum: - - users - type: string - x-enum-varnames: - - USERS - IncidentRelatedObject: - description: Object related to an incident. - enum: - - users - - attachments - type: string - x-enum-varnames: - - USERS - - ATTACHMENTS - IncidentSearchSortOrder: - description: The ways searched incidents can be sorted. - enum: - - created - - '-created' - type: string - x-enum-varnames: - - CREATED_ASCENDING - - CREATED_DESCENDING - ServiceDefinitionSchemaVersions: - description: Schema versions - enum: - - v1 - - v2 - - v2.1 - - v2.2 - type: string - x-enum-varnames: - - V1 - - V2 - - V2_1 - - V2_2 - UserInvitationRelationships: - description: Relationships data for user invitation. - properties: - user: - $ref: '#/components/schemas/RelationshipToUser' - required: - - user - type: object - UserInvitationsType: - default: user_invitations - description: User invitations type. - enum: - - user_invitations - example: user_invitations - type: string - x-enum-varnames: - - USER_INVITATIONS - UserInvitationDataAttributes: - description: Attributes of a user invitation. - properties: - created_at: - description: Creation time of the user invitation. - format: date-time - type: string - expires_at: - description: Time of invitation expiration. - format: date-time - type: string - invite_type: - description: Type of invitation. - type: string - uuid: - description: UUID of the user invitation. - type: string - type: object - RelationshipToUser: - description: Relationship to user. - properties: - data: - $ref: '#/components/schemas/RelationshipToUserData' - required: - - data - type: object - RelationshipToUserData: - description: Relationship to user object. - properties: - id: - description: A unique identifier that represents the user. - example: 00000000-0000-0000-2345-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - id - - type - type: object - UsersType: - default: users - description: Users resource type. - enum: - - users - example: users - type: string - x-enum-varnames: - - USERS - UserInvitationResponse: - description: User invitation as returned by the API. - properties: - data: - $ref: '#/components/schemas/UserInvitationResponseData' - type: object - QuerySortOrder: - default: desc - description: Direction of sort. - enum: - - asc - - desc - type: string - x-enum-varnames: - - ASC - - DESC - UsersResponse: - description: Response containing information about multiple users. - properties: - data: - description: Array of returned users. - items: - $ref: '#/components/schemas/User' - type: array - included: - description: Array of objects related to the users. - items: - $ref: '#/components/schemas/UserResponseIncludedItem' - type: array - meta: - $ref: '#/components/schemas/ResponseMetaAttributes' - readOnly: true - type: object - User: - description: User object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/UserAttributes' - id: - description: ID of the user. - type: string - relationships: - $ref: '#/components/schemas/UserResponseRelationships' - type: - $ref: '#/components/schemas/UsersType' - type: object - UserResponseIncludedItem: - description: An object related to a user. - oneOf: - - $ref: '#/components/schemas/Organization' - - $ref: '#/components/schemas/Permission' - - $ref: '#/components/schemas/Role' - ResponseMetaAttributes: - description: Object describing meta attributes of response. - properties: - page: - $ref: '#/components/schemas/Pagination' - type: object - UserAttributes: - description: Attributes of user object returned by the API. - properties: - created_at: - description: Creation time of the user. - format: date-time - type: string - disabled: - description: Whether the user is disabled. - type: boolean - email: - description: Email of the user. - type: string - handle: - description: Handle of the user. - type: string - icon: - description: URL of the user's icon. - type: string - modified_at: - description: Time that the user was last modified. - format: date-time - type: string - name: - description: Name of the user. - nullable: true - type: string - service_account: - description: Whether the user is a service account. - type: boolean - status: - description: Status of the user. - type: string - title: - description: Title of the user. - nullable: true - type: string - verified: - description: Whether the user is verified. - type: boolean - type: object - UserResponseRelationships: - description: Relationships of the user object returned by the API. - properties: - org: - $ref: '#/components/schemas/RelationshipToOrganization' - other_orgs: - $ref: '#/components/schemas/RelationshipToOrganizations' - other_users: - $ref: '#/components/schemas/RelationshipToUsers' - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - Organization: - description: Organization object. - properties: - attributes: - $ref: '#/components/schemas/OrganizationAttributes' - id: - description: ID of the organization. - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - type - type: object - Permission: - description: Permission object. - properties: - attributes: - $ref: '#/components/schemas/PermissionAttributes' - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - required: - - type - type: object - Role: - description: Role object returned by the API. - properties: - attributes: - $ref: '#/components/schemas/RoleAttributes' - id: - description: The unique identifier of the role. - type: string - relationships: - $ref: '#/components/schemas/RoleResponseRelationships' - type: - $ref: '#/components/schemas/RolesType' - required: - - type - type: object - Pagination: - description: Pagination object. - properties: - total_count: - description: Total count. - format: int64 - type: integer - total_filtered_count: - description: Total count of elements matched by the filter. - format: int64 - type: integer - type: object - RelationshipToOrganization: - description: Relationship to an organization. - properties: - data: - $ref: '#/components/schemas/RelationshipToOrganizationData' - required: - - data - type: object - RelationshipToOrganizations: - description: Relationship to organizations. - properties: - data: - description: Relationships to organization objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToOrganizationData' - type: array - required: - - data - type: object - RelationshipToUsers: - description: Relationship to users. - properties: - data: - description: Relationships to user objects. - example: [] - items: - $ref: '#/components/schemas/RelationshipToUserData' - type: array - required: - - data - type: object - RelationshipToRoles: - description: Relationship to roles. - properties: - data: - description: An array containing type and the unique identifier of a role. - items: - $ref: '#/components/schemas/RelationshipToRoleData' - type: array - type: object - OrganizationAttributes: - description: Attributes of the organization. - properties: - created_at: - description: Creation time of the organization. - format: date-time - type: string - description: - description: Description of the organization. - type: string - disabled: - description: Whether or not the organization is disabled. - type: boolean - modified_at: - description: Time of last organization modification. - format: date-time - type: string - name: - description: Name of the organization. - type: string - public_id: - description: Public ID of the organization. - type: string - sharing: - description: Sharing type of the organization. - type: string - url: - description: URL of the site that this organization exists at. - type: string - type: object - OrganizationsType: - default: orgs - description: Organizations resource type. - enum: - - orgs - example: orgs - type: string - x-enum-varnames: - - ORGS - PermissionAttributes: - description: Attributes of a permission. - properties: - created: - description: Creation time of the permission. - format: date-time - type: string - description: - description: Description of the permission. - type: string - display_name: - description: Displayed name for the permission. - type: string - display_type: - description: Display type. - type: string - group_name: - description: Name of the permission group. - type: string - name: - description: Name of the permission. - type: string - restricted: - description: Whether or not the permission is restricted. - type: boolean - type: object - PermissionsType: - default: permissions - description: Permissions resource type. - enum: - - permissions - example: permissions - type: string - x-enum-varnames: - - PERMISSIONS - RoleAttributes: - description: Attributes of the role. - properties: - created_at: - description: Creation time of the role. - format: date-time - readOnly: true - type: string - modified_at: - description: Time of last role modification. - format: date-time - readOnly: true - type: string - name: - description: The name of the role. The name is neither unique nor a stable identifier of the role. - type: string - user_count: - description: Number of users with that role. - format: int64 - readOnly: true - type: integer - type: object - RoleResponseRelationships: - description: Relationships of the role object returned by the API. - properties: - permissions: - $ref: '#/components/schemas/RelationshipToPermissions' - type: object - RolesType: - default: roles - description: Roles type. - enum: - - roles - example: roles - type: string - x-enum-varnames: - - ROLES - RelationshipToOrganizationData: - description: Relationship to organization object. - properties: - id: - description: ID of the organization. - example: 00000000-0000-beef-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/OrganizationsType' - required: - - id - - type - type: object - RelationshipToRoleData: - description: Relationship to role object. - properties: - id: - description: The unique identifier of the role. - example: 3653d3c6-0c75-11ea-ad28-fb5701eabc7d - type: string - type: - $ref: '#/components/schemas/RolesType' - type: object - RelationshipToPermissions: - description: Relationship to multiple permissions objects. - properties: - data: - description: Relationships to permission objects. - items: - $ref: '#/components/schemas/RelationshipToPermissionData' - type: array - type: object - RelationshipToPermissionData: - description: Relationship to permission object. - properties: - id: - description: ID of the permission. - type: string - type: - $ref: '#/components/schemas/PermissionsType' - type: object - UserCreateRequest: - description: Create a user. - properties: - data: - $ref: '#/components/schemas/UserCreateData' - required: - - data - type: object - UserResponse: - description: Response containing information about a single user. - properties: - data: - $ref: '#/components/schemas/User' - included: - description: Array of objects related to the user. - items: - $ref: '#/components/schemas/UserResponseIncludedItem' - type: array - type: object - UserCreateData: - description: Object to create a user. - properties: - attributes: - $ref: '#/components/schemas/UserCreateAttributes' - relationships: - $ref: '#/components/schemas/UserRelationships' - type: - $ref: '#/components/schemas/UsersType' - required: - - attributes - - type - type: object - UserCreateAttributes: - description: Attributes of the created user. - properties: - email: - description: The email of the user. - example: jane.doe@example.com - type: string - name: - description: The name of the user. - type: string - title: - description: The title of the user. - type: string - required: - - email - type: object - UserRelationships: - description: Relationships of the user object. - properties: - roles: - $ref: '#/components/schemas/RelationshipToRoles' - type: object - UserUpdateRequest: - description: Update a user. - properties: - data: - $ref: '#/components/schemas/UserUpdateData' - required: - - data - type: object - UserUpdateData: - description: Object to update a user. - properties: - attributes: - $ref: '#/components/schemas/UserUpdateAttributes' - id: - description: ID of the user. - example: 00000000-0000-feed-0000-000000000000 - type: string - type: - $ref: '#/components/schemas/UsersType' - required: - - attributes - - type - - id - type: object - UserUpdateAttributes: - description: Attributes of the edited user. - properties: - disabled: - description: If the user is enabled or disabled. - type: boolean - email: - description: The email of the user. - type: string - name: - description: The name of the user. - type: string - type: object - PermissionsResponse: - description: Payload with API-returned permissions. - properties: - data: - description: Array of permissions. - items: - $ref: '#/components/schemas/Permission' - type: array - type: object - parameters: - APIKeyCategoryParameter: - description: Filter API keys by category. - in: query - name: 'filter[category]' - required: false - schema: - type: string - APIKeyFilterCreatedAtEndParameter: - description: Only include API keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterCreatedAtStartParameter: - description: Only include API keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtEndParameter: - description: Only include API keys modified on or before the specified date. - in: query - name: 'filter[modified_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterModifiedAtStartParameter: - description: Only include API keys modified on or after the specified date. - in: query - name: 'filter[modified_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - APIKeyFilterParameter: - description: Filter API keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - APIKeyId: - description: The ID of the API key. - in: path - name: api_key_id - required: true - schema: - type: string - APIKeyIncludeParameter: - description: Comma separated list of resource paths for related resources to include in the response. Supported resource paths are `created_by` and `modified_by`. - in: query - name: include - required: false - schema: - example: 'created_by,modified_by' - type: string - APIKeyReadConfigReadEnabledParameter: - description: Filter API keys by remote config read enabled status. - in: query - name: 'filter[remote_config_read_enabled]' - required: false - schema: - type: boolean - APIKeysSortParameter: - description: |- - API key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/APIKeysSort' - ApplicationKeyFilterCreatedAtEndParameter: - description: Only include application keys created on or before the specified date. - in: query - name: 'filter[created_at][end]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterCreatedAtStartParameter: - description: Only include application keys created on or after the specified date. - in: query - name: 'filter[created_at][start]' - required: false - schema: - example: '2020-11-24T18:46:21+00:00' - type: string - ApplicationKeyFilterParameter: - description: Filter application keys by the specified string. - in: query - name: filter - required: false - schema: - type: string - ApplicationKeyID: - description: The ID of the application key. - in: path - name: app_key_id - required: true - schema: - type: string - ApplicationKeyIncludeParameter: - description: Resource path for related resources to include in the response. Only `owned_by` is supported. - in: query - name: include - required: false - schema: - example: owned_by - type: string - ApplicationKeysSortParameter: - description: |- - Application key attribute used to sort results. Sort order is ascending - by default. In order to specify a descending sort, prefix the - attribute with a minus sign. - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/ApplicationKeysSort' - ArchiveID: - description: The ID of the archive. - in: path - name: archive_id - required: true - schema: - type: string - AuthNMappingID: - description: The UUID of the AuthN Mapping. - in: path - name: authn_mapping_id - required: true - schema: - type: string - CloudWorkloadSecurityAgentRuleID: - description: The ID of the Agent rule. - example: 3b5-v82-ns6 - in: path - name: agent_rule_id - required: true - schema: - type: string - ConfluentAccountID: - description: Confluent Account id. - in: path - name: account_id - required: true - schema: - type: string - ConfluentResourceID: - description: Confluent Account Resource ID. - in: path - name: resource_id - required: true - schema: - type: string - FastlyAccountID: - description: Fastly Account id. - in: path - name: account_id - required: true - schema: - type: string - FastlyServiceID: - description: Fastly Service ID. - in: path - name: service_id - required: true - schema: - type: string - GCPSTSServiceAccountID: - description: Your GCP STS enabled service account's unique ID. - in: path - name: account_id - required: true - schema: - type: string - IncidentAttachmentFilterQueryParameter: - description: Specifies which types of attachments are included in the response. - explode: false - in: query - name: 'filter[attachment_type]' - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentAttachmentType' - type: array - IncidentAttachmentIncludeQueryParameter: - description: Specifies which types of related objects are included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentAttachmentRelatedObject' - type: array - IncidentIDPathParameter: - description: The UUID of the incident. - in: path - name: incident_id - required: true - schema: - type: string - IncidentIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - explode: false - in: query - name: include - required: false - schema: - items: - $ref: '#/components/schemas/IncidentRelatedObject' - type: array - IncidentIntegrationMetadataIDPathParameter: - description: The UUID of the incident integration metadata. - in: path - name: integration_metadata_id - required: true - schema: - type: string - IncidentSearchIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentSearchQueryQueryParameter: - description: |- - Specifies which incidents should be returned. The query can contain any number of incident facets - joined by `ANDs`, along with multiple values for each of those facets joined by `OR`s. For - example: `state:active AND severity:(SEV-2 OR SEV-1)`. - explode: false - in: query - name: query - required: true - schema: - type: string - IncidentSearchSortQueryParameter: - description: Specifies the order of returned incidents. - explode: false - in: query - name: sort - required: false - schema: - $ref: '#/components/schemas/IncidentSearchSortOrder' - IncidentServiceIDPathParameter: - description: The ID of the incident service. - in: path - name: service_id - required: true - schema: - type: string - IncidentServiceIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentServiceSearchQueryParameter: - description: A search query that filters services by name. - in: query - name: filter - required: false - schema: - example: ExampleServiceName - type: string - IncidentTeamIDPathParameter: - description: The ID of the incident team. - in: path - name: team_id - required: true - schema: - type: string - IncidentTeamIncludeQueryParameter: - description: Specifies which types of related objects should be included in the response. - in: query - name: include - required: false - schema: - $ref: '#/components/schemas/IncidentRelatedObject' - IncidentTeamSearchQueryParameter: - description: A search query that filters teams by name. - in: query - name: filter - required: false - schema: - example: ExampleTeamName - type: string - IncidentTodoIDPathParameter: - description: The UUID of the incident todo. - in: path - name: todo_id - required: true - schema: - type: string - MetricID: - description: The name of the log-based metric. - in: path - name: metric_id - required: true - schema: - type: string - MetricName: - description: The name of the metric. - example: dist.http.endpoint.request - in: path - name: metric_name - required: true - schema: - type: string - OpsgenieServiceIDPathParameter: - description: The UUID of the service. - in: path - name: integration_service_id - required: true - schema: - type: string - PageNumber: - description: Specific page number to return. - in: query - name: 'page[number]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageOffset: - description: Specific offset to use as the beginning of the returned page. - in: query - name: 'page[offset]' - required: false - schema: - default: 0 - example: 0 - format: int64 - type: integer - PageSize: - description: Size for a given page. The maximum allowed value is 100. - in: query - name: 'page[size]' - required: false - schema: - default: 10 - example: 10 - format: int64 - type: integer - ResourceID: - description: 'Identifier, formatted as `type:id`. Supported types: `connection`, `dashboard`, `notebook`, `security-rule`, `slo`.' - example: 'dashboard:abc-def-ghi' - in: path - name: resource_id - required: true - schema: - type: string - RetentionFilterIdParam: - description: The ID of the retention filter. - in: path - name: filter_id - required: true - schema: - type: string - RoleID: - description: The unique identifier of the role. - in: path - name: role_id - required: true - schema: - type: string - RuleId: - description: The ID of the rule/scorecard. - in: path - name: rule_id - required: true - schema: - type: string - SchemaVersion: - description: The schema version desired in the response. - in: query - name: schema_version - required: false - schema: - $ref: '#/components/schemas/ServiceDefinitionSchemaVersions' - SecurityFilterID: - description: The ID of the security filter. - in: path - name: security_filter_id - required: true - schema: - type: string - SecurityMonitoringRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - SensitiveDataScannerGroupID: - description: The ID of a group of rules. - in: path - name: group_id - required: true - schema: - type: string - SensitiveDataScannerRuleID: - description: The ID of the rule. - in: path - name: rule_id - required: true - schema: - type: string - ServiceAccountID: - description: The ID of the service account. - in: path - name: service_account_id - required: true - schema: - example: 00000000-0000-1234-0000-000000000000 - type: string - ServiceName: - description: The name of the service. - in: path - name: service_name - required: true - schema: - example: my-service - type: string - SignalID: - description: The ID of the signal. - in: path - name: signal_id - required: true - schema: - type: string - SpansMetricIDParameter: - description: The name of the span-based metric. - in: path - name: metric_id - required: true - schema: - type: string - UserID: - description: The ID of the user. - in: path - name: user_id - required: true - schema: - example: 00000000-0000-9999-0000-000000000000 - type: string - responses: - TooManyRequestsResponse: - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Too many requests - securitySchemes: - AuthZ: - description: This API uses OAuth 2 with the implicit grant flow. - flows: - authorizationCode: - authorizationUrl: /oauth2/v1/authorize - scopes: - apm_service_catalog_read: View service catalog and service definitions. - apm_service_catalog_write: 'Add, modify, and delete service catalog definitions when those definitions are maintained by Datadog.' - ci_visibility_pipelines_write: Create CI Visibility pipeline spans using the API. - ci_visibility_read: View CI Visibility. - create_webhooks: Create webhooks integrations. - dashboards_public_share: Generate public and authenticated links to share dashboards or embeddable graphs externally. - dashboards_read: View dashboards. - dashboards_write: Create and change dashboards. - events_read: Read Events data. - incident_notification_settings_write: Configure Incidents Notification settings. - incident_read: View incidents in Datadog. - incident_settings_write: Configure Incident Settings. - incident_write: 'Create, view, and manage incidents in Datadog.' - metrics_read: View custom metrics. - monitors_downtime: Set downtimes to suppress alerts from any monitor in an organization. Mute and unmute hosts. The ability to write monitors is not required to set downtimes. - monitors_read: View monitors. - monitors_write: Edit and delete individual monitors. - security_monitoring_filters_read: Read Security Filters. - security_monitoring_filters_write: 'Create, edit, and delete Security Filters.' - security_monitoring_findings_read: View CSPM Findings. - security_monitoring_rules_read: Read Detection Rules. - security_monitoring_rules_write: Create and edit Detection Rules. - security_monitoring_signals_read: View Security Signals. - security_monitoring_suppressions_read: Read Rule Suppressions. - security_monitoring_suppressions_write: Write Rule Suppressions. - slos_corrections: 'Apply, edit, and delete SLO status corrections. A user with this permission can make status corrections, even if they do not have permission to edit those SLOs.' - slos_read: View SLOs and status corrections. - slos_write: 'Create, edit, and delete SLOs.' - synthetics_global_variable_read: 'View, search, and use Synthetics global variables.' - synthetics_global_variable_write: 'Create, edit, and delete global variables for Synthetics.' - synthetics_private_location_read: 'View, search, and use Synthetics private locations.' - synthetics_private_location_write: Create and delete private locations in addition to having access to the associated installation guidelines. - synthetics_read: List and view configured Synthetic tests and test results. - synthetics_write: 'Create, edit, and delete Synthetic tests.' - teams_manage: 'Manage Teams. Create, delete, rename, and edit metadata of all Teams. To control Team membership across all Teams, use the User Access Manage permission.' - teams_read: 'Read Teams data. A User with this permission can view Team names, metadata, and which Users are on each Team.' - timeseries_query: Query Timeseries data. - usage_read: View your organization's usage and usage attribution. - user_access_invite: Invite other users to your organization. - user_access_manage: 'Disable users, manage user roles, manage SAML-to-role mappings, and configure logs restriction queries.' - user_access_read: View users and their roles and settings. - tokenUrl: /oauth2/v1/token - type: oauth2 - apiKeyAuth: - description: Your Datadog API Key. - in: header - name: DD-API-KEY - type: apiKey - x-env-name: DD_API_KEY - appKeyAuth: - description: Your Datadog APP Key. - in: header - name: DD-APPLICATION-KEY - type: apiKey - x-env-name: DD_APP_KEY - callbacks: {} - examples: {} - requestBodies: {} - headers: {} - links: {} - x-stackQL-resources: - invitations: - id: datadog.users.invitations - name: invitations - title: Invitations - methods: - send_invitations: - operation: - $ref: '#/paths/~1api~1v2~1user_invitations/post' - response: - mediaType: application/json - openAPIDocKey: '201' - get_invitation: - operation: - $ref: '#/paths/~1api~1v2~1user_invitations~1{user_invitation_uuid}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_invitation: - operation: - $ref: '#/paths/~1api~1v2~1user_invitations~1{user_invitation_uuid}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/invitations/methods/get_invitation' - insert: [] - update: [] - delete: [] - users: - id: datadog.users.users - name: users - title: Users - methods: - list_users: - operation: - $ref: '#/paths/~1api~1v2~1users/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_users: - operation: - $ref: '#/paths/~1api~1v2~1users/get' - response: - mediaType: application/json - openAPIDocKey: '200' - create_user: - operation: - $ref: '#/paths/~1api~1v2~1users/post' - response: - mediaType: application/json - openAPIDocKey: '201' - disable_user: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_id}/delete' - response: - mediaType: application/json - openAPIDocKey: '204' - get_user: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _get_user: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_id}/get' - response: - mediaType: application/json - openAPIDocKey: '200' - update_user: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_id}/patch' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/users/methods/get_user' - - $ref: '#/components/x-stackQL-resources/users/methods/list_users' - insert: - - $ref: '#/components/x-stackQL-resources/users/methods/create_user' - update: [] - delete: [] - user_organizations: - id: datadog.users.user_organizations - name: user_organizations - title: User Organizations - methods: - list_user_organizations: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_id}~1orgs/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_user_organizations: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_id}~1orgs/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/user_organizations/methods/list_user_organizations' - insert: [] - update: [] - delete: [] - user_permissions: - id: datadog.users.user_permissions - name: user_permissions - title: User Permissions - methods: - list_user_permissions: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_id}~1permissions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - objectKey: $.data - _list_user_permissions: - operation: - $ref: '#/paths/~1api~1v2~1users~1{user_id}~1permissions/get' - response: - mediaType: application/json - openAPIDocKey: '200' - sqlVerbs: - select: - - $ref: '#/components/x-stackQL-resources/user_permissions/methods/list_user_permissions' - insert: [] - update: [] - delete: [] - vw_users: - name: vw_users - id: datadog.users.vw_users - config: - views: - select: - predicate: sqlDialect == "sqlite3" - ddl: |- - SELECT - id, - JSON_EXTRACT(attributes, '$.name') as name, - JSON_EXTRACT(attributes, '$.email') as email, - JSON_EXTRACT(attributes, '$.handle') as handle, - JSON_EXTRACT(attributes, '$.title') as title, - JSON_EXTRACT(attributes, '$.status') as status, - CASE - WHEN JSON_EXTRACT(attributes, '$.mfa_enabled') = 1 THEN 'true' - ELSE 'false' - END as mfa_enabled, - CASE - WHEN JSON_EXTRACT(attributes, '$.verified') = 1 THEN 'true' - ELSE 'false' - END as verified, - CASE - WHEN JSON_EXTRACT(attributes, '$.disabled') = 1 THEN 'true' - ELSE 'false' - END as disabled, - CASE - WHEN JSON_EXTRACT(attributes, '$.service_account') = 1 THEN 'true' - ELSE 'false' - END as service_account, - JSON_EXTRACT(attributes, '$.icon') as icon, - JSON_EXTRACT(attributes, '$.allowed_login_methods') as allowed_login_methods, - JSON_EXTRACT(attributes, '$.created_at') as created_at, - JSON_EXTRACT(attributes, '$.modified_at') as modified_at - FROM - datadog.users.users - WHERE dd_site = 'us3.datadoghq.com' -paths: - /api/v2/user_invitations: - post: - description: Sends emails to one or more users inviting them to join the organization. - operationId: SendInvitations - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/UserInvitationsRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/UserInvitationsResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_invite - summary: Send invitation emails - tags: - - Users - x-codegen-request-body-name: body - '/api/v2/user_invitations/{user_invitation_uuid}': - get: - description: Returns a single user invitation by its UUID. - operationId: GetInvitation - parameters: - - description: The UUID of the user invitation. - in: path - name: user_invitation_uuid - required: true - schema: - example: 00000000-0000-0000-3456-000000000000 - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UserInvitationResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_invite - summary: Get a user invitation - tags: - - Users - x-codegen-request-body-name: body - /api/v2/users: - get: - description: |- - Get the list of all users in the organization. This list includes - all users even if they are deactivated or unverified. - operationId: ListUsers - parameters: - - $ref: '#/components/parameters/PageSize' - - $ref: '#/components/parameters/PageNumber' - - description: |- - User attribute to order results by. Sort order is ascending by default. - Sort order is descending if the field - is prefixed by a negative sign, for example `sort=-name`. Options: `name`, - `modified_at`, `user_count`. - in: query - name: sort - required: false - schema: - default: name - example: name - type: string - - description: 'Direction of sort. Options: `asc`, `desc`.' - in: query - name: sort_dir - required: false - schema: - $ref: '#/components/schemas/QuerySortOrder' - - description: Filter all users by the given string. Defaults to no filtering. - in: query - name: filter - required: false - schema: - type: string - - description: |- - Filter on status attribute. - Comma separated list, with possible values `Active`, `Pending`, and `Disabled`. - Defaults to no filtering. - in: query - name: 'filter[status]' - required: false - schema: - example: Active - type: string - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UsersResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_read - summary: List all users - tags: - - Users - x-codegen-request-body-name: body - x-pagination: - limitParam: 'page[size]' - pageParam: 'page[number]' - resultsPath: data - post: - description: Create a user for your organization. - operationId: CreateUser - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/UserCreateRequest' - required: true - responses: - '201': - content: - application/json: - schema: - $ref: '#/components/schemas/UserResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_invite - summary: Create a user - tags: - - Users - x-codegen-request-body-name: body - '/api/v2/users/{user_id}': - delete: - description: |- - Disable a user. Can only be used with an application key belonging - to an administrator user. - operationId: DisableUser - parameters: - - $ref: '#/components/parameters/UserID' - responses: - '204': - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Disable a user - tags: - - Users - x-codegen-request-body-name: body - get: - description: Get a user in the organization specified by the user’s `user_id`. - operationId: GetUser - parameters: - - $ref: '#/components/parameters/UserID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UserResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_read - summary: Get user details - tags: - - Users - x-codegen-request-body-name: body - patch: - description: |- - Edit a user. Can only be used with an application key belonging - to an administrator user. - operationId: UpdateUser - parameters: - - $ref: '#/components/parameters/UserID' - requestBody: - content: - application/json: - schema: - $ref: '#/components/schemas/UserUpdateRequest' - required: true - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UserResponse' - description: OK - '400': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Bad Request - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '422': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Unprocessable Entity - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_manage - summary: Update a user - tags: - - Users - x-codegen-request-body-name: body - '/api/v2/users/{user_id}/orgs': - get: - description: |- - Get a user organization. Returns the user information and all organizations - joined by this user. - operationId: ListUserOrganizations - parameters: - - $ref: '#/components/parameters/UserID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/UserResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: [] - summary: Get a user organization - tags: - - Users - x-codegen-request-body-name: body - '/api/v2/users/{user_id}/permissions': - get: - description: |- - Get a user permission set. Returns a list of the user’s permissions - granted by the associated user's roles. - operationId: ListUserPermissions - parameters: - - $ref: '#/components/parameters/UserID' - responses: - '200': - content: - application/json: - schema: - $ref: '#/components/schemas/PermissionsResponse' - description: OK - '403': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Authentication error - '404': - content: - application/json: - schema: - $ref: '#/components/schemas/APIErrorResponse' - description: Not found - '429': - $ref: '#/components/responses/TooManyRequestsResponse' - security: - - apiKeyAuth: [] - appKeyAuth: [] - - AuthZ: - - user_access_read - summary: Get a user permissions - tags: - - Users - x-codegen-request-body-name: body From 0e9eec019c54e07fd6657e3dd2c867c76c6e3fb7 Mon Sep 17 00:00:00 2001 From: General Kroll Date: Sun, 12 Oct 2025 18:27:33 +1100 Subject: [PATCH 2/2] any-sdk-json-schema-validation Summary: - `any-sdk` json schema validation. - json schema validation incorpoarated into AOT checks. --- .github/workflows/aot.yml | 2 +- scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh | 6 ++++-- scripts/cicd/shell/aot-orchestration/01-aot-analyse-all.sh | 4 +++- 3 files changed, 8 insertions(+), 4 deletions(-) diff --git a/.github/workflows/aot.yml b/.github/workflows/aot.yml index a6c04f99..967c882f 100644 --- a/.github/workflows/aot.yml +++ b/.github/workflows/aot.yml @@ -108,7 +108,7 @@ jobs: echo "" for line in $(${{ github.workspace }}/stackql-any-sdk/build/anysdk interrogate services ${{ github.workspace }}/providers ${subdir}/v00.00.00000/provider.yaml); do serviceIdentifier="${line}" - ./scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh ${{ github.workspace }}/stackql-any-sdk/build/anysdk "${providerID}" "${subdir}/v00.00.00000/provider.yaml" "${serviceIdentifier}" & + ./scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh ${{ github.workspace }}/stackql-any-sdk/build/anysdk "${providerID}" "${subdir}/v00.00.00000/provider.yaml" "${serviceIdentifier}" "${{ github.workspace }}/stackql-any-sdk/cicd/schema-definitions" & echo "" done done diff --git a/scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh b/scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh index 08c15c83..ecdf9a74 100755 --- a/scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh +++ b/scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh @@ -12,14 +12,16 @@ providerRootFile="${3}" serviceIdentifier="${4}" +jsonSchemaDir="${5}" + logDir="${REPOSITORY_ROOT}/test/log" registryDir="${REPOSITORY_ROOT}/providers" if [ "${serviceIdentifier}" != "" ]; then - ${anySdkExe} aot "${registryDir}" "${providerRootFile}" "${serviceIdentifier}" -v > "${logDir}/aot_${providerID}_${serviceIdentifier}.log" 2>&1 + ${anySdkExe} aot --schema-dir "${jsonSchemaDir}" "${registryDir}" "${providerRootFile}" "${serviceIdentifier}" -v > "${logDir}/aot_${providerID}_${serviceIdentifier}.log" 2>&1 else - ${anySdkExe} aot "${registryDir}" "${providerRootFile}" -v > "${logDir}/aot_${providerID}.log" 2>&1 + ${anySdkExe} aot --schema-dir "${jsonSchemaDir}" "${registryDir}" "${providerRootFile}" -v > "${logDir}/aot_${providerID}.log" 2>&1 fi rc="$?" diff --git a/scripts/cicd/shell/aot-orchestration/01-aot-analyse-all.sh b/scripts/cicd/shell/aot-orchestration/01-aot-analyse-all.sh index 7fa08f54..6790fe7d 100755 --- a/scripts/cicd/shell/aot-orchestration/01-aot-analyse-all.sh +++ b/scripts/cicd/shell/aot-orchestration/01-aot-analyse-all.sh @@ -6,6 +6,8 @@ REPOSITORY_ROOT="$(realpath "${CUR_DIR}/../../../..")" anySdkCliPath="${1}" +jsonSchemaDir="${2}" + for sd in ${REPOSITORY_ROOT}/providers/src/*/ ; do echo "" subdir="$(realpath "${sd}")" @@ -14,7 +16,7 @@ for sd in ${REPOSITORY_ROOT}/providers/src/*/ ; do echo "" for line in $(${anySdkCliPath} interrogate services ${REPOSITORY_ROOT}/providers ${subdir}/v00.00.00000/provider.yaml); do serviceIdentifier="${line}" - ${REPOSITORY_ROOT}/scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh ${anySdkCliPath} "${providerID}" "${subdir}/v00.00.00000/provider.yaml" "${serviceIdentifier}" & + ${REPOSITORY_ROOT}/scripts/cicd/shell/aot-analysis/01-aot-analysis-compact.sh ${anySdkCliPath} "${providerID}" "${subdir}/v00.00.00000/provider.yaml" "${serviceIdentifier}" "${jsonSchemaDir}" & echo "" done done