Skip to main content

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.

Role requirements

To create or modify organizations, you must have a profile with the tenant-admin role.

Create an organization

You can create an organization with or without a default skill assembly and default Node Management agents settings.

  • To create an organization, use the create-organization command:

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

    Replace:

    • <ORGANIZATION_NAME> with a unique organization name.

    • <ORGANIZATION_DESCRIPTION> with an organization description.

    • <CREATE_DEFAULT_SKILL_ASSEMBLY> with true or false.

      If true, Chef 360 Platform adds the default skill assembly to the organization.

      If false Chef 360 Platform creates an empty skill assembly called sample-skill-assembly.

    • <CREATE_DEFAULTS> with true or false.

      If true, Chef 360 Platform creates an organization with the default node management settings.

      If false, Chef 360 Platform creates an organization without any skills, node settings, a skill assembly, or a node cohort.

    • <PROFILE_NAME> with your profile.

More information

Thank you for your feedback!

×