Skip to main content

global_orgs

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

Overview

Nameglobal_orgs
TypeResource
Iddatadog.organization.global_orgs

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
attributesobjectAttributes of an organization associated with the authenticated user.
typestringThe resource type for global user organizations. (global_user_orgs) (example: global_user_orgs)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_global_orgsselectuser_handlepage[limit], page[cursor]Returns organizations across regions for the authenticated user. The user_handle query parameter must match the authenticated user's handle.

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
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.
user_handlestringThe handle of the authenticated user.
page[cursor]stringString to query the next page of results. This key is provided with each valid response from the API in meta.page.next_cursor.
page[limit]integer (int32)Maximum number of results returned.

SELECT examples

Returns organizations across regions for the authenticated user. The user_handle query parameter must match the authenticated user's handle.

SELECT
attributes,
type
FROM datadog.organization.global_orgs
WHERE user_handle = '{{ user_handle }}' -- required
AND page[limit] = '{{ page[limit] }}'
AND page[cursor] = '{{ page[cursor] }}'
;