[GitHub] [hadoop-ozone] xiaoyuyao commented on a change in pull request #493: HDDS-2749. interface/S3.md translation

[GitBox <gi...@apache.org>]

xiaoyuyao commented on a change in pull request #493: HDDS-2749. interface/S3.md translation
URL: https://github.com/apache/hadoop-ozone/pull/493#discussion_r373170368
 
 

 ##########
 File path: hadoop-hdds/docs/content/interface/S3.zh.md
 ##########
 @@ -22,4 +22,128 @@ summary: Ozone supports Amazon's Simple Storage Service (S3) protocol. In fact,
 -->
 
 
-测试页面
+Ozone 提供了兼容 S3 的 REST 接口，你可以使用任何兼容 S3 的工具来操作 Ozone 的对象存储数据。
+
+## 起步
+
+S3 网关是提供兼容 S3 的 API 的独立组件，它应当和普通的 Ozone 组件分别启动。
+
+你可以使用发行包启动一个基于 docker 的集群，其中会包括 S3 网关。
+
+进入 `compose/ozones3` 目录，启动服务：
+
+```bash
+docker-compose up -d
+```
+
+你可以通过 `http://localhost:9878` 访问 S3 网关。
+
+## URL 规范
+
+Ozone S3 网关既支持虚拟主机风格的 URL 作为桶地址（形如：http://bucketname.host:9878），也支持多级路径风格的 URL 作为桶地址（形如 http://host:9878/bucketname）。
+
+默认使用多级路径风格，如果要使用虚拟主机风格的 URL，在 `ozone-site.xml` 中设置你的主域名：
+
+```xml
+<property>
+   <name>ozone.s3g.domain.name</name>
+   <value>s3g.internal</value>
+</property>
+```
+
+## 桶浏览器
+
+在桶的 URL 中加上 `?browser=true`，就可以在浏览器中浏览桶。
+
+比如，`testbucket` 桶中的内容可以在浏览器中用 http://localhost:9878/testbucket?browser=true 来查看。
+
+
+## 已实现的 REST 端点
+
+S3 网关服务的操作：
+
+端点    | 状态      |
+------------|-------------|
+GET 服务 | 已实现 |
+
+桶操作：
+
+端点                            | 状态      | 备注
+------------------------------------|-------------|---------------
+GET 桶（列举对象）第二版  | 已实现 |
+HEAD 桶                         | 已实现 |
+DELETE 桶                       | 已实现 |
+PUT 桶 (创建桶)          | 已实现 |
+Delete 多个对象 (POST)      | 已实现 |
+
+对象操作：
+
+端点                            | 状态          | 备注 
+------------------------------------|-----------------|---------------
+PUT 对象                          | 已实现     |
+GET 对象                          | 已实现     |
+Multipart Upload                    | 已实现     | Except the listing of the current MultiPartUploads.
 
 Review comment:
   分块上传

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-issues-help@hadoop.apache.org