diff --git a/.apigentools-info b/.apigentools-info index 815fd7f079f..faf5336f36c 100644 --- a/.apigentools-info +++ b/.apigentools-info @@ -4,13 +4,13 @@ "spec_versions": { "v1": { "apigentools_version": "1.5.1.dev2", - "regenerated": "2021-12-19 13:14:08.452093", - "spec_repo_commit": "f4bca2b" + "regenerated": "2021-12-20 09:54:50.345482", + "spec_repo_commit": "d90592c" }, "v2": { "apigentools_version": "1.5.1.dev2", - "regenerated": "2021-12-19 13:14:09.314811", - "spec_repo_commit": "f4bca2b" + "regenerated": "2021-12-20 09:54:51.177498", + "spec_repo_commit": "d90592c" } } } \ No newline at end of file diff --git a/.generator/schemas/v1/openapi.yaml b/.generator/schemas/v1/openapi.yaml index 809380e2547..adbf8e2a3ab 100644 --- a/.generator/schemas/v1/openapi.yaml +++ b/.generator/schemas/v1/openapi.yaml @@ -1723,8 +1723,8 @@ components: alert_type: $ref: '#/components/schemas/EventAlertType' date_happened: - description: 'POSIX timestamp of the event. Must be sent as an integer (i.e. - no quotes). + description: 'POSIX timestamp of the event. Must be sent as an integer (that + is no quotes). Limited to events no older than 7 days.' format: int64 @@ -1829,8 +1829,8 @@ components: alert_type: $ref: '#/components/schemas/EventAlertType' date_happened: - description: 'POSIX timestamp of the event. Must be sent as an integer (i.e. - no quotes). + description: 'POSIX timestamp of the event. Must be sent as an integer (that + is no quotes). Limited to events no older than 7 days.' format: int64 @@ -1856,8 +1856,8 @@ components: priority: $ref: '#/components/schemas/EventPriority' related_event_id: - description: ID of the parent event. Must be sent as an integer (i.e. no - quotes). + description: ID of the parent event. Must be sent as an integer (that is + no quotes). format: int64 type: integer source_type_name: @@ -1903,8 +1903,8 @@ components: alert_type: $ref: '#/components/schemas/EventAlertType' date_happened: - description: 'POSIX timestamp of the event. Must be sent as an integer (i.e. - no quotes). + description: 'POSIX timestamp of the event. Must be sent as an integer (that + is no quotes). Limited to events no older than 7 days.' format: int64 @@ -1930,8 +1930,8 @@ components: priority: $ref: '#/components/schemas/EventPriority' related_event_id: - description: ID of the parent event. Must be sent as an integer (i.e. no - quotes). + description: ID of the parent event. Must be sent as an integer (that is + no quotes). format: int64 type: integer source_type_name: @@ -4563,9 +4563,10 @@ components: format: date-time type: string timezone: - description: 'Timezone can be specified both as an offset (e.g. "UTC+03:00") + description: 'Timezone can be specified both as an offset (for example + "UTC+03:00") - or a regional zone (e.g. "Europe/Paris").' + or a regional zone (for example "Europe/Paris").' type: string to: description: Maximum timestamp for requested logs. @@ -5988,13 +5989,13 @@ components: example: avg(last_5m):sum:system.net.bytes_rcvd{host:host0} > 100 type: string scopes: - description: 'The scope(s) to which the downtime applies, e.g. `host:app2`. + description: 'The scope(s) to which the downtime applies, for example `host:app2`. - Provide multiple scopes as a comma-separated list, e.g. `env:dev,env:prod`. + Provide multiple scopes as a comma-separated list, for example `env:dev,env:prod`. The resulting downtime applies to sources that matches ALL provided scopes - (i.e. `env:dev AND env:prod`), NOT any of them.' + (that is `env:dev AND env:prod`), NOT any of them.' example: - host:app2 - env:dev,env:prod @@ -8447,7 +8448,8 @@ components: target_display: description: 'A string representation of the target that indicates its precision. - It uses trailing zeros to show significant decimal places (e.g. `98.00`). + It uses trailing zeros to show significant decimal places (for example + `98.00`). Always included in service level objective responses. Ignored in @@ -12488,7 +12490,7 @@ components: format: int64 type: integer alibaba_host_count: - description: 'Contains the total number of hosts that reported via Alibaba + description: 'Contains the total number of hosts that reported through Alibaba integration (and were NOT running the Datadog Agent).' @@ -12506,14 +12508,14 @@ components: format: int64 type: integer aws_host_count: - description: 'Contains the total number of hosts that reported via the AWS - integration + description: 'Contains the total number of hosts that reported through the + AWS integration (and were NOT running the Datadog Agent).' format: int64 type: integer azure_host_count: - description: 'Contains the total number of hosts that reported via Azure + description: 'Contains the total number of hosts that reported through Azure integration (and were NOT running the Datadog Agent).' @@ -12525,8 +12527,8 @@ components: format: int64 type: integer gcp_host_count: - description: 'Contains the total number of hosts that reported via the Google - Cloud integration + description: 'Contains the total number of hosts that reported through the + Google Cloud integration (and were NOT running the Datadog Agent).' format: int64 @@ -12548,8 +12550,8 @@ components: format: date-time type: string infra_azure_app_service: - description: 'Contains the total number of hosts that reported via the Azure - App Services integration + description: 'Contains the total number of hosts that reported through the + Azure App Services integration (and were NOT running the Datadog Agent).' format: int64 @@ -12560,7 +12562,7 @@ components: format: int64 type: integer vsphere_host_count: - description: 'Contains the total number of hosts that reported via vSphere + description: 'Contains the total number of hosts that reported through vSphere integration (and were NOT running the Datadog Agent).' @@ -14395,7 +14397,7 @@ components: scale: default: linear description: Specifies the scale type. Possible values are `linear`, `log`, - `sqrt`, `pow##` (e.g. `pow2`, `pow0.5` etc.). + `sqrt`, `pow##` (for example `pow2`, `pow0.5` etc.). type: string type: object WidgetChangeType: @@ -15170,7 +15172,7 @@ paths: variables: site: default: datadoghq.com - description: The regional site for our customers. + description: The regional site for Datadog customers. enum: - datadoghq.com - us3.datadoghq.com @@ -19875,10 +19877,10 @@ paths: Example: `"check".over(tags).last(count).by(group).count_by_status()` - - **`check`** name of the check, e.g. `datadog.agent.up` + - **`check`** name of the check, for example `datadog.agent.up` - - **`tags`** one or more quoted tags (comma-separated), or "*". e.g.: `.over("env:prod", - "role:db")`; **`over`** cannot be blank. + - **`tags`** one or more quoted tags (comma-separated), or "*". for example: + `.over("env:prod", "role:db")`; **`over`** cannot be blank. - **`count`** must be at greater than or equal to your max threshold (defined in the `options`). It is limited to 100. @@ -20229,8 +20231,8 @@ paths: format: int64 type: integer - description: 'String for sort order, composed of field and sort order separate - by a comma, e.g. `name,asc`. Supported sort directions: `asc`, `desc`. Supported - fields: + by a comma, for example `name,asc`. Supported sort directions: `asc`, `desc`. + Supported fields: * `name` @@ -20318,8 +20320,8 @@ paths: format: int64 type: integer - description: 'String for sort order, composed of field and sort order separate - by a comma, e.g. `name,asc`. Supported sort directions: `asc`, `desc`. Supported - fields: + by a comma, for example `name,asc`. Supported sort directions: `asc`, `desc`. + Supported fields: * `name` @@ -20422,7 +20424,7 @@ paths: format: int64 type: integer - description: Delete the monitor even if it's referenced by other resources - (e.g. SLO, composite monitor). + (for example SLO, composite monitor). in: query name: force required: false @@ -21999,7 +22001,7 @@ paths: schema: type: string - description: Delete the monitor even if it's referenced by other resources - (e.g. SLO, composite monitor). + (for example SLO, composite monitor). in: query name: force required: false @@ -23702,7 +23704,7 @@ paths: required: true schema: type: string - - description: 'The source of the tags (e.g. chef, puppet). + - description: 'The source of the tags (for example chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value).' in: query @@ -23853,7 +23855,7 @@ paths: required: true schema: type: string - - description: 'The source of the tags (e.g. chef, puppet). + - description: 'The source of the tags (for example chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value)' in: query @@ -25953,7 +25955,7 @@ paths: variables: site: default: datadoghq.com - description: The regional site for our customers. + description: The regional site for Datadog customers. enum: - datadoghq.com - us3.datadoghq.com @@ -26111,7 +26113,7 @@ tags: - description: "Pipelines and processors operate on incoming logs, parsing\nand transforming them into structured attributes for easier querying.\n\n- See the [pipelines configuration page](https://app.datadoghq.com/logs/pipelines)\n for a list of the pipelines - and processors currently configured in our UI.\n\n- Additional API-related information + and processors currently configured in web UI.\n\n- Additional API-related information about processors can be found in the\n [processors documentation](https://docs.datadoghq.com/logs/log_configuration/processors/?tab=api#lookup-processor).\n\n- For more information about Pipelines, see the\n [pipeline documentation](https://docs.datadoghq.com/logs/log_configuration/pipelines).\n\n**Notes:**\n\nThese endpoints are only available for admin users.\nMake sure to use an application diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml index 90926d7e7cb..89c74c3009e 100644 --- a/.generator/schemas/v2/openapi.yaml +++ b/.generator/schemas/v2/openapi.yaml @@ -9949,7 +9949,7 @@ servers: variables: site: default: datadoghq.com - description: The regional site for our customers. + description: The regional site for Datadog customers. enum: - datadoghq.com - us3.datadoghq.com @@ -10009,7 +10009,7 @@ tags: See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) - for a list of the archives currently configured in our UI.' + for a list of the archives currently configured in web UI.' externalDocs: description: Find out more at url: https://docs.datadoghq.com/logs/archives/ diff --git a/api_docs/v1/Event.md b/api_docs/v1/Event.md index e02833fe87b..b4b81eea76b 100644 --- a/api_docs/v1/Event.md +++ b/api_docs/v1/Event.md @@ -7,7 +7,7 @@ Object representing an event. | Name | Type | Description | Notes | | ------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | **alertType** | **EventAlertType** | | [optional] | -| **dateHappened** | **Long** | POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to events no older than 7 days. | [optional] | +| **dateHappened** | **Long** | POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited to events no older than 7 days. | [optional] | | **deviceName** | **String** | A device name. | [optional] | | **host** | **String** | Host name to associate with the event. Any tags associated with the host are also applied to this event. | [optional] | | **id** | **Long** | Integer ID of the event. | [optional] [readonly] | diff --git a/api_docs/v1/EventCreateRequest.md b/api_docs/v1/EventCreateRequest.md index 81b4795d71b..810e60e4238 100644 --- a/api_docs/v1/EventCreateRequest.md +++ b/api_docs/v1/EventCreateRequest.md @@ -8,13 +8,13 @@ Object representing an event. | ------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | **aggregationKey** | **String** | An arbitrary string to use for aggregation. Limited to 100 characters. If you specify a key, all events using that key are grouped together in the Event Stream. | [optional] | | **alertType** | **EventAlertType** | | [optional] | -| **dateHappened** | **Long** | POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to events no older than 7 days. | [optional] | +| **dateHappened** | **Long** | POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited to events no older than 7 days. | [optional] | | **deviceName** | **String** | A device name. | [optional] | | **host** | **String** | Host name to associate with the event. Any tags associated with the host are also applied to this event. | [optional] | | **id** | **Long** | Integer ID of the event. | [optional] [readonly] | | **payload** | **String** | Payload of the event. | [optional] [readonly] | | **priority** | **EventPriority** | | [optional] | -| **relatedEventId** | **Long** | ID of the parent event. Must be sent as an integer (i.e. no quotes). | [optional] | +| **relatedEventId** | **Long** | ID of the parent event. Must be sent as an integer (that is no quotes). | [optional] | | **sourceTypeName** | **String** | The type of event being posted. Option examples include nagios, hudson, jenkins, my_apps, chef, puppet, git, bitbucket, etc. A complete list of source attribute values [available here](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). | [optional] | | **tags** | **List<String>** | A list of tags to apply to the event. | [optional] | | **text** | **String** | The body of the event. Limited to 4000 characters. The text supports markdown. To use markdown in the event text, start the text block with `%%% \\n` and end the text block with `\\n %%%`. Use `msg_text` with the Datadog Ruby library. | diff --git a/api_docs/v1/EventCreateResponse.md b/api_docs/v1/EventCreateResponse.md index e7f027c9e8d..da3babe0f33 100644 --- a/api_docs/v1/EventCreateResponse.md +++ b/api_docs/v1/EventCreateResponse.md @@ -7,13 +7,13 @@ Object containing an event response. | Name | Type | Description | Notes | | ------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | | **alertType** | **EventAlertType** | | [optional] | -| **dateHappened** | **Long** | POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to events no older than 7 days. | [optional] | +| **dateHappened** | **Long** | POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited to events no older than 7 days. | [optional] | | **deviceName** | **String** | A device name. | [optional] | | **host** | **String** | Host name to associate with the event. Any tags associated with the host are also applied to this event. | [optional] | | **id** | **Long** | Integer ID of the event. | [optional] [readonly] | | **payload** | **String** | Payload of the event. | [optional] [readonly] | | **priority** | **EventPriority** | | [optional] | -| **relatedEventId** | **Long** | ID of the parent event. Must be sent as an integer (i.e. no quotes). | [optional] | +| **relatedEventId** | **Long** | ID of the parent event. Must be sent as an integer (that is no quotes). | [optional] | | **sourceTypeName** | **String** | The type of event being posted. Option examples include nagios, hudson, jenkins, my_apps, chef, puppet, git, bitbucket, etc. A complete list of source attribute values [available here](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). | [optional] | | **status** | **String** | A status. | [optional] | | **tags** | **List<String>** | A list of tags to apply to the event. | [optional] | diff --git a/api_docs/v1/LogsListRequestTime.md b/api_docs/v1/LogsListRequestTime.md index aa81c016e63..23321d2c9d5 100644 --- a/api_docs/v1/LogsListRequestTime.md +++ b/api_docs/v1/LogsListRequestTime.md @@ -4,8 +4,8 @@ Timeframe to retrieve the log from. ## Properties -| Name | Type | Description | Notes | -| ------------ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------- | ---------- | -| **from** | **OffsetDateTime** | Minimum timestamp for requested logs. | -| **timezone** | **String** | Timezone can be specified both as an offset (e.g. \"UTC+03:00\") or a regional zone (e.g. \"Europe/Paris\"). | [optional] | -| **to** | **OffsetDateTime** | Maximum timestamp for requested logs. | +| Name | Type | Description | Notes | +| ------------ | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | +| **from** | **OffsetDateTime** | Minimum timestamp for requested logs. | +| **timezone** | **String** | Timezone can be specified both as an offset (for example \"UTC+03:00\") or a regional zone (for example \"Europe/Paris\"). | [optional] | +| **to** | **OffsetDateTime** | Maximum timestamp for requested logs. | diff --git a/api_docs/v1/MonitorSearchResult.md b/api_docs/v1/MonitorSearchResult.md index 60cda165e7f..74fa816c65f 100644 --- a/api_docs/v1/MonitorSearchResult.md +++ b/api_docs/v1/MonitorSearchResult.md @@ -4,18 +4,18 @@ Holds search results. ## Properties -| Name | Type | Description | Notes | -| ------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | -| **classification** | **String** | Classification of the monitor. | [optional] [readonly] | -| **creator** | [**Creator**](Creator.md) | | [optional] | -| **id** | **Long** | ID of the monitor. | [optional] [readonly] | -| **lastTriggeredTs** | **Long** | Latest timestamp the monitor triggered. | [optional] [readonly] | -| **metrics** | **List<String>** | Metrics used by the monitor. | [optional] [readonly] | -| **name** | **String** | The monitor name. | [optional] [readonly] | -| **notifications** | [**List<MonitorSearchResultNotification>**](MonitorSearchResultNotification.md) | The notification triggered by the monitor. | [optional] [readonly] | -| **orgId** | **Long** | The ID of the organization. | [optional] [readonly] | -| **query** | **String** | The monitor query. | [optional] | -| **scopes** | **List<String>** | The scope(s) to which the downtime applies, e.g. `host:app2`. Provide multiple scopes as a comma-separated list, e.g. `env:dev,env:prod`. The resulting downtime applies to sources that matches ALL provided scopes (i.e. `env:dev AND env:prod`), NOT any of them. | [optional] | -| **status** | **MonitorOverallStates** | | [optional] | -| **tags** | **List<String>** | Tags associated with the monitor. | [optional] [readonly] | -| **type** | **MonitorType** | | [optional] | +| Name | Type | Description | Notes | +| ------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | +| **classification** | **String** | Classification of the monitor. | [optional] [readonly] | +| **creator** | [**Creator**](Creator.md) | | [optional] | +| **id** | **Long** | ID of the monitor. | [optional] [readonly] | +| **lastTriggeredTs** | **Long** | Latest timestamp the monitor triggered. | [optional] [readonly] | +| **metrics** | **List<String>** | Metrics used by the monitor. | [optional] [readonly] | +| **name** | **String** | The monitor name. | [optional] [readonly] | +| **notifications** | [**List<MonitorSearchResultNotification>**](MonitorSearchResultNotification.md) | The notification triggered by the monitor. | [optional] [readonly] | +| **orgId** | **Long** | The ID of the organization. | [optional] [readonly] | +| **query** | **String** | The monitor query. | [optional] | +| **scopes** | **List<String>** | The scope(s) to which the downtime applies, for example `host:app2`. Provide multiple scopes as a comma-separated list, for example `env:dev,env:prod`. The resulting downtime applies to sources that matches ALL provided scopes (that is `env:dev AND env:prod`), NOT any of them. | [optional] | +| **status** | **MonitorOverallStates** | | [optional] | +| **tags** | **List<String>** | Tags associated with the monitor. | [optional] [readonly] | +| **type** | **MonitorType** | | [optional] | diff --git a/api_docs/v1/MonitorsApi.md b/api_docs/v1/MonitorsApi.md index 2965ec743bb..976a87b642a 100644 --- a/api_docs/v1/MonitorsApi.md +++ b/api_docs/v1/MonitorsApi.md @@ -137,8 +137,8 @@ Use this to create an outlier monitor using the following query: Example: `"check".over(tags).last(count).by(group).count_by_status()` -- **`check`** name of the check, e.g. `datadog.agent.up` -- **`tags`** one or more quoted tags (comma-separated), or "\*". e.g.: `.over("env:prod", "role:db")`; **`over`** cannot be blank. +- **`check`** name of the check, for example `datadog.agent.up` +- **`tags`** one or more quoted tags (comma-separated), or "\*". for example: `.over("env:prod", "role:db")`; **`over`** cannot be blank. - **`count`** must be at greater than or equal to your max threshold (defined in the `options`). It is limited to 100. For example, if you've specified to notify on 1 critical, 3 ok, and 2 warn statuses, `count` should be at least 3. - **`group`** must be specified for check monitors. Per-check grouping is already explicitly known for some service checks. @@ -309,7 +309,7 @@ public class Example { MonitorsApi apiInstance = new MonitorsApi(defaultClient); Long monitorId = 56L; // Long | The ID of the monitor. - String force = "false"; // String | Delete the monitor even if it's referenced by other resources (e.g. SLO, composite monitor). + String force = "false"; // String | Delete the monitor even if it's referenced by other resources (for example SLO, composite monitor). try { DeletedMonitor result = apiInstance.deleteMonitor(monitorId, new MonitorsApi.DeleteMonitorOptionalParameters() .force(force)); @@ -327,10 +327,10 @@ public class Example { ### Parameters -| Name | Type | Description | Notes | -| ------------- | ---------- | ------------------------------------------------------------------------------------------------ | ---------- | -| **monitorId** | **Long** | The ID of the monitor. | -| **force** | **String** | Delete the monitor even if it's referenced by other resources (e.g. SLO, composite monitor). | [optional] | +| Name | Type | Description | Notes | +| ------------- | ---------- | ------------------------------------------------------------------------------------------------------- | ---------- | +| **monitorId** | **Long** | The ID of the monitor. | +| **force** | **String** | Delete the monitor even if it's referenced by other resources (for example SLO, composite monitor). | [optional] | ### Return type @@ -534,7 +534,7 @@ public class Example { String query = "query_example"; // String | After entering a search query in your [Manage Monitor page][1] use the query parameter value in the URL of the page as value for this parameter. Consult the dedicated [manage monitor documentation][2] page to learn more. The query can contain any number of space-separated monitor attributes, for instance `query=\"type:metric status:alert\"`. [1]: https://app.datadoghq.com/monitors/manage [2]: /monitors/manage/#find-the-monitors Long page = 0L; // Long | Page to start paginating from. Long perPage = 30L; // Long | Number of monitors to return per page. - String sort = "sort_example"; // String | String for sort order, composed of field and sort order separate by a comma, e.g. `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields: * `name` * `status` * `tags` + String sort = "sort_example"; // String | String for sort order, composed of field and sort order separate by a comma, for example `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields: * `name` * `status` * `tags` try { MonitorGroupSearchResponse result = apiInstance.searchMonitorGroups(new MonitorsApi.SearchMonitorGroupsOptionalParameters() .query(query) @@ -560,7 +560,7 @@ public class Example { | **query** | **String** | After entering a search query in your [Manage Monitor page][1] use the query parameter value in the URL of the page as value for this parameter. Consult the dedicated [manage monitor documentation][2] page to learn more. The query can contain any number of space-separated monitor attributes, for instance `query=\"type:metric status:alert\"`. [1]: https://app.datadoghq.com/monitors/manage [2]: /monitors/manage/#find-the-monitors | [optional] | | **page** | **Long** | Page to start paginating from. | [optional] [default to 0] | | **perPage** | **Long** | Number of monitors to return per page. | [optional] [default to 30] | -| **sort** | **String** | String for sort order, composed of field and sort order separate by a comma, e.g. `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields: _ `name` _ `status` \* `tags` | [optional] | +| **sort** | **String** | String for sort order, composed of field and sort order separate by a comma, for example `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields: _ `name` _ `status` \* `tags` | [optional] | ### Return type @@ -608,7 +608,7 @@ public class Example { String query = "query_example"; // String | After entering a search query in your [Manage Monitor page][1] use the query parameter value in the URL of the page as value for this parameter. Consult the dedicated [manage monitor documentation][2] page to learn more. The query can contain any number of space-separated monitor attributes, for instance `query=\"type:metric status:alert\"`. [1]: https://app.datadoghq.com/monitors/manage [2]: /monitors/manage/#find-the-monitors Long page = 0L; // Long | Page to start paginating from. Long perPage = 30L; // Long | Number of monitors to return per page. - String sort = "sort_example"; // String | String for sort order, composed of field and sort order separate by a comma, e.g. `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields: * `name` * `status` * `tags` + String sort = "sort_example"; // String | String for sort order, composed of field and sort order separate by a comma, for example `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields: * `name` * `status` * `tags` try { MonitorSearchResponse result = apiInstance.searchMonitors(new MonitorsApi.SearchMonitorsOptionalParameters() .query(query) @@ -634,7 +634,7 @@ public class Example { | **query** | **String** | After entering a search query in your [Manage Monitor page][1] use the query parameter value in the URL of the page as value for this parameter. Consult the dedicated [manage monitor documentation][2] page to learn more. The query can contain any number of space-separated monitor attributes, for instance `query=\"type:metric status:alert\"`. [1]: https://app.datadoghq.com/monitors/manage [2]: /monitors/manage/#find-the-monitors | [optional] | | **page** | **Long** | Page to start paginating from. | [optional] [default to 0] | | **perPage** | **Long** | Number of monitors to return per page. | [optional] [default to 30] | -| **sort** | **String** | String for sort order, composed of field and sort order separate by a comma, e.g. `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields: _ `name` _ `status` \* `tags` | [optional] | +| **sort** | **String** | String for sort order, composed of field and sort order separate by a comma, for example `name,asc`. Supported sort directions: `asc`, `desc`. Supported fields: _ `name` _ `status` \* `tags` | [optional] | ### Return type diff --git a/api_docs/v1/SLOThreshold.md b/api_docs/v1/SLOThreshold.md index 8b985ee6531..f473ece32b5 100644 --- a/api_docs/v1/SLOThreshold.md +++ b/api_docs/v1/SLOThreshold.md @@ -4,10 +4,10 @@ SLO thresholds (target and optionally warning) for a single time window. ## Properties -| Name | Type | Description | Notes | -| ------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | -| **target** | **Double** | The target value for the service level indicator within the corresponding timeframe. | -| **targetDisplay** | **String** | A string representation of the target that indicates its precision. It uses trailing zeros to show significant decimal places (e.g. `98.00`). Always included in service level objective responses. Ignored in create/update requests. | [optional] | -| **timeframe** | **SLOTimeframe** | | -| **warning** | **Double** | The warning value for the service level objective. | [optional] | -| **warningDisplay** | **String** | A string representation of the warning target (see the description of the `target_display` field for details). Included in service level objective responses if a warning target exists. Ignored in create/update requests. | [optional] | +| Name | Type | Description | Notes | +| ------------------ | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | +| **target** | **Double** | The target value for the service level indicator within the corresponding timeframe. | +| **targetDisplay** | **String** | A string representation of the target that indicates its precision. It uses trailing zeros to show significant decimal places (for example `98.00`). Always included in service level objective responses. Ignored in create/update requests. | [optional] | +| **timeframe** | **SLOTimeframe** | | +| **warning** | **Double** | The warning value for the service level objective. | [optional] | +| **warningDisplay** | **String** | A string representation of the warning target (see the description of the `target_display` field for details). Included in service level objective responses if a warning target exists. Ignored in create/update requests. | [optional] | diff --git a/api_docs/v1/ServiceLevelObjectivesApi.md b/api_docs/v1/ServiceLevelObjectivesApi.md index 1a536f34bef..45fa0b97b19 100644 --- a/api_docs/v1/ServiceLevelObjectivesApi.md +++ b/api_docs/v1/ServiceLevelObjectivesApi.md @@ -169,7 +169,7 @@ public class Example { ServiceLevelObjectivesApi apiInstance = new ServiceLevelObjectivesApi(defaultClient); String sloId = "sloId_example"; // String | The ID of the service level objective. - String force = "force_example"; // String | Delete the monitor even if it's referenced by other resources (e.g. SLO, composite monitor). + String force = "force_example"; // String | Delete the monitor even if it's referenced by other resources (for example SLO, composite monitor). try { SLODeleteResponse result = apiInstance.deleteSLO(sloId, new ServiceLevelObjectivesApi.DeleteSLOOptionalParameters() .force(force)); @@ -187,10 +187,10 @@ public class Example { ### Parameters -| Name | Type | Description | Notes | -| --------- | ---------- | ------------------------------------------------------------------------------------------------ | ---------- | -| **sloId** | **String** | The ID of the service level objective. | -| **force** | **String** | Delete the monitor even if it's referenced by other resources (e.g. SLO, composite monitor). | [optional] | +| Name | Type | Description | Notes | +| --------- | ---------- | ------------------------------------------------------------------------------------------------------- | ---------- | +| **sloId** | **String** | The ID of the service level objective. | +| **force** | **String** | Delete the monitor even if it's referenced by other resources (for example SLO, composite monitor). | [optional] | ### Return type diff --git a/api_docs/v1/TagsApi.md b/api_docs/v1/TagsApi.md index 95faa6e5d62..04ff8504834 100644 --- a/api_docs/v1/TagsApi.md +++ b/api_docs/v1/TagsApi.md @@ -103,7 +103,7 @@ public class Example { TagsApi apiInstance = new TagsApi(defaultClient); String hostName = "hostName_example"; // String | This endpoint allows you to remove all user-assigned tags for a single host. - String source = "source_example"; // String | The source of the tags (e.g. chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). + String source = "source_example"; // String | The source of the tags (for example chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). try { apiInstance.deleteHostTags(hostName, new TagsApi.DeleteHostTagsOptionalParameters() .source(source)); @@ -120,10 +120,10 @@ public class Example { ### Parameters -| Name | Type | Description | Notes | -| ------------ | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | -| **hostName** | **String** | This endpoint allows you to remove all user-assigned tags for a single host. | -| **source** | **String** | The source of the tags (e.g. chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). | [optional] | +| Name | Type | Description | Notes | +| ------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | +| **hostName** | **String** | This endpoint allows you to remove all user-assigned tags for a single host. | +| **source** | **String** | The source of the tags (for example chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). | [optional] | ### Return type @@ -303,7 +303,7 @@ public class Example { TagsApi apiInstance = new TagsApi(defaultClient); String hostName = "hostName_example"; // String | This endpoint allows you to update/replace all in an integration source with those supplied in the request. HostTags body = new HostTags(); // HostTags | Add tags to host - String source = "source_example"; // String | The source of the tags (e.g. chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value) + String source = "source_example"; // String | The source of the tags (for example chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value) try { HostTags result = apiInstance.updateHostTags(hostName, body, new TagsApi.UpdateHostTagsOptionalParameters() .source(source)); @@ -321,11 +321,11 @@ public class Example { ### Parameters -| Name | Type | Description | Notes | -| ------------ | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | -| **hostName** | **String** | This endpoint allows you to update/replace all in an integration source with those supplied in the request. | -| **body** | [**HostTags**](HostTags.md) | Add tags to host | -| **source** | **String** | The source of the tags (e.g. chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value) | [optional] | +| Name | Type | Description | Notes | +| ------------ | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | +| **hostName** | **String** | This endpoint allows you to update/replace all in an integration source with those supplied in the request. | +| **body** | [**HostTags**](HostTags.md) | Add tags to host | +| **source** | **String** | The source of the tags (for example chef, puppet). [Complete list of source attribute values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value) | [optional] | ### Return type diff --git a/api_docs/v1/UsageHostHour.md b/api_docs/v1/UsageHostHour.md index 4a1735eaded..884a9813080 100644 --- a/api_docs/v1/UsageHostHour.md +++ b/api_docs/v1/UsageHostHour.md @@ -7,16 +7,16 @@ Number of hosts/containers recorded for each hour for a given organization. | Name | Type | Description | Notes | | ------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | | **agentHostCount** | **Long** | Contains the total number of infrastructure hosts reporting during a given hour that were running the Datadog Agent. | [optional] | -| **alibabaHostCount** | **Long** | Contains the total number of hosts that reported via Alibaba integration (and were NOT running the Datadog Agent). | [optional] | +| **alibabaHostCount** | **Long** | Contains the total number of hosts that reported through Alibaba integration (and were NOT running the Datadog Agent). | [optional] | | **apmAzureAppServiceHostCount** | **Long** | Contains the total number of Azure App Services hosts using APM. | [optional] | | **apmHostCount** | **Long** | Shows the total number of hosts using APM during the hour, these are counted as billable (except during trial periods). | [optional] | -| **awsHostCount** | **Long** | Contains the total number of hosts that reported via the AWS integration (and were NOT running the Datadog Agent). | [optional] | -| **azureHostCount** | **Long** | Contains the total number of hosts that reported via Azure integration (and were NOT running the Datadog Agent). | [optional] | +| **awsHostCount** | **Long** | Contains the total number of hosts that reported through the AWS integration (and were NOT running the Datadog Agent). | [optional] | +| **azureHostCount** | **Long** | Contains the total number of hosts that reported through Azure integration (and were NOT running the Datadog Agent). | [optional] | | **containerCount** | **Long** | Shows the total number of containers reported by the Docker integration during the hour. | [optional] | -| **gcpHostCount** | **Long** | Contains the total number of hosts that reported via the Google Cloud integration (and were NOT running the Datadog Agent). | [optional] | +| **gcpHostCount** | **Long** | Contains the total number of hosts that reported through the Google Cloud integration (and were NOT running the Datadog Agent). | [optional] | | **herokuHostCount** | **Long** | Contains the total number of Heroku dynos reported by the Datadog Agent. | [optional] | | **hostCount** | **Long** | Contains the total number of billable infrastructure hosts reporting during a given hour. This is the sum of `agent_host_count`, `aws_host_count`, and `gcp_host_count`. | [optional] | | **hour** | **OffsetDateTime** | The hour for the usage. | [optional] | -| **infraAzureAppService** | **Long** | Contains the total number of hosts that reported via the Azure App Services integration (and were NOT running the Datadog Agent). | [optional] | +| **infraAzureAppService** | **Long** | Contains the total number of hosts that reported through the Azure App Services integration (and were NOT running the Datadog Agent). | [optional] | | **opentelemetryHostCount** | **Long** | Contains the total number of hosts reported by Datadog exporter for the OpenTelemetry Collector. | [optional] | -| **vsphereHostCount** | **Long** | Contains the total number of hosts that reported via vSphere integration (and were NOT running the Datadog Agent). | [optional] | +| **vsphereHostCount** | **Long** | Contains the total number of hosts that reported through vSphere integration (and were NOT running the Datadog Agent). | [optional] | diff --git a/api_docs/v1/WidgetAxis.md b/api_docs/v1/WidgetAxis.md index eceb03985fe..3a10273d697 100644 --- a/api_docs/v1/WidgetAxis.md +++ b/api_docs/v1/WidgetAxis.md @@ -4,10 +4,10 @@ Axis controls for the widget. ## Properties -| Name | Type | Description | Notes | -| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | -| **includeZero** | **Boolean** | True includes zero. | [optional] | -| **label** | **String** | The label of the axis to display on the graph. | [optional] | -| **max** | **String** | Specifies the maximum value to show on the y-axis. It takes a number, or auto for default behavior. | [optional] | -| **min** | **String** | Specifies minimum value to show on the y-axis. It takes a number, or auto for default behavior. | [optional] | -| **scale** | **String** | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, `pow##` (e.g. `pow2`, `pow0.5` etc.). | [optional] | +| Name | Type | Description | Notes | +| --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | +| **includeZero** | **Boolean** | True includes zero. | [optional] | +| **label** | **String** | The label of the axis to display on the graph. | [optional] | +| **max** | **String** | Specifies the maximum value to show on the y-axis. It takes a number, or auto for default behavior. | [optional] | +| **min** | **String** | Specifies minimum value to show on the y-axis. It takes a number, or auto for default behavior. | [optional] | +| **scale** | **String** | Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, `pow##` (for example `pow2`, `pow0.5` etc.). | [optional] | diff --git a/src/main/java/com/datadog/api/v1/client/ApiClient.java b/src/main/java/com/datadog/api/v1/client/ApiClient.java index 9ff00154a48..88a832e0ad6 100644 --- a/src/main/java/com/datadog/api/v1/client/ApiClient.java +++ b/src/main/java/com/datadog/api/v1/client/ApiClient.java @@ -146,7 +146,7 @@ public class ApiClient extends JavaTimeFormatter { put( "site", new ServerVariable( - "The regional site for our customers.", + "The regional site for Datadog customers.", "datadoghq.com", new HashSet( Arrays.asList( @@ -207,7 +207,7 @@ public class ApiClient extends JavaTimeFormatter { put( "site", new ServerVariable( - "The regional site for our customers.", + "The regional site for Datadog customers.", "datadoghq.com", new HashSet( Arrays.asList( diff --git a/src/main/java/com/datadog/api/v1/client/api/MonitorsApi.java b/src/main/java/com/datadog/api/v1/client/api/MonitorsApi.java index dce0fe0ac0b..6b2ab719c30 100644 --- a/src/main/java/com/datadog/api/v1/client/api/MonitorsApi.java +++ b/src/main/java/com/datadog/api/v1/client/api/MonitorsApi.java @@ -167,10 +167,10 @@ public ApiResponse checkCanDeleteMonitorWithHttpI * `avg(last_30m):outliers(avg:system.cpu.user{role:es-events-data} by {host}, * 'dbscan', 7) > 0` **Service Check Query** Example: * `\"check\".over(tags).last(count).by(group).count_by_status()` - - * **`check`** name of the check, e.g. `datadog.agent.up` - - * **`tags`** one or more quoted tags (comma-separated), or \"*\". e.g.: - * `.over(\"env:prod\", \"role:db\")`; **`over`** cannot - * be blank. - **`count`** must be at greater than or equal to your max threshold + * **`check`** name of the check, for example `datadog.agent.up` - + * **`tags`** one or more quoted tags (comma-separated), or \"*\". for + * example: `.over(\"env:prod\", \"role:db\")`; **`over`** + * cannot be blank. - **`count`** must be at greater than or equal to your max threshold * (defined in the `options`). It is limited to 100. For example, if you've * specified to notify on 1 critical, 3 ok, and 2 warn statuses, `count` should be at * least 3. - **`group`** must be specified for check monitors. Per-check grouping is @@ -294,10 +294,10 @@ public Monitor createMonitor(Monitor body) throws ApiException { * `avg(last_30m):outliers(avg:system.cpu.user{role:es-events-data} by {host}, * 'dbscan', 7) > 0` **Service Check Query** Example: * `\"check\".over(tags).last(count).by(group).count_by_status()` - - * **`check`** name of the check, e.g. `datadog.agent.up` - - * **`tags`** one or more quoted tags (comma-separated), or \"*\". e.g.: - * `.over(\"env:prod\", \"role:db\")`; **`over`** cannot - * be blank. - **`count`** must be at greater than or equal to your max threshold + * **`check`** name of the check, for example `datadog.agent.up` - + * **`tags`** one or more quoted tags (comma-separated), or \"*\". for + * example: `.over(\"env:prod\", \"role:db\")`; **`over`** + * cannot be blank. - **`count`** must be at greater than or equal to your max threshold * (defined in the `options`). It is limited to 100. For example, if you've * specified to notify on 1 critical, 3 ok, and 2 warn statuses, `count` should be at * least 3. - **`group`** must be specified for check monitors. Per-check grouping is @@ -438,8 +438,8 @@ public static class DeleteMonitorOptionalParameters { /** * Set force * - * @param force Delete the monitor even if it's referenced by other resources (e.g. SLO, - * composite monitor). (optional) + * @param force Delete the monitor even if it's referenced by other resources (for example + * SLO, composite monitor). (optional) * @return DeleteMonitorOptionalParameters */ public DeleteMonitorOptionalParameters force(String force) { @@ -965,9 +965,10 @@ public SearchMonitorGroupsOptionalParameters perPage(Long perPage) { /** * Set sort * - * @param sort String for sort order, composed of field and sort order separate by a comma, e.g. - * `name,asc`. Supported sort directions: `asc`, `desc`. - * Supported fields: * `name` * `status` * `tags` (optional) + * @param sort String for sort order, composed of field and sort order separate by a comma, for + * example `name,asc`. Supported sort directions: `asc`, + * `desc`. Supported fields: * `name` * `status` * + * `tags` (optional) * @return SearchMonitorGroupsOptionalParameters */ public SearchMonitorGroupsOptionalParameters sort(String sort) { @@ -1129,9 +1130,10 @@ public SearchMonitorsOptionalParameters perPage(Long perPage) { /** * Set sort * - * @param sort String for sort order, composed of field and sort order separate by a comma, e.g. - * `name,asc`. Supported sort directions: `asc`, `desc`. - * Supported fields: * `name` * `status` * `tags` (optional) + * @param sort String for sort order, composed of field and sort order separate by a comma, for + * example `name,asc`. Supported sort directions: `asc`, + * `desc`. Supported fields: * `name` * `status` * + * `tags` (optional) * @return SearchMonitorsOptionalParameters */ public SearchMonitorsOptionalParameters sort(String sort) { diff --git a/src/main/java/com/datadog/api/v1/client/api/ServiceLevelObjectivesApi.java b/src/main/java/com/datadog/api/v1/client/api/ServiceLevelObjectivesApi.java index 04d9e439600..4c4a8dcb32f 100644 --- a/src/main/java/com/datadog/api/v1/client/api/ServiceLevelObjectivesApi.java +++ b/src/main/java/com/datadog/api/v1/client/api/ServiceLevelObjectivesApi.java @@ -229,8 +229,8 @@ public static class DeleteSLOOptionalParameters { /** * Set force * - * @param force Delete the monitor even if it's referenced by other resources (e.g. SLO, - * composite monitor). (optional) + * @param force Delete the monitor even if it's referenced by other resources (for example + * SLO, composite monitor). (optional) * @return DeleteSLOOptionalParameters */ public DeleteSLOOptionalParameters force(String force) { diff --git a/src/main/java/com/datadog/api/v1/client/api/TagsApi.java b/src/main/java/com/datadog/api/v1/client/api/TagsApi.java index b1551e82e0b..314acce721b 100644 --- a/src/main/java/com/datadog/api/v1/client/api/TagsApi.java +++ b/src/main/java/com/datadog/api/v1/client/api/TagsApi.java @@ -194,7 +194,8 @@ public static class DeleteHostTagsOptionalParameters { /** * Set source * - * @param source The source of the tags (e.g. chef, puppet). [Complete list of source attribute + * @param source The source of the tags (for example chef, puppet). [Complete list of source + * attribute * values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value). * (optional) * @return DeleteHostTagsOptionalParameters @@ -562,7 +563,8 @@ public static class UpdateHostTagsOptionalParameters { /** * Set source * - * @param source The source of the tags (e.g. chef, puppet). [Complete list of source attribute + * @param source The source of the tags (for example chef, puppet). [Complete list of source + * attribute * values](https://docs.datadoghq.com/integrations/faq/list-of-api-source-attribute-value) * (optional) * @return UpdateHostTagsOptionalParameters diff --git a/src/main/java/com/datadog/api/v1/client/model/Event.java b/src/main/java/com/datadog/api/v1/client/model/Event.java index 68cb4e458b3..8ad1e50e8f3 100644 --- a/src/main/java/com/datadog/api/v1/client/model/Event.java +++ b/src/main/java/com/datadog/api/v1/client/model/Event.java @@ -111,16 +111,16 @@ public Event dateHappened(Long dateHappened) { } /** - * POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to events no - * older than 7 days. + * POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited to events + * no older than 7 days. * * @return dateHappened */ @javax.annotation.Nullable @ApiModelProperty( value = - "POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to" - + " events no older than 7 days.") + "POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited" + + " to events no older than 7 days.") @JsonProperty(JSON_PROPERTY_DATE_HAPPENED) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getDateHappened() { diff --git a/src/main/java/com/datadog/api/v1/client/model/EventCreateRequest.java b/src/main/java/com/datadog/api/v1/client/model/EventCreateRequest.java index fc1ce450d94..24c8801d25a 100644 --- a/src/main/java/com/datadog/api/v1/client/model/EventCreateRequest.java +++ b/src/main/java/com/datadog/api/v1/client/model/EventCreateRequest.java @@ -152,16 +152,16 @@ public EventCreateRequest dateHappened(Long dateHappened) { } /** - * POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to events no - * older than 7 days. + * POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited to events + * no older than 7 days. * * @return dateHappened */ @javax.annotation.Nullable @ApiModelProperty( value = - "POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to" - + " events no older than 7 days.") + "POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited" + + " to events no older than 7 days.") @JsonProperty(JSON_PROPERTY_DATE_HAPPENED) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getDateHappened() { @@ -278,12 +278,13 @@ public EventCreateRequest relatedEventId(Long relatedEventId) { } /** - * ID of the parent event. Must be sent as an integer (i.e. no quotes). + * ID of the parent event. Must be sent as an integer (that is no quotes). * * @return relatedEventId */ @javax.annotation.Nullable - @ApiModelProperty(value = "ID of the parent event. Must be sent as an integer (i.e. no quotes).") + @ApiModelProperty( + value = "ID of the parent event. Must be sent as an integer (that is no quotes).") @JsonProperty(JSON_PROPERTY_RELATED_EVENT_ID) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getRelatedEventId() { diff --git a/src/main/java/com/datadog/api/v1/client/model/EventCreateResponse.java b/src/main/java/com/datadog/api/v1/client/model/EventCreateResponse.java index e833fcede5f..a6080c56edb 100644 --- a/src/main/java/com/datadog/api/v1/client/model/EventCreateResponse.java +++ b/src/main/java/com/datadog/api/v1/client/model/EventCreateResponse.java @@ -115,16 +115,16 @@ public EventCreateResponse dateHappened(Long dateHappened) { } /** - * POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to events no - * older than 7 days. + * POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited to events + * no older than 7 days. * * @return dateHappened */ @javax.annotation.Nullable @ApiModelProperty( value = - "POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to" - + " events no older than 7 days.") + "POSIX timestamp of the event. Must be sent as an integer (that is no quotes). Limited" + + " to events no older than 7 days.") @JsonProperty(JSON_PROPERTY_DATE_HAPPENED) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getDateHappened() { @@ -241,12 +241,13 @@ public EventCreateResponse relatedEventId(Long relatedEventId) { } /** - * ID of the parent event. Must be sent as an integer (i.e. no quotes). + * ID of the parent event. Must be sent as an integer (that is no quotes). * * @return relatedEventId */ @javax.annotation.Nullable - @ApiModelProperty(value = "ID of the parent event. Must be sent as an integer (i.e. no quotes).") + @ApiModelProperty( + value = "ID of the parent event. Must be sent as an integer (that is no quotes).") @JsonProperty(JSON_PROPERTY_RELATED_EVENT_ID) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getRelatedEventId() { diff --git a/src/main/java/com/datadog/api/v1/client/model/LogsListRequestTime.java b/src/main/java/com/datadog/api/v1/client/model/LogsListRequestTime.java index 70fd78e5288..39f27b842bf 100644 --- a/src/main/java/com/datadog/api/v1/client/model/LogsListRequestTime.java +++ b/src/main/java/com/datadog/api/v1/client/model/LogsListRequestTime.java @@ -79,16 +79,16 @@ public LogsListRequestTime timezone(String timezone) { } /** - * Timezone can be specified both as an offset (e.g. \"UTC+03:00\") or a regional zone - * (e.g. \"Europe/Paris\"). + * Timezone can be specified both as an offset (for example \"UTC+03:00\") or a regional + * zone (for example \"Europe/Paris\"). * * @return timezone */ @javax.annotation.Nullable @ApiModelProperty( value = - "Timezone can be specified both as an offset (e.g. \"UTC+03:00\") or a regional zone" - + " (e.g. \"Europe/Paris\").") + "Timezone can be specified both as an offset (for example \"UTC+03:00\") or a regional" + + " zone (for example \"Europe/Paris\").") @JsonProperty(JSON_PROPERTY_TIMEZONE) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public String getTimezone() { diff --git a/src/main/java/com/datadog/api/v1/client/model/MonitorSearchResult.java b/src/main/java/com/datadog/api/v1/client/model/MonitorSearchResult.java index 4c706e920ff..bbdfa9d7268 100644 --- a/src/main/java/com/datadog/api/v1/client/model/MonitorSearchResult.java +++ b/src/main/java/com/datadog/api/v1/client/model/MonitorSearchResult.java @@ -246,10 +246,10 @@ public MonitorSearchResult addScopesItem(String scopesItem) { } /** - * The scope(s) to which the downtime applies, e.g. `host:app2`. Provide multiple scopes - * as a comma-separated list, e.g. `env:dev,env:prod`. The resulting downtime applies to - * sources that matches ALL provided scopes (i.e. `env:dev AND env:prod`), NOT any of - * them. + * The scope(s) to which the downtime applies, for example `host:app2`. Provide multiple + * scopes as a comma-separated list, for example `env:dev,env:prod`. The resulting + * downtime applies to sources that matches ALL provided scopes (that is `env:dev AND + * env:prod`), NOT any of them. * * @return scopes */ @@ -257,10 +257,10 @@ public MonitorSearchResult addScopesItem(String scopesItem) { @ApiModelProperty( example = "[\"host:app2\",\"env:dev,env:prod\"]", value = - "The scope(s) to which the downtime applies, e.g. `host:app2`. Provide multiple scopes" - + " as a comma-separated list, e.g. `env:dev,env:prod`. The resulting downtime" - + " applies to sources that matches ALL provided scopes (i.e. `env:dev AND" - + " env:prod`), NOT any of them.") + "The scope(s) to which the downtime applies, for example `host:app2`. Provide multiple" + + " scopes as a comma-separated list, for example `env:dev,env:prod`. The resulting" + + " downtime applies to sources that matches ALL provided scopes (that is `env:dev" + + " AND env:prod`), NOT any of them.") @JsonProperty(JSON_PROPERTY_SCOPES) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public List getScopes() { diff --git a/src/main/java/com/datadog/api/v1/client/model/SLOThreshold.java b/src/main/java/com/datadog/api/v1/client/model/SLOThreshold.java index 79eea92712c..0993bf2a83b 100644 --- a/src/main/java/com/datadog/api/v1/client/model/SLOThreshold.java +++ b/src/main/java/com/datadog/api/v1/client/model/SLOThreshold.java @@ -89,8 +89,8 @@ public SLOThreshold targetDisplay(String targetDisplay) { /** * A string representation of the target that indicates its precision. It uses trailing zeros to - * show significant decimal places (e.g. `98.00`). Always included in service level - * objective responses. Ignored in create/update requests. + * show significant decimal places (for example `98.00`). Always included in service + * level objective responses. Ignored in create/update requests. * * @return targetDisplay */ @@ -99,8 +99,8 @@ public SLOThreshold targetDisplay(String targetDisplay) { example = "99.9", value = "A string representation of the target that indicates its precision. It uses trailing" - + " zeros to show significant decimal places (e.g. `98.00`). Always included in" - + " service level objective responses. Ignored in create/update requests.") + + " zeros to show significant decimal places (for example `98.00`). Always included" + + " in service level objective responses. Ignored in create/update requests.") @JsonProperty(JSON_PROPERTY_TARGET_DISPLAY) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public String getTargetDisplay() { diff --git a/src/main/java/com/datadog/api/v1/client/model/UsageHostHour.java b/src/main/java/com/datadog/api/v1/client/model/UsageHostHour.java index 579f8aaf32d..9397941dd27 100644 --- a/src/main/java/com/datadog/api/v1/client/model/UsageHostHour.java +++ b/src/main/java/com/datadog/api/v1/client/model/UsageHostHour.java @@ -116,16 +116,16 @@ public UsageHostHour alibabaHostCount(Long alibabaHostCount) { } /** - * Contains the total number of hosts that reported via Alibaba integration (and were NOT running - * the Datadog Agent). + * Contains the total number of hosts that reported through Alibaba integration (and were NOT + * running the Datadog Agent). * * @return alibabaHostCount */ @javax.annotation.Nullable @ApiModelProperty( value = - "Contains the total number of hosts that reported via Alibaba integration (and were NOT" - + " running the Datadog Agent).") + "Contains the total number of hosts that reported through Alibaba integration (and were" + + " NOT running the Datadog Agent).") @JsonProperty(JSON_PROPERTY_ALIBABA_HOST_COUNT) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getAlibabaHostCount() { @@ -190,16 +190,16 @@ public UsageHostHour awsHostCount(Long awsHostCount) { } /** - * Contains the total number of hosts that reported via the AWS integration (and were NOT running - * the Datadog Agent). + * Contains the total number of hosts that reported through the AWS integration (and were NOT + * running the Datadog Agent). * * @return awsHostCount */ @javax.annotation.Nullable @ApiModelProperty( value = - "Contains the total number of hosts that reported via the AWS integration (and were NOT" - + " running the Datadog Agent).") + "Contains the total number of hosts that reported through the AWS integration (and were" + + " NOT running the Datadog Agent).") @JsonProperty(JSON_PROPERTY_AWS_HOST_COUNT) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getAwsHostCount() { @@ -216,16 +216,16 @@ public UsageHostHour azureHostCount(Long azureHostCount) { } /** - * Contains the total number of hosts that reported via Azure integration (and were NOT running - * the Datadog Agent). + * Contains the total number of hosts that reported through Azure integration (and were NOT + * running the Datadog Agent). * * @return azureHostCount */ @javax.annotation.Nullable @ApiModelProperty( value = - "Contains the total number of hosts that reported via Azure integration (and were NOT" - + " running the Datadog Agent).") + "Contains the total number of hosts that reported through Azure integration (and were" + + " NOT running the Datadog Agent).") @JsonProperty(JSON_PROPERTY_AZURE_HOST_COUNT) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getAzureHostCount() { @@ -267,16 +267,16 @@ public UsageHostHour gcpHostCount(Long gcpHostCount) { } /** - * Contains the total number of hosts that reported via the Google Cloud integration (and were NOT - * running the Datadog Agent). + * Contains the total number of hosts that reported through the Google Cloud integration (and were + * NOT running the Datadog Agent). * * @return gcpHostCount */ @javax.annotation.Nullable @ApiModelProperty( value = - "Contains the total number of hosts that reported via the Google Cloud integration (and" - + " were NOT running the Datadog Agent).") + "Contains the total number of hosts that reported through the Google Cloud integration" + + " (and were NOT running the Datadog Agent).") @JsonProperty(JSON_PROPERTY_GCP_HOST_COUNT) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getGcpHostCount() { @@ -366,16 +366,16 @@ public UsageHostHour infraAzureAppService(Long infraAzureAppService) { } /** - * Contains the total number of hosts that reported via the Azure App Services integration (and - * were NOT running the Datadog Agent). + * Contains the total number of hosts that reported through the Azure App Services integration + * (and were NOT running the Datadog Agent). * * @return infraAzureAppService */ @javax.annotation.Nullable @ApiModelProperty( value = - "Contains the total number of hosts that reported via the Azure App Services integration" - + " (and were NOT running the Datadog Agent).") + "Contains the total number of hosts that reported through the Azure App Services" + + " integration (and were NOT running the Datadog Agent).") @JsonProperty(JSON_PROPERTY_INFRA_AZURE_APP_SERVICE) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getInfraAzureAppService() { @@ -418,16 +418,16 @@ public UsageHostHour vsphereHostCount(Long vsphereHostCount) { } /** - * Contains the total number of hosts that reported via vSphere integration (and were NOT running - * the Datadog Agent). + * Contains the total number of hosts that reported through vSphere integration (and were NOT + * running the Datadog Agent). * * @return vsphereHostCount */ @javax.annotation.Nullable @ApiModelProperty( value = - "Contains the total number of hosts that reported via vSphere integration (and were NOT" - + " running the Datadog Agent).") + "Contains the total number of hosts that reported through vSphere integration (and were" + + " NOT running the Datadog Agent).") @JsonProperty(JSON_PROPERTY_VSPHERE_HOST_COUNT) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public Long getVsphereHostCount() { diff --git a/src/main/java/com/datadog/api/v1/client/model/WidgetAxis.java b/src/main/java/com/datadog/api/v1/client/model/WidgetAxis.java index 8b284012399..8a96312c68b 100644 --- a/src/main/java/com/datadog/api/v1/client/model/WidgetAxis.java +++ b/src/main/java/com/datadog/api/v1/client/model/WidgetAxis.java @@ -147,15 +147,15 @@ public WidgetAxis scale(String scale) { /** * Specifies the scale type. Possible values are `linear`, `log`, - * `sqrt`, `pow##` (e.g. `pow2`, `pow0.5` etc.). + * `sqrt`, `pow##` (for example `pow2`, `pow0.5` etc.). * * @return scale */ @javax.annotation.Nullable @ApiModelProperty( value = - "Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, `pow##` (e.g." - + " `pow2`, `pow0.5` etc.).") + "Specifies the scale type. Possible values are `linear`, `log`, `sqrt`, `pow##` (for" + + " example `pow2`, `pow0.5` etc.).") @JsonProperty(JSON_PROPERTY_SCALE) @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS) public String getScale() { diff --git a/src/main/java/com/datadog/api/v2/client/ApiClient.java b/src/main/java/com/datadog/api/v2/client/ApiClient.java index 9e938c88827..b7f4e275707 100644 --- a/src/main/java/com/datadog/api/v2/client/ApiClient.java +++ b/src/main/java/com/datadog/api/v2/client/ApiClient.java @@ -78,7 +78,7 @@ public class ApiClient extends JavaTimeFormatter { put( "site", new ServerVariable( - "The regional site for our customers.", + "The regional site for Datadog customers.", "datadoghq.com", new HashSet( Arrays.asList( diff --git a/src/test/resources/com/datadog/api/v1/client/api/logs_pipelines.feature b/src/test/resources/com/datadog/api/v1/client/api/logs_pipelines.feature index 9495c7af86b..65dbddbd016 100644 --- a/src/test/resources/com/datadog/api/v1/client/api/logs_pipelines.feature +++ b/src/test/resources/com/datadog/api/v1/client/api/logs_pipelines.feature @@ -4,7 +4,7 @@ Feature: Logs Pipelines transforming them into structured attributes for easier querying. - See the [pipelines configuration page](https://app.datadoghq.com/logs/pipelines) for a list of the - pipelines and processors currently configured in our UI. - Additional + pipelines and processors currently configured in web UI. - Additional API-related information about processors can be found in the [processors documentation](https://docs.datadoghq.com/logs/log_configuration/processor s/?tab=api#lookup-processor). - For more information about Pipelines, see diff --git a/src/test/resources/com/datadog/api/v2/client/api/logs_archives.feature b/src/test/resources/com/datadog/api/v2/client/api/logs_archives.feature index 29294c989a0..46662ff6baa 100644 --- a/src/test/resources/com/datadog/api/v2/client/api/logs_archives.feature +++ b/src/test/resources/com/datadog/api/v2/client/api/logs_archives.feature @@ -2,7 +2,7 @@ Feature: Logs Archives 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 our UI. + list of the archives currently configured in web UI. Background: Given a valid "apiKeyAuth" key in the system