datadog_api_client.v2.api package¶
Submodules¶
datadog_api_client.v2.api.api_management_api module¶
- class APIManagementApi(api_client=None)¶
Bases:
object
Configure your API endpoints through the Datadog API.
- create_open_api(*, openapi_spec_file: IOBase | UnsetType = UnsetType.unset) CreateOpenAPIResponse ¶
Create a new API.
Create a new API from the OpenAPI specification given. See the API Catalog documentation for additional information about the possible metadata. It returns the created API ID.
- Parameters:
openapi_spec_file (file_type, optional) – Binary
OpenAPI
spec file- Return type:
- delete_open_api(id: UUID) None ¶
Delete an API.
Delete a specific API by ID.
- Parameters:
id (UUID) – ID of the API to delete
- Return type:
None
- get_open_api(id: UUID) IOBase ¶
Get an API.
Retrieve information about a specific API in OpenAPI format file.
- Parameters:
id (UUID) – ID of the API to retrieve
- Return type:
file_type
- list_apis(*, query: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset) ListAPIsResponse ¶
List APIs.
List APIs and their IDs.
- Parameters:
query (str, optional) – Filter APIs by name
page_limit (int, optional) – Number of items per page.
page_offset (int, optional) – Offset for pagination.
- Return type:
- update_open_api(id: UUID, *, openapi_spec_file: IOBase | UnsetType = UnsetType.unset) UpdateOpenAPIResponse ¶
Update an API.
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.
- Parameters:
id (UUID) – ID of the API to modify
openapi_spec_file (file_type, optional) – Binary
OpenAPI
spec file
- Return type:
datadog_api_client.v2.api.apm_retention_filters_api module¶
- class APMRetentionFiltersApi(api_client=None)¶
Bases:
object
Manage configuration of APM retention filters for your organization. You need an API and application key with Admin rights to interact with this endpoint. See retention filters on the Trace Retention page for more information.
- create_apm_retention_filter(body: RetentionFilterCreateRequest) RetentionFilterCreateResponse ¶
Create a retention filter.
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.
- Parameters:
body (RetentionFilterCreateRequest) – The definition of the new retention filter.
- Return type:
- delete_apm_retention_filter(filter_id: str) None ¶
Delete a retention filter.
Delete a specific retention filter from your organization.
Default filters with types spans-errors-sampling-processor and spans-appsec-sampling-processor cannot be deleted.
- Parameters:
filter_id (str) – The ID of the retention filter.
- Return type:
None
- get_apm_retention_filter(filter_id: str) RetentionFilterResponse ¶
Get a given APM retention filter.
Get an APM retention filter.
- Parameters:
filter_id (str) – The ID of the retention filter.
- Return type:
- list_apm_retention_filters() RetentionFiltersResponse ¶
List all APM retention filters.
Get the list of APM retention filters.
- Return type:
- reorder_apm_retention_filters(body: ReorderRetentionFiltersRequest) None ¶
Re-order retention filters.
Re-order the execution order of retention filters.
- Parameters:
body (ReorderRetentionFiltersRequest) – The list of retention filters in the new order.
- Return type:
None
- update_apm_retention_filter(filter_id: str, body: RetentionFilterUpdateRequest) RetentionFilterResponse ¶
Update a retention filter.
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.
- Parameters:
filter_id (str) – The ID of the retention filter.
body (RetentionFilterUpdateRequest) – The updated definition of the retention filter.
- Return type:
datadog_api_client.v2.api.audit_api module¶
- class AuditApi(api_client=None)¶
Bases:
object
Search your Audit Logs events over HTTP.
- list_audit_logs(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: AuditLogsSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) AuditLogsEventsResponse ¶
Get a list of Audit Logs events.
List endpoint returns events that match a Audit Logs search query. Results are paginated.
Use this endpoint to see your latest Audit Logs events.
- Parameters:
filter_query (str, optional) – Search query following Audit Logs syntax.
filter_from (datetime, optional) – Minimum timestamp for requested events.
filter_to (datetime, optional) – Maximum timestamp for requested events.
sort (AuditLogsSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Return type:
- list_audit_logs_with_pagination(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: AuditLogsSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[AuditLogsEvent] ¶
Get a list of Audit Logs events.
Provide a paginated version of
list_audit_logs()
, returning all items.- Parameters:
filter_query (str, optional) – Search query following Audit Logs syntax.
filter_from (datetime, optional) – Minimum timestamp for requested events.
filter_to (datetime, optional) – Maximum timestamp for requested events.
sort (AuditLogsSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[AuditLogsEvent]
- search_audit_logs(*, body: AuditLogsSearchEventsRequest | UnsetType = UnsetType.unset) AuditLogsEventsResponse ¶
Search Audit Logs events.
List endpoint returns Audit Logs events that match an Audit search query. Results are paginated.
Use this endpoint to build complex Audit Logs events filtering and search.
- Return type:
- search_audit_logs_with_pagination(*, body: AuditLogsSearchEventsRequest | UnsetType = UnsetType.unset) Iterable[AuditLogsEvent] ¶
Search Audit Logs events.
Provide a paginated version of
search_audit_logs()
, returning all items.- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[AuditLogsEvent]
datadog_api_client.v2.api.authn_mappings_api module¶
- class AuthNMappingsApi(api_client=None)¶
Bases:
object
The AuthN Mappings API is used to automatically map groups of users to roles in Datadog using attributes sent from Identity Providers. Use these endpoints to manage your AuthN Mappings.
- create_authn_mapping(body: AuthNMappingCreateRequest) AuthNMappingResponse ¶
Create an AuthN Mapping.
Create an AuthN Mapping.
- Return type:
- delete_authn_mapping(authn_mapping_id: str) None ¶
Delete an AuthN Mapping.
Delete an AuthN Mapping specified by AuthN Mapping UUID.
- Parameters:
authn_mapping_id (str) – The UUID of the AuthN Mapping.
- Return type:
None
- get_authn_mapping(authn_mapping_id: str) AuthNMappingResponse ¶
Get an AuthN Mapping by UUID.
Get an AuthN Mapping specified by the AuthN Mapping UUID.
- Parameters:
authn_mapping_id (str) – The UUID of the AuthN Mapping.
- Return type:
- list_authn_mappings(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: AuthNMappingsSort | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, resource_type: AuthNMappingResourceType | UnsetType = UnsetType.unset) AuthNMappingsResponse ¶
List all AuthN Mappings.
List all AuthN Mappings in the org.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (AuthNMappingsSort, optional) – Sort AuthN Mappings depending on the given field.
filter (str, optional) – Filter all mappings by the given string.
resource_type (AuthNMappingResourceType, optional) – Filter by mapping resource type. Defaults to “role” if not specified.
- Return type:
- update_authn_mapping(authn_mapping_id: str, body: AuthNMappingUpdateRequest) AuthNMappingResponse ¶
Edit an AuthN Mapping.
Edit an AuthN Mapping.
- Parameters:
authn_mapping_id (str) – The UUID of the AuthN Mapping.
- Return type:
datadog_api_client.v2.api.aws_integration_api module¶
- class AWSIntegrationApi(api_client=None)¶
Bases:
object
Configure your Datadog-AWS integration directly through the Datadog API. For more information, see the AWS integration page.
- create_aws_account(body: AWSAccountCreateRequest) AWSAccountResponse ¶
Create an AWS integration.
Create a new AWS Account Integration Config.
- Return type:
- create_new_aws_external_id() AWSNewExternalIDResponse ¶
Generate a new external ID.
Generate a new external ID for AWS role-based authentication.
- Return type:
- delete_aws_account(aws_account_config_id: str) None ¶
Delete an AWS integration.
Delete an AWS Account Integration Config
- Parameters:
aws_account_config_id (str) – Unique Datadog ID of the AWS Account Integration Config
- Return type:
None
- get_aws_account(aws_account_config_id: str) AWSAccountResponse ¶
Get an AWS integration by config ID.
Get an AWS Account Integration Config
- Parameters:
aws_account_config_id (str) – Unique Datadog ID of the AWS Account Integration Config
- Return type:
- list_aws_accounts(*, aws_account_id: str | UnsetType = UnsetType.unset) AWSAccountsResponse ¶
List all AWS integrations.
Get a list of AWS Account Integration Configs.
- Parameters:
aws_account_id (str, optional) – Optional query filter accounts by AWS Account ID
- Return type:
- list_aws_namespaces() AWSNamespacesResponse ¶
List available namespaces.
Get a list of available AWS CloudWatch namespaces that can send metrics to Datadog.
- Return type:
- update_aws_account(aws_account_config_id: str, body: AWSAccountUpdateRequest) AWSAccountResponse ¶
Update an AWS integration.
Update an AWS Account Integration Config
- Parameters:
aws_account_config_id (str) – Unique Datadog ID of the AWS Account Integration Config
- Return type:
datadog_api_client.v2.api.aws_logs_integration_api module¶
- class AWSLogsIntegrationApi(api_client=None)¶
Bases:
object
Configure your Datadog-AWS-Logs integration directly through Datadog API. For more information, see the AWS integration page.
- list_aws_logs_services() AWSLogsServicesResponse ¶
Get list of AWS log ready services.
Get a list of AWS services that can send logs to Datadog.
- Return type:
datadog_api_client.v2.api.case_management_api module¶
- class CaseManagementApi(api_client=None)¶
Bases:
object
View and manage cases and projects within Case Management. See the Case Management page for more information.
- archive_case(case_id: str, body: CaseEmptyRequest) CaseResponse ¶
Archive case.
Archive case
- Parameters:
case_id (str) – Case’s UUID or key
body (CaseEmptyRequest) – Archive case payload
- Return type:
- assign_case(case_id: str, body: CaseAssignRequest) CaseResponse ¶
Assign case.
Assign case to a user
- Parameters:
case_id (str) – Case’s UUID or key
body (CaseAssignRequest) – Assign case payload
- Return type:
- create_case(body: CaseCreateRequest) CaseResponse ¶
Create a case.
Create a Case
- Parameters:
body (CaseCreateRequest) – Case payload
- Return type:
- create_project(body: ProjectCreateRequest) ProjectResponse ¶
Create a project.
Create a project.
- Parameters:
body (ProjectCreateRequest) – Project payload
- Return type:
- delete_project(project_id: str) None ¶
Remove a project.
Remove a project using the project’s
id
.- Parameters:
project_id (str) – Project UUID
- Return type:
None
- get_case(case_id: str) CaseResponse ¶
Get the details of a case.
Get the details of case by
case_id
- Parameters:
case_id (str) – Case’s UUID or key
- Return type:
- get_project(project_id: str) ProjectResponse ¶
Get the details of a project.
Get the details of a project by
project_id
.- Parameters:
project_id (str) – Project UUID
- Return type:
- get_projects() ProjectsResponse ¶
Get all projects.
Get all projects.
- Return type:
- search_cases(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort_field: CaseSortableField | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, sort_asc: bool | UnsetType = UnsetType.unset) CasesResponse ¶
Search cases.
Search cases.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort_field (CaseSortableField, optional) – Specify which field to sort
filter (str, optional) – Search query
sort_asc (bool, optional) – Specify if order is ascending or not
- Return type:
- search_cases_with_pagination(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort_field: CaseSortableField | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, sort_asc: bool | UnsetType = UnsetType.unset) Iterable[Case] ¶
Search cases.
Provide a paginated version of
search_cases()
, returning all items.- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort_field (CaseSortableField, optional) – Specify which field to sort
filter (str, optional) – Search query
sort_asc (bool, optional) – Specify if order is ascending or not
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[Case]
- unarchive_case(case_id: str, body: CaseEmptyRequest) CaseResponse ¶
Unarchive case.
Unarchive case
- Parameters:
case_id (str) – Case’s UUID or key
body (CaseEmptyRequest) – Unarchive case payload
- Return type:
- unassign_case(case_id: str, body: CaseEmptyRequest) CaseResponse ¶
Unassign case.
Unassign case
- Parameters:
case_id (str) – Case’s UUID or key
body (CaseEmptyRequest) – Unassign case payload
- Return type:
- update_priority(case_id: str, body: CaseUpdatePriorityRequest) CaseResponse ¶
Update case priority.
Update case priority
- Parameters:
case_id (str) – Case’s UUID or key
body (CaseUpdatePriorityRequest) – Case priority update payload
- Return type:
- update_status(case_id: str, body: CaseUpdateStatusRequest) CaseResponse ¶
Update case status.
Update case status
- Parameters:
case_id (str) – Case’s UUID or key
body (CaseUpdateStatusRequest) – Case status update payload
- Return type:
datadog_api_client.v2.api.ci_visibility_pipelines_api module¶
- class CIVisibilityPipelinesApi(api_client=None)¶
Bases:
object
Search or aggregate your CI Visibility pipeline events and send them to your Datadog site over HTTP. See the CI Pipeline Visibility in Datadog page for more information.
- aggregate_ci_app_pipeline_events(body: CIAppPipelinesAggregateRequest) CIAppPipelinesAnalyticsAggregateResponse ¶
Aggregate pipelines events.
Use this API endpoint to aggregate CI Visibility pipeline events into buckets of computed metrics and timeseries.
- Return type:
- create_ci_app_pipeline_event(body: CIAppCreatePipelineEventRequest) dict ¶
Send pipeline event.
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.
Pipeline events can be submitted with a timestamp that is up to 18 hours in the past.
- Return type:
dict
- list_ci_app_pipeline_events(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: CIAppSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) CIAppPipelineEventsResponse ¶
Get a list of pipelines events.
List endpoint returns CI Visibility pipeline events that match a search query. Results are paginated similarly to logs.
Use this endpoint to see your latest pipeline events.
- Parameters:
filter_query (str, optional) – Search query following log syntax.
filter_from (datetime, optional) – Minimum timestamp for requested events.
filter_to (datetime, optional) – Maximum timestamp for requested events.
sort (CIAppSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Return type:
- list_ci_app_pipeline_events_with_pagination(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: CIAppSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[CIAppPipelineEvent] ¶
Get a list of pipelines events.
Provide a paginated version of
list_ci_app_pipeline_events()
, returning all items.- Parameters:
filter_query (str, optional) – Search query following log syntax.
filter_from (datetime, optional) – Minimum timestamp for requested events.
filter_to (datetime, optional) – Maximum timestamp for requested events.
sort (CIAppSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[CIAppPipelineEvent]
- search_ci_app_pipeline_events(*, body: CIAppPipelineEventsRequest | UnsetType = UnsetType.unset) CIAppPipelineEventsResponse ¶
Search pipelines events.
List endpoint returns CI Visibility pipeline events that match a search query. Results are paginated similarly to logs.
Use this endpoint to build complex events filtering and search.
- Return type:
- search_ci_app_pipeline_events_with_pagination(*, body: CIAppPipelineEventsRequest | UnsetType = UnsetType.unset) Iterable[CIAppPipelineEvent] ¶
Search pipelines events.
Provide a paginated version of
search_ci_app_pipeline_events()
, returning all items.- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[CIAppPipelineEvent]
datadog_api_client.v2.api.ci_visibility_tests_api module¶
- class CIVisibilityTestsApi(api_client=None)¶
Bases:
object
Search or aggregate your CI Visibility test events over HTTP. See the Test Visibility in Datadog page for more information.
- aggregate_ci_app_test_events(body: CIAppTestsAggregateRequest) CIAppTestsAnalyticsAggregateResponse ¶
Aggregate tests events.
The API endpoint to aggregate CI Visibility test events into buckets of computed metrics and timeseries.
- Return type:
- list_ci_app_test_events(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: CIAppSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) CIAppTestEventsResponse ¶
Get a list of tests events.
List endpoint returns CI Visibility test events that match a search query. Results are paginated similarly to logs.
Use this endpoint to see your latest test events.
- Parameters:
filter_query (str, optional) – Search query following log syntax.
filter_from (datetime, optional) – Minimum timestamp for requested events.
filter_to (datetime, optional) – Maximum timestamp for requested events.
sort (CIAppSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Return type:
- list_ci_app_test_events_with_pagination(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: CIAppSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[CIAppTestEvent] ¶
Get a list of tests events.
Provide a paginated version of
list_ci_app_test_events()
, returning all items.- Parameters:
filter_query (str, optional) – Search query following log syntax.
filter_from (datetime, optional) – Minimum timestamp for requested events.
filter_to (datetime, optional) – Maximum timestamp for requested events.
sort (CIAppSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[CIAppTestEvent]
- search_ci_app_test_events(*, body: CIAppTestEventsRequest | UnsetType = UnsetType.unset) CIAppTestEventsResponse ¶
Search tests events.
List endpoint returns CI Visibility test events that match a search query. Results are paginated similarly to logs.
Use this endpoint to build complex events filtering and search.
- Return type:
- search_ci_app_test_events_with_pagination(*, body: CIAppTestEventsRequest | UnsetType = UnsetType.unset) Iterable[CIAppTestEvent] ¶
Search tests events.
Provide a paginated version of
search_ci_app_test_events()
, returning all items.- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[CIAppTestEvent]
datadog_api_client.v2.api.cloud_cost_management_api module¶
- class CloudCostManagementApi(api_client=None)¶
Bases:
object
The Cloud Cost Management API allows you to set up, edit, and delete Cloud Cost Management accounts for AWS and Azure. You can query your cost data by using the Metrics endpoint and the
cloud_cost
data source. For more information, see the Cloud Cost Management documentation.- create_cost_awscur_config(body: AwsCURConfigPostRequest) AwsCURConfigResponse ¶
Create Cloud Cost Management AWS CUR config.
Create a Cloud Cost Management account for an AWS CUR config.
- Return type:
- create_cost_azure_uc_configs(body: AzureUCConfigPostRequest) AzureUCConfigPairsResponse ¶
Create Cloud Cost Management Azure configs.
Create a Cloud Cost Management account for an Azure config.
- Return type:
- delete_cost_awscur_config(cloud_account_id: str) None ¶
Delete Cloud Cost Management AWS CUR config.
Archive a Cloud Cost Management Account.
- Parameters:
cloud_account_id (str) – Cloud Account id.
- Return type:
None
- delete_cost_azure_uc_config(cloud_account_id: str) None ¶
Delete Cloud Cost Management Azure config.
Archive a Cloud Cost Management Account.
- Parameters:
cloud_account_id (str) – Cloud Account id.
- Return type:
None
- delete_custom_costs_file(file_id: str) None ¶
Delete Custom Costs file.
Delete the specified Custom Costs file.
- Parameters:
file_id (str) – File ID.
- Return type:
None
- get_cloud_cost_activity() CloudCostActivityResponse ¶
Cloud Cost Enabled. Deprecated.
Get the Cloud Cost Management activity.
- Return type:
- get_custom_costs_file(file_id: str) CustomCostsFileGetResponse ¶
Get Custom Costs file.
Fetch the specified Custom Costs file.
- Parameters:
file_id (str) – File ID.
- Return type:
- list_cost_awscur_configs() AwsCURConfigsResponse ¶
List Cloud Cost Management AWS CUR configs.
List the AWS CUR configs.
- Return type:
- list_cost_azure_uc_configs() AzureUCConfigsResponse ¶
List Cloud Cost Management Azure configs.
List the Azure configs.
- Return type:
- list_custom_costs_files() CustomCostsFileListResponse ¶
List Custom Costs files.
List the Custom Costs files.
- Return type:
- update_cost_awscur_config(cloud_account_id: str, body: AwsCURConfigPatchRequest) AwsCURConfigsResponse ¶
Update Cloud Cost Management AWS CUR config.
Update the status of an AWS CUR config (active/archived).
- Parameters:
cloud_account_id (str) – Cloud Account id.
- Return type:
- update_cost_azure_uc_configs(cloud_account_id: str, body: AzureUCConfigPatchRequest) AzureUCConfigPairsResponse ¶
Update Cloud Cost Management Azure config.
Update the status of an Azure config (active/archived).
- Parameters:
cloud_account_id (str) – Cloud Account id.
- Return type:
- upload_custom_costs_file(body: List[CustomCostsFileLineItem]) CustomCostsFileUploadResponse ¶
Upload Custom Costs file.
Upload a Custom Costs file.
- Return type:
datadog_api_client.v2.api.cloudflare_integration_api module¶
- class CloudflareIntegrationApi(api_client=None)¶
Bases:
object
Manage your Datadog Cloudflare integration directly through the Datadog API. See the Cloudflare integration page for more information.
- create_cloudflare_account(body: CloudflareAccountCreateRequest) CloudflareAccountResponse ¶
Add Cloudflare account.
Create a Cloudflare account.
- Return type:
- delete_cloudflare_account(account_id: str) None ¶
Delete Cloudflare account.
Delete a Cloudflare account.
- Parameters:
account_id (str) – None
- Return type:
None
- get_cloudflare_account(account_id: str) CloudflareAccountResponse ¶
Get Cloudflare account.
Get a Cloudflare account.
- Parameters:
account_id (str) – None
- Return type:
- list_cloudflare_accounts() CloudflareAccountsResponse ¶
List Cloudflare accounts.
List Cloudflare accounts.
- Return type:
- update_cloudflare_account(account_id: str, body: CloudflareAccountUpdateRequest) CloudflareAccountResponse ¶
Update Cloudflare account.
Update a Cloudflare account.
- Parameters:
account_id (str) – None
- Return type:
datadog_api_client.v2.api.confluent_cloud_api module¶
- class ConfluentCloudApi(api_client=None)¶
Bases:
object
Manage your Datadog Confluent Cloud integration accounts and account resources directly through the Datadog API. See the Confluent Cloud page for more information.
- create_confluent_account(body: ConfluentAccountCreateRequest) ConfluentAccountResponse ¶
Add Confluent account.
Create a Confluent account.
- Parameters:
body (ConfluentAccountCreateRequest) – Confluent payload
- Return type:
- create_confluent_resource(account_id: str, body: ConfluentResourceRequest) ConfluentResourceResponse ¶
Add resource to Confluent account.
Create a Confluent resource for the account associated with the provided ID.
- Parameters:
account_id (str) – Confluent Account id.
body (ConfluentResourceRequest) – Confluent payload
- Return type:
- delete_confluent_account(account_id: str) None ¶
Delete Confluent account.
Delete a Confluent account with the provided account ID.
- Parameters:
account_id (str) – Confluent Account id.
- Return type:
None
- delete_confluent_resource(account_id: str, resource_id: str) None ¶
Delete resource from Confluent account.
Delete a Confluent resource with the provided resource id for the account associated with the provided account ID.
- Parameters:
account_id (str) – Confluent Account id.
resource_id (str) – Confluent Account Resource ID.
- Return type:
None
- get_confluent_account(account_id: str) ConfluentAccountResponse ¶
Get Confluent account.
Get the Confluent account with the provided account ID.
- Parameters:
account_id (str) – Confluent Account id.
- Return type:
- get_confluent_resource(account_id: str, resource_id: str) ConfluentResourceResponse ¶
Get resource from Confluent account.
Get a Confluent resource with the provided resource id for the account associated with the provided account ID.
- Parameters:
account_id (str) – Confluent Account id.
resource_id (str) – Confluent Account Resource ID.
- Return type:
- list_confluent_account() ConfluentAccountsResponse ¶
List Confluent accounts.
List Confluent accounts.
- Return type:
- list_confluent_resource(account_id: str) ConfluentResourcesResponse ¶
List Confluent Account resources.
Get a Confluent resource for the account associated with the provided ID.
- Parameters:
account_id (str) – Confluent Account id.
- Return type:
- update_confluent_account(account_id: str, body: ConfluentAccountUpdateRequest) ConfluentAccountResponse ¶
Update Confluent account.
Update the Confluent account with the provided account ID.
- Parameters:
account_id (str) – Confluent Account id.
body (ConfluentAccountUpdateRequest) – Confluent payload
- Return type:
- update_confluent_resource(account_id: str, resource_id: str, body: ConfluentResourceRequest) ConfluentResourceResponse ¶
Update resource in Confluent account.
Update a Confluent resource with the provided resource id for the account associated with the provided account ID.
- Parameters:
account_id (str) – Confluent Account id.
resource_id (str) – Confluent Account Resource ID.
body (ConfluentResourceRequest) – Confluent payload
- Return type:
datadog_api_client.v2.api.container_images_api module¶
- class ContainerImagesApi(api_client=None)¶
Bases:
object
The Container Images API allows you to query Container Image data for your organization. See the Container Images View page for more information.
- list_container_images(*, filter_tags: str | UnsetType = UnsetType.unset, group_by: str | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset) ContainerImagesResponse ¶
Get all Container Images.
Get all Container Images for your organization.
- Parameters:
filter_tags (str, optional) – Comma-separated list of tags to filter Container Images by.
group_by (str, optional) – Comma-separated list of tags to group Container Images by.
sort (str, optional) – Attribute to sort Container Images by.
page_size (int, optional) – Maximum number of results returned.
page_cursor (str, optional) – String to query the next page of results. This key is provided with each valid response from the API in
meta.pagination.next_cursor
.
- Return type:
- list_container_images_with_pagination(*, filter_tags: str | UnsetType = UnsetType.unset, group_by: str | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset) Iterable[ContainerImageItem] ¶
Get all Container Images.
Provide a paginated version of
list_container_images()
, returning all items.- Parameters:
filter_tags (str, optional) – Comma-separated list of tags to filter Container Images by.
group_by (str, optional) – Comma-separated list of tags to group Container Images by.
sort (str, optional) – Attribute to sort Container Images by.
page_size (int, optional) – Maximum number of results returned.
page_cursor (str, optional) – String to query the next page of results. This key is provided with each valid response from the API in
meta.pagination.next_cursor
.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[ContainerImageItem]
datadog_api_client.v2.api.containers_api module¶
- class ContainersApi(api_client=None)¶
Bases:
object
The Containers API allows you to query container data for your organization. See the Container Monitoring page for more information.
- list_containers(*, filter_tags: str | UnsetType = UnsetType.unset, group_by: str | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset) ContainersResponse ¶
Get All Containers.
Get all containers for your organization.
- Parameters:
filter_tags (str, optional) – Comma-separated list of tags to filter containers by.
group_by (str, optional) – Comma-separated list of tags to group containers by.
sort (str, optional) – Attribute to sort containers by.
page_size (int, optional) – Maximum number of results returned.
page_cursor (str, optional) – String to query the next page of results. This key is provided with each valid response from the API in
meta.pagination.next_cursor
.
- Return type:
- list_containers_with_pagination(*, filter_tags: str | UnsetType = UnsetType.unset, group_by: str | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset) Iterable[ContainerItem] ¶
Get All Containers.
Provide a paginated version of
list_containers()
, returning all items.- Parameters:
filter_tags (str, optional) – Comma-separated list of tags to filter containers by.
group_by (str, optional) – Comma-separated list of tags to group containers by.
sort (str, optional) – Attribute to sort containers by.
page_size (int, optional) – Maximum number of results returned.
page_cursor (str, optional) – String to query the next page of results. This key is provided with each valid response from the API in
meta.pagination.next_cursor
.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[ContainerItem]
datadog_api_client.v2.api.csm_threats_api module¶
- class CSMThreatsApi(api_client=None)¶
Bases:
object
Cloud Security Management Threats (CSM Threats) monitors file, network, and process activity across your environment to detect real-time threats to your infrastructure. See Cloud Security Management Threats for more information on setting up CSM Threats.
- create_cloud_workload_security_agent_rule(body: CloudWorkloadSecurityAgentRuleCreateRequest) CloudWorkloadSecurityAgentRuleResponse ¶
Create a Cloud Workload Security Agent rule.
Create a new Agent rule with the given parameters.
- Parameters:
body (CloudWorkloadSecurityAgentRuleCreateRequest) – The definition of the new Agent rule.
- Return type:
- create_csm_threats_agent_rule(body: CloudWorkloadSecurityAgentRuleCreateRequest) CloudWorkloadSecurityAgentRuleResponse ¶
Create a CSM Threats Agent rule.
Create a new Cloud Security Management Threats Agent rule with the given parameters.
- Parameters:
body (CloudWorkloadSecurityAgentRuleCreateRequest) – The definition of the new Agent rule.
- Return type:
- delete_cloud_workload_security_agent_rule(agent_rule_id: str) None ¶
Delete a Cloud Workload Security Agent rule.
Delete a specific Agent rule.
- Parameters:
agent_rule_id (str) – The ID of the Agent rule.
- Return type:
None
- delete_csm_threats_agent_rule(agent_rule_id: str) None ¶
Delete a CSM Threats Agent rule.
Delete a specific Cloud Security Management Threats Agent rule.
- Parameters:
agent_rule_id (str) – The ID of the Agent rule.
- Return type:
None
- download_cloud_workload_policy_file() IOBase ¶
Get the latest Cloud Workload Security policy.
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.
- Return type:
file_type
- download_csm_threats_policy() IOBase ¶
Get the latest CSM Threats policy.
The download endpoint generates a CSM Threats policy file from your currently active CSM Threats 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.- Return type:
file_type
- get_cloud_workload_security_agent_rule(agent_rule_id: str) CloudWorkloadSecurityAgentRuleResponse ¶
Get a Cloud Workload Security Agent rule.
Get the details of a specific Agent rule.
- Parameters:
agent_rule_id (str) – The ID of the Agent rule.
- Return type:
- get_csm_threats_agent_rule(agent_rule_id: str) CloudWorkloadSecurityAgentRuleResponse ¶
Get a CSM Threats Agent rule.
Get the details of a specific Cloud Security Management Threats Agent rule.
- Parameters:
agent_rule_id (str) – The ID of the Agent rule.
- Return type:
- list_cloud_workload_security_agent_rules() CloudWorkloadSecurityAgentRulesListResponse ¶
Get all Cloud Workload Security Agent rules.
Get the list of Agent rules.
- Return type:
- list_csm_threats_agent_rules() CloudWorkloadSecurityAgentRulesListResponse ¶
Get all CSM Threats Agent rules.
Get the list of Cloud Security Management Threats Agent rules.
- Return type:
- update_cloud_workload_security_agent_rule(agent_rule_id: str, body: CloudWorkloadSecurityAgentRuleUpdateRequest) CloudWorkloadSecurityAgentRuleResponse ¶
Update a Cloud Workload Security Agent rule.
Update a specific Agent rule. Returns the Agent rule object when the request is successful.
- Parameters:
agent_rule_id (str) – The ID of the Agent rule.
body (CloudWorkloadSecurityAgentRuleUpdateRequest) – New definition of the Agent rule.
- Return type:
- update_csm_threats_agent_rule(agent_rule_id: str, body: CloudWorkloadSecurityAgentRuleUpdateRequest) CloudWorkloadSecurityAgentRuleResponse ¶
Update a CSM Threats Agent rule.
Update a specific Cloud Security Management Threats Agent rule. Returns the Agent rule object when the request is successful.
- Parameters:
agent_rule_id (str) – The ID of the Agent rule.
body (CloudWorkloadSecurityAgentRuleUpdateRequest) – New definition of the Agent rule.
- Return type:
datadog_api_client.v2.api.dashboard_lists_api module¶
- class DashboardListsApi(api_client=None)¶
Bases:
object
Interact with your dashboard lists through the API to organize, find, and share all of your dashboards with your team and organization.
- create_dashboard_list_items(dashboard_list_id: int, body: DashboardListAddItemsRequest) DashboardListAddItemsResponse ¶
Add Items to a Dashboard List.
Add dashboards to an existing dashboard list.
- Parameters:
dashboard_list_id (int) – ID of the dashboard list to add items to.
body (DashboardListAddItemsRequest) – Dashboards to add to the dashboard list.
- Return type:
- delete_dashboard_list_items(dashboard_list_id: int, body: DashboardListDeleteItemsRequest) DashboardListDeleteItemsResponse ¶
Delete items from a dashboard list.
Delete dashboards from an existing dashboard list.
- Parameters:
dashboard_list_id (int) – ID of the dashboard list to delete items from.
body (DashboardListDeleteItemsRequest) – Dashboards to delete from the dashboard list.
- Return type:
- get_dashboard_list_items(dashboard_list_id: int) DashboardListItems ¶
Get items of a Dashboard List.
Fetch the dashboard list’s dashboard definitions.
- Parameters:
dashboard_list_id (int) – ID of the dashboard list to get items from.
- Return type:
- update_dashboard_list_items(dashboard_list_id: int, body: DashboardListUpdateItemsRequest) DashboardListUpdateItemsResponse ¶
Update items of a dashboard list.
Update dashboards of an existing dashboard list.
- Parameters:
dashboard_list_id (int) – ID of the dashboard list to update items from.
body (DashboardListUpdateItemsRequest) – New dashboards of the dashboard list.
- Return type:
datadog_api_client.v2.api.domain_allowlist_api module¶
- class DomainAllowlistApi(api_client=None)¶
Bases:
object
Configure your Datadog Email Domain Allowlist directly through the Datadog API. The Email Domain Allowlist controls the domains that certain datadog emails can be sent to. For more information, see the Domain Allowlist docs page
- get_domain_allowlist() DomainAllowlistResponse ¶
Get Domain Allowlist.
Get the domain allowlist for an organization.
- Return type:
- patch_domain_allowlist(body: DomainAllowlistRequest) DomainAllowlistResponse ¶
Sets Domain Allowlist.
Update the domain allowlist for an organization.
- Return type:
datadog_api_client.v2.api.dora_metrics_api module¶
- class DORAMetricsApi(api_client=None)¶
Bases:
object
Send events for DORA Metrics to measure and improve software delivery. See the DORA Metrics page for more information.
- create_dora_deployment(body: DORADeploymentRequest) DORADeploymentResponse ¶
Send a deployment event for DORA Metrics.
Use this API endpoint to provide data about deployments for DORA metrics.
This is necessary for:
Deployment Frequency
Change Lead Time
Change Failure Rate
- Return type:
- create_dora_incident(body: DORAIncidentRequest) DORAIncidentResponse ¶
Send an incident event for DORA Metrics.
Use this API endpoint to provide data about incidents for DORA metrics.
This is necessary for:
Change Failure Rate
Time to Restore
- Return type:
datadog_api_client.v2.api.downtimes_api module¶
- class DowntimesApi(api_client=None)¶
Bases:
object
Note : Downtime V2 is currently in private beta. To request access, contact Datadog support.
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.
- cancel_downtime(downtime_id: str) None ¶
Cancel a downtime.
Cancel a downtime.
- Parameters:
downtime_id (str) – ID of the downtime to cancel.
- Return type:
None
- create_downtime(body: DowntimeCreateRequest) DowntimeResponse ¶
Schedule a downtime.
Schedule a downtime.
- Parameters:
body (DowntimeCreateRequest) – Schedule a downtime request body.
- Return type:
- get_downtime(downtime_id: str, *, include: str | UnsetType = UnsetType.unset) DowntimeResponse ¶
Get a downtime.
Get downtime detail by
downtime_id
.- Parameters:
downtime_id (str) – ID of the downtime to fetch.
include (str, optional) – Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are
created_by
andmonitor
.
- Return type:
- list_downtimes(*, current_only: bool | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) ListDowntimesResponse ¶
Get all downtimes.
Get all scheduled downtimes.
- Parameters:
current_only (bool, optional) – Only return downtimes that are active when the request is made.
include (str, optional) – Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are
created_by
andmonitor
.page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
page_limit (int, optional) – Maximum number of downtimes in the response.
- Return type:
- list_downtimes_with_pagination(*, current_only: bool | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[DowntimeResponseData] ¶
Get all downtimes.
Provide a paginated version of
list_downtimes()
, returning all items.- Parameters:
current_only (bool, optional) – Only return downtimes that are active when the request is made.
include (str, optional) – Comma-separated list of resource paths for related resources to include in the response. Supported resource paths are
created_by
andmonitor
.page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
page_limit (int, optional) – Maximum number of downtimes in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[DowntimeResponseData]
- list_monitor_downtimes(monitor_id: int, *, page_offset: int | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) MonitorDowntimeMatchResponse ¶
Get active downtimes for a monitor.
Get all active downtimes for the specified monitor.
- Parameters:
monitor_id (int) – The id of the monitor.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
page_limit (int, optional) – Maximum number of downtimes in the response.
- Return type:
- list_monitor_downtimes_with_pagination(monitor_id: int, *, page_offset: int | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[MonitorDowntimeMatchResponseData] ¶
Get active downtimes for a monitor.
Provide a paginated version of
list_monitor_downtimes()
, returning all items.- Parameters:
monitor_id (int) – The id of the monitor.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
page_limit (int, optional) – Maximum number of downtimes in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[MonitorDowntimeMatchResponseData]
- update_downtime(downtime_id: str, body: DowntimeUpdateRequest) DowntimeResponse ¶
Update a downtime.
Update a downtime by
downtime_id
.- Parameters:
downtime_id (str) – ID of the downtime to update.
body (DowntimeUpdateRequest) – Update a downtime request body.
- Return type:
datadog_api_client.v2.api.events_api module¶
- class EventsApi(api_client=None)¶
Bases:
object
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.
- create_event(body: EventCreateRequestPayload) EventCreateResponsePayload ¶
Post an event.
This endpoint allows you to post events.
Only events with change category are under General Availability. Refer to Change Tracking for further details.
- Parameters:
body (EventCreateRequestPayload) – Event request object
- Return type:
- list_events(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: str | UnsetType = UnsetType.unset, filter_to: str | UnsetType = UnsetType.unset, sort: EventsSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) EventsListResponse ¶
Get a list of events.
List endpoint returns events that match an events search query. Results are paginated similarly to logs.
Use this endpoint to see your latest events.
- Parameters:
filter_query (str, optional) – Search query following events syntax.
filter_from (str, optional) – Minimum timestamp for requested events, in milliseconds.
filter_to (str, optional) – Maximum timestamp for requested events, in milliseconds.
sort (EventsSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Return type:
- list_events_with_pagination(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: str | UnsetType = UnsetType.unset, filter_to: str | UnsetType = UnsetType.unset, sort: EventsSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[EventResponse] ¶
Get a list of events.
Provide a paginated version of
list_events()
, returning all items.- Parameters:
filter_query (str, optional) – Search query following events syntax.
filter_from (str, optional) – Minimum timestamp for requested events, in milliseconds.
filter_to (str, optional) – Maximum timestamp for requested events, in milliseconds.
sort (EventsSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[EventResponse]
- search_events(*, body: EventsListRequest | UnsetType = UnsetType.unset) EventsListResponse ¶
Search events.
List endpoint returns events that match an events search query. Results are paginated similarly to logs.
Use this endpoint to build complex events filtering and search.
- Return type:
- search_events_with_pagination(*, body: EventsListRequest | UnsetType = UnsetType.unset) Iterable[EventResponse] ¶
Search events.
Provide a paginated version of
search_events()
, returning all items.- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[EventResponse]
datadog_api_client.v2.api.fastly_integration_api module¶
- class FastlyIntegrationApi(api_client=None)¶
Bases:
object
Manage your Datadog Fastly integration accounts and services directly through the Datadog API. See the Fastly integration page for more information.
- create_fastly_account(body: FastlyAccountCreateRequest) FastlyAccountResponse ¶
Add Fastly account.
Create a Fastly account.
- Return type:
- create_fastly_service(account_id: str, body: FastlyServiceRequest) FastlyServiceResponse ¶
Add Fastly service.
Create a Fastly service for an account.
- Parameters:
account_id (str) – Fastly Account id.
- Return type:
- delete_fastly_account(account_id: str) None ¶
Delete Fastly account.
Delete a Fastly account.
- Parameters:
account_id (str) – Fastly Account id.
- Return type:
None
- delete_fastly_service(account_id: str, service_id: str) None ¶
Delete Fastly service.
Delete a Fastly service for an account.
- Parameters:
account_id (str) – Fastly Account id.
service_id (str) – Fastly Service ID.
- Return type:
None
- get_fastly_account(account_id: str) FastlyAccountResponse ¶
Get Fastly account.
Get a Fastly account.
- Parameters:
account_id (str) – Fastly Account id.
- Return type:
- get_fastly_service(account_id: str, service_id: str) FastlyServiceResponse ¶
Get Fastly service.
Get a Fastly service for an account.
- Parameters:
account_id (str) – Fastly Account id.
service_id (str) – Fastly Service ID.
- Return type:
- list_fastly_accounts() FastlyAccountsResponse ¶
List Fastly accounts.
List Fastly accounts.
- Return type:
- list_fastly_services(account_id: str) FastlyServicesResponse ¶
List Fastly services.
List Fastly services for an account.
- Parameters:
account_id (str) – Fastly Account id.
- Return type:
- update_fastly_account(account_id: str, body: FastlyAccountUpdateRequest) FastlyAccountResponse ¶
Update Fastly account.
Update a Fastly account.
- Parameters:
account_id (str) – Fastly Account id.
- Return type:
- update_fastly_service(account_id: str, service_id: str, body: FastlyServiceRequest) FastlyServiceResponse ¶
Update Fastly service.
Update a Fastly service for an account.
- Parameters:
account_id (str) – Fastly Account id.
service_id (str) – Fastly Service ID.
- Return type:
datadog_api_client.v2.api.gcp_integration_api module¶
- class GCPIntegrationApi(api_client=None)¶
Bases:
object
Configure your Datadog-Google Cloud Platform (GCP) integration directly through the Datadog API. Read more about the Datadog-Google Cloud Platform integration.
- create_gcpsts_account(body: GCPSTSServiceAccountCreateRequest) GCPSTSServiceAccountResponse ¶
Create a new entry for your service account.
Create a new entry within Datadog for your STS enabled service account.
- Return type:
- delete_gcpsts_account(account_id: str) None ¶
Delete an STS enabled GCP Account.
Delete an STS enabled GCP account from within Datadog.
- Parameters:
account_id (str) – Your GCP STS enabled service account’s unique ID.
- Return type:
None
- get_gcpsts_delegate() GCPSTSDelegateAccountResponse ¶
List delegate account.
List your Datadog-GCP STS delegate account configured in your Datadog account.
- Return type:
- list_gcpsts_accounts() GCPSTSServiceAccountsResponse ¶
List all GCP STS-enabled service accounts.
List all GCP STS-enabled service accounts configured in your Datadog account.
- Return type:
- make_gcpsts_delegate(*, body: dict | UnsetType = UnsetType.unset) GCPSTSDelegateAccountResponse ¶
Create a Datadog GCP principal.
Create a Datadog GCP principal.
- Parameters:
body (dict, optional) – Create a delegate service account within Datadog.
- Return type:
- update_gcpsts_account(account_id: str, body: GCPSTSServiceAccountUpdateRequest) GCPSTSServiceAccountResponse ¶
Update STS Service Account.
Update an STS enabled service account.
- Parameters:
account_id (str) – Your GCP STS enabled service account’s unique ID.
- Return type:
datadog_api_client.v2.api.incident_services_api module¶
- class IncidentServicesApi(api_client=None)¶
Bases:
object
Create, update, delete, and retrieve services which can be associated with incidents. See the Incident Management page for more information.
- create_incident_service(body: IncidentServiceCreateRequest) IncidentServiceResponse ¶
Create a new incident service. Deprecated.
Creates a new incident service.
- Parameters:
body (IncidentServiceCreateRequest) – Incident Service Payload.
- Return type:
- delete_incident_service(service_id: str) None ¶
Delete an existing incident service. Deprecated.
Deletes an existing incident service.
- Parameters:
service_id (str) – The ID of the incident service.
- Return type:
None
- get_incident_service(service_id: str, *, include: IncidentRelatedObject | UnsetType = UnsetType.unset) IncidentServiceResponse ¶
Get details of an incident service. Deprecated.
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.- Parameters:
service_id (str) – The ID of the incident service.
include (IncidentRelatedObject, optional) – Specifies which types of related objects should be included in the response.
- Return type:
- list_incident_services(*, include: IncidentRelatedObject | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset) IncidentServicesResponse ¶
Get a list of all incident services. Deprecated.
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.- Parameters:
include (IncidentRelatedObject, optional) – Specifies which types of related objects should be included in the response.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
filter (str, optional) – A search query that filters services by name.
- Return type:
- update_incident_service(service_id: str, body: IncidentServiceUpdateRequest) IncidentServiceResponse ¶
Update an existing incident service. Deprecated.
Updates an existing incident service. Only provide the attributes which should be updated as this request is a partial update.
- Parameters:
service_id (str) – The ID of the incident service.
body (IncidentServiceUpdateRequest) – Incident Service Payload.
- Return type:
datadog_api_client.v2.api.incident_teams_api module¶
- class IncidentTeamsApi(api_client=None)¶
Bases:
object
The Incident Teams endpoints are deprecated. See the Teams API endpoints to create, update, delete, and retrieve teams which can be associated with incidents.
- create_incident_team(body: IncidentTeamCreateRequest) IncidentTeamResponse ¶
Create a new incident team. Deprecated.
Creates a new incident team.
- Parameters:
body (IncidentTeamCreateRequest) – Incident Team Payload.
- Return type:
- delete_incident_team(team_id: str) None ¶
Delete an existing incident team. Deprecated.
Deletes an existing incident team.
- Parameters:
team_id (str) – The ID of the incident team.
- Return type:
None
- get_incident_team(team_id: str, *, include: IncidentRelatedObject | UnsetType = UnsetType.unset) IncidentTeamResponse ¶
Get details of an incident team. Deprecated.
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.- Parameters:
team_id (str) – The ID of the incident team.
include (IncidentRelatedObject, optional) – Specifies which types of related objects should be included in the response.
- Return type:
- list_incident_teams(*, include: IncidentRelatedObject | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset) IncidentTeamsResponse ¶
Get a list of all incident teams. Deprecated.
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.- Parameters:
include (IncidentRelatedObject, optional) – Specifies which types of related objects should be included in the response.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
filter (str, optional) – A search query that filters teams by name.
- Return type:
- update_incident_team(team_id: str, body: IncidentTeamUpdateRequest) IncidentTeamResponse ¶
Update an existing incident team. Deprecated.
Updates an existing incident team. Only provide the attributes which should be updated as this request is a partial update.
- Parameters:
team_id (str) – The ID of the incident team.
body (IncidentTeamUpdateRequest) – Incident Team Payload.
- Return type:
datadog_api_client.v2.api.incidents_api module¶
- class IncidentsApi(api_client=None)¶
Bases:
object
Manage incident response, as well as associated attachments, metadata, and todos. See the Incident Management page for more information.
- create_incident(body: IncidentCreateRequest) IncidentResponse ¶
Create an incident.
Create an incident.
- Parameters:
body (IncidentCreateRequest) – Incident payload.
- Return type:
- create_incident_integration(incident_id: str, body: IncidentIntegrationMetadataCreateRequest) IncidentIntegrationMetadataResponse ¶
Create an incident integration metadata.
Create an incident integration metadata.
- Parameters:
incident_id (str) – The UUID of the incident.
body (IncidentIntegrationMetadataCreateRequest) – Incident integration metadata payload.
- Return type:
- create_incident_todo(incident_id: str, body: IncidentTodoCreateRequest) IncidentTodoResponse ¶
Create an incident todo.
Create an incident todo.
- Parameters:
incident_id (str) – The UUID of the incident.
body (IncidentTodoCreateRequest) – Incident todo payload.
- Return type:
- create_incident_type(body: IncidentTypeCreateRequest) IncidentTypeResponse ¶
Create an incident type.
Create an incident type.
- Parameters:
body (IncidentTypeCreateRequest) – Incident type payload.
- Return type:
- delete_incident(incident_id: str) None ¶
Delete an existing incident.
Deletes an existing incident from the users organization.
- Parameters:
incident_id (str) – The UUID of the incident.
- Return type:
None
- delete_incident_integration(incident_id: str, integration_metadata_id: str) None ¶
Delete an incident integration metadata.
Delete an incident integration metadata.
- Parameters:
incident_id (str) – The UUID of the incident.
integration_metadata_id (str) – The UUID of the incident integration metadata.
- Return type:
None
- delete_incident_todo(incident_id: str, todo_id: str) None ¶
Delete an incident todo.
Delete an incident todo.
- Parameters:
incident_id (str) – The UUID of the incident.
todo_id (str) – The UUID of the incident todo.
- Return type:
None
- delete_incident_type(incident_type_id: str) None ¶
Delete an incident type.
Delete an incident type.
- Parameters:
incident_type_id (str) – The UUID of the incident type.
- Return type:
None
- get_incident(incident_id: str, *, include: List[IncidentRelatedObject] | UnsetType = UnsetType.unset) IncidentResponse ¶
Get the details of an incident.
Get the details of an incident by
incident_id
.- Parameters:
incident_id (str) – The UUID of the incident.
include ([IncidentRelatedObject], optional) – Specifies which types of related objects should be included in the response.
- Return type:
- get_incident_integration(incident_id: str, integration_metadata_id: str) IncidentIntegrationMetadataResponse ¶
Get incident integration metadata details.
Get incident integration metadata details.
- Parameters:
incident_id (str) – The UUID of the incident.
integration_metadata_id (str) – The UUID of the incident integration metadata.
- Return type:
- get_incident_todo(incident_id: str, todo_id: str) IncidentTodoResponse ¶
Get incident todo details.
Get incident todo details.
- Parameters:
incident_id (str) – The UUID of the incident.
todo_id (str) – The UUID of the incident todo.
- Return type:
- get_incident_type(incident_type_id: str) IncidentTypeResponse ¶
Get incident type details.
Get incident type details.
- Parameters:
incident_type_id (str) – The UUID of the incident type.
- Return type:
- list_incident_attachments(incident_id: str, *, include: List[IncidentAttachmentRelatedObject] | UnsetType = UnsetType.unset, filter_attachment_type: List[IncidentAttachmentAttachmentType] | UnsetType = UnsetType.unset) IncidentAttachmentsResponse ¶
Get a list of attachments.
Get all attachments for a given incident.
- Parameters:
incident_id (str) – The UUID of the incident.
include ([IncidentAttachmentRelatedObject], optional) – Specifies which types of related objects are included in the response.
filter_attachment_type ([IncidentAttachmentAttachmentType], optional) – Specifies which types of attachments are included in the response.
- Return type:
- list_incident_integrations(incident_id: str) IncidentIntegrationMetadataListResponse ¶
Get a list of an incident’s integration metadata.
Get all integration metadata for an incident.
- Parameters:
incident_id (str) – The UUID of the incident.
- Return type:
- list_incident_todos(incident_id: str) IncidentTodoListResponse ¶
Get a list of an incident’s todos.
Get all todos for an incident.
- Parameters:
incident_id (str) – The UUID of the incident.
- Return type:
- list_incident_types(*, include_deleted: bool | UnsetType = UnsetType.unset) IncidentTypeListResponse ¶
Get a list of incident types.
Get all incident types.
- Parameters:
include_deleted (bool, optional) – Include deleted incident types in the response.
- Return type:
- list_incidents(*, include: List[IncidentRelatedObject] | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset) IncidentsResponse ¶
Get a list of incidents.
Get all incidents for the user’s organization.
- Parameters:
include ([IncidentRelatedObject], optional) – Specifies which types of related objects should be included in the response.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
- Return type:
- list_incidents_with_pagination(*, include: List[IncidentRelatedObject] | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset) Iterable[IncidentResponseData] ¶
Get a list of incidents.
Provide a paginated version of
list_incidents()
, returning all items.- Parameters:
include ([IncidentRelatedObject], optional) – Specifies which types of related objects should be included in the response.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[IncidentResponseData]
- search_incidents(query: str, *, include: IncidentRelatedObject | UnsetType = UnsetType.unset, sort: IncidentSearchSortOrder | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset) IncidentSearchResponse ¶
Search for incidents.
Search for incidents matching a certain query.
- Parameters:
query (str) – 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 byOR
s. For example:state:active AND severity:(SEV-2 OR SEV-1)
.include (IncidentRelatedObject, optional) – Specifies which types of related objects should be included in the response.
sort (IncidentSearchSortOrder, optional) – Specifies the order of returned incidents.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
- Return type:
- search_incidents_with_pagination(query: str, *, include: IncidentRelatedObject | UnsetType = UnsetType.unset, sort: IncidentSearchSortOrder | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset) Iterable[IncidentSearchResponseIncidentsData] ¶
Search for incidents.
Provide a paginated version of
search_incidents()
, returning all items.- Parameters:
query (str) – 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 byOR
s. For example:state:active AND severity:(SEV-2 OR SEV-1)
.include (IncidentRelatedObject, optional) – Specifies which types of related objects should be included in the response.
sort (IncidentSearchSortOrder, optional) – Specifies the order of returned incidents.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[IncidentSearchResponseIncidentsData]
- update_incident(incident_id: str, body: IncidentUpdateRequest, *, include: List[IncidentRelatedObject] | UnsetType = UnsetType.unset) IncidentResponse ¶
Update an existing incident.
Updates an incident. Provide only the attributes that should be updated as this request is a partial update.
- Parameters:
incident_id (str) – The UUID of the incident.
body (IncidentUpdateRequest) – Incident Payload.
include ([IncidentRelatedObject], optional) – Specifies which types of related objects should be included in the response.
- Return type:
- update_incident_attachments(incident_id: str, body: IncidentAttachmentUpdateRequest, *, include: List[IncidentAttachmentRelatedObject] | UnsetType = UnsetType.unset) IncidentAttachmentUpdateResponse ¶
Create, update, and delete incident attachments.
The bulk update endpoint for creating, updating, and deleting attachments for a given incident.
- Parameters:
incident_id (str) – The UUID of the incident.
body (IncidentAttachmentUpdateRequest) – Incident Attachment Payload.
include ([IncidentAttachmentRelatedObject], optional) – Specifies which types of related objects are included in the response.
- Return type:
- update_incident_integration(incident_id: str, integration_metadata_id: str, body: IncidentIntegrationMetadataPatchRequest) IncidentIntegrationMetadataResponse ¶
Update an existing incident integration metadata.
Update an existing incident integration metadata.
- Parameters:
incident_id (str) – The UUID of the incident.
integration_metadata_id (str) – The UUID of the incident integration metadata.
body (IncidentIntegrationMetadataPatchRequest) – Incident integration metadata payload.
- Return type:
- update_incident_todo(incident_id: str, todo_id: str, body: IncidentTodoPatchRequest) IncidentTodoResponse ¶
Update an incident todo.
Update an incident todo.
- Parameters:
incident_id (str) – The UUID of the incident.
todo_id (str) – The UUID of the incident todo.
body (IncidentTodoPatchRequest) – Incident todo payload.
- Return type:
- update_incident_type(incident_type_id: str, body: IncidentTypePatchRequest) IncidentTypeResponse ¶
Update an incident type.
Update an incident type.
- Parameters:
incident_type_id (str) – The UUID of the incident type.
body (IncidentTypePatchRequest) – Incident type payload.
- Return type:
datadog_api_client.v2.api.ip_allowlist_api module¶
- class IPAllowlistApi(api_client=None)¶
Bases:
object
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, or see the IP Allowlist page for more information.
- get_ip_allowlist() IPAllowlistResponse ¶
Get IP Allowlist.
Returns the IP allowlist and its enabled or disabled state.
- Return type:
- update_ip_allowlist(body: IPAllowlistUpdateRequest) IPAllowlistResponse ¶
Update IP Allowlist.
Edit the entries in the IP allowlist, and enable or disable it.
- Return type:
datadog_api_client.v2.api.key_management_api module¶
- class KeyManagementApi(api_client=None)¶
Bases:
object
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.
- create_api_key(body: APIKeyCreateRequest) APIKeyResponse ¶
Create an API key.
Create an API key.
- Return type:
- create_current_user_application_key(body: ApplicationKeyCreateRequest) ApplicationKeyResponse ¶
Create an application key for current user.
Create an application key for current user
- Return type:
- delete_api_key(api_key_id: str) None ¶
Delete an API key.
Delete an API key.
- Parameters:
api_key_id (str) – The ID of the API key.
- Return type:
None
- delete_application_key(app_key_id: str) None ¶
Delete an application key.
Delete an application key
- Parameters:
app_key_id (str) – The ID of the application key.
- Return type:
None
- delete_current_user_application_key(app_key_id: str) None ¶
Delete an application key owned by current user.
Delete an application key owned by current user
- Parameters:
app_key_id (str) – The ID of the application key.
- Return type:
None
- get_api_key(api_key_id: str, *, include: str | UnsetType = UnsetType.unset) APIKeyResponse ¶
Get API key.
Get an API key.
- Parameters:
api_key_id (str) – The ID of the API key.
include (str, optional) – Comma separated list of resource paths for related resources to include in the response. Supported resource paths are
created_by
andmodified_by
.
- Return type:
- get_application_key(app_key_id: str, *, include: str | UnsetType = UnsetType.unset) ApplicationKeyResponse ¶
Get an application key.
Get an application key for your org.
- Parameters:
app_key_id (str) – The ID of the application key.
include (str, optional) – Resource path for related resources to include in the response. Only
owned_by
is supported.
- Return type:
- get_current_user_application_key(app_key_id: str) ApplicationKeyResponse ¶
Get one application key owned by current user.
Get an application key owned by current user
- Parameters:
app_key_id (str) – The ID of the application key.
- Return type:
- list_api_keys(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: APIKeysSort | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, filter_created_at_start: str | UnsetType = UnsetType.unset, filter_created_at_end: str | UnsetType = UnsetType.unset, filter_modified_at_start: str | UnsetType = UnsetType.unset, filter_modified_at_end: str | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset, filter_remote_config_read_enabled: bool | UnsetType = UnsetType.unset, filter_category: str | UnsetType = UnsetType.unset) APIKeysResponse ¶
Get all API keys.
List all API keys available for your account.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (APIKeysSort, optional) – 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.
filter (str, optional) – Filter API keys by the specified string.
filter_created_at_start (str, optional) – Only include API keys created on or after the specified date.
filter_created_at_end (str, optional) – Only include API keys created on or before the specified date.
filter_modified_at_start (str, optional) – Only include API keys modified on or after the specified date.
filter_modified_at_end (str, optional) – Only include API keys modified on or before the specified date.
include (str, optional) – Comma separated list of resource paths for related resources to include in the response. Supported resource paths are
created_by
andmodified_by
.filter_remote_config_read_enabled (bool, optional) – Filter API keys by remote config read enabled status.
filter_category (str, optional) – Filter API keys by category.
- Return type:
- list_application_keys(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: ApplicationKeysSort | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, filter_created_at_start: str | UnsetType = UnsetType.unset, filter_created_at_end: str | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset) ListApplicationKeysResponse ¶
Get all application keys.
List all application keys available for your org
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (ApplicationKeysSort, optional) – 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.
filter (str, optional) – Filter application keys by the specified string.
filter_created_at_start (str, optional) – Only include application keys created on or after the specified date.
filter_created_at_end (str, optional) – Only include application keys created on or before the specified date.
include (str, optional) – Resource path for related resources to include in the response. Only
owned_by
is supported.
- Return type:
- list_current_user_application_keys(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: ApplicationKeysSort | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, filter_created_at_start: str | UnsetType = UnsetType.unset, filter_created_at_end: str | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset) ListApplicationKeysResponse ¶
Get all application keys owned by current user.
List all application keys available for current user
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (ApplicationKeysSort, optional) – 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.
filter (str, optional) – Filter application keys by the specified string.
filter_created_at_start (str, optional) – Only include application keys created on or after the specified date.
filter_created_at_end (str, optional) – Only include application keys created on or before the specified date.
include (str, optional) – Resource path for related resources to include in the response. Only
owned_by
is supported.
- Return type:
- update_api_key(api_key_id: str, body: APIKeyUpdateRequest) APIKeyResponse ¶
Edit an API key.
Update an API key.
- Parameters:
api_key_id (str) – The ID of the API key.
- Return type:
- update_application_key(app_key_id: str, body: ApplicationKeyUpdateRequest) ApplicationKeyResponse ¶
Edit an application key.
Edit an application key
- Parameters:
app_key_id (str) – The ID of the application key.
- Return type:
- update_current_user_application_key(app_key_id: str, body: ApplicationKeyUpdateRequest) ApplicationKeyResponse ¶
Edit an application key owned by current user.
Edit an application key owned by current user
- Parameters:
app_key_id (str) – The ID of the application key.
- Return type:
datadog_api_client.v2.api.logs_api module¶
- class LogsApi(api_client=None)¶
Bases:
object
Search your logs and send them to your Datadog platform over HTTP. See the Log Management page for more information.
- aggregate_logs(body: LogsAggregateRequest) LogsAggregateResponse ¶
Aggregate events.
The API endpoint to aggregate events into buckets and compute metrics and timeseries.
- Return type:
- list_logs(*, body: LogsListRequest | UnsetType = UnsetType.unset) LogsListResponse ¶
Search logs.
List endpoint returns logs that match a log search query. Results are paginated.
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.
- Return type:
- list_logs_get(*, filter_query: str | UnsetType = UnsetType.unset, filter_indexes: List[str] | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, filter_storage_tier: LogsStorageTier | UnsetType = UnsetType.unset, sort: LogsSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) LogsListResponse ¶
Get a list of logs.
List endpoint returns logs that match a log search query. Results are paginated.
Use this endpoint to see your latest 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.
- Parameters:
filter_query (str, optional) – Search query following logs syntax.
filter_indexes ([str], optional) – For customers with multiple indexes, the indexes to search. Defaults to ‘*’ which means all indexes
filter_from (datetime, optional) – Minimum timestamp for requested logs.
filter_to (datetime, optional) – Maximum timestamp for requested logs.
filter_storage_tier (LogsStorageTier, optional) – Specifies the storage type to be used
sort (LogsSort, optional) – Order of logs in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of logs in the response.
- Return type:
- list_logs_get_with_pagination(*, filter_query: str | UnsetType = UnsetType.unset, filter_indexes: List[str] | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, filter_storage_tier: LogsStorageTier | UnsetType = UnsetType.unset, sort: LogsSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[Log] ¶
Get a list of logs.
Provide a paginated version of
list_logs_get()
, returning all items.- Parameters:
filter_query (str, optional) – Search query following logs syntax.
filter_indexes ([str], optional) – For customers with multiple indexes, the indexes to search. Defaults to ‘*’ which means all indexes
filter_from (datetime, optional) – Minimum timestamp for requested logs.
filter_to (datetime, optional) – Maximum timestamp for requested logs.
filter_storage_tier (LogsStorageTier, optional) – Specifies the storage type to be used
sort (LogsSort, optional) – Order of logs in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of logs in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[Log]
- list_logs_with_pagination(*, body: LogsListRequest | UnsetType = UnsetType.unset) Iterable[Log] ¶
Search logs.
Provide a paginated version of
list_logs()
, returning all items.- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[Log]
- submit_log(body: HTTPLog, *, content_encoding: ContentEncoding | UnsetType = UnsetType.unset, ddtags: str | UnsetType = UnsetType.unset) dict ¶
Send logs.
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
- Parameters:
body (HTTPLog) – Log to send (JSON format).
content_encoding (ContentEncoding, optional) – HTTP header used to compress the media-type.
ddtags (str, optional) – Log tags can be passed as query parameters with
text/plain
content type.
- Return type:
dict
datadog_api_client.v2.api.logs_archives_api module¶
- class LogsArchivesApi(api_client=None)¶
Bases:
object
Archives forward all the logs ingested to a cloud storage system.
See the Archives Page for a list of the archives currently configured in Datadog.
You need an API and non-scoped application key with Admin rights to interact with these endpoints.
- add_read_role_to_archive(archive_id: str, body: RelationshipToRole) None ¶
Grant role to an archive.
Adds a read role to an archive. ( Roles API )
- Parameters:
archive_id (str) – The ID of the archive.
- Return type:
None
- create_logs_archive(body: LogsArchiveCreateRequest) LogsArchive ¶
Create an archive.
Create an archive in your organization.
- Parameters:
body (LogsArchiveCreateRequest) – The definition of the new archive.
- Return type:
- delete_logs_archive(archive_id: str) None ¶
Delete an archive.
Delete a given archive from your organization.
- Parameters:
archive_id (str) – The ID of the archive.
- Return type:
None
- get_logs_archive(archive_id: str) LogsArchive ¶
Get an archive.
Get a specific archive from your organization.
- Parameters:
archive_id (str) – The ID of the archive.
- Return type:
- get_logs_archive_order() LogsArchiveOrder ¶
Get archive order.
Get the current order of your archives. This endpoint takes no JSON arguments.
- Return type:
- list_archive_read_roles(archive_id: str) RolesResponse ¶
List read roles for an archive.
Returns all read roles a given archive is restricted to.
- Parameters:
archive_id (str) – The ID of the archive.
- Return type:
- list_logs_archives() LogsArchives ¶
Get all archives.
Get the list of configured logs archives with their definitions.
- Return type:
- remove_role_from_archive(archive_id: str, body: RelationshipToRole) None ¶
Revoke role from an archive.
Removes a role from an archive. ( Roles API )
- Parameters:
archive_id (str) – The ID of the archive.
- Return type:
None
- update_logs_archive(archive_id: str, body: LogsArchiveCreateRequest) LogsArchive ¶
Update an archive.
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.
- Parameters:
archive_id (str) – The ID of the archive.
body (LogsArchiveCreateRequest) – New definition of the archive.
- Return type:
- update_logs_archive_order(body: LogsArchiveOrder) LogsArchiveOrder ¶
Update archive order.
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.- Parameters:
body (LogsArchiveOrder) – An object containing the new ordered list of archive IDs.
- Return type:
datadog_api_client.v2.api.logs_custom_destinations_api module¶
- class LogsCustomDestinationsApi(api_client=None)¶
Bases:
object
Custom Destinations forward all the logs ingested to an external destination.
Note : Log forwarding is not available for the Government (US1-FED) site. Contact your account representative for more information.
See the Custom Destinations Page for a list of the custom destinations currently configured in web UI.
- create_logs_custom_destination(body: CustomDestinationCreateRequest) CustomDestinationResponse ¶
Create a custom destination.
Create a custom destination in your organization.
- Parameters:
body (CustomDestinationCreateRequest) – The definition of the new custom destination.
- Return type:
- delete_logs_custom_destination(custom_destination_id: str) None ¶
Delete a custom destination.
Delete a specific custom destination in your organization.
- Parameters:
custom_destination_id (str) – The ID of the custom destination.
- Return type:
None
- get_logs_custom_destination(custom_destination_id: str) CustomDestinationResponse ¶
Get a custom destination.
Get a specific custom destination in your organization.
- Parameters:
custom_destination_id (str) – The ID of the custom destination.
- Return type:
- list_logs_custom_destinations() CustomDestinationsResponse ¶
Get all custom destinations.
Get the list of configured custom destinations in your organization with their definitions.
- Return type:
- update_logs_custom_destination(custom_destination_id: str, body: CustomDestinationUpdateRequest) CustomDestinationResponse ¶
Update a custom destination.
Update the given fields of a specific custom destination in your organization.
- Parameters:
custom_destination_id (str) – The ID of the custom destination.
body (CustomDestinationUpdateRequest) – New definition of the custom destination’s fields.
- Return type:
datadog_api_client.v2.api.logs_metrics_api module¶
- class LogsMetricsApi(api_client=None)¶
Bases:
object
Manage configuration of log-based metrics for your organization. You need an API and non-scoped application key with Admin rights to interact with these endpoints.
- create_logs_metric(body: LogsMetricCreateRequest) LogsMetricResponse ¶
Create a log-based metric.
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.
- Parameters:
body (LogsMetricCreateRequest) – The definition of the new log-based metric.
- Return type:
- delete_logs_metric(metric_id: str) None ¶
Delete a log-based metric.
Delete a specific log-based metric from your organization.
- Parameters:
metric_id (str) – The name of the log-based metric.
- Return type:
None
- get_logs_metric(metric_id: str) LogsMetricResponse ¶
Get a log-based metric.
Get a specific log-based metric from your organization.
- Parameters:
metric_id (str) – The name of the log-based metric.
- Return type:
- list_logs_metrics() LogsMetricsResponse ¶
Get all log-based metrics.
Get the list of configured log-based metrics with their definitions.
- Return type:
- update_logs_metric(metric_id: str, body: LogsMetricUpdateRequest) LogsMetricResponse ¶
Update a log-based metric.
Update a specific log-based metric from your organization. Returns the log-based metric object from the request body when the request is successful.
- Parameters:
metric_id (str) – The name of the log-based metric.
body (LogsMetricUpdateRequest) – New definition of the log-based metric.
- Return type:
datadog_api_client.v2.api.metrics_api module¶
- class MetricsApi(api_client=None)¶
Bases:
object
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 theManage Tags for Metrics
permission.See the Metrics page for more information.
- create_bulk_tags_metrics_configuration(body: MetricBulkTagConfigCreateRequest) MetricBulkTagConfigResponse ¶
Configure tags for multiple metrics.
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 theManage Tags for Metrics
permission.- Return type:
- create_tag_configuration(metric_name: str, body: MetricTagConfigurationCreateRequest) MetricTagConfigurationResponse ¶
Create a tag configuration.
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 theManage Tags for Metrics
permission.- Parameters:
metric_name (str) – The name of the metric.
- Return type:
- delete_bulk_tags_metrics_configuration(body: MetricBulkTagConfigDeleteRequest) MetricBulkTagConfigResponse ¶
Delete tags for multiple metrics.
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.- Return type:
- delete_tag_configuration(metric_name: str) None ¶
Delete a tag configuration.
Deletes a metric’s tag configuration. Can only be used with application keys from users with the
Manage Tags for Metrics
permission.- Parameters:
metric_name (str) – The name of the metric.
- Return type:
None
- estimate_metrics_output_series(metric_name: str, *, filter_groups: str | UnsetType = UnsetType.unset, filter_hours_ago: int | UnsetType = UnsetType.unset, filter_num_aggregations: int | UnsetType = UnsetType.unset, filter_pct: bool | UnsetType = UnsetType.unset, filter_timespan_h: int | UnsetType = UnsetType.unset) MetricEstimateResponse ¶
Tag Configuration Cardinality Estimator.
Returns the estimated cardinality for a metric with a given tag, percentile and number of aggregations configuration using Metrics without Limits™.
- Parameters:
metric_name (str) – The name of the metric.
filter_groups (str, optional) – Filtered tag keys that the metric is configured to query with.
filter_hours_ago (int, optional) – The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.
filter_num_aggregations (int, optional) – The number of aggregations that a
count
,rate
, orgauge
metric is configured to use. Max number of aggregation combos is 9.filter_pct (bool, optional) – A boolean, for distribution metrics only, to estimate cardinality if the metric includes additional percentile aggregators.
filter_timespan_h (int, optional) – A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
- Return type:
- list_active_metric_configurations(metric_name: str, *, window_seconds: int | UnsetType = UnsetType.unset) MetricSuggestedTagsAndAggregationsResponse ¶
List active tags and aggregations.
List tags and aggregations that are actively queried on dashboards, notebooks, monitors, and the Metrics Explorer for a given metric name.
- Parameters:
metric_name (str) – The name of the metric.
window_seconds (int, optional) – 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).
- Return type:
- list_metric_assets(metric_name: str) MetricAssetsResponse ¶
Related Assets to a Metric.
Returns dashboards, monitors, notebooks, and SLOs that a metric is stored in, if any. Updated every 24 hours.
- Parameters:
metric_name (str) – The name of the metric.
- Return type:
- list_tag_configuration_by_name(metric_name: str) MetricTagConfigurationResponse ¶
List tag configuration by name.
Returns the tag configuration for the given metric name.
- Parameters:
metric_name (str) – The name of the metric.
- Return type:
- list_tag_configurations(*, filter_configured: bool | UnsetType = UnsetType.unset, filter_tags_configured: str | UnsetType = UnsetType.unset, filter_metric_type: MetricTagConfigurationMetricTypeCategory | UnsetType = UnsetType.unset, filter_include_percentiles: bool | UnsetType = UnsetType.unset, filter_queried: bool | UnsetType = UnsetType.unset, filter_tags: str | UnsetType = UnsetType.unset, window_seconds: int | UnsetType = UnsetType.unset) MetricsAndMetricTagConfigurationsResponse ¶
Get a list of metrics.
Returns all metrics that can be configured in the Metrics Summary page or with Metrics without Limits™ (matching additional filters if specified).
- Parameters:
filter_configured (bool, optional) – Filter custom metrics that have configured tags.
filter_tags_configured (str, optional) – Filter tag configurations by configured tags.
filter_metric_type (MetricTagConfigurationMetricTypeCategory, optional) – Filter metrics by metric type.
filter_include_percentiles (bool, optional) – Filter distributions with additional percentile aggregations enabled or disabled.
filter_queried (bool, optional) – (Beta) 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.
filter_tags (str, optional) – Filter metrics that have been submitted with the given tags. Supports boolean and wildcard expressions. Can only be combined with the filter[queried] filter.
window_seconds (int, optional) – 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).
- Return type:
- list_tags_by_metric_name(metric_name: str) MetricAllTagsResponse ¶
List tags by metric name.
View indexed tag key-value pairs for a given metric name over the previous hour.
- Parameters:
metric_name (str) – The name of the metric.
- Return type:
- list_volumes_by_metric_name(metric_name: str) MetricVolumesResponse ¶
List distinct metric volumes by metric name.
View distinct metrics volumes for the given metric name.
Custom metrics generated in-app from other products will return
null
for ingested volumes.- Parameters:
metric_name (str) – The name of the metric.
- Return type:
- query_scalar_data(body: ScalarFormulaQueryRequest) ScalarFormulaQueryResponse ¶
Query scalar data across multiple products.
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.
- Return type:
- query_timeseries_data(body: TimeseriesFormulaQueryRequest) TimeseriesFormulaQueryResponse ¶
Query timeseries data across multiple products.
Query timeseries data across various data sources and process the data by applying formulas and functions.
- Return type:
- submit_metrics(body: MetricPayload, *, content_encoding: MetricContentEncoding | UnsetType = UnsetType.unset) IntakePayloadAccepted ¶
Submit metrics.
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.
- Parameters:
content_encoding (MetricContentEncoding, optional) – HTTP header used to compress the media-type.
- Return type:
- update_tag_configuration(metric_name: str, body: MetricTagConfigurationUpdateRequest) MetricTagConfigurationResponse ¶
Update a tag configuration.
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 theManage Tags for Metrics
permission. This endpoint requires a tag configuration to be created first.- Parameters:
metric_name (str) – The name of the metric.
- Return type:
datadog_api_client.v2.api.microsoft_teams_integration_api module¶
- class MicrosoftTeamsIntegrationApi(api_client=None)¶
Bases:
object
Configure your Datadog Microsoft Teams integration directly through the Datadog API. Note: These endpoints do not support legacy connector handles.
- create_tenant_based_handle(body: MicrosoftTeamsCreateTenantBasedHandleRequest) MicrosoftTeamsTenantBasedHandleResponse ¶
Create tenant-based handle.
Create a tenant-based handle in the Datadog Microsoft Teams integration.
- Parameters:
body (MicrosoftTeamsCreateTenantBasedHandleRequest) – Tenant-based handle payload.
- Return type:
- delete_tenant_based_handle(handle_id: str) None ¶
Delete tenant-based handle.
Delete a tenant-based handle from the Datadog Microsoft Teams integration.
- Parameters:
handle_id (str) – Your tenant-based handle id.
- Return type:
None
- get_channel_by_name(tenant_name: str, team_name: str, channel_name: str) MicrosoftTeamsGetChannelByNameResponse ¶
Get channel information by name.
Get the tenant, team, and channel ID of a channel in the Datadog Microsoft Teams integration.
- Parameters:
tenant_name (str) – Your tenant name.
team_name (str) – Your team name.
channel_name (str) – Your channel name.
- Return type:
- get_tenant_based_handle(handle_id: str) MicrosoftTeamsTenantBasedHandleResponse ¶
Get tenant-based handle information.
Get the tenant, team, and channel information of a tenant-based handle from the Datadog Microsoft Teams integration.
- Parameters:
handle_id (str) – Your tenant-based handle id.
- Return type:
- list_tenant_based_handles(*, tenant_id: str | UnsetType = UnsetType.unset, name: str | UnsetType = UnsetType.unset) MicrosoftTeamsTenantBasedHandlesResponse ¶
Get all tenant-based handles.
Get a list of all tenant-based handles from the Datadog Microsoft Teams integration.
- Parameters:
tenant_id (str, optional) – Your tenant id.
name (str, optional) – Your tenant-based handle name.
- Return type:
- update_tenant_based_handle(handle_id: str, body: MicrosoftTeamsUpdateTenantBasedHandleRequest) MicrosoftTeamsTenantBasedHandleResponse ¶
Update tenant-based handle.
Update a tenant-based handle from the Datadog Microsoft Teams integration.
- Parameters:
handle_id (str) – Your tenant-based handle id.
body (MicrosoftTeamsUpdateTenantBasedHandleRequest) – Tenant-based handle payload.
- Return type:
datadog_api_client.v2.api.monitors_api module¶
- class MonitorsApi(api_client=None)¶
Bases:
object
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 and Tag Policies.
- create_monitor_config_policy(body: MonitorConfigPolicyCreateRequest) MonitorConfigPolicyResponse ¶
Create a monitor configuration policy.
Create a monitor configuration policy.
- Parameters:
body (MonitorConfigPolicyCreateRequest) – Create a monitor configuration policy request body.
- Return type:
- delete_monitor_config_policy(policy_id: str) None ¶
Delete a monitor configuration policy.
Delete a monitor configuration policy.
- Parameters:
policy_id (str) – ID of the monitor configuration policy.
- Return type:
None
- get_monitor_config_policy(policy_id: str) MonitorConfigPolicyResponse ¶
Get a monitor configuration policy.
Get a monitor configuration policy by
policy_id
.- Parameters:
policy_id (str) – ID of the monitor configuration policy.
- Return type:
- list_monitor_config_policies() MonitorConfigPolicyListResponse ¶
Get all monitor configuration policies.
Get all monitor configuration policies.
- Return type:
- update_monitor_config_policy(policy_id: str, body: MonitorConfigPolicyEditRequest) MonitorConfigPolicyResponse ¶
Edit a monitor configuration policy.
Edit a monitor configuration policy.
- Parameters:
policy_id (str) – ID of the monitor configuration policy.
body (MonitorConfigPolicyEditRequest) – Description of the update.
- Return type:
datadog_api_client.v2.api.network_device_monitoring_api module¶
- class NetworkDeviceMonitoringApi(api_client=None)¶
Bases:
object
The Network Device Monitoring API allows you to fetch devices and interfaces and their attributes. See the Network Device Monitoring page for more information.
- get_device(device_id: str) GetDeviceResponse ¶
Get the device details.
Get the device details.
- Parameters:
device_id (str) – The id of the device to fetch.
- Return type:
- get_interfaces(device_id: str) GetInterfacesResponse ¶
Get the list of interfaces of the device.
Get the list of interfaces of the device.
- Parameters:
device_id (str) – The ID of the device to get interfaces from.
- Return type:
- list_device_user_tags(device_id: str) ListTagsResponse ¶
Get the list of tags for a device.
Get the list of tags for a device.
- Parameters:
device_id (str) – The id of the device to fetch tags for.
- Return type:
- list_devices(*, page_number: int | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, filter_tag: str | UnsetType = UnsetType.unset) ListDevicesResponse ¶
Get the list of devices.
Get the list of devices.
- Parameters:
page_number (int, optional) – The page number to fetch.
page_size (int, optional) – The number of devices to return per page.
sort (str, optional) – The field to sort the devices by.
filter_tag (str, optional) – Filter devices by tag.
- Return type:
- update_device_user_tags(device_id: str, body: ListTagsResponse) ListTagsResponse ¶
Update the tags for a device.
Update the tags for a device.
- Parameters:
device_id (str) – The id of the device to update tags for.
- Return type:
datadog_api_client.v2.api.okta_integration_api module¶
- class OktaIntegrationApi(api_client=None)¶
Bases:
object
Configure your Datadog Okta integration directly through the Datadog API.
- create_okta_account(body: OktaAccountRequest) OktaAccountResponse ¶
Add Okta account.
Create an Okta account.
- Return type:
- delete_okta_account(account_id: str) None ¶
Delete Okta account.
Delete an Okta account.
- Parameters:
account_id (str) – None
- Return type:
None
- get_okta_account(account_id: str) OktaAccountResponse ¶
Get Okta account.
Get an Okta account.
- Parameters:
account_id (str) – None
- Return type:
- list_okta_accounts() OktaAccountsResponse ¶
List Okta accounts.
List Okta accounts.
- Return type:
- update_okta_account(account_id: str, body: OktaAccountUpdateRequest) OktaAccountResponse ¶
Update Okta account.
Update an Okta account.
- Parameters:
account_id (str) – None
- Return type:
datadog_api_client.v2.api.opsgenie_integration_api module¶
- class OpsgenieIntegrationApi(api_client=None)¶
Bases:
object
Configure your Datadog Opsgenie integration directly through the Datadog API.
- create_opsgenie_service(body: OpsgenieServiceCreateRequest) OpsgenieServiceResponse ¶
Create a new service object.
Create a new service object in the Opsgenie integration.
- Parameters:
body (OpsgenieServiceCreateRequest) – Opsgenie service payload
- Return type:
- delete_opsgenie_service(integration_service_id: str) None ¶
Delete a single service object.
Delete a single service object in the Datadog Opsgenie integration.
- Parameters:
integration_service_id (str) – The UUID of the service.
- Return type:
None
- get_opsgenie_service(integration_service_id: str) OpsgenieServiceResponse ¶
Get a single service object.
Get a single service from the Datadog Opsgenie integration.
- Parameters:
integration_service_id (str) – The UUID of the service.
- Return type:
- list_opsgenie_services() OpsgenieServicesResponse ¶
Get all service objects.
Get a list of all services from the Datadog Opsgenie integration.
- Return type:
- update_opsgenie_service(integration_service_id: str, body: OpsgenieServiceUpdateRequest) OpsgenieServiceResponse ¶
Update a single service object.
Update a single service object in the Datadog Opsgenie integration.
- Parameters:
integration_service_id (str) – The UUID of the service.
body (OpsgenieServiceUpdateRequest) – Opsgenie service payload.
- Return type:
datadog_api_client.v2.api.organizations_api module¶
- class OrganizationsApi(api_client=None)¶
Bases:
object
Create, edit, and manage your organizations. Read more about multi-org accounts.
- get_org_config(org_config_name: str) OrgConfigGetResponse ¶
Get a specific Org Config value.
Return the name, description, and value of a specific Org Config.
- Parameters:
org_config_name (str) – The name of an Org Config.
- Return type:
- list_org_configs() OrgConfigListResponse ¶
List Org Configs.
Returns all Org Configs (name, description, and value).
- Return type:
- update_org_config(org_config_name: str, body: OrgConfigWriteRequest) OrgConfigGetResponse ¶
Update a specific Org Config.
Update the value of a specific Org Config.
- Parameters:
org_config_name (str) – The name of an Org Config.
- Return type:
- upload_idp_metadata(*, idp_file: IOBase | UnsetType = UnsetType.unset) None ¶
Upload IdP metadata.
Endpoint for uploading IdP metadata for SAML setup.
Use this endpoint to upload or replace IdP metadata for SAML login configuration.
- Parameters:
idp_file (file_type, optional) – The IdP metadata XML file
- Return type:
None
datadog_api_client.v2.api.powerpack_api module¶
- class PowerpackApi(api_client=None)¶
Bases:
object
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.
Read Scale Graphing Expertise with Powerpacks for more information.
- create_powerpack(body: Powerpack) PowerpackResponse ¶
Create a new powerpack.
Create a powerpack.
- Parameters:
body (Powerpack) – Create a powerpack request body.
- Return type:
- delete_powerpack(powerpack_id: str) None ¶
Delete a powerpack.
Delete a powerpack.
- Parameters:
powerpack_id (str) – Powerpack id
- Return type:
None
- get_powerpack(powerpack_id: str) PowerpackResponse ¶
Get a Powerpack.
Get a powerpack.
- Parameters:
powerpack_id (str) – ID of the powerpack.
- Return type:
- list_powerpacks(*, page_limit: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset) ListPowerpacksResponse ¶
Get all powerpacks.
Get a list of all powerpacks.
- Parameters:
page_limit (int, optional) – Maximum number of powerpacks in the response.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
- Return type:
- list_powerpacks_with_pagination(*, page_limit: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset) Iterable[PowerpackData] ¶
Get all powerpacks.
Provide a paginated version of
list_powerpacks()
, returning all items.- Parameters:
page_limit (int, optional) – Maximum number of powerpacks in the response.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[PowerpackData]
- update_powerpack(powerpack_id: str, body: Powerpack) PowerpackResponse ¶
Update a powerpack.
Update a powerpack.
- Parameters:
powerpack_id (str) – ID of the powerpack.
body (Powerpack) – Update a powerpack request body.
- Return type:
datadog_api_client.v2.api.processes_api module¶
- class ProcessesApi(api_client=None)¶
Bases:
object
The processes API allows you to query processes data for your organization. See the Live Processes page for more information.
- list_processes(*, search: str | UnsetType = UnsetType.unset, tags: str | UnsetType = UnsetType.unset, _from: int | UnsetType = UnsetType.unset, to: int | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset) ProcessSummariesResponse ¶
Get all processes.
Get all processes for your organization.
- Parameters:
search (str, optional) – String to search processes by.
tags (str, optional) – Comma-separated list of tags to filter processes by.
_from (int, optional) – 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 neitherfrom
norto
are provided, the query window will be[now - 15m, now]
.to (int, optional) – 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 neitherfrom
norto
are provided, the query window will be[now - 15m, now]
.page_limit (int, optional) – Maximum number of results returned.
page_cursor (str, optional) – String to query the next page of results. This key is provided with each valid response from the API in
meta.page.after
.
- Return type:
- list_processes_with_pagination(*, search: str | UnsetType = UnsetType.unset, tags: str | UnsetType = UnsetType.unset, _from: int | UnsetType = UnsetType.unset, to: int | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset) Iterable[ProcessSummary] ¶
Get all processes.
Provide a paginated version of
list_processes()
, returning all items.- Parameters:
search (str, optional) – String to search processes by.
tags (str, optional) – Comma-separated list of tags to filter processes by.
_from (int, optional) – 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 neitherfrom
norto
are provided, the query window will be[now - 15m, now]
.to (int, optional) – 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 neitherfrom
norto
are provided, the query window will be[now - 15m, now]
.page_limit (int, optional) – Maximum number of results returned.
page_cursor (str, optional) – String to query the next page of results. This key is provided with each valid response from the API in
meta.page.after
.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[ProcessSummary]
datadog_api_client.v2.api.restriction_policies_api module¶
- class RestrictionPoliciesApi(api_client=None)¶
Bases:
object
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.
- delete_restriction_policy(resource_id: str) None ¶
Delete a restriction policy.
Deletes the restriction policy associated with a specified resource.
- Parameters:
resource_id (str) – Identifier, formatted as
type:id
. Supported types:connection
,dashboard
,notebook
,security-rule
,slo
.- Return type:
None
- get_restriction_policy(resource_id: str) RestrictionPolicyResponse ¶
Get a restriction policy.
Retrieves the restriction policy associated with a specified resource.
- Parameters:
resource_id (str) – Identifier, formatted as
type:id
. Supported types:connection
,dashboard
,notebook
,security-rule
,slo
.- Return type:
- update_restriction_policy(resource_id: str, body: RestrictionPolicyUpdateRequest) RestrictionPolicyResponse ¶
Update a restriction policy.
Updates the restriction policy associated with a resource.
Supported resources
Restriction policies can be applied to the following resources:
Dashboards:
dashboard
Notebooks:
notebook
Powerpacks:
powerpack
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
Supported relations for resources
Resource Type
Supported Relations
Dashboards
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
- Parameters:
resource_id (str) – Identifier, formatted as
type:id
. Supported types:connection
,dashboard
,notebook
,security-rule
,slo
.body (RestrictionPolicyUpdateRequest) – Restriction policy payload
- Return type:
datadog_api_client.v2.api.roles_api module¶
- class RolesApi(api_client=None)¶
Bases:
object
The Roles API is used to create and manage Datadog roles, what global permissions 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.
- add_permission_to_role(role_id: str, body: RelationshipToPermission) PermissionsResponse ¶
Grant permission to a role.
Adds a permission to a role.
- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
- add_user_to_role(role_id: str, body: RelationshipToUser) UsersResponse ¶
Add a user to a role.
Adds a user to a role.
- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
- clone_role(role_id: str, body: RoleCloneRequest) RoleResponse ¶
Create a new role by cloning an existing role.
Clone an existing role
- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
- create_role(body: RoleCreateRequest) RoleCreateResponse ¶
Create role.
Create a new role for your organization.
- Return type:
- delete_role(role_id: str) None ¶
Delete role.
Disables a role.
- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
None
- get_role(role_id: str) RoleResponse ¶
Get a role.
Get a role in the organization specified by the role’s
role_id
.- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
- list_permissions() PermissionsResponse ¶
List permissions.
Returns a list of all permissions, including name, description, and ID.
- Return type:
- list_role_permissions(role_id: str) PermissionsResponse ¶
List permissions for a role.
Returns a list of all permissions for a single role.
- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
- list_role_users(role_id: str, *, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset) UsersResponse ¶
Get all users of a role.
Gets all users of a role.
- Parameters:
role_id (str) – The unique identifier of the role.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (str, optional) – 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
.filter (str, optional) – Filter all users by the given string. Defaults to no filtering.
- Return type:
- list_roles(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: RolesSort | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, filter_id: str | UnsetType = UnsetType.unset) RolesResponse ¶
List roles.
Returns all roles, including their names and their unique identifiers.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (RolesSort, optional) – 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
.filter (str, optional) – Filter all roles by the given string.
filter_id (str, optional) – Filter all roles by the given list of role IDs.
- Return type:
- remove_permission_from_role(role_id: str, body: RelationshipToPermission) PermissionsResponse ¶
Revoke permission.
Removes a permission from a role.
- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
- remove_user_from_role(role_id: str, body: RelationshipToUser) UsersResponse ¶
Remove a user from a role.
Removes a user from a role.
- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
- update_role(role_id: str, body: RoleUpdateRequest) RoleUpdateResponse ¶
Update a role.
Edit a role. Can only be used with application keys belonging to administrators.
- Parameters:
role_id (str) – The unique identifier of the role.
- Return type:
datadog_api_client.v2.api.rum_api module¶
- class RUMApi(api_client=None)¶
Bases:
object
Manage your Real User Monitoring (RUM) applications, and search or aggregate your RUM events over HTTP. See the RUM & Session Replay page for more information
- aggregate_rum_events(body: RUMAggregateRequest) RUMAnalyticsAggregateResponse ¶
Aggregate RUM events.
The API endpoint to aggregate RUM events into buckets of computed metrics and timeseries.
- Return type:
- create_rum_application(body: RUMApplicationCreateRequest) RUMApplicationResponse ¶
Create a new RUM application.
Create a new RUM application in your organization.
- Return type:
- delete_rum_application(id: str) None ¶
Delete a RUM application.
Delete an existing RUM application in your organization.
- Parameters:
id (str) – RUM application ID.
- Return type:
None
- get_rum_application(id: str) RUMApplicationResponse ¶
Get a RUM application.
Get the RUM application with given ID in your organization.
- Parameters:
id (str) – RUM application ID.
- Return type:
- get_rum_applications() RUMApplicationsResponse ¶
List all the RUM applications.
List all the RUM applications in your organization.
- Return type:
- list_rum_events(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: RUMSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) RUMEventsResponse ¶
Get a list of RUM events.
List endpoint returns events that match a RUM search query. Results are paginated.
Use this endpoint to see your latest RUM events.
- Parameters:
filter_query (str, optional) – Search query following RUM syntax.
filter_from (datetime, optional) – Minimum timestamp for requested events.
filter_to (datetime, optional) – Maximum timestamp for requested events.
sort (RUMSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Return type:
- list_rum_events_with_pagination(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: RUMSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[RUMEvent] ¶
Get a list of RUM events.
Provide a paginated version of
list_rum_events()
, returning all items.- Parameters:
filter_query (str, optional) – Search query following RUM syntax.
filter_from (datetime, optional) – Minimum timestamp for requested events.
filter_to (datetime, optional) – Maximum timestamp for requested events.
sort (RUMSort, optional) – Order of events in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of events in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[RUMEvent]
- search_rum_events(body: RUMSearchEventsRequest) RUMEventsResponse ¶
Search RUM events.
List endpoint returns RUM events that match a RUM search query. Results are paginated.
Use this endpoint to build complex RUM events filtering and search.
- Return type:
- search_rum_events_with_pagination(body: RUMSearchEventsRequest) Iterable[RUMEvent] ¶
Search RUM events.
Provide a paginated version of
search_rum_events()
, returning all items.- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[RUMEvent]
- update_rum_application(id: str, body: RUMApplicationUpdateRequest) RUMApplicationResponse ¶
Update a RUM application.
Update the RUM application with given ID in your organization.
- Parameters:
id (str) – RUM application ID.
- Return type:
datadog_api_client.v2.api.rum_metrics_api module¶
- class RumMetricsApi(api_client=None)¶
Bases:
object
Manage configuration of rum-based metrics for your organization.
- create_rum_metric(body: RumMetricCreateRequest) RumMetricResponse ¶
Create a rum-based metric.
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.
- Parameters:
body (RumMetricCreateRequest) – The definition of the new rum-based metric.
- Return type:
- delete_rum_metric(metric_id: str) None ¶
Delete a rum-based metric.
Delete a specific rum-based metric from your organization.
- Parameters:
metric_id (str) – The name of the rum-based metric.
- Return type:
None
- get_rum_metric(metric_id: str) RumMetricResponse ¶
Get a rum-based metric.
Get a specific rum-based metric from your organization.
- Parameters:
metric_id (str) – The name of the rum-based metric.
- Return type:
- list_rum_metrics() RumMetricsResponse ¶
Get all rum-based metrics.
Get the list of configured rum-based metrics with their definitions.
- Return type:
- update_rum_metric(metric_id: str, body: RumMetricUpdateRequest) RumMetricResponse ¶
Update a rum-based metric.
Update a specific rum-based metric from your organization. Returns the rum-based metric object from the request body when the request is successful.
- Parameters:
metric_id (str) – The name of the rum-based metric.
body (RumMetricUpdateRequest) – New definition of the rum-based metric.
- Return type:
datadog_api_client.v2.api.security_monitoring_api module¶
- class SecurityMonitoringApi(api_client=None)¶
Bases:
object
Create and manage your security rules, signals, filters, and more. See the Datadog Security page for more information.
- cancel_historical_job(job_id: str) None ¶
Cancel a historical job.
Cancel a historical job.
- Parameters:
job_id (str) – The ID of the job.
- Return type:
None
- convert_existing_security_monitoring_rule(rule_id: str) SecurityMonitoringRuleConvertResponse ¶
Convert an existing rule from JSON to Terraform.
Convert an existing rule from JSON to Terraform for datadog provider resource datadog_security_monitoring_rule.
- Parameters:
rule_id (str) – The ID of the rule.
- Return type:
- convert_job_result_to_signal(body: ConvertJobResultsToSignalsRequest) None ¶
Convert a job result to a signal.
Convert a job result to a signal.
- Return type:
None
- convert_security_monitoring_rule_from_json_to_terraform(body: SecurityMonitoringRuleConvertPayload | SecurityMonitoringStandardRulePayload | SecurityMonitoringSignalRulePayload) SecurityMonitoringRuleConvertResponse ¶
Convert a rule from JSON to Terraform.
Convert a rule that doesn’t (yet) exist from JSON to Terraform for datadog provider resource datadog_security_monitoring_rule.
- Return type:
- create_security_filter(body: SecurityFilterCreateRequest) SecurityFilterResponse ¶
Create a security filter.
Create a security filter.
See the security filter guide for more examples.
- Parameters:
body (SecurityFilterCreateRequest) – The definition of the new security filter.
- Return type:
- create_security_monitoring_rule(body: SecurityMonitoringRuleCreatePayload | SecurityMonitoringStandardRuleCreatePayload | SecurityMonitoringSignalRuleCreatePayload | CloudConfigurationRuleCreatePayload) SecurityMonitoringRuleResponse ¶
Create a detection rule.
Create a detection rule.
- Return type:
- create_security_monitoring_suppression(body: SecurityMonitoringSuppressionCreateRequest) SecurityMonitoringSuppressionResponse ¶
Create a suppression rule.
Create a new suppression rule.
- Parameters:
body (SecurityMonitoringSuppressionCreateRequest) – The definition of the new suppression rule.
- Return type:
- delete_historical_job(job_id: str) None ¶
Delete an existing job.
Delete an existing job.
- Parameters:
job_id (str) – The ID of the job.
- Return type:
None
- delete_security_filter(security_filter_id: str) None ¶
Delete a security filter.
Delete a specific security filter.
- Parameters:
security_filter_id (str) – The ID of the security filter.
- Return type:
None
- delete_security_monitoring_rule(rule_id: str) None ¶
Delete an existing rule.
Delete an existing rule. Default rules cannot be deleted.
- Parameters:
rule_id (str) – The ID of the rule.
- Return type:
None
- delete_security_monitoring_suppression(suppression_id: str) None ¶
Delete a suppression rule.
Delete a specific suppression rule.
- Parameters:
suppression_id (str) – The ID of the suppression rule
- Return type:
None
- edit_security_monitoring_signal_assignee(signal_id: str, body: SecurityMonitoringSignalAssigneeUpdateRequest) SecurityMonitoringSignalTriageUpdateResponse ¶
Modify the triage assignee of a security signal.
Modify the triage assignee of a security signal.
- Parameters:
signal_id (str) – The ID of the signal.
body (SecurityMonitoringSignalAssigneeUpdateRequest) – Attributes describing the signal update.
- Return type:
- edit_security_monitoring_signal_incidents(signal_id: str, body: SecurityMonitoringSignalIncidentsUpdateRequest) SecurityMonitoringSignalTriageUpdateResponse ¶
Change the related incidents of a security signal.
Change the related incidents for a security signal.
- Parameters:
signal_id (str) – The ID of the signal.
body (SecurityMonitoringSignalIncidentsUpdateRequest) – Attributes describing the signal update.
- Return type:
- edit_security_monitoring_signal_state(signal_id: str, body: SecurityMonitoringSignalStateUpdateRequest) SecurityMonitoringSignalTriageUpdateResponse ¶
Change the triage state of a security signal.
Change the triage state of a security signal.
- Parameters:
signal_id (str) – The ID of the signal.
body (SecurityMonitoringSignalStateUpdateRequest) – Attributes describing the signal update.
- Return type:
- get_finding(finding_id: str, *, snapshot_timestamp: int | UnsetType = UnsetType.unset) GetFindingResponse ¶
Get a finding.
Returns a single finding with message and resource configuration.
- Parameters:
finding_id (str) – The ID of the finding.
snapshot_timestamp (int, optional) – Return the finding for a given snapshot of time (Unix ms).
- Return type:
- get_historical_job(job_id: str) HistoricalJobResponse ¶
Get a job’s details.
Get a job’s details.
- Parameters:
job_id (str) – The ID of the job.
- Return type:
- get_security_filter(security_filter_id: str) SecurityFilterResponse ¶
Get a security filter.
Get the details of a specific security filter.
See the security filter guide for more examples.
- Parameters:
security_filter_id (str) – The ID of the security filter.
- Return type:
- get_security_monitoring_rule(rule_id: str) SecurityMonitoringRuleResponse ¶
Get a rule’s details.
Get a rule’s details.
- Parameters:
rule_id (str) – The ID of the rule.
- Return type:
- get_security_monitoring_signal(signal_id: str) SecurityMonitoringSignalResponse ¶
Get a signal’s details.
Get a signal’s details.
- Parameters:
signal_id (str) – The ID of the signal.
- Return type:
- get_security_monitoring_suppression(suppression_id: str) SecurityMonitoringSuppressionResponse ¶
Get a suppression rule.
Get the details of a specific suppression rule.
- Parameters:
suppression_id (str) – The ID of the suppression rule
- Return type:
- list_findings(*, page_limit: int | UnsetType = UnsetType.unset, snapshot_timestamp: int | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, filter_tags: str | UnsetType = UnsetType.unset, filter_evaluation_changed_at: str | UnsetType = UnsetType.unset, filter_muted: bool | UnsetType = UnsetType.unset, filter_rule_id: str | UnsetType = UnsetType.unset, filter_rule_name: str | UnsetType = UnsetType.unset, filter_resource_type: str | UnsetType = UnsetType.unset, filter_discovery_timestamp: str | UnsetType = UnsetType.unset, filter_evaluation: FindingEvaluation | UnsetType = UnsetType.unset, filter_status: FindingStatus | UnsetType = UnsetType.unset, filter_vulnerability_type: List[FindingVulnerabilityType] | UnsetType = UnsetType.unset) ListFindingsResponse ¶
List findings.
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 byevaluation_changed_at
orresource_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
andresource_discovery_date
time stamps.An array of associated tags.
- Parameters:
page_limit (int, optional) – Limit the number of findings returned. Must be <= 1000.
snapshot_timestamp (int, optional) – Return findings for a given snapshot of time (Unix ms).
page_cursor (str, optional) – Return the next page of findings pointed to by the cursor.
filter_tags (str, optional) – Return findings that have these associated tags (repeatable).
filter_evaluation_changed_at (str, optional) – Return findings that have changed from pass to fail or vice versa on a specified date (Unix ms) or date range (using comparison operators).
filter_muted (bool, optional) – Set to
true
to return findings that are muted. Set tofalse
to return unmuted findings.filter_rule_id (str, optional) – Return findings for the specified rule ID.
filter_rule_name (str, optional) – Return findings for the specified rule.
filter_resource_type (str, optional) – Return only findings for the specified resource type.
filter_discovery_timestamp (str, optional) – Return findings that were found on a specified date (Unix ms) or date range (using comparison operators).
filter_evaluation (FindingEvaluation, optional) – Return only
pass
orfail
findings.filter_status (FindingStatus, optional) – Return only findings with the specified status.
filter_vulnerability_type ([FindingVulnerabilityType], optional) – Return findings that match the selected vulnerability types (repeatable).
- Return type:
- list_findings_with_pagination(*, page_limit: int | UnsetType = UnsetType.unset, snapshot_timestamp: int | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, filter_tags: str | UnsetType = UnsetType.unset, filter_evaluation_changed_at: str | UnsetType = UnsetType.unset, filter_muted: bool | UnsetType = UnsetType.unset, filter_rule_id: str | UnsetType = UnsetType.unset, filter_rule_name: str | UnsetType = UnsetType.unset, filter_resource_type: str | UnsetType = UnsetType.unset, filter_discovery_timestamp: str | UnsetType = UnsetType.unset, filter_evaluation: FindingEvaluation | UnsetType = UnsetType.unset, filter_status: FindingStatus | UnsetType = UnsetType.unset, filter_vulnerability_type: List[FindingVulnerabilityType] | UnsetType = UnsetType.unset) Iterable[Finding] ¶
List findings.
Provide a paginated version of
list_findings()
, returning all items.- Parameters:
page_limit (int, optional) – Limit the number of findings returned. Must be <= 1000.
snapshot_timestamp (int, optional) – Return findings for a given snapshot of time (Unix ms).
page_cursor (str, optional) – Return the next page of findings pointed to by the cursor.
filter_tags (str, optional) – Return findings that have these associated tags (repeatable).
filter_evaluation_changed_at (str, optional) – Return findings that have changed from pass to fail or vice versa on a specified date (Unix ms) or date range (using comparison operators).
filter_muted (bool, optional) – Set to
true
to return findings that are muted. Set tofalse
to return unmuted findings.filter_rule_id (str, optional) – Return findings for the specified rule ID.
filter_rule_name (str, optional) – Return findings for the specified rule.
filter_resource_type (str, optional) – Return only findings for the specified resource type.
filter_discovery_timestamp (str, optional) – Return findings that were found on a specified date (Unix ms) or date range (using comparison operators).
filter_evaluation (FindingEvaluation, optional) – Return only
pass
orfail
findings.filter_status (FindingStatus, optional) – Return only findings with the specified status.
filter_vulnerability_type ([FindingVulnerabilityType], optional) – Return findings that match the selected vulnerability types (repeatable).
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[Finding]
- list_historical_jobs(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, filter_query: str | UnsetType = UnsetType.unset) ListHistoricalJobsResponse ¶
List historical jobs.
List historical jobs.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (str, optional) – The order of the jobs in results.
filter_query (str, optional) – Query used to filter items from the fetched list.
- Return type:
- list_security_filters() SecurityFiltersResponse ¶
Get all security filters.
Get the list of configured security filters with their definitions.
- Return type:
- list_security_monitoring_rules(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset) SecurityMonitoringListRulesResponse ¶
List rules.
List rules.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
- Return type:
- list_security_monitoring_signals(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: SecurityMonitoringSignalsSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) SecurityMonitoringSignalsListResponse ¶
Get a quick list of security signals.
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.
- Parameters:
filter_query (str, optional) – The search query for security signals.
filter_from (datetime, optional) – The minimum timestamp for requested security signals.
filter_to (datetime, optional) – The maximum timestamp for requested security signals.
sort (SecurityMonitoringSignalsSort, optional) – The order of the security signals in results.
page_cursor (str, optional) – A list of results using the cursor provided in the previous query.
page_limit (int, optional) – The maximum number of security signals in the response.
- Return type:
- list_security_monitoring_signals_with_pagination(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: datetime | UnsetType = UnsetType.unset, filter_to: datetime | UnsetType = UnsetType.unset, sort: SecurityMonitoringSignalsSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[SecurityMonitoringSignal] ¶
Get a quick list of security signals.
Provide a paginated version of
list_security_monitoring_signals()
, returning all items.- Parameters:
filter_query (str, optional) – The search query for security signals.
filter_from (datetime, optional) – The minimum timestamp for requested security signals.
filter_to (datetime, optional) – The maximum timestamp for requested security signals.
sort (SecurityMonitoringSignalsSort, optional) – The order of the security signals in results.
page_cursor (str, optional) – A list of results using the cursor provided in the previous query.
page_limit (int, optional) – The maximum number of security signals in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[SecurityMonitoringSignal]
- list_security_monitoring_suppressions() SecurityMonitoringSuppressionsResponse ¶
Get all suppression rules.
Get the list of all suppression rules.
- Return type:
- mute_findings(body: BulkMuteFindingsRequest) BulkMuteFindingsResponse ¶
Mute or unmute a batch of findings.
Mute or unmute findings.
- Parameters:
body (BulkMuteFindingsRequest) –
Attributes
All findings are updated with the same attributes. The request body must include at least two attributes:
muted
andreason
. 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.
- Return type:
- run_historical_job(body: RunHistoricalJobRequest) JobCreateResponse ¶
Run a historical job.
Run a historical job.
- Return type:
- search_security_monitoring_signals(*, body: SecurityMonitoringSignalListRequest | UnsetType = UnsetType.unset) SecurityMonitoringSignalsListResponse ¶
Get a list of security signals.
Returns security signals that match a search query. Both this endpoint and the GET endpoint can be used interchangeably for listing security signals.
- Return type:
- search_security_monitoring_signals_with_pagination(*, body: SecurityMonitoringSignalListRequest | UnsetType = UnsetType.unset) Iterable[SecurityMonitoringSignal] ¶
Get a list of security signals.
Provide a paginated version of
search_security_monitoring_signals()
, returning all items.- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[SecurityMonitoringSignal]
- test_existing_security_monitoring_rule(rule_id: str, body: SecurityMonitoringRuleTestRequest) SecurityMonitoringRuleTestResponse ¶
Test an existing rule.
Test an existing rule.
- Parameters:
rule_id (str) – The ID of the rule.
- Return type:
- test_security_monitoring_rule(body: SecurityMonitoringRuleTestRequest) SecurityMonitoringRuleTestResponse ¶
Test a rule.
Test a rule.
- Return type:
- update_security_filter(security_filter_id: str, body: SecurityFilterUpdateRequest) SecurityFilterResponse ¶
Update a security filter.
Update a specific security filter. Returns the security filter object when the request is successful.
- Parameters:
security_filter_id (str) – The ID of the security filter.
body (SecurityFilterUpdateRequest) – New definition of the security filter.
- Return type:
- update_security_monitoring_rule(rule_id: str, body: SecurityMonitoringRuleUpdatePayload) SecurityMonitoringRuleResponse ¶
Update an existing rule.
Update an existing rule. When updating
cases
,queries
oroptions
, 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).- Parameters:
rule_id (str) – The ID of the rule.
- Return type:
- update_security_monitoring_suppression(suppression_id: str, body: SecurityMonitoringSuppressionUpdateRequest) SecurityMonitoringSuppressionResponse ¶
Update a suppression rule.
Update a specific suppression rule.
- Parameters:
suppression_id (str) – The ID of the suppression rule
body (SecurityMonitoringSuppressionUpdateRequest) – New definition of the suppression rule. Supports partial updates.
- Return type:
- validate_security_monitoring_rule(body: SecurityMonitoringRuleValidatePayload | SecurityMonitoringStandardRulePayload | SecurityMonitoringSignalRulePayload | CloudConfigurationRulePayload) None ¶
Validate a detection rule.
Validate a detection rule.
- Return type:
None
datadog_api_client.v2.api.sensitive_data_scanner_api module¶
- class SensitiveDataScannerApi(api_client=None)¶
Bases:
object
Create, update, delete, and retrieve sensitive data scanner groups and rules. See the Sensitive Data Scanner page for more information.
- create_scanning_group(body: SensitiveDataScannerGroupCreateRequest) SensitiveDataScannerCreateGroupResponse ¶
Create Scanning Group.
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.
- Return type:
- create_scanning_rule(body: SensitiveDataScannerRuleCreateRequest) SensitiveDataScannerCreateRuleResponse ¶
Create Scanning Rule.
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.
- Return type:
- delete_scanning_group(group_id: str, body: SensitiveDataScannerGroupDeleteRequest) SensitiveDataScannerGroupDeleteResponse ¶
Delete Scanning Group.
Delete a given group.
- Parameters:
group_id (str) – The ID of a group of rules.
- Return type:
- delete_scanning_rule(rule_id: str, body: SensitiveDataScannerRuleDeleteRequest) SensitiveDataScannerRuleDeleteResponse ¶
Delete Scanning Rule.
Delete a given rule.
- Parameters:
rule_id (str) – The ID of the rule.
- Return type:
- list_scanning_groups() SensitiveDataScannerGetConfigResponse ¶
List Scanning Groups.
List all the Scanning groups in your organization.
- Return type:
- list_standard_patterns() SensitiveDataScannerStandardPatternsResponseData ¶
List standard patterns.
Returns all standard patterns.
- Return type:
- reorder_scanning_groups(body: SensitiveDataScannerConfigRequest) SensitiveDataScannerReorderGroupsResponse ¶
Reorder Groups.
Reorder the list of groups.
- Return type:
- update_scanning_group(group_id: str, body: SensitiveDataScannerGroupUpdateRequest) SensitiveDataScannerGroupUpdateResponse ¶
Update Scanning Group.
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.
- Parameters:
group_id (str) – The ID of a group of rules.
- Return type:
- update_scanning_rule(rule_id: str, body: SensitiveDataScannerRuleUpdateRequest) SensitiveDataScannerRuleUpdateResponse ¶
Update Scanning Rule.
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.
- Parameters:
rule_id (str) – The ID of the rule.
- Return type:
datadog_api_client.v2.api.service_accounts_api module¶
- class ServiceAccountsApi(api_client=None)¶
Bases:
object
Create, edit, and disable service accounts. See the Service Accounts page for more information.
- create_service_account(body: ServiceAccountCreateRequest) UserResponse ¶
Create a service account.
Create a service account for your organization.
- Return type:
- create_service_account_application_key(service_account_id: str, body: ApplicationKeyCreateRequest) ApplicationKeyResponse ¶
Create an application key for this service account.
Create an application key for this service account.
- Parameters:
service_account_id (str) – The ID of the service account.
- Return type:
- delete_service_account_application_key(service_account_id: str, app_key_id: str) None ¶
Delete an application key for this service account.
Delete an application key owned by this service account.
- Parameters:
service_account_id (str) – The ID of the service account.
app_key_id (str) – The ID of the application key.
- Return type:
None
- get_service_account_application_key(service_account_id: str, app_key_id: str) PartialApplicationKeyResponse ¶
Get one application key for this service account.
Get an application key owned by this service account.
- Parameters:
service_account_id (str) – The ID of the service account.
app_key_id (str) – The ID of the application key.
- Return type:
- list_service_account_application_keys(service_account_id: str, *, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: ApplicationKeysSort | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, filter_created_at_start: str | UnsetType = UnsetType.unset, filter_created_at_end: str | UnsetType = UnsetType.unset) ListApplicationKeysResponse ¶
List application keys for this service account.
List all application keys available for this service account.
- Parameters:
service_account_id (str) – The ID of the service account.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (ApplicationKeysSort, optional) – 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.
filter (str, optional) – Filter application keys by the specified string.
filter_created_at_start (str, optional) – Only include application keys created on or after the specified date.
filter_created_at_end (str, optional) – Only include application keys created on or before the specified date.
- Return type:
- update_service_account_application_key(service_account_id: str, app_key_id: str, body: ApplicationKeyUpdateRequest) PartialApplicationKeyResponse ¶
Edit an application key for this service account.
Edit an application key owned by this service account.
- Parameters:
service_account_id (str) – The ID of the service account.
app_key_id (str) – The ID of the application key.
- Return type:
datadog_api_client.v2.api.service_definition_api module¶
- class ServiceDefinitionApi(api_client=None)¶
Bases:
object
API to create, update, retrieve and delete service definitions.
- create_or_update_service_definitions(body: ServiceDefinitionsCreateRequest | ServiceDefinitionV2Dot2 | ServiceDefinitionV2Dot1 | ServiceDefinitionV2 | str) ServiceDefinitionCreateResponse ¶
Create or update service definition.
Create or update service definition in the Datadog Service Catalog.
- Parameters:
body (ServiceDefinitionsCreateRequest) – Service Definition YAML/JSON.
- Return type:
- delete_service_definition(service_name: str) None ¶
Delete a single service definition.
Delete a single service definition in the Datadog Service Catalog.
- Parameters:
service_name (str) – The name of the service.
- Return type:
None
- get_service_definition(service_name: str, *, schema_version: ServiceDefinitionSchemaVersions | UnsetType = UnsetType.unset) ServiceDefinitionGetResponse ¶
Get a single service definition.
Get a single service definition from the Datadog Service Catalog.
- Parameters:
service_name (str) – The name of the service.
schema_version (ServiceDefinitionSchemaVersions, optional) – The schema version desired in the response.
- Return type:
- list_service_definitions(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, schema_version: ServiceDefinitionSchemaVersions | UnsetType = UnsetType.unset) ServiceDefinitionsListResponse ¶
Get all service definitions.
Get a list of all service definitions from the Datadog Service Catalog.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
schema_version (ServiceDefinitionSchemaVersions, optional) – The schema version desired in the response.
- Return type:
- list_service_definitions_with_pagination(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, schema_version: ServiceDefinitionSchemaVersions | UnsetType = UnsetType.unset) Iterable[ServiceDefinitionData] ¶
Get all service definitions.
Provide a paginated version of
list_service_definitions()
, returning all items.- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
schema_version (ServiceDefinitionSchemaVersions, optional) – The schema version desired in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[ServiceDefinitionData]
datadog_api_client.v2.api.service_level_objectives_api module¶
- class ServiceLevelObjectivesApi(api_client=None)¶
Bases:
object
Service Level Objectives (SLOs) are a key part of the site reliability engineering toolkit. SLOs provide a framework for defining clear targets around application performance, which ultimately help teams provide a consistent customer experience, balance feature development with platform stability, and improve communication with internal and external users.
- create_slo_report_job(body: SloReportCreateRequest) SLOReportPostResponse ¶
Create a new SLO report.
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
.- Parameters:
body (SloReportCreateRequest) – Create SLO report job request body.
- Return type:
- get_slo_report(report_id: str) str ¶
Get SLO report.
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.
- Parameters:
report_id (str) – The ID of the report job.
- Return type:
str
- get_slo_report_job_status(report_id: str) SLOReportStatusGetResponse ¶
Get SLO report status.
Get the status of the SLO report job.
- Parameters:
report_id (str) – The ID of the report job.
- Return type:
datadog_api_client.v2.api.service_scorecards_api module¶
- class ServiceScorecardsApi(api_client=None)¶
Bases:
object
API to create and update scorecard rules and outcomes. See Service Scorecards for more information.
This feature is currently in BETA. If you have any feedback, contact Datadog support.
- create_scorecard_outcomes_batch(body: OutcomesBatchRequest) OutcomesBatchResponse ¶
Create outcomes batch.
Sets multiple service-rule outcomes in a single batched request.
- Parameters:
body (OutcomesBatchRequest) – Set of scorecard outcomes.
- Return type:
- create_scorecard_rule(body: CreateRuleRequest) CreateRuleResponse ¶
Create a new rule.
Creates a new rule.
- Parameters:
body (CreateRuleRequest) – Rule attributes.
- Return type:
- delete_scorecard_rule(rule_id: str) None ¶
Delete a rule.
Deletes a single rule.
- Parameters:
rule_id (str) – The ID of the rule.
- Return type:
None
- list_scorecard_outcomes(*, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset, fields_outcome: str | UnsetType = UnsetType.unset, fields_rule: str | UnsetType = UnsetType.unset, filter_outcome_service_name: str | UnsetType = UnsetType.unset, filter_outcome_state: str | UnsetType = UnsetType.unset, filter_rule_enabled: bool | UnsetType = UnsetType.unset, filter_rule_id: str | UnsetType = UnsetType.unset, filter_rule_name: str | UnsetType = UnsetType.unset) OutcomesResponse ¶
List all rule outcomes.
Fetches all rule outcomes.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
include (str, optional) – Include related rule details in the response.
fields_outcome (str, optional) – Return only specified values in the outcome attributes.
fields_rule (str, optional) – Return only specified values in the included rule details.
filter_outcome_service_name (str, optional) – Filter the outcomes on a specific service name.
filter_outcome_state (str, optional) – Filter the outcomes by a specific state.
filter_rule_enabled (bool, optional) – Filter outcomes on whether a rule is enabled/disabled.
filter_rule_id (str, optional) – Filter outcomes based on rule ID.
filter_rule_name (str, optional) – Filter outcomes based on rule name.
- Return type:
- list_scorecard_outcomes_with_pagination(*, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset, fields_outcome: str | UnsetType = UnsetType.unset, fields_rule: str | UnsetType = UnsetType.unset, filter_outcome_service_name: str | UnsetType = UnsetType.unset, filter_outcome_state: str | UnsetType = UnsetType.unset, filter_rule_enabled: bool | UnsetType = UnsetType.unset, filter_rule_id: str | UnsetType = UnsetType.unset, filter_rule_name: str | UnsetType = UnsetType.unset) Iterable[OutcomesResponseDataItem] ¶
List all rule outcomes.
Provide a paginated version of
list_scorecard_outcomes()
, returning all items.- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
include (str, optional) – Include related rule details in the response.
fields_outcome (str, optional) – Return only specified values in the outcome attributes.
fields_rule (str, optional) – Return only specified values in the included rule details.
filter_outcome_service_name (str, optional) – Filter the outcomes on a specific service name.
filter_outcome_state (str, optional) – Filter the outcomes by a specific state.
filter_rule_enabled (bool, optional) – Filter outcomes on whether a rule is enabled/disabled.
filter_rule_id (str, optional) – Filter outcomes based on rule ID.
filter_rule_name (str, optional) – Filter outcomes based on rule name.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[OutcomesResponseDataItem]
- list_scorecard_rules(*, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset, filter_rule_id: str | UnsetType = UnsetType.unset, filter_rule_enabled: bool | UnsetType = UnsetType.unset, filter_rule_custom: bool | UnsetType = UnsetType.unset, filter_rule_name: str | UnsetType = UnsetType.unset, filter_rule_description: str | UnsetType = UnsetType.unset, fields_rule: str | UnsetType = UnsetType.unset, fields_scorecard: str | UnsetType = UnsetType.unset) ListRulesResponse ¶
List all rules.
Fetch all rules.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
include (str, optional) – Include related scorecard details in the response.
filter_rule_id (str, optional) – Filter the rules on a rule ID.
filter_rule_enabled (bool, optional) – Filter for enabled rules only.
filter_rule_custom (bool, optional) – Filter for custom rules only.
filter_rule_name (str, optional) – Filter rules on the rule name.
filter_rule_description (str, optional) – Filter rules on the rule description.
fields_rule (str, optional) – Return only specific fields in the response for rule attributes.
fields_scorecard (str, optional) – Return only specific fields in the included response for scorecard attributes.
- Return type:
- list_scorecard_rules_with_pagination(*, page_size: int | UnsetType = UnsetType.unset, page_offset: int | UnsetType = UnsetType.unset, include: str | UnsetType = UnsetType.unset, filter_rule_id: str | UnsetType = UnsetType.unset, filter_rule_enabled: bool | UnsetType = UnsetType.unset, filter_rule_custom: bool | UnsetType = UnsetType.unset, filter_rule_name: str | UnsetType = UnsetType.unset, filter_rule_description: str | UnsetType = UnsetType.unset, fields_rule: str | UnsetType = UnsetType.unset, fields_scorecard: str | UnsetType = UnsetType.unset) Iterable[ListRulesResponseDataItem] ¶
List all rules.
Provide a paginated version of
list_scorecard_rules()
, returning all items.- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
include (str, optional) – Include related scorecard details in the response.
filter_rule_id (str, optional) – Filter the rules on a rule ID.
filter_rule_enabled (bool, optional) – Filter for enabled rules only.
filter_rule_custom (bool, optional) – Filter for custom rules only.
filter_rule_name (str, optional) – Filter rules on the rule name.
filter_rule_description (str, optional) – Filter rules on the rule description.
fields_rule (str, optional) – Return only specific fields in the response for rule attributes.
fields_scorecard (str, optional) – Return only specific fields in the included response for scorecard attributes.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[ListRulesResponseDataItem]
- update_scorecard_rule(rule_id: str, body: UpdateRuleRequest) UpdateRuleResponse ¶
Update an existing rule.
Updates an existing rule.
- Parameters:
rule_id (str) – The ID of the rule.
body (UpdateRuleRequest) – Rule attributes.
- Return type:
datadog_api_client.v2.api.software_catalog_api module¶
- class SoftwareCatalogApi(api_client=None)¶
Bases:
object
API to create, update, retrieve, and delete Software Catalog entities.
- delete_catalog_entity(entity_id: str) None ¶
Delete a single entity.
Delete a single entity in Software Catalog.
- Parameters:
entity_id (str) – UUID or Entity Ref.
- Return type:
None
- list_catalog_entity(*, page_offset: int | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset, filter_id: str | UnsetType = UnsetType.unset, filter_ref: str | UnsetType = UnsetType.unset, filter_name: str | UnsetType = UnsetType.unset, filter_kind: str | UnsetType = UnsetType.unset, filter_owner: str | UnsetType = UnsetType.unset, filter_relation_type: RelationType | UnsetType = UnsetType.unset, filter_exclude_snapshot: str | UnsetType = UnsetType.unset, include: IncludeType | UnsetType = UnsetType.unset) ListEntityCatalogResponse ¶
Get a list of entities.
Get a list of entities from Software Catalog.
- Parameters:
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
page_limit (int, optional) – Maximum number of entities in the response.
filter_id (str, optional) – Filter entities by UUID.
filter_ref (str, optional) – Filter entities by reference
filter_name (str, optional) – Filter entities by name.
filter_kind (str, optional) – Filter entities by kind.
filter_owner (str, optional) – Filter entities by owner.
filter_relation_type (RelationType, optional) – Filter entities by relation type.
filter_exclude_snapshot (str, optional) – Filter entities by excluding snapshotted entities.
include (IncludeType, optional) – Include relationship data.
- Return type:
- list_catalog_entity_with_pagination(*, page_offset: int | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset, filter_id: str | UnsetType = UnsetType.unset, filter_ref: str | UnsetType = UnsetType.unset, filter_name: str | UnsetType = UnsetType.unset, filter_kind: str | UnsetType = UnsetType.unset, filter_owner: str | UnsetType = UnsetType.unset, filter_relation_type: RelationType | UnsetType = UnsetType.unset, filter_exclude_snapshot: str | UnsetType = UnsetType.unset, include: IncludeType | UnsetType = UnsetType.unset) Iterable[EntityData] ¶
Get a list of entities.
Provide a paginated version of
list_catalog_entity()
, returning all items.- Parameters:
page_offset (int, optional) – Specific offset to use as the beginning of the returned page.
page_limit (int, optional) – Maximum number of entities in the response.
filter_id (str, optional) – Filter entities by UUID.
filter_ref (str, optional) – Filter entities by reference
filter_name (str, optional) – Filter entities by name.
filter_kind (str, optional) – Filter entities by kind.
filter_owner (str, optional) – Filter entities by owner.
filter_relation_type (RelationType, optional) – Filter entities by relation type.
filter_exclude_snapshot (str, optional) – Filter entities by excluding snapshotted entities.
include (IncludeType, optional) – Include relationship data.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[EntityData]
- upsert_catalog_entity(body: UpsertCatalogEntityRequest | EntityV3 | str) UpsertCatalogEntityResponse ¶
Create or update entities.
Create or update entities in Software Catalog.
- Parameters:
body (UpsertCatalogEntityRequest) – Entity YAML or JSON.
- Return type:
datadog_api_client.v2.api.spans_api module¶
- class SpansApi(api_client=None)¶
Bases:
object
Search and aggregate your spans from your Datadog platform over HTTP.
- aggregate_spans(body: SpansAggregateRequest) SpansAggregateResponse ¶
Aggregate spans.
The API endpoint to aggregate spans into buckets and compute metrics and timeseries. This endpoint is rate limited to
300
requests per hour.- Return type:
- list_spans(body: SpansListRequest) SpansListResponse ¶
Search spans.
List endpoint returns spans that match a span search query. Results are paginated.
Use this endpoint to build complex spans filtering and search. This endpoint is rate limited to
300
requests per hour.- Return type:
- list_spans_get(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: str | UnsetType = UnsetType.unset, filter_to: str | UnsetType = UnsetType.unset, sort: SpansSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) SpansListResponse ¶
Get a list of spans.
List endpoint returns spans that match a span search query. Results are paginated.
Use this endpoint to see your latest spans. This endpoint is rate limited to
300
requests per hour.- Parameters:
filter_query (str, optional) – Search query following spans syntax.
filter_from (str, optional) – Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
filter_to (str, optional) – Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
sort (SpansSort, optional) – Order of spans in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of spans in the response.
- Return type:
- list_spans_get_with_pagination(*, filter_query: str | UnsetType = UnsetType.unset, filter_from: str | UnsetType = UnsetType.unset, filter_to: str | UnsetType = UnsetType.unset, sort: SpansSort | UnsetType = UnsetType.unset, page_cursor: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset) Iterable[Span] ¶
Get a list of spans.
Provide a paginated version of
list_spans_get()
, returning all items.- Parameters:
filter_query (str, optional) – Search query following spans syntax.
filter_from (str, optional) – Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
filter_to (str, optional) – Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
sort (SpansSort, optional) – Order of spans in results.
page_cursor (str, optional) – List following results with a cursor provided in the previous query.
page_limit (int, optional) – Maximum number of spans in the response.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[Span]
- list_spans_with_pagination(body: SpansListRequest) Iterable[Span] ¶
Search spans.
Provide a paginated version of
list_spans()
, returning all items.- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[Span]
datadog_api_client.v2.api.spans_metrics_api module¶
- class SpansMetricsApi(api_client=None)¶
Bases:
object
Manage configuration of span-based metrics for your organization. See Generate Metrics from Spans for more information.
- create_spans_metric(body: SpansMetricCreateRequest) SpansMetricResponse ¶
Create a span-based metric.
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.
- Parameters:
body (SpansMetricCreateRequest) – The definition of the new span-based metric.
- Return type:
- delete_spans_metric(metric_id: str) None ¶
Delete a span-based metric.
Delete a specific span-based metric from your organization.
- Parameters:
metric_id (str) – The name of the span-based metric.
- Return type:
None
- get_spans_metric(metric_id: str) SpansMetricResponse ¶
Get a span-based metric.
Get a specific span-based metric from your organization.
- Parameters:
metric_id (str) – The name of the span-based metric.
- Return type:
- list_spans_metrics() SpansMetricsResponse ¶
Get all span-based metrics.
Get the list of configured span-based metrics with their definitions.
- Return type:
- update_spans_metric(metric_id: str, body: SpansMetricUpdateRequest) SpansMetricResponse ¶
Update a span-based metric.
Update a specific span-based metric from your organization. Returns the span-based metric object from the request body when the request is successful.
- Parameters:
metric_id (str) – The name of the span-based metric.
body (SpansMetricUpdateRequest) – New definition of the span-based metric.
- Return type:
datadog_api_client.v2.api.synthetics_api module¶
- class SyntheticsApi(api_client=None)¶
Bases:
object
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 and browser tests. You can use Datadog’s API to manage both test types programmatically.
For more information about Synthetics, see the Synthetics overview.
- get_on_demand_concurrency_cap() OnDemandConcurrencyCapResponse ¶
Get the on-demand concurrency cap.
Get the on-demand concurrency cap.
- Return type:
- set_on_demand_concurrency_cap(body: OnDemandConcurrencyCapAttributes) OnDemandConcurrencyCapResponse ¶
Save new value for on-demand concurrency cap.
Save new value for on-demand concurrency cap.
- Parameters:
body (OnDemandConcurrencyCapAttributes) –
.
- Return type:
datadog_api_client.v2.api.teams_api module¶
- class TeamsApi(api_client=None)¶
Bases:
object
View and manage teams within Datadog. See the Teams page for more information.
- create_team(body: TeamCreateRequest) TeamResponse ¶
Create a team.
Create a new team. User IDs passed through the
users
relationship field are added to the team.- Return type:
- create_team_link(team_id: str, body: TeamLinkCreateRequest) TeamLinkResponse ¶
Create a team link.
Add a new link to a team.
- Parameters:
team_id (str) – None
- Return type:
- create_team_membership(team_id: str, body: UserTeamRequest) UserTeamResponse ¶
Add a user to a team.
Add a user to a team.
- Parameters:
team_id (str) – None
- Return type:
- delete_team(team_id: str) None ¶
Remove a team.
Remove a team using the team’s
id
.- Parameters:
team_id (str) – None
- Return type:
None
- delete_team_link(team_id: str, link_id: str) None ¶
Remove a team link.
Remove a link from a team.
- Parameters:
team_id (str) – None
link_id (str) – None
- Return type:
None
- delete_team_membership(team_id: str, user_id: str) None ¶
Remove a user from a team.
Remove a user from a team.
- Parameters:
team_id (str) – None
user_id (str) – None
- Return type:
None
- get_team(team_id: str) TeamResponse ¶
Get a team.
Get a single team using the team’s
id
.- Parameters:
team_id (str) – None
- Return type:
- get_team_link(team_id: str, link_id: str) TeamLinkResponse ¶
Get a team link.
Get a single link for a team.
- Parameters:
team_id (str) – None
link_id (str) – None
- Return type:
- get_team_links(team_id: str) TeamLinksResponse ¶
Get links for a team.
Get all links for a given team.
- Parameters:
team_id (str) – None
- Return type:
- get_team_memberships(team_id: str, *, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: GetTeamMembershipsSort | UnsetType = UnsetType.unset, filter_keyword: str | UnsetType = UnsetType.unset) UserTeamsResponse ¶
Get team memberships.
Get a paginated list of members for a team
- Parameters:
team_id (str) – None
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (GetTeamMembershipsSort, optional) – Specifies the order of returned team memberships
filter_keyword (str, optional) – Search query, can be user email or name
- Return type:
- get_team_memberships_with_pagination(team_id: str, *, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: GetTeamMembershipsSort | UnsetType = UnsetType.unset, filter_keyword: str | UnsetType = UnsetType.unset) Iterable[UserTeam] ¶
Get team memberships.
Provide a paginated version of
get_team_memberships()
, returning all items.- Parameters:
team_id (str) – None
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (GetTeamMembershipsSort, optional) – Specifies the order of returned team memberships
filter_keyword (str, optional) – Search query, can be user email or name
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[UserTeam]
- get_team_permission_settings(team_id: str) TeamPermissionSettingsResponse ¶
Get permission settings for a team.
Get all permission settings for a given team.
- Parameters:
team_id (str) – None
- Return type:
- get_user_memberships(user_uuid: str) UserTeamsResponse ¶
Get user memberships.
Get a list of memberships for a user
- Parameters:
user_uuid (str) – None
- Return type:
- list_teams(*, page_number: int | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, sort: ListTeamsSort | UnsetType = UnsetType.unset, include: List[ListTeamsInclude] | UnsetType = UnsetType.unset, filter_keyword: str | UnsetType = UnsetType.unset, filter_me: bool | UnsetType = UnsetType.unset, fields_team: List[TeamsField] | UnsetType = UnsetType.unset) TeamsResponse ¶
Get all teams.
Get all teams. Can be used to search for teams using the
filter[keyword]
andfilter[me]
query parameters.- Parameters:
page_number (int, optional) – Specific page number to return.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
sort (ListTeamsSort, optional) – Specifies the order of the returned teams
include ([ListTeamsInclude], optional) – Included related resources optionally requested. Allowed enum values:
team_links, user_team_permissions
filter_keyword (str, optional) – Search query. Can be team name, team handle, or email of team member
filter_me (bool, optional) – When true, only returns teams the current user belongs to
fields_team ([TeamsField], optional) – List of fields that need to be fetched.
- Return type:
- list_teams_with_pagination(*, page_number: int | UnsetType = UnsetType.unset, page_size: int | UnsetType = UnsetType.unset, sort: ListTeamsSort | UnsetType = UnsetType.unset, include: List[ListTeamsInclude] | UnsetType = UnsetType.unset, filter_keyword: str | UnsetType = UnsetType.unset, filter_me: bool | UnsetType = UnsetType.unset, fields_team: List[TeamsField] | UnsetType = UnsetType.unset) Iterable[Team] ¶
Get all teams.
Provide a paginated version of
list_teams()
, returning all items.- Parameters:
page_number (int, optional) – Specific page number to return.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
sort (ListTeamsSort, optional) – Specifies the order of the returned teams
include ([ListTeamsInclude], optional) – Included related resources optionally requested. Allowed enum values:
team_links, user_team_permissions
filter_keyword (str, optional) – Search query. Can be team name, team handle, or email of team member
filter_me (bool, optional) – When true, only returns teams the current user belongs to
fields_team ([TeamsField], optional) – List of fields that need to be fetched.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[Team]
- update_team(team_id: str, body: TeamUpdateRequest) TeamResponse ¶
Update a team.
Update a team using the team’s
id
. If theteam_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.- Parameters:
team_id (str) – None
- Return type:
- update_team_link(team_id: str, link_id: str, body: TeamLinkCreateRequest) TeamLinkResponse ¶
Update a team link.
Update a team link.
- Parameters:
team_id (str) – None
link_id (str) – None
- Return type:
- update_team_membership(team_id: str, user_id: str, body: UserTeamUpdateRequest) UserTeamResponse ¶
Update a user’s membership attributes on a team.
Update a user’s membership attributes on a team.
- Parameters:
team_id (str) – None
user_id (str) – None
- Return type:
- update_team_permission_setting(team_id: str, action: str, body: TeamPermissionSettingUpdateRequest) TeamPermissionSettingResponse ¶
Update permission setting for team.
Update a team permission setting for a given team.
- Parameters:
team_id (str) – None
action (str) – None
- Return type:
datadog_api_client.v2.api.usage_metering_api module¶
- class UsageMeteringApi(api_client=None)¶
Bases:
object
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.
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. Learn more on the usage details documentation.
- get_active_billing_dimensions() ActiveBillingDimensionsResponse ¶
Get active billing dimensions for cost attribution.
Get active billing dimensions for cost attribution. Cost data for a given month becomes available no later than the 19th of the following month.
- Return type:
- get_billing_dimension_mapping(*, filter_month: datetime | UnsetType = UnsetType.unset, filter_view: str | UnsetType = UnsetType.unset) BillingDimensionsMappingResponse ¶
Get billing dimension mapping for usage endpoints.
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.
- Parameters:
filter_month (datetime, optional) – Datetime in ISO-8601 format, UTC, and for mappings beginning this month. Defaults to the current month.
filter_view (str, optional) – String to specify whether to retrieve active billing dimension mappings for the contract or for all available mappings. Allowed views have the string
active
orall
. Defaults toactive
.
- Return type:
- get_cost_by_org(start_month: datetime, *, end_month: datetime | UnsetType = UnsetType.unset) CostByOrgResponse ¶
Get cost across multi-org account. Deprecated.
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.
- Parameters:
start_month (datetime) – Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost beginning this month.end_month (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost ending this month.
- Return type:
- get_estimated_cost_by_org(*, view: str | UnsetType = UnsetType.unset, start_month: datetime | UnsetType = UnsetType.unset, end_month: datetime | UnsetType = UnsetType.unset, start_date: datetime | UnsetType = UnsetType.unset, end_date: datetime | UnsetType = UnsetType.unset, include_connected_accounts: bool | UnsetType = UnsetType.unset) CostByOrgResponse ¶
Get estimated cost across your account.
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.
- Parameters:
view (str, optional) – String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are
summary
andsub-org
. Defaults tosummary
.start_month (datetime, optional) – 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 anend_month
to view month-over-month cost.end_month (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost ending this month.start_date (datetime, optional) – 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 anend_date
to view day-over-day cumulative cost.end_date (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to day:
[YYYY-MM-DD]
for cost ending this day.include_connected_accounts (bool, optional) – Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to
false
.
- Return type:
- get_historical_cost_by_org(start_month: datetime, *, view: str | UnsetType = UnsetType.unset, end_month: datetime | UnsetType = UnsetType.unset, include_connected_accounts: bool | UnsetType = UnsetType.unset) CostByOrgResponse ¶
Get historical cost across your account.
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.
- Parameters:
start_month (datetime) – Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost beginning this month.view (str, optional) – String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are
summary
andsub-org
. Defaults tosummary
.end_month (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost ending this month.include_connected_accounts (bool, optional) – Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to
false
.
- Return type:
- get_hourly_usage(filter_timestamp_start: datetime, filter_product_families: str, *, filter_timestamp_end: datetime | UnsetType = UnsetType.unset, filter_include_descendants: bool | UnsetType = UnsetType.unset, filter_include_connected_accounts: bool | UnsetType = UnsetType.unset, filter_include_breakdown: bool | UnsetType = UnsetType.unset, filter_versions: str | UnsetType = UnsetType.unset, page_limit: int | UnsetType = UnsetType.unset, page_next_record_id: str | UnsetType = UnsetType.unset) HourlyUsageResponse ¶
Get hourly usage by product family.
Get hourly usage by product family.
- Parameters:
filter_timestamp_start (datetime) – Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] for usage beginning at this hour.
filter_product_families (str) – 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
,logs
,network_flows
,network_hosts
,network_monitoring
,observability_pipelines
,online_archive
,profiling
,rum
,rum_browser_sessions
,rum_mobile_sessions
,sds
,snmp
,software_delivery
,synthetics_api
,synthetics_browser
,synthetics_mobile
,synthetics_parallel_testing
,timeseries
,vuln_management
, andworkflow_executions
. The following product family has been deprecated :audit_logs
.filter_timestamp_end (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to hour: [YYYY-MM-DDThh] for usage ending before this hour.
filter_include_descendants (bool, optional) – Include child org usage in the response. Defaults to false.
filter_include_connected_accounts (bool, optional) – Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to false.
filter_include_breakdown (bool, optional) – Include breakdown of usage by subcategories where applicable (for product family logs only). Defaults to false.
filter_versions (str, optional) – 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 version1.0.0
.page_limit (int, optional) – Maximum number of results to return (between 1 and 500) - defaults to 500 if limit not specified.
page_next_record_id (str, optional) – List following results with a next_record_id provided in the previous query.
- Return type:
- get_monthly_cost_attribution(start_month: datetime, fields: str, *, end_month: datetime | UnsetType = UnsetType.unset, sort_direction: SortDirection | UnsetType = UnsetType.unset, sort_name: str | UnsetType = UnsetType.unset, tag_breakdown_keys: str | UnsetType = UnsetType.unset, next_record_id: str | UnsetType = UnsetType.unset, include_descendants: bool | UnsetType = UnsetType.unset) MonthlyCostAttributionResponse ¶
Get Monthly Cost Attribution.
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 passnext_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.
- Parameters:
start_month (datetime) – Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost beginning in this month.fields (str) – Comma-separated list specifying cost types (e.g.,
<billing_dimension>_on_demand_cost
,<billing_dimension>_committed_cost
,<billing_dimension>_total_cost
) and the proportions (<billing_dimension>_percentage_in_org
,<billing_dimension>_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<billing_dimension>
in the field names, make a request to the Get active billing dimensions API.end_month (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to month:
[YYYY-MM]
for cost ending this month.sort_direction (SortDirection, optional) – The direction to sort by:
[desc, asc]
.sort_name (str, optional) – The billing dimension to sort by. Always sorted by total cost. Example:
infra_host
.tag_breakdown_keys (str, optional) – 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.next_record_id (str, optional) – List following results with a next_record_id provided in the previous query.
include_descendants (bool, optional) – Include child org cost in the response. Defaults to
true
.
- Return type:
- get_projected_cost(*, view: str | UnsetType = UnsetType.unset, include_connected_accounts: bool | UnsetType = UnsetType.unset) ProjectedCostResponse ¶
Get projected cost across your account.
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.
- Parameters:
view (str, optional) – String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are
summary
andsub-org
. Defaults tosummary
.include_connected_accounts (bool, optional) – Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to
false
.
- Return type:
- get_usage_application_security_monitoring(start_hr: datetime, *, end_hr: datetime | UnsetType = UnsetType.unset) UsageApplicationSecurityMonitoringResponse ¶
Get hourly usage for application security. Deprecated.
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
- Parameters:
start_hr (datetime) – Datetime in ISO-8601 format, UTC, precise to hour:
[YYYY-MM-DDThh]
for usage beginning at this hour.end_hr (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to hour:
[YYYY-MM-DDThh]
for usage ending before this hour.
- Return type:
- get_usage_lambda_traced_invocations(start_hr: datetime, *, end_hr: datetime | UnsetType = UnsetType.unset) UsageLambdaTracedInvocationsResponse ¶
Get hourly usage for Lambda traced invocations. Deprecated.
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
- Parameters:
start_hr (datetime) – Datetime in ISO-8601 format, UTC, precise to hour:
[YYYY-MM-DDThh]
for usage beginning at this hour.end_hr (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to hour:
[YYYY-MM-DDThh]
for usage ending before this hour.
- Return type:
- get_usage_observability_pipelines(start_hr: datetime, *, end_hr: datetime | UnsetType = UnsetType.unset) UsageObservabilityPipelinesResponse ¶
Get hourly usage for observability pipelines. Deprecated.
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
- Parameters:
start_hr (datetime) – Datetime in ISO-8601 format, UTC, precise to hour:
[YYYY-MM-DDThh]
for usage beginning at this hour.end_hr (datetime, optional) – Datetime in ISO-8601 format, UTC, precise to hour:
[YYYY-MM-DDThh]
for usage ending before this hour.
- Return type:
datadog_api_client.v2.api.users_api module¶
- class UsersApi(api_client=None)¶
Bases:
object
Create, edit, and disable users.
- create_user(body: UserCreateRequest) UserResponse ¶
Create a user.
Create a user for your organization.
- Return type:
- disable_user(user_id: str) None ¶
Disable a user.
Disable a user. Can only be used with an application key belonging to an administrator user.
- Parameters:
user_id (str) – The ID of the user.
- Return type:
None
- get_invitation(user_invitation_uuid: str) UserInvitationResponse ¶
Get a user invitation.
Returns a single user invitation by its UUID.
- Parameters:
user_invitation_uuid (str) – The UUID of the user invitation.
- Return type:
- get_user(user_id: str) UserResponse ¶
Get user details.
Get a user in the organization specified by the user’s
user_id
.- Parameters:
user_id (str) – The ID of the user.
- Return type:
- list_user_organizations(user_id: str) UserResponse ¶
Get a user organization.
Get a user organization. Returns the user information and all organizations joined by this user.
- Parameters:
user_id (str) – The ID of the user.
- Return type:
- list_user_permissions(user_id: str) PermissionsResponse ¶
Get a user permissions.
Get a user permission set. Returns a list of the user’s permissions granted by the associated user’s roles.
- Parameters:
user_id (str) – The ID of the user.
- Return type:
- list_users(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, sort_dir: QuerySortOrder | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, filter_status: str | UnsetType = UnsetType.unset) UsersResponse ¶
List all users.
Get the list of all users in the organization. This list includes all users even if they are deactivated or unverified.
- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (str, optional) – 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
.sort_dir (QuerySortOrder, optional) – Direction of sort. Options:
asc
,desc
.filter (str, optional) – Filter all users by the given string. Defaults to no filtering.
filter_status (str, optional) – Filter on status attribute. Comma separated list, with possible values
Active
,Pending
, andDisabled
. Defaults to no filtering.
- Return type:
- list_users_with_pagination(*, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset, sort: str | UnsetType = UnsetType.unset, sort_dir: QuerySortOrder | UnsetType = UnsetType.unset, filter: str | UnsetType = UnsetType.unset, filter_status: str | UnsetType = UnsetType.unset) Iterable[User] ¶
List all users.
Provide a paginated version of
list_users()
, returning all items.- Parameters:
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
sort (str, optional) – 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
.sort_dir (QuerySortOrder, optional) – Direction of sort. Options:
asc
,desc
.filter (str, optional) – Filter all users by the given string. Defaults to no filtering.
filter_status (str, optional) – Filter on status attribute. Comma separated list, with possible values
Active
,Pending
, andDisabled
. Defaults to no filtering.
- Returns:
A generator of paginated results.
- Return type:
collections.abc.Iterable[User]
- send_invitations(body: UserInvitationsRequest) UserInvitationsResponse ¶
Send invitation emails.
Sends emails to one or more users inviting them to join the organization.
- Return type:
- update_user(user_id: str, body: UserUpdateRequest) UserResponse ¶
Update a user.
Edit a user. Can only be used with an application key belonging to an administrator user.
- Parameters:
user_id (str) – The ID of the user.
- Return type:
datadog_api_client.v2.api.workflow_automation_api module¶
- class WorkflowAutomationApi(api_client=None)¶
Bases:
object
Automate your teams operational processes with Datadog Workflow Automation.
- cancel_workflow_instance(workflow_id: str, instance_id: str) WorklflowCancelInstanceResponse ¶
Cancel a workflow instance.
Cancels a specific execution of a given workflow. This API requires an application key scoped with the workflows_run permission.
- Parameters:
workflow_id (str) – The ID of the workflow.
instance_id (str) – The ID of the workflow instance.
- Return type:
- create_workflow_instance(workflow_id: str, body: WorkflowInstanceCreateRequest) WorkflowInstanceCreateResponse ¶
Execute a workflow.
Execute the given workflow. This API requires an application key scoped with the workflows_run permission.
- Parameters:
workflow_id (str) – The ID of the workflow.
- Return type:
- get_workflow_instance(workflow_id: str, instance_id: str) WorklflowGetInstanceResponse ¶
Get a workflow instance.
Get a specific execution of a given workflow. This API requires an application key scoped with the workflows_read permission.
- Parameters:
workflow_id (str) – The ID of the workflow.
instance_id (str) – The ID of the workflow instance.
- Return type:
- list_workflow_instances(workflow_id: str, *, page_size: int | UnsetType = UnsetType.unset, page_number: int | UnsetType = UnsetType.unset) WorkflowListInstancesResponse ¶
List workflow instances.
List all instances of a given workflow. This API requires an application key scoped with the workflows_read permission.
- Parameters:
workflow_id (str) – The ID of the workflow.
page_size (int, optional) – Size for a given page. The maximum allowed value is 100.
page_number (int, optional) – Specific page number to return.
- Return type: