About Projects
Learn how to work with your Data Science projects.
Projects are containers that enable you to organize your work. They contain a collection of notebook sessions and models.
Projects are managed using the Projects page, where you can:
-
Select a project to view its details and manage it. All notebook sessions and models in the project are listed.
-
Use the Actions menu to view project details, edit projects, move the project to another compartment, or delete the project.
-
Use the List Scope filter to view projects in another compartment.
-
Filter projects by status using the Project State list. The default is to view all status types.
-
When there are tags applied to projects, you can further filter projects by clicking add or clear next to Tag Filters.
Creating Projects
You create a Data Science project to organize your notebook sessions and models.
After you successfully create a project, you can create notebook sessions and models and associate them with the project. You and your collaborators can then organize and document your data science work within the projects.
Viewing Project Details
To open a project's detail page, you can click the project's name or the Actions button (three dots), and click View Details.
From the Project Information tab, you can view these details:
- Description:
-
A description of the project is one was defined.
- OCID
-
A shortened version of the OCID is displayed. You can use the Show and Hide links to toggle the display of the full OCID. Use the Copy link to save the entire OCID to your clipboard to paste it elsewhere. For example, you could paste into a file and save it, then use it in your model scripts.
- Created On:
-
The date and time when the project was created.
- Created By:
-
A shortened version of the OCID user that created the project. You can use the Show and Hide links to toggle the display of the full OCID user. Use the Copy link to save the entire OCID user to your clipboard to paste it elsewhere. For example, you could paste into other Data Science dialogs.
From the Tags tab, you can view the tags that have been applied to the project. To update or remove a tag, find the tag you want and click the pencil button next to it. Enter the new tag then save it or remove the tag by clicking Remove Tag.
Editing Projects
You can click the project's name or the Actions menu, then click Edit to change the name and description of the project.
Applying Tags to Projects
You can click the project's name or the Actions menu, and click Add Tags. You can apply both defined and free form tags, see Working with Resource Tags.
Moving Projects
You can move a project from its current compartment to a different one. Moving a project does not move any of its notebook sessions or models to the new compartment.
For example, you may want to move a project to promote it from a development compartment to production compartment, or you could change the visibility of the project.
You can click the project's name or the Actions menu, and click Move resource. Select the destination compartment and click Move Resource.
Deleting Projects
To delete a project, it cannot be associated with any Data Science resources. Before you can start to delete a project, you must first delete the notebook session and models associated with the project.
You can click the project's name or the Actions menu, and click Delete to delete a project.
Enter the name exactly as it appears because it's case-sensitive, then click Delete.
The state of the project becomes "deleting" during the delete project operation. The service checks for the absence of associated resources. If successful, the project status is updated to deleted.
The delete project action is asynchronous and initiates a work request. You can use the work request to track the status of an operation. For general information about using work requests in OCI, see Work Requests and the Work Requests API.
Deleted projects exist in lists for 30 days after being deleted. You can filter them out of lists using the State filter.
Using the API
For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.
Use the following operations to manage projects: