Organizational Unit
OrganizationalUnit
A middle-tier container in the Infrastream resource hierarchy.
It groups related Environments and Release Tracks of one business unit or product area. Permissions, regional parameters, and hibernation logic cascade from it to child environments.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be OrganizationalUnit. |
| metadata | map | The engine reads the reserved keys name and organization to resolve the identity and the parent Organization. |
| spec | OrganizationalUnitDefinition | Desired organizational-unit configuration. Folder display name, permissions, regional overrides, and hibernation settings cascade to child Environments and Release Tracks. See OrganizationalUnitDefinition. |
OrganizationalUnitDefinition
Definition of an Organizational Unit (OU) that groups environments and governs policies.
It maps to a GCP folder. IAM, network and hibernation defaults propagate down from it.
| Property | Type | Description |
|---|---|---|
| displayName | string | Display name of the GCP folder. Defaults to metadata.name. Must have 3 to 30 characters: letters, digits, spaces, underscores and dashes. |
| description | string | Free-text description. |
| hibernation | HibernationConfig | Default hibernation schedule for the OU. Child Environment or Project manifests can override it. |
| permissions | AccessPermissions | Default permissions for the OU. Child Environment and Project manifests inherit them. |
| network | OrganizationalUnitNetwork | NOT YET IMPLEMENTED. The engine ignores this field. See OrganizationalUnitNetwork. |
HibernationConfig
Hibernation schedule configuration.
The engine combines windows and exclusions from the OU, Environment and Project into the final state.
| Property | Type | Description |
|---|---|---|
| hibernate | bool | If true, the resource hibernates immediately and overrides all windows and exclusions. Defaults to false. |
| windows | list of WindowsEntry | Time windows that repeat, in which the resource hibernates. The map key is a unique name. |
| exclusions | list of ExclusionsEntry | One-time windows that suspend hibernation, even if a window is active. Use them for planned maintenance or high-traffic periods. The map key is a unique name. |
OrganizationalUnitNetwork
VPC flow log settings for an Organizational Unit (OU).
NOT YET IMPLEMENTED. The engine ignores this message.
| Property | Type | Description |
|---|---|---|
| logs | NetworkLogs | NOT YET IMPLEMENTED. The engine ignores this field. See NetworkLogs. |
AccessPermissions
Administrator, contributor, and viewer privileges for an asset.
The engine aggregates the users and groups into IAM policies.
| Property | Type | Description |
|---|---|---|
| administrators | DetailedAccessPermissions | Users and groups with administrative privileges, usually full control. |
| contributors | DetailedAccessPermissions | Users and groups with contributor privileges, usually read and write access. |
| viewers | DetailedAccessPermissions | Users and groups with viewer privileges, usually read-only access. |
DetailedAccessPermissions
User and group access definitions.
The engine resolves the listed manifests to Google Workspace identity emails for IAM bindings.
| Property | Type | Description |
|---|---|---|
| members | list of string | Names of OrganizationUser manifests. |
| groups | list of string | Names of OrganizationUserGroup manifests. |
WindowsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | HibernationWindow |
NetworkLogs
VPC Flow Logs export settings.
NOT YET IMPLEMENTED. The engine ignores this message. Intended use: set the aggregation interval and sampling rate of flow logs.
| Property | Type | Description |
|---|---|---|
| interval | string | Aggregation interval. One of the INTERVAL_* values, from INTERVAL_5_SEC to INTERVAL_15_MIN. |
| sampling | double | Fraction of connections to capture, from 0.0 (no logs) to 1.0 (all logs). |
ExclusionsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | HibernationExclusion |
HibernationExclusion
Suspension of the hibernation schedule.
Workloads stay active in the given time frame.
| Property | Type | Description |
|---|---|---|
| start | string | Window start, in RFC3339 format. RFC3339 |
| end | string | Window end, in RFC3339 format. RFC3339 |
HibernationWindow
Period when an asset scales down.
Cron strings tell the control plane when to stop virtual machines or scale Cloud Run instances to zero.
| Property | Type | Description |
|---|---|---|
| start | string | Cron expression for the start of the window. |
| end | string | Cron expression for the end of the window. |