hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From aengin...@apache.org
Subject hadoop git commit: HDFS-12081. Ozone: Add infoKey REST API document. Contributed by Weiwei Yang.
Date Wed, 05 Jul 2017 18:53:19 GMT
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 <aengineer@apache.org>
Authored: Wed Jul 5 11:53:02 2017 -0700
Committer: Anu Engineer <aengineer@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


Mime
View raw message