|
5 | 5 | "id": "ac60a3db-eb56-4fd4-b139-95114faaee64",
|
6 | 6 | "metadata": {},
|
7 | 7 | "source": [
|
8 |
| - "# Using objects from your S3 buckets in OVHcloud AI Tools\n", |
| 8 | + "# Using objects from your S3* compatible buckets in OVHcloud AI Tools\n", |
9 | 9 | "\n",
|
10 |
| - "This tutorial provides help to manage and use S3 buckets with AI Tools in Python, using the `boto3` library. We will show you how you can interact with your S3 Buckets and files by creating buckets, downloading objects, listing objects and reading their content when working with AI Notebooks, AI Training and AI Deploy.\n", |
| 10 | + "This tutorial provides help to manage and use S3* compatible buckets with AI Tools in Python, using the `boto3` library. We will show you how you can interact with your S3 compatible Buckets and files by creating buckets, downloading objects, listing objects and reading their content when working with AI Notebooks, AI Training and AI Deploy.\n", |
11 | 11 | "\n",
|
12 | 12 | "## Requirements\n",
|
13 | 13 | "\n",
|
14 |
| - "To be able to follow this tutorial, you will need to have followed the [Data - S3 compliance with AI Tools documentation](https://help.ovhcloud.com/csm/en-gb-public-cloud-ai-s3-compliance?id=kb_article_view&sysparm_article=KB0058011) first, in particular the following steps:\n", |
| 14 | + "To be able to follow this tutorial, you will need to have followed the [Data - Compliance between AI Tools and S3 compatible Object Storage](https://help.ovhcloud.com/csm/en-gb-public-cloud-ai-s3-compliance?id=kb_article_view&sysparm_article=KB0058011) first, in particular the following steps:\n", |
15 | 15 | "\n",
|
16 |
| - "- Have created a S3 user\n", |
| 16 | + "- Have created a S3 compatible user\n", |
17 | 17 | "- Checked that this user has ***ObjectStore operator*** and ***AI Training Operator*** rights\n",
|
18 | 18 | "- Have created a datastore with this user\n",
|
19 | 19 | "\n",
|
20 | 20 | "## Code\n",
|
21 | 21 | "\n",
|
22 | 22 | "The different steps are as follow:\n",
|
23 | 23 | "- Setup the environment\n",
|
24 |
| - "- Set your S3 datastore\n", |
25 |
| - "- List all S3 buckets in your S3 datastore\n", |
| 24 | + "- Set your S3 compatible datastore\n", |
| 25 | + "- List all S3 compatible buckets in your S3 compatible datastore\n", |
26 | 26 | "- Create a new bucket\n",
|
27 | 27 | "- List all objects of a specific bucket\n",
|
28 | 28 | "- Read content from objects\n",
|
29 |
| - "- Download object from S3 bucket\n", |
| 29 | + "- Download object from S3 compatible bucket\n", |
30 | 30 | "\n",
|
31 | 31 | "### Setup the environment\n",
|
32 | 32 | "\n",
|
|
72 | 72 | "id": "8347366f-98ec-4f4b-87c8-f53aea2b20e7",
|
73 | 73 | "metadata": {},
|
74 | 74 | "source": [
|
75 |
| - "### Set your S3 datastore" |
| 75 | + "### Set your S3 compatible datastore" |
76 | 76 | ]
|
77 | 77 | },
|
78 | 78 | {
|
79 | 79 | "cell_type": "markdown",
|
80 | 80 | "id": "10bc5759-97ce-472c-8c96-cb7224387bcc",
|
81 | 81 | "metadata": {},
|
82 | 82 | "source": [
|
83 |
| - "To interact with an S3 bucket, we need to initialize a S3 client and configure it with our user credentials (`s3_access_key`, `s3_secret_key`, the `endpoint URL`, and the selected region).\n", |
| 83 | + "To interact with an S3 compatible bucket, we need to initialize a S3 compatible client and configure it with our user credentials (`s3_access_key`, `s3_secret_key`, the `endpoint URL`, and the selected region).\n", |
84 | 84 | "\n",
|
85 | 85 | "***Make sure to replace these credentials by yours.***"
|
86 | 86 | ]
|
|
114 | 114 | "id": "84a88d2f-5a8a-4c82-a4b3-9fc7b5d24ec1",
|
115 | 115 | "metadata": {},
|
116 | 116 | "source": [
|
117 |
| - "Once the S3 client has been initialized, we are ready to communicate with the S3-compatible storage service. Many things can be done.\n", |
| 117 | + "Once the S3 compatible client has been initialized, we are ready to communicate with the S3 compatible storage service. Many things can be done.\n", |
118 | 118 | "\n",
|
119 |
| - "### List all S3 buckets in your S3 datastore" |
| 119 | + "### List all S3 compatible buckets in your S3 compatible datastore" |
120 | 120 | ]
|
121 | 121 | },
|
122 | 122 | {
|
|
431 | 431 | "id": "12ea21bf-bde2-481e-b9ea-be327ec365f5",
|
432 | 432 | "metadata": {},
|
433 | 433 | "source": [
|
434 |
| - "### Download object from S3 bucket\n", |
| 434 | + "### Download object from S3 compatible bucket\n", |
435 | 435 | "\n",
|
436 |
| - "You can download any object from your S3 bucket into your environment. Here is how to download the `requirements.txt` file under the name `local-object.txt`" |
| 436 | + "You can download any object from your S3 compatible bucket into your environment. Here is how to download the `requirements.txt` file under the name `local-object.txt`" |
437 | 437 | ]
|
438 | 438 | },
|
439 | 439 | {
|
|
466 | 466 | "source": [
|
467 | 467 | "### Conclusion\n",
|
468 | 468 | "\n",
|
469 |
| - "We hope this example has helped you to manipulate the objects in your S3 buckets directly from the OVHcloud AI Tools products. \n", |
| 469 | + "We hope this example has helped you to manipulate the objects in your S3 compatible buckets directly from the OVHcloud AI Tools products. \n", |
470 | 470 | "\n",
|
471 | 471 | "The operations presented here are not the only possible actions. Please consult the documentation for a full list of available commands.\n",
|
472 | 472 | "\n",
|
473 |
| - "More commands here : https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3.html" |
| 473 | + "More commands here : https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3.html\n", |
| 474 | + "\n", |
| 475 | + "**\\***: S3 is a trademark of Amazon Technologies, Inc. OVHcloud’s service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies, Inc." |
474 | 476 | ]
|
475 | 477 | }
|
476 | 478 | ],
|
|
0 commit comments