You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-commits@hadoop.apache.org by ae...@apache.org on 2017/07/05 18:53:19 UTC
hadoop git commit: HDFS-12081. Ozone: Add infoKey REST API document.
Contributed by Weiwei Yang.
Repository: hadoop
Updated Branches:
refs/heads/HDFS-7240 ebbc04c2d -> 62c0cc767
HDFS-12081. Ozone: Add infoKey REST API document. Contributed by Weiwei Yang.
Project: http://git-wip-us.apache.org/repos/asf/hadoop/repo
Commit: http://git-wip-us.apache.org/repos/asf/hadoop/commit/62c0cc76
Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/62c0cc76
Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/62c0cc76
Branch: refs/heads/HDFS-7240
Commit: 62c0cc767e3301760412fbe6565d8a5279073f6e
Parents: ebbc04c
Author: Anu Engineer <ae...@apache.org>
Authored: Wed Jul 5 11:53:02 2017 -0700
Committer: Anu Engineer <ae...@apache.org>
Committed: Wed Jul 5 11:53:02 2017 -0700
----------------------------------------------------------------------
.../hadoop-hdfs/src/site/markdown/OzoneRest.md | 36 ++++++++++++++++++++
1 file changed, 36 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/hadoop/blob/62c0cc76/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/OzoneRest.md
----------------------------------------------------------------------
diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/OzoneRest.md b/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/OzoneRest.md
index 5ef1450..fe8c260 100644
--- a/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/OzoneRest.md
+++ b/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/OzoneRest.md
@@ -462,6 +462,42 @@ this request deletes key */volume-of-bilbo/bucket-0/file-0*. The client receives
Content-Length: 0
Connection: keep-alive
+### Info Key
+
+This API returns information about a given key.
+
+Schema:
+
+- `GET /{volume}/{bucket}/{key}?info=key`
+
+Query Parameter:
+
+| Query Parameter | Value | Description |
+|:---- |:---- |:----
+| info | String, "key" | Required and enforced with this value. |
+
+Sample HTTP DELETE request:
+
+ curl -i -H "x-ozone-user: bilbo" -H "x-ozone-version: v1" -H "Date: Mon, 26 Jun 2017 04:23:30 GMT" -H "Authorization:OZONE" "http://localhost:9864/volume-of-bilbo/buket-0/file-0?info=key"
+
+this request returns information of the key */volume-of-bilbo/bucket-0/file-0*. The client receives a JSON object listed attributes of the key.
+
+ HTTP/1.1 200 OK
+ x-ozone-server-name: localhost
+ x-ozone-request-id: c674343c-a0f2-49e4-bbd6-daa73e7dc131
+ Date: Mon, 03 Jul 2017 14:28:45 GMT
+ Content-Type: application/octet-stream
+ Content-Length: 73
+ Connection: keep-alive
+
+ {
+ "version" : 0,
+ "md5hash" : null,
+ "createdOn" : null,
+ "size" : 0,
+ "keyName" : "file-0"
+ }
+
### List Keys
This API allows user to list keys in a bucket.
---------------------------------------------------------------------
To unsubscribe, e-mail: common-commits-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-commits-help@hadoop.apache.org