Manage projects

Projects help you organize your Aiven services and centrally configure settings for all services in the project. You can create projects in your organization or its organizational units.

Create a project

Console

1. Click Projects and select Create project.
2. Enter a name for the project.
3. Select an organization or organizational unit to add the project to.
4. Select a billing group. The costs from all services in this project are charged to the payment method for this billing group.

Terraform

Loading...

More information on this resource and its configuration options are available in the Terraform documentation.

Tag a project

Console

1. In the project, click Settings.
2. In the Tags section, click Project or Billing.
   • Billing tags are returned in the invoice API and displayed on PDF invoices for the project.
   • Project tags are returned for resources in the API and displayed in the list of projects.
3. Click Add tags.
4. Enter a key and value for each tag.
5. Click Save changes.

Terraform

To add billing and project tags, use the tag attribute in your aiven_project resource. For billing tags, prefix the key with billing:. For example: key = "billing:PO".

Rename a project

important

The project name in your DNS records will not be updated.

1. Power off all services in the project.

   note

   Except for Aiven for Apache Kafka®, all services have backups that are restored when you power them back on.

2. In the project, click Settings.

3. In the Project settings, edit the Project name.

4. Click Save changes.

Move a project

You can move a project to another organization or organizational unit. Users with the organization admin or project admin role can move projects within an organization.

note

You cannot move a project to an Aiven organization on AWS Marketplace, Azure Marketplace, or Google Cloud Marketplace using the Aiven Console. To move to a marketplace, set up your organization and projects in the marketplace and contact Aiven for help moving your services.

To move a project to a different organization, you must be an organization admin of both organizations. All users with permission to access the project lose the permissions when you move it to a different organization unless they are members of the target organization.

Services in the project continue running during the move.

Console

1. In the organization with the project, click Admin.
2. Click Projects and find the project to move.
3. Click > Move project.
4. Select the organization or organizational unit to move the project to.
5. Select a Billing group.
6. Click Next and Finish.

Terraform

You can move a project to another organization or organizational unit by updating your aiven_project or aiven_organization_project resource.

Delete a project

1. Delete all the services in the project.
2. In the project, click Settings.
3. Click Delete and Confirm.