seat_assignments
Creates, updates, deletes, gets or lists a seat_assignments resource.
Overview
| Name | seat_assignments |
| Type | Resource |
| Id | datadog.organization.seat_assignments |
Fields
The following fields are returned by SELECT queries:
- get_seats_users
| Name | Datatype | Description |
|---|---|---|
id | string | The ID of the seat user. (example: 00000000-0000-0000-0000-000000000000) |
attributes | object | The attributes of the seat user. |
type | string | Seat users resource type. (seat-users) (default: seat-users, example: seat-users) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_seats_users | select | product_code | page[limit], page[cursor] | Get the list of users assigned seats for a product code. |
assign_seats_user | insert | Assign seats to users for a product code. | ||
unassign_seats_user | delete | Unassign seats from users for a product code. |
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 |
|---|---|---|
product_code | string | The product code for which to retrieve seat users. |
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. |
page[cursor] | string | Cursor for pagination. |
page[limit] | integer (int64) | Maximum number of results to return. |
SELECT examples
- get_seats_users
Get the list of users assigned seats for a product code.
SELECT
id,
attributes,
type
FROM datadog.organization.seat_assignments
WHERE product_code = '{{ product_code }}' -- required
AND page[limit] = '{{ page[limit] }}'
AND page[cursor] = '{{ page[cursor] }}'
;
INSERT examples
- assign_seats_user
- Manifest
Assign seats to users for a product code.
INSERT INTO datadog.organization.seat_assignments (
data
)
SELECT
'{{ data }}'
RETURNING
data
;
# Description fields are for documentation purposes
- name: seat_assignments
props:
- name: data
description: |
The data for the assign seats user request.
value:
attributes:
product_code: "{{ product_code }}"
user_uuids:
- "{{ user_uuids }}"
id: "{{ id }}"
type: "{{ type }}"
DELETE examples
- unassign_seats_user
Unassign seats from users for a product code.
DELETE FROM datadog.organization.seat_assignments
;