uip or folders

uip or folders manages Orchestrator folders — the hierarchical containers that scope processes, jobs, assets, queues, and user permissions. Verbs cover listing, creating, moving, editing, and deleting folders, plus a runtimes command that reports machine-runtime allocation inside a folder.

Synopsis

uip or folders <verb> [options]

Verbs

Verb	目的
list	List folders. Default: folders the current user can access; with --all, every folder in the tenant.
create	Create a folder, optionally nested under a parent.
get	Fetch one folder by key or path.
delete	Delete a folder by key or path.
move	Re-parent a folder, or move it to the root.
edit	Update display name and/or description.
runtimes	Show runtime allocation (total / connected / available) per runtime type for a folder.

uip or folders list

List folders. The default view uses GetAllForCurrentUser — folders the caller has access to. With --all, the verb switches to the full Folders endpoint (Standard and Solution folders in the tenant); with --type personal, it switches to the PersonalWorkspaces endpoint. Filtering and sorting flags (--name, --path, --type, --top-level, --order-by) require --all.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	session default	Override the tenant.
-a	--all	flag	off	List all folders in the tenant; required to enable the filter and sort flags below.
-n	--name	text	—	Contains-match on display name. Requires --all.
—	--path	path prefix	—	Filter by folder path prefix (for example, Shared matches Shared and everything below). Requires --all.
—	--type	ENUM	—	standard, solution, or personal. Requires --all. personal switches to the personal-workspaces endpoint.
—	--top-level	flag	off	Only root folders (no parent). Requires --all. Not supported with --type personal.
-l	--limit	Number	50	Page size.
—	--offset	Number	0	Skip count.
—	--order-by	フィールド	—	OData sort (for example, Name asc). Requires --all.
—	--login-validity	分	10	Minimum minutes before token expiry that triggers a pre-request refresh.

例

# Folders the authenticated user can access
uip or folders list

# All tenant folders, filtered and sorted
uip or folders list --all --type standard --name "Prod" --order-by "Name asc"

# Personal workspaces only
uip or folders list --all --type personal

Data shape (--output json)

{
  "Code": "FolderList",
  "Data": [
    {
      "Key": "a1b2c3d4-0000-0000-0000-000000000001",
      "Name": "Shared",
      "Path": "Shared",
      "Description": "",
      "Type": "Standard",
      "ParentKey": ""
    }
  ]
}

With --all, items also include FeedType and PermissionModel. With --type personal, the payload is { Key, Name, OwnerName, OwnerKey, LastLogin }.

uip or folders create

Create a folder, optionally nested under a parent. --parent accepts either a folder GUID or a path (Shared, Production/EU).

引数

名前	Required	目的
<name>	○	Folder display name.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	session default	Override the tenant.
-d	--description	text	—	Folder description.
-p	--parent	key or path	—	Parent folder by GUID or path. Omit for a root folder.
—	--feed-type	ENUM	Processes	Processes, Libraries, FolderHierarchy.
—	--permission-model	ENUM	FineGrained	FineGrained または InheritFromTenant。
—	--provision-type	ENUM	Automatic	Automatic または Manual。

例

uip or folders create "Staging"

uip or folders create "EU" --parent "Production" \
    --description "European workloads"

uip or folders create "Libraries" --feed-type Libraries \
    --permission-model InheritFromTenant

Data shape (--output json)

{
  "Code": "FolderCreated",
  "Data": {
    "Name": "Staging",
    "ID": 103,
    "Key": "a1b2c3d4-0000-0000-0000-000000000010",
    "Path": "Shared/Staging",
    "Status": "Created successfully"
  }
}

uip or folders get

Fetch one folder by key or path. The positional argument auto-detects: UUID input is treated as a key, anything else as a path.

引数

名前	Required	目的
<folder-key-or-path>	○	Folder GUID or path.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	session default	Override the tenant.

例

uip or folders get "Shared"
uip or folders get a1b2c3d4-0000-0000-0000-000000000001
uip or folders get "Shared/Staging" --output-filter 'Data.Key'

Data shape (--output json)

{
  "Code": "FolderGet",
  "Data": {
    "Name": "Shared",
    "ID": 101,
    "Key": "a1b2c3d4-0000-0000-0000-000000000001",
    "Description": "No description",
    "Path": "Shared",
    "ParentID": "Root",
    "FolderType": "Standard",
    "IsPersonal": "No",
    "ProvisionType": "Automatic",
    "PermissionModel": "FineGrained",
    "FeedType": "Processes"
  }
}

uip or folders delete

Delete a folder by key or path. Fails if the folder contains entities or user associations — remove or move contents first.

引数

名前	Required	目的
<folder-key-or-path>	○	Folder GUID or path.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	session default	Override the tenant.

例

uip or folders delete "Shared/Staging"
uip or folders delete a1b2c3d4-0000-0000-0000-000000000010
uip or folders delete "Shared/Staging" --output-filter 'Data.Status'

Data shape (--output json)

{
  "Code": "FolderDelete",
  "Data": {
    "Key": "a1b2c3d4-0000-0000-0000-000000000010",
    "Path": "Shared/Staging",
    "Status": "Deleted successfully"
  }
}

uip or folders move

Move a folder to a new parent, or up to the root. You must provide exactly one of --parent or --root.

引数

名前	Required	目的
<folder-key-or-path>	○	Folder GUID or path to move.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	session default	Override the tenant.
-p	--parent	key or path	—	New parent folder. Required unless --root is set.
—	--root	flag	off	Move to the top level (no parent).

例

uip or folders move "Shared/Staging" --parent "Production"
uip or folders move a1b2c3d4-0000-0000-0000-000000000010 --root
uip or folders move "Shared/Staging" --parent "Production" \
    --output-filter 'Data.TargetParentPath'

Data shape (--output json)

{
  "Code": "FolderMove",
  "Data": {
    "FolderKey": "a1b2c3d4-0000-0000-0000-000000000010",
    "FolderPath": "Shared/Staging",
    "TargetParentPath": "Production",
    "Status": "Moved successfully"
  }
}

--root sets TargetParentPath to (root).

uip or folders edit

Update display name and/or description. At least one of --name or --description must be provided.

引数

名前	Required	目的
<folder-key-or-path>	○	Folder GUID or path.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	session default	Override the tenant.
-n	--name	text	—	New display name.
-d	--description	text	—	New description.

例

uip or folders edit a1b2c3d4-0000-0000-0000-000000000010 --name "Staging (EU)"
uip or folders edit "Shared/Staging" --description "Pre-prod runs"
uip or folders edit "Shared/Staging" --name "Staging (EU)" --output-filter 'Data.Status'

Data shape (--output json)

{
  "Code": "FolderUpdate",
  "Data": { "Status": "Updated successfully" }
}

uip or folders runtimes

List runtime allocation for a folder — for each runtime type, how many slots are total, connected, and available. Useful for checking capacity before starting jobs.

引数

名前	Required	目的
<folder-key-or-path>	○	Folder GUID or path.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-t	--tenant	name	session default	Override the tenant.

例

uip or folders runtimes "Shared"
uip or folders runtimes a1b2c3d4-0000-0000-0000-000000000001
uip or folders runtimes "Shared" \
    --output-filter "Data[?Type=='Unattended'].Available | [0]"

Data shape (--output json)

{
  "Code": "FolderRuntimes",
  "Data": [
    { "Type": "Unattended", "Total": 4, "Connected": 3, "Available": 1 },
    { "Type": "NonProduction", "Total": 2, "Connected": 1, "Available": 1 }
  ]
}

終了コード

See Exit codes. No verb-specific overrides.

Related commands

• uip or processes — folder-scoped process bindings.
• uip or machines — especially machines assign / unassign for folder membership.
• uip or users — users list-in-folder, users assign, users unassign.
• uip or roles — folder-level role assignments.

参照

• Global options.
• Sessions — tenant and folder context resolution.