Skip to main content

subdomain

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

Overview

Namesubdomain
TypeResource
Idsumologic.account.subdomain

Fields

The following fields are returned by SELECT queries:

The subdomain's definition.

NameDatatypeDescription
createdAtstring (date-time)Creation timestamp in UTC in RFC3339 format.
createdBystringIdentifier of the user who created the resource.
modifiedAtstring (date-time)Last modification timestamp in UTC.
modifiedBystringIdentifier of the user who last modified the resource.
subdomainstringThe new subdomain. (example: my-company)
urlstringLogin URL corresponding to the subdomain. (example: https://your-company.sumologic.com)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getSubdomainselectregionGet the configured subdomain.
createSubdomaininsertregion, data__subdomainCreate a subdomain. Only the Account Owner can create a subdomain.
deleteSubdomaindeleteregionDelete the configured subdomain.
updateSubdomainexecregion, subdomainUpdate a subdomain. Only the Account Owner can update the subdomain.

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
regionstringSumoLogic region (enum: [us2, au, ca, de, eu, fed, in, jp], default: us2)

SELECT examples

Get the configured subdomain.

SELECT
createdAt,
createdBy,
modifiedAt,
modifiedBy,
subdomain,
url
FROM sumologic.account.subdomain
WHERE region = '{{ region }}' -- required
;

INSERT examples

Create a subdomain. Only the Account Owner can create a subdomain.

INSERT INTO sumologic.account.subdomain (
data__subdomain,
region
)
SELECT
'{{ subdomain }}' /* required */,
'{{ region }}'
RETURNING
createdAt,
createdBy,
modifiedAt,
modifiedBy,
subdomain,
url
;

DELETE examples

Delete the configured subdomain.

DELETE FROM sumologic.account.subdomain
WHERE region = '{{ region }}' --required
;

Lifecycle Methods

Update a subdomain. Only the Account Owner can update the subdomain.

EXEC sumologic.account.subdomain.updateSubdomain 
@region='{{ region }}' --required
@@json=
'{
"subdomain": "{{ subdomain }}"
}'
;