team_connections

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

Overview

Name	team_connections
Type	Resource
Id	datadog.organization.team_connections

Fields

The following fields are returned by SELECT queries:

list_team_connections

Name	Datatype	Description
id	string	The unique identifier of the team connection. (example: 12345678-1234-5678-9abc-123456789012)
attributes	object	Attributes of the team connection.
relationships	object	Relationships of the team connection.
type	string	Team connection resource type. (team_connection) (default: team_connection, example: team_connection)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_team_connections	select		page[size], page[number], filter[sources], filter[team_ids], filter[connected_team_ids], filter[connection_ids]	Returns all team connections.
create_team_connections	insert	data		Create multiple team connections.
delete_team_connections	delete			Delete multiple team connections.

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.

Name	Datatype	Description
site	string	The 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.
filter[connected_team_ids]	array	Filter team connections by connected team IDs from external systems.
filter[connection_ids]	array	Filter team connections by connection IDs.
filter[sources]	array	Filter team connections by external source systems.
filter[team_ids]	array	Filter team connections by Datadog team IDs.
page[number]	integer (int64)	Specific page number to return.
page[size]	integer (int64)	Number of items to return per page. The maximum allowed value is 100.

SELECT examples

list_team_connections

Returns all team connections.

SELECT
id,
attributes,
relationships,
type
FROM datadog.organization.team_connections
WHERE page[size] = '{{ page[size] }}'
AND page[number] = '{{ page[number] }}'
AND filter[sources] = '{{ filter[sources] }}'
AND filter[team_ids] = '{{ filter[team_ids] }}'
AND filter[connected_team_ids] = '{{ filter[connected_team_ids] }}'
AND filter[connection_ids] = '{{ filter[connection_ids] }}'
;

INSERT examples

create_team_connections

Create multiple team connections.

INSERT INTO datadog.organization.team_connections (
data
)
SELECT 
'{{ data }}' /* required */
RETURNING
data,
meta
;

Manifest

# Description fields are for documentation purposes
- name: team_connections
props:
  - name: data
    description: |
      Array of team connections to create.
    value:
      - attributes:
          managed_by: "{{ managed_by }}"
          source: "{{ source }}"
        relationships:
          connected_team:
            data:
              id: "{{ id }}"
              type: "{{ type }}"
          team:
            data:
              id: "{{ id }}"
              type: "{{ type }}"
        type: "{{ type }}"

DELETE examples

delete_team_connections

Delete multiple team connections.

DELETE FROM datadog.organization.team_connections
;