Projects
Overview
This document explains the concepts related to Pinecone projects.
Projects contain indexes and users
Each Pinecone project contains a number of indexes and users. Only a user who belongs to the project can access the indexes in that project. Each project also has at least one project owner. All of the pods in a single project are located in a single environment.
Project settings
When you create a new project, you can choose the name, deployment environment, and pod limit.
Project environment
When creating a project, you must choose a cloud environment for the indexes in that project. The following table lists the available cloud regions, the corresponding values of the environment parameter for the init() operation, and which billing tier has access to each environment:
| Cloud region | environment value | Tier availability |
|---|---|---|
| GCP US-West-1 Free (N. California) | us-west1-gcp-free | Starter |
| GCP Asia-Southeast-1 (Singapore) | asia-southeast1-gcp-free | Starter |
| GCP US-West-4 (Las Vegas) | us-west4-gcp | Starter |
| GCP US-West-1 (N. California) | us-west1-gcp | Standard / Enterprise |
| GCP US-Central-1 (Iowa) | us-central1-gcp | Standard / Enterprise |
| GCP US-West-4 (Las Vegas) | us-west4-gcp | Standard / Enterprise |
| GCP US-East-4 (Virginia) | us-east4-gcp | Standard / Enterprise |
| GCP northamerica-northeast-1 | northamerica-northeast1-gcp | Standard / Enterprise |
| GCP Asia-Northeast-1 (Japan) | asia-northeast1-gcp | Standard / Enterprise |
| GCP Asia-Southeast-1 (Singapore) | asia-southeast1-gcp | Standard / Enterprise |
| GCP US-East-1 (South Carolina) | us-east1-gcp | Standard / Enterprise |
| GCP EU-West-1 (Ireland) | eu-west1-gcp | Standard / Enterprise |
| GCP EU-West-4 (Netherlands) | eu-west4-gcp | Standard / Enterprise |
| AWS US-East-1 (Virginia) | us-east1-aws | Standard / Enterprise |
Contact us if you need a dedicated deployment in other regions.
The environment cannot be changed after the project is created.
Project pod limit
You can set the maximum number of pods that can be used in total across all indexes in a project. Use this to control costs.
The pod limit can be changed only by the project owner.
Project roles
There are two project roles: Project owner and project member. Table 1 below summarizes the permissions for each role.
Table 1: Project roles and permissions
| Project role | Permissions in organization |
|---|---|
| Project owner | Manage project members |
| Manage project API keys | |
| Manage pod limits | |
| Project member | Access API keys |
| Create indexes in project | |
| Use indexes in project |
Updated 16 days ago