Harness entity reference
The term entity is used to refer to the components of Harness. Most entities can be created at the account, organization, and project level.
Examples of Entities
Here are some example of entity types in Harness:
- Account
- User
- Users Group
- Service
- Service Definition
- Environment
- Infrastructure
- Infrastructure Definition
- Pipeline
- Connectors
- Secrets
- Secret Managers
Entity Identifiers
Most Harness entities and resources include a unique Id (Identifier) that is immutable once the entity is created.
Identifiers provide a permanent way to refer to an entity, and avoid issues that can arise when a name is changed.
See Entity Identifier Reference.
Entity Id Scope
Entity Id is scoped at the level where it is created. For example, two Pipelines can have the same Id if they are in different Projects.
Entity Id has the following rules:
- There cannot be 2 or more Orgs with the same Id within the account.
- There cannot be 2 or more Projects with the same Id within the Org.
- There cannot be 2 or more Pipelines with the same Id within the Project.
- There cannot be 2 or more stages with the same Id within the Pipeline.
- There cannot be 2 or more steps with the same Id within the stage.
Id Naming
The identifier must start with a-z, A-Z or _ and can then be followed by 0-9, a-z, A-Z, _ or $.
Reserved Words
The Id should not be any of the following words:
- or
- and
- eq
- ne
- lt
- gt
- le
- ge
- div
- mod
- not
- null
- true
- false
- new
- var
- return
- step
- parallel
- stepGroup
- org
- account