Skip to main content

projects

Creates, updates, deletes, gets or lists a projects resource.

Overview

Nameprojects
TypeResource
Iddatadog.service_management.projects

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe Project's identifier. (example: aeadc05e-98a8-11ec-ac2c-da7ad0900001)
attributesobjectProject attributes.
relationshipsobjectProject relationships.
typestringProject resource type. (project) (default: project, example: project)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_projectselectproject_idGet the details of a project by project_id.
get_projectsselectGet all projects.
create_projectinsertdataCreate a project.
delete_projectdeleteproject_idRemove a project using the project's id.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
project_idstringProject UUID. (example: e555e290-ed65-49bd-ae18-8acbfcf18db7)
sitestringThe Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.

SELECT examples

Get the details of a project by project_id.

SELECT
id,
attributes,
relationships,
type
FROM datadog.service_management.projects
WHERE project_id = '{{ project_id }}' -- required
;

INSERT examples

Create a project.

INSERT INTO datadog.service_management.projects (
data
)
SELECT
'{{ data }}' /* required */
RETURNING
data
;

DELETE examples

Remove a project using the project's id.

DELETE FROM datadog.service_management.projects
WHERE project_id = '{{ project_id }}' --required
;