Skip to main content

personal_folder

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

Overview

Namepersonal_folder
TypeResource
Idsumologic.content.personal_folder

Fields

The following fields are returned by SELECT queries:

The personal folder of the current user.<br />

NameDatatypeDescription
idstringIdentifier of the content item. (example: 000000000C1C17C6)
namestringThe name of the content item. (example: Personal)
parent_idstringIdentifier of the parent content item. (example: 0000000001C41EF2) (wire: parentId)
childrenarrayA list of the content items.
created_atstring (date-time)Creation timestamp in UTC in [RFC3339](https:​//tools.ietf.org/html/rfc3339) format. (example: 2018-10-16T09:10:00.000Z) (wire: createdAt)
created_bystringIdentifier of the user who created the resource. (example: 0000000006743FDD) (wire: createdBy)
descriptionstringDescription of the content item. (example: Personal folder for John Doe)
is_scheduledbooleanIndicates whether the content item refers to scheduled search. This field is only relevant to Search content type. (wire: isScheduled)
item_typestringType of the content item. Supported values are: 1. Folder 2. Search 3. Report (for old dashboards) 4. Dashboard (for new dashboards) 5. Lookups (example: Folder) (wire: itemType)
modified_atstring (date-time)Last modification timestamp in UTC. (example: 2018-10-16T09:10:00.000Z) (wire: modifiedAt)
modified_bystringIdentifier of the user who last modified the resource. (example: 0000000006743FE8) (wire: modifiedBy)
permissionsarrayList of permissions the user has on the content item.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectregionGet the personal folder of the current user.

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
regionstringSumo Logic deployment (au, ca, ch, de, eu, fed, in, jp, kr, us1, us2). Resolved from the SUMOLOGIC_ENVIRONMENT environment variable when it is set (x-stackQL-envVar, the same variable the Terraform provider reads); otherwise defaults to us2. A WHERE region = '...' value always takes precedence. (enum: [au, ca, ch, de, eu, fed, in, jp, kr, us1, us2], default: us2, x-stackQL-envVar: SUMOLOGIC_ENVIRONMENT)

SELECT examples

Get the personal folder of the current user.

SELECT
id,
name,
parent_id,
children,
created_at,
created_by,
description,
is_scheduled,
item_type,
modified_at,
modified_by,
permissions
FROM sumologic.content.personal_folder
WHERE region = '{{ region }}' -- required unless SUMOLOGIC_ENVIRONMENT is set
;