{"id":19411467,"url":"https://github.com/volcengine/ve-tos-python-sdk","last_synced_at":"2025-04-24T10:33:32.115Z","repository":{"id":41856901,"uuid":"434456758","full_name":"volcengine/ve-tos-python-sdk","owner":"volcengine","description":"Volcengine TOS Python SDK","archived":false,"fork":false,"pushed_at":"2024-10-22T07:06:53.000Z","size":316,"stargazers_count":5,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-23T09:32:05.568Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/volcengine.png","metadata":{"files":{"readme":"README-zh.md","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-03T03:42:48.000Z","updated_at":"2024-07-10T07:26:09.000Z","dependencies_parsed_at":"2024-01-02T04:21:12.070Z","dependency_job_id":"14fe3959-28b8-4ada-bfe5-8a32bd56208d","html_url":"https://github.com/volcengine/ve-tos-python-sdk","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tos-python-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tos-python-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tos-python-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Fve-tos-python-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/volcengine","download_url":"https://codeload.github.com/volcengine/ve-tos-python-sdk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223950268,"owners_count":17230446,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T12:21:32.794Z","updated_at":"2024-11-10T12:21:33.304Z","avatar_url":"https://github.com/volcengine.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 火山引擎 TOS Python SDK\n## 简介\nTOS Python SDK为Python开发者提供了访问火山引擎对象存储服务TOS（Tinder Object Storage）的系列接口。本文档将给出TOS桶和对象的基本操作代码，供开发者参考.\n\n## 安装\n### 最低依赖\n- Python3\n\n# 快速入门\n\n本章节介绍，如何通过TOS Python SDK来完成常见的操作，如创建桶，上传、下载和删除对象等。\n\n## 初始化TOS客户端\n\n初始化TosClient实例之后，才可以向TOS服务发送HTTP/HTTPS请求。\n\nTOS Python客户端初始化，提供了一系列接口用来与TOS服务进行交互，用来管理桶和对象等TOS上的资源。初始化客户端时，需要带上accesskey，secretkey，endpoint和region。初始化代码如下：\n\n```python\nimport tos\n\nak = \"your access key\"\nsk = \"your secret key\"\nendpoint = \"your endpoint\"\nregion = \"your region\"\nbucket_name = \"your bucket name\"\nobject_key = \"your object key\"\nclient = tos.TosClientV2(ak, sk, endpoint, region)  \n```\n\n## 创建桶\n\n桶是TOS的全局唯一的命名空间，相当于数据的容器，用来储存对象数据。如下代码展示如何创建一个新桶：\n\n```python\n# 创建桶\nresp = client.create_bucket(bucket_name)\nassert resp.status_code == 200                                \n```\n\n## 上传对象\n\n新建桶成功后，可以往桶中上传对象，如下展示如何上传一个对象到已创建的桶中：\n\n```python\n# 调用 put_object 将对象上传到桶中                     \nresp = client.put_object(bucket_name, key_name, content=\"123\")\nassert resp.status_code == 200       \n```\n## 下载对象\n\n如下展示如何从桶中下载一个已经存在的对象：\n\n```python\n# 调用 get_object 接口从桶中获取对象\nresp = client.get_object(bucket_name, key_name)\nassert resp.status_code == 200\n```\n\n## 删除对象\n\n如下展示如何从桶中删除一个已经存在的对象：\n\n```python\n# 调用 put_object 将对象上传到桶中                     \nresp = client.put_object(bucket_name, key_name, content=\"123\")\nassert resp.status_code == 200   \n# 调用 delete_object 从桶中删除对象\nresp = client.delete_object(bucket_name, key_name)\nassert resp.status_code == 204\n```\n\n## License\n[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0.html)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Fve-tos-python-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvolcengine%2Fve-tos-python-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Fve-tos-python-sdk/lists"}