Manage organizational units

An organizational unit is the second level of hierarchy in Chef 360 Platform’s multi-tenancy structure. Each organizational unit helps establish a logical boundary around users (who are its members) and the entities they interact with.

For example, changes to the system made by users and administrators in one organizational unit won’t impact other organizational units. No two organizational units can have the same name. A user with the admin role in an organizational unit can perform administrative actions in that unit. The same user can have different roles in different organizational units within the same tenant. Users can also have multiple roles within the same organizational unit.

You must have a profile with the tenant-admin role to create or modify organizations.

Create an organization

• Create an organization:

  chef-platform-auth-cli system organization create-organization --body '{"name": "<ORGANIZATION_NAME>","description": "<ORGANIZATION_DESCRIPTION>"}' --profile <PROFILE_NAME>
  

  Replace:

  • <ORGANIZATION_NAME> with the name of the organization you’re creating
  • <ORGANIZATION_DESCRIPTION> with a description of the organization
  • <PROFILE_NAME> with your profile