diff --git a/.apigentools-info b/.apigentools-info index bd1c1c10c1..575d210907 100644 --- a/.apigentools-info +++ b/.apigentools-info @@ -4,13 +4,13 @@ "spec_versions": { "v1": { "apigentools_version": "1.6.6", - "regenerated": "2024-01-31 20:51:09.699607", - "spec_repo_commit": "e545b10b" + "regenerated": "2024-02-05 19:51:56.938870", + "spec_repo_commit": "4e68d2cd" }, "v2": { "apigentools_version": "1.6.6", - "regenerated": "2024-01-31 20:51:09.736111", - "spec_repo_commit": "e545b10b" + "regenerated": "2024-02-05 19:51:56.952999", + "spec_repo_commit": "4e68d2cd" } } } \ No newline at end of file diff --git a/.generator/schemas/v1/openapi.yaml b/.generator/schemas/v1/openapi.yaml index a52bd550c9..709d51bc79 100644 --- a/.generator/schemas/v1/openapi.yaml +++ b/.generator/schemas/v1/openapi.yaml @@ -33601,10 +33601,9 @@ tags: organization.' name: Dashboard Lists x-deprecated: true -- description: 'Interact with your dashboard lists through the API to make it easier - to organize, - - find, and share all of your dashboards with your team and organization.' +- description: Manage all your dashboards, as well as access to your shared dashboards, + through the API. See the [Dashboards page](https://docs.datadoghq.com/dashboards/) + for more information. name: Dashboards - description: '[Downtiming](https://docs.datadoghq.com/monitors/notify/downtimes) gives @@ -33615,15 +33614,11 @@ tags: 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 +- description: 'The Event Management API allows you to programmatically post events + to the Events Explorer - first 4000 characters are displayed.' + and fetch events from the Events Explorer. See the [Event Management page](https://docs.datadoghq.com/service_management/events/) + for more information.' name: Events - description: 'Configure your Datadog-Google Cloud Platform (GCP) integration directly @@ -33631,7 +33626,9 @@ tags: externalDocs: url: https://docs.datadoghq.com/integrations/google_cloud_platform name: GCP Integration -- description: Get information about your live hosts in Datadog. +- description: Get information about your infrastructure hosts in Datadog, and mute + or unmute any notifications from your hosts. See the [Infrastructure page](https://docs.datadoghq.com/infrastructure/) + for more information. name: Hosts - description: Get a list of IP prefixes belonging to Datadog. name: IP Ranges diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml index 58db4b9ef5..ab0c880bb4 100644 --- a/.generator/schemas/v2/openapi.yaml +++ b/.generator/schemas/v2/openapi.yaml @@ -33475,13 +33475,17 @@ tags: API. See the [Cloudflare integration page](https://docs.datadoghq.com/integrations/cloudflare/) for more information. name: Cloudflare Integration -- description: Configure your Datadog Confluent Cloud integration directly through - the Datadog API. +- description: Manage your Datadog Confluent Cloud integration accounts and account + resources directly through the Datadog API. See the [Confluent Cloud page](https://docs.datadoghq.com/integrations/confluent_cloud/) + for more information. name: Confluent Cloud - description: The Container Images API allows you to query Container Image data for - your organization. + your organization. See the [Container Images View page](https://docs.datadoghq.com/infrastructure/containers/container_images/) + for more information. name: Container Images - description: The Containers API allows you to query container data for your organization. + See the [Container Monitoring page](https://docs.datadoghq.com/containers/) for + more information. name: Containers - description: Send events for DORA Metrics to measure and improve software delivery. See the [DORA Metrics page](https://docs.datadoghq.com/dora_metrics/) for more @@ -33505,18 +33509,15 @@ tags: 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 +- description: 'The Event Management API allows you to programmatically post events + to the Events Explorer - first 4000 characters are displayed.' + and fetch events from the Events Explorer. See the [Event Management page](https://docs.datadoghq.com/service_management/events/) + for more information.' name: Events -- description: Configure your Datadog Fastly integration directly through the Datadog - API. +- description: Manage your Datadog Fastly integration accounts and services directly + through the Datadog API. See the [Fastly integration page](https://docs.datadoghq.com/integrations/fastly/) + for more information. name: Fastly Integration - description: 'Configure your Datadog-Google Cloud Platform (GCP) integration directly @@ -33536,12 +33537,15 @@ tags: contacting Datadog support.' name: IP Allowlist - description: Create, update, delete, and retrieve services which can be associated - with incidents. + with incidents. See the [Incident Management page](https://docs.datadoghq.com/service_management/incident_management/) + for more information. 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. +- description: Manage incident response, as well as associated attachments, metadata, + and todos. See the [Incident Management page](https://docs.datadoghq.com/service_management/incident_management/) + for more information. name: Incidents - description: 'Manage your Datadog API and application keys. You need an API key and diff --git a/src/datadog_api_client/v1/api/dashboards_api.py b/src/datadog_api_client/v1/api/dashboards_api.py index abd8ba23bb..88b7b4c560 100644 --- a/src/datadog_api_client/v1/api/dashboards_api.py +++ b/src/datadog_api_client/v1/api/dashboards_api.py @@ -28,8 +28,7 @@ class DashboardsApi: """ - Interact with your dashboard lists through the API to make it easier to organize, - find, and share all of your dashboards with your team and organization. + Manage all your dashboards, as well as access to your shared dashboards, through the API. See the `Dashboards page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v1/api/events_api.py b/src/datadog_api_client/v1/api/events_api.py index 1de22d57e0..2b404bfd98 100644 --- a/src/datadog_api_client/v1/api/events_api.py +++ b/src/datadog_api_client/v1/api/events_api.py @@ -20,10 +20,8 @@ class EventsApi: """ - 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. + The Event Management API allows you to programmatically post events to the Events Explorer + and fetch events from the Events Explorer. See the `Event Management page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v1/api/hosts_api.py b/src/datadog_api_client/v1/api/hosts_api.py index c2231abeab..524277a495 100644 --- a/src/datadog_api_client/v1/api/hosts_api.py +++ b/src/datadog_api_client/v1/api/hosts_api.py @@ -19,7 +19,7 @@ class HostsApi: """ - Get information about your live hosts in Datadog. + Get information about your infrastructure hosts in Datadog, and mute or unmute any notifications from your hosts. See the `Infrastructure page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v2/api/confluent_cloud_api.py b/src/datadog_api_client/v2/api/confluent_cloud_api.py index 3777aa12b2..06b4c1b05b 100644 --- a/src/datadog_api_client/v2/api/confluent_cloud_api.py +++ b/src/datadog_api_client/v2/api/confluent_cloud_api.py @@ -18,7 +18,7 @@ class ConfluentCloudApi: """ - Configure your Datadog Confluent Cloud integration directly through the Datadog API. + Manage your Datadog Confluent Cloud integration accounts and account resources directly through the Datadog API. See the `Confluent Cloud page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v2/api/container_images_api.py b/src/datadog_api_client/v2/api/container_images_api.py index 499825edbf..c64f71fab3 100644 --- a/src/datadog_api_client/v2/api/container_images_api.py +++ b/src/datadog_api_client/v2/api/container_images_api.py @@ -20,7 +20,7 @@ class ContainerImagesApi: """ - The Container Images API allows you to query Container Image data for your organization. + The Container Images API allows you to query Container Image data for your organization. See the `Container Images View page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v2/api/containers_api.py b/src/datadog_api_client/v2/api/containers_api.py index 94aa153c31..71c06c1c9a 100644 --- a/src/datadog_api_client/v2/api/containers_api.py +++ b/src/datadog_api_client/v2/api/containers_api.py @@ -20,7 +20,7 @@ class ContainersApi: """ - The Containers API allows you to query container data for your organization. + The Containers API allows you to query container data for your organization. See the `Container Monitoring page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v2/api/events_api.py b/src/datadog_api_client/v2/api/events_api.py index 8ade8fb94b..23a28ebdce 100644 --- a/src/datadog_api_client/v2/api/events_api.py +++ b/src/datadog_api_client/v2/api/events_api.py @@ -22,10 +22,8 @@ class EventsApi: """ - 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. + The Event Management API allows you to programmatically post events to the Events Explorer + and fetch events from the Events Explorer. See the `Event Management page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v2/api/fastly_integration_api.py b/src/datadog_api_client/v2/api/fastly_integration_api.py index d7a8a47b64..85a671dcdd 100644 --- a/src/datadog_api_client/v2/api/fastly_integration_api.py +++ b/src/datadog_api_client/v2/api/fastly_integration_api.py @@ -18,7 +18,7 @@ class FastlyIntegrationApi: """ - Configure your Datadog Fastly integration directly through the Datadog API. + Manage your Datadog Fastly integration accounts and services directly through the Datadog API. See the `Fastly integration page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v2/api/incident_services_api.py b/src/datadog_api_client/v2/api/incident_services_api.py index 1bf7b749b9..a6fa3cf837 100644 --- a/src/datadog_api_client/v2/api/incident_services_api.py +++ b/src/datadog_api_client/v2/api/incident_services_api.py @@ -20,7 +20,7 @@ class IncidentServicesApi: """ - Create, update, delete, and retrieve services which can be associated with incidents. + Create, update, delete, and retrieve services which can be associated with incidents. See the `Incident Management page `_ for more information. """ def __init__(self, api_client=None): diff --git a/src/datadog_api_client/v2/api/incidents_api.py b/src/datadog_api_client/v2/api/incidents_api.py index d5a25a55d2..70f2ed2813 100644 --- a/src/datadog_api_client/v2/api/incidents_api.py +++ b/src/datadog_api_client/v2/api/incidents_api.py @@ -46,7 +46,7 @@ class IncidentsApi: """ - Manage incident response. + Manage incident response, as well as associated attachments, metadata, and todos. See the `Incident Management page `_ for more information. """ def __init__(self, api_client=None): diff --git a/tests/v1/features/dashboards.feature b/tests/v1/features/dashboards.feature index 0177acd4f4..e631bc3459 100644 --- a/tests/v1/features/dashboards.feature +++ b/tests/v1/features/dashboards.feature @@ -1,8 +1,8 @@ @endpoint(dashboards) @endpoint(dashboards-v1) Feature: Dashboards - Interact with your dashboard lists through the API to make it easier to - organize, find, and share all of your dashboards with your team and - organization. + Manage all your dashboards, as well as access to your shared dashboards, + through the API. See the [Dashboards + page](https://docs.datadoghq.com/dashboards/) for more information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v1/features/events.feature b/tests/v1/features/events.feature index d9faefb437..3005fc756f 100644 --- a/tests/v1/features/events.feature +++ b/tests/v1/features/events.feature @@ -1,9 +1,9 @@ @endpoint(events) @endpoint(events-v1) Feature: Events - 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. + The Event Management API allows you to programmatically post events to the + Events Explorer and fetch events from the Events Explorer. See the [Event + Management page](https://docs.datadoghq.com/service_management/events/) + for more information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v1/features/hosts.feature b/tests/v1/features/hosts.feature index 2a6838923b..7ed533f7b2 100644 --- a/tests/v1/features/hosts.feature +++ b/tests/v1/features/hosts.feature @@ -1,6 +1,8 @@ @endpoint(hosts) @endpoint(hosts-v1) Feature: Hosts - Get information about your live hosts in Datadog. + Get information about your infrastructure hosts in Datadog, and mute or + unmute any notifications from your hosts. See the [Infrastructure + page](https://docs.datadoghq.com/infrastructure/) for more information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v2/features/confluent_cloud.feature b/tests/v2/features/confluent_cloud.feature index 498db076a0..d3d6d26d6a 100644 --- a/tests/v2/features/confluent_cloud.feature +++ b/tests/v2/features/confluent_cloud.feature @@ -1,7 +1,9 @@ @endpoint(confluent-cloud) @endpoint(confluent-cloud-v2) Feature: Confluent Cloud - Configure your Datadog Confluent Cloud integration directly through the - Datadog API. + Manage your Datadog Confluent Cloud integration accounts and account + resources directly through the Datadog API. See the [Confluent Cloud + page](https://docs.datadoghq.com/integrations/confluent_cloud/) for more + information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v2/features/container_images.feature b/tests/v2/features/container_images.feature index 7de87bcb69..ad6e1559be 100644 --- a/tests/v2/features/container_images.feature +++ b/tests/v2/features/container_images.feature @@ -1,7 +1,8 @@ @endpoint(container-images) @endpoint(container-images-v2) Feature: Container Images The Container Images API allows you to query Container Image data for your - organization. + organization. See the [Container Images View page](https://docs.datadoghq. + com/infrastructure/containers/container_images/) for more information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v2/features/containers.feature b/tests/v2/features/containers.feature index 302f1ab0a6..8149319237 100644 --- a/tests/v2/features/containers.feature +++ b/tests/v2/features/containers.feature @@ -1,7 +1,8 @@ @endpoint(containers) @endpoint(containers-v2) Feature: Containers The Containers API allows you to query container data for your - organization. + organization. See the [Container Monitoring + page](https://docs.datadoghq.com/containers/) for more information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v2/features/events.feature b/tests/v2/features/events.feature index 50954f2b20..9a1c79072d 100644 --- a/tests/v2/features/events.feature +++ b/tests/v2/features/events.feature @@ -1,9 +1,9 @@ @endpoint(events) @endpoint(events-v2) Feature: Events - 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. + The Event Management API allows you to programmatically post events to the + Events Explorer and fetch events from the Events Explorer. See the [Event + Management page](https://docs.datadoghq.com/service_management/events/) + for more information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v2/features/fastly_integration.feature b/tests/v2/features/fastly_integration.feature index a42378363a..7eebb4bf3d 100644 --- a/tests/v2/features/fastly_integration.feature +++ b/tests/v2/features/fastly_integration.feature @@ -1,7 +1,9 @@ @endpoint(fastly-integration) @endpoint(fastly-integration-v2) Feature: Fastly Integration - Configure your Datadog Fastly integration directly through the Datadog - API. + Manage your Datadog Fastly integration accounts and services directly + through the Datadog API. See the [Fastly integration + page](https://docs.datadoghq.com/integrations/fastly/) for more + information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v2/features/incident_services.feature b/tests/v2/features/incident_services.feature index 66eb74e5d9..eb5e5716d4 100644 --- a/tests/v2/features/incident_services.feature +++ b/tests/v2/features/incident_services.feature @@ -1,7 +1,9 @@ @endpoint(incident-services) @endpoint(incident-services-v2) Feature: Incident Services Create, update, delete, and retrieve services which can be associated with - incidents. + incidents. See the [Incident Management + page](https://docs.datadoghq.com/service_management/incident_management/) + for more information. Background: Given a valid "apiKeyAuth" key in the system diff --git a/tests/v2/features/incidents.feature b/tests/v2/features/incidents.feature index 796d1e7d93..e14dba5556 100644 --- a/tests/v2/features/incidents.feature +++ b/tests/v2/features/incidents.feature @@ -1,6 +1,9 @@ @endpoint(incidents) @endpoint(incidents-v2) Feature: Incidents - Manage incident response. + Manage incident response, as well as associated attachments, metadata, and + todos. See the [Incident Management + page](https://docs.datadoghq.com/service_management/incident_management/) + for more information. Background: Given a valid "apiKeyAuth" key in the system