root / docs / examplesdir / sharing.rst @ 1c366ac9
History | View | Annotate | Download (4.3 kB)
1 | 4dd5ea2c | Stavros Sachtouris | Sharing |
---|---|---|---|
2 | 4dd5ea2c | Stavros Sachtouris | ======= |
3 | 4dd5ea2c | Stavros Sachtouris | |
4 | 4dd5ea2c | Stavros Sachtouris | In Pithos, an object can be published, shared with all or restricted to be |
5 | 4dd5ea2c | Stavros Sachtouris | accessible by only some users or groups. |
6 | 4dd5ea2c | Stavros Sachtouris | |
7 | 4dd5ea2c | Stavros Sachtouris | Publish and unpublish |
8 | 4dd5ea2c | Stavros Sachtouris | --------------------- |
9 | 4dd5ea2c | Stavros Sachtouris | |
10 | f6822a26 | Stavros Sachtouris | Get publishing information for objects `info.txt` and `file2upload.txt` |
11 | 4dd5ea2c | Stavros Sachtouris | |
12 | 4dd5ea2c | Stavros Sachtouris | .. code-block:: console |
13 | 4dd5ea2c | Stavros Sachtouris | |
14 | 1c366ac9 | Stavros Sachtouris | $ kamaki file info info.txt |
15 | 4dd5ea2c | Stavros Sachtouris | cache-control: no-cache, no-store, must-revalidate, max-age=0 |
16 | 4dd5ea2c | Stavros Sachtouris | content-language: en-us |
17 | 4dd5ea2c | Stavros Sachtouris | content-type: plan-text/unicode |
18 | 4dd5ea2c | Stavros Sachtouris | date: Tue, 18 Jun 2013 12:54:14 GMT |
19 | 4dd5ea2c | Stavros Sachtouris | etag: d41d8cd98f00b204e9800998ecf8427e |
20 | 4dd5ea2c | Stavros Sachtouris | expires: Tue, 18 Jun 2013 12:54:14 GMT |
21 | 4dd5ea2c | Stavros Sachtouris | last-modified: Mon, 17 Jun 2013 13:09:44 GMT |
22 | 4dd5ea2c | Stavros Sachtouris | server: gunicorn/0.14.5 |
23 | 4dd5ea2c | Stavros Sachtouris | vary: X-Auth-Token,Accept-Language,Accept-Encoding |
24 | f6822a26 | Stavros Sachtouris | x-object-hash: e3b0c44298fc1c14....ca495991b7852b855 |
25 | 4dd5ea2c | Stavros Sachtouris | x-object-modified-by: s0m3-u53r-1d |
26 | 4dd5ea2c | Stavros Sachtouris | x-object-public: https://example.com/pithos/public/14lhJnAhVU7 |
27 | 4dd5ea2c | Stavros Sachtouris | x-object-uuid: 0493f1d9-9410-4f4b-a81f-fe42f9cefa70 |
28 | 4dd5ea2c | Stavros Sachtouris | x-object-version: 1085 |
29 | 4dd5ea2c | Stavros Sachtouris | x-object-version-timestamp: Mon, 17 Jun 2013 13:09:44 GMT |
30 | 1c366ac9 | Stavros Sachtouris | $ kamaki file info file2upload.txt |
31 | 4dd5ea2c | Stavros Sachtouris | cache-control: no-cache, no-store, must-revalidate, max-age=0 |
32 | 4dd5ea2c | Stavros Sachtouris | content-language: en-us |
33 | 4dd5ea2c | Stavros Sachtouris | content-type: plan-text/unicode |
34 | 4dd5ea2c | Stavros Sachtouris | date: Tue, 18 Jun 2013 12:54:14 GMT |
35 | 4dd5ea2c | Stavros Sachtouris | etag: c41d8cd98f00b304e9800998ecf8427g |
36 | 4dd5ea2c | Stavros Sachtouris | expires: Tue, 18 Jun 2013 12:54:14 GMT |
37 | 4dd5ea2c | Stavros Sachtouris | last-modified: Mon, 17 Jun 2013 13:09:44 GMT |
38 | 4dd5ea2c | Stavros Sachtouris | server: gunicorn/0.14.5 |
39 | 4dd5ea2c | Stavros Sachtouris | vary: X-Auth-Token,Accept-Language,Accept-Encoding |
40 | f6822a26 | Stavros Sachtouris | x-object-hash: f3b0c44298fc1c149af...a495991b7852b857 |
41 | 4dd5ea2c | Stavros Sachtouris | x-object-modified-by: s0m3-u53r-1d |
42 | 4dd5ea2c | Stavros Sachtouris | x-object-uuid: 0493f1d9-9410-4f4b-a81f-fe42f9cefa70 |
43 | 4dd5ea2c | Stavros Sachtouris | x-object-version: 1085 |
44 | 4dd5ea2c | Stavros Sachtouris | x-object-version-timestamp: Mon, 17 Jun 2013 13:09:44 GMT |
45 | 4dd5ea2c | Stavros Sachtouris | |
46 | f6822a26 | Stavros Sachtouris | .. note:: The first object contains an "x-object-public" field, therefore is |
47 | 1c366ac9 | Stavros Sachtouris | published. Alternatively, use the "--sharing" argument |
48 | 1c366ac9 | Stavros Sachtouris | |
49 | 1c366ac9 | Stavros Sachtouris | .. code-block:: console |
50 | 1c366ac9 | Stavros Sachtouris | |
51 | 1c366ac9 | Stavros Sachtouris | $ kamaki file info info.txt --sharing |
52 | 1c366ac9 | Stavros Sachtouris | public url: https://example.com/pithos/public/14lhJnAhVU7 |
53 | 4dd5ea2c | Stavros Sachtouris | |
54 | 4dd5ea2c | Stavros Sachtouris | Unpublish info.txt, publish file2upload.txt |
55 | 4dd5ea2c | Stavros Sachtouris | |
56 | 4dd5ea2c | Stavros Sachtouris | .. code-block:: console |
57 | 4dd5ea2c | Stavros Sachtouris | |
58 | 1c366ac9 | Stavros Sachtouris | $ kamaki file modify /pithos/info.txt --unpublish |
59 | 1c366ac9 | Stavros Sachtouris | $ kamaki file modify /pithos/file2upload.txt --publish |
60 | 4dd5ea2c | Stavros Sachtouris | https://example.com/pithos/public/43gdL2df02ld3 |
61 | 4dd5ea2c | Stavros Sachtouris | |
62 | 4dd5ea2c | Stavros Sachtouris | Modify permissions |
63 | 4dd5ea2c | Stavros Sachtouris | ------------------ |
64 | 4dd5ea2c | Stavros Sachtouris | |
65 | f6822a26 | Stavros Sachtouris | Get current permissions. If none set, the object inherits permissions from the |
66 | f6822a26 | Stavros Sachtouris | container and account (in that order). |
67 | 4dd5ea2c | Stavros Sachtouris | |
68 | 4dd5ea2c | Stavros Sachtouris | .. code-block:: console |
69 | 4dd5ea2c | Stavros Sachtouris | |
70 | 1c366ac9 | Stavros Sachtouris | $ kamaki file info info.txt --sharing |
71 | 1c366ac9 | Stavros Sachtouris | public url: https://example.com/pithos/public/14lhJnAhVU7 |
72 | 1c366ac9 | Stavros Sachtouris | $ kamaki file info file2upload.txt --sharing |
73 | 4dd5ea2c | Stavros Sachtouris | read: local_user_group, write: s0m3-u53r-1d |
74 | 1c366ac9 | Stavros Sachtouris | public url: https://example.com/pithos/public/43gdL2df02ld3 |
75 | 4dd5ea2c | Stavros Sachtouris | |
76 | 4dd5ea2c | Stavros Sachtouris | Let user with id `4n07h3r-u53r-1d` to have read access to `info.txt` and write |
77 | 4dd5ea2c | Stavros Sachtouris | access to `file2upload.txt`, and current user to have the opposite access |
78 | 4dd5ea2c | Stavros Sachtouris | |
79 | 4dd5ea2c | Stavros Sachtouris | .. code-block:: console |
80 | 4dd5ea2c | Stavros Sachtouris | |
81 | 1c366ac9 | Stavros Sachtouris | $ kamaki file modify info.txt --read-permission=4n07h3r-u53r-1d --write-permission=s0m3-u53r-1d |
82 | 1c366ac9 | Stavros Sachtouris | $ kamaki file modify file2upload.txt --write-permission=4n07h3r-u53r-1d --read-permission=s0m3-u53r-1d |
83 | 4dd5ea2c | Stavros Sachtouris | |
84 | 4dd5ea2c | Stavros Sachtouris | Share (read permission) `info.txt` with all |
85 | 4dd5ea2c | Stavros Sachtouris | |
86 | 4dd5ea2c | Stavros Sachtouris | .. code-block:: console |
87 | 4dd5ea2c | Stavros Sachtouris | |
88 | 1c366ac9 | Stavros Sachtouris | $ kamaki file permissions set info.txt --read-permission=* |
89 | 4dd5ea2c | Stavros Sachtouris | |
90 | 4dd5ea2c | Stavros Sachtouris | Shared with me |
91 | 4dd5ea2c | Stavros Sachtouris | -------------- |
92 | 4dd5ea2c | Stavros Sachtouris | |
93 | 1c366ac9 | Stavros Sachtouris | List users who share objects with current user |
94 | 4dd5ea2c | Stavros Sachtouris | |
95 | 4dd5ea2c | Stavros Sachtouris | .. code-block:: console |
96 | 4dd5ea2c | Stavros Sachtouris | |
97 | 1c366ac9 | Stavros Sachtouris | $ kamaki sharer list |
98 | 1c366ac9 | Stavros Sachtouris | 5h4r1ng-u53r-1d (somesharinguser@example.com) |
99 | 1c366ac9 | Stavros Sachtouris | 4n07h3r-5h4r1ng-u53r-1d (anothersharinguser@example.com) |
100 | 4dd5ea2c | Stavros Sachtouris | |
101 | 1c366ac9 | Stavros Sachtouris | List containers of `5h4r1ng-u53r-1d` and then list `images` container |
102 | 4dd5ea2c | Stavros Sachtouris | |
103 | 4dd5ea2c | Stavros Sachtouris | .. code-block:: console |
104 | 4dd5ea2c | Stavros Sachtouris | |
105 | 1c366ac9 | Stavros Sachtouris | $ kamaki container list -A 5h4r1ng-u53r-1d |
106 | 1c366ac9 | Stavros Sachtouris | images |
107 | 4dd5ea2c | Stavros Sachtouris | pithos |
108 | 4dd5ea2c | Stavros Sachtouris | trash |
109 | 1c366ac9 | Stavros Sachtouris | $ kamaki file list -A 5h4r1ng-u53r-1d /images |
110 | 4dd5ea2c | Stavros Sachtouris | some-image.diskdump |
111 | 4dd5ea2c | Stavros Sachtouris | some-other-image.diskdump |
112 | 4dd5ea2c | Stavros Sachtouris | |
113 | 4dd5ea2c | Stavros Sachtouris | Copy the shared image `some-image.diskdump` to current pithos container |
114 | 4dd5ea2c | Stavros Sachtouris | |
115 | 4dd5ea2c | Stavros Sachtouris | .. code-block:: console |
116 | 4dd5ea2c | Stavros Sachtouris | |
117 | 1c366ac9 | Stavros Sachtouris | $ kamaki file copy -A 5h4r1ng-u53r-1d /images/some-image.diskdump /pithos |
118 | 4dd5ea2c | Stavros Sachtouris | |
119 | 1c366ac9 | Stavros Sachtouris | OR |
120 | 4dd5ea2c | Stavros Sachtouris | |
121 | 1c366ac9 | Stavros Sachtouris | $ kamaki file copy pithos://5h4r1ng-u53r-1d/images/some-image.diskdump /pithos |