Skip to main content

Integration file

File nameResource
*.integration.yamlIntegration

GitOps file for a single space.

Identity​

  • originKey: GitOps identity of the resource this file owns. The same value as the API's originKey.
  • id: Server-assigned id. Absent until the resource exists.

Fields​

FieldTypeRequiredDescription
defaultConnectorKindstringOptionalConnector kind preselected when pack install creates a connector. A registry kind id such as crowdstrike, or a built-in kind such as aws-s3. May be null. Must not be empty.
folderstringOptionalA Folder by its originKey (managed in this repo) or its server id (FLD_…).
idstringOptionalServer-assigned id. Absent until the resource exists. Pattern: ^INT_[A-Z0-9]{1,7}$.
namestringRequired
originKeystringRequiredGitOps identity of the resource this file owns. The same value as the API's originKey. Pattern: ^(?!perpetual:)[a-z][a-z0-9-]{0,31}:[A-Za-z0-9._~\-/:@]{1,256}$.
retentionDaysintegerOptionalMay be null. Greater than 0.
spaceIdstringRequiredSpace the resource belongs to. Pattern: ^SPC_[A-Z0-9]{1,7}$.
viewNamestringOptionalMay be null. Defaults to null.

In a content pack​

A content pack's source directory uses the same file, with these differences:

  • Not used in a pack: originKey, spaceId.
  • These fields are new in a pack, or have a different type, requirement or meaning there:
FieldTypeRequiredDescription
folderstringOptionalid of a Folder file in the same pack. Omit to place the item at the pack root. Format: uuid. Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$.
idstringRequiredFormat: uuid. Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$.

Perpetual CLI 0.5.0