# Using Swift REST API To use Swift Rest API, you need at least 1 Swift user. To create a Swift user, please refer to Initializing Swift user. You can use this Swift user to create (or delete) multiple containers, where each container serves as a storage unit (similar to a folder). In each container, users can upload, get, and delete multiple corresponding objects (objects here are understood as files or subfolders within the container). **Basic process:** Authentication -> Create Container -> Upload Object Below is a list of Swift Rest APIs that we provide, along with instructions on how to operate with POSTMAN or CURL. #### 1. Get token Input: username, password, projectId, authentication url | Url | /auth/tokens | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Method | POST | | Header | Content-Type: application/json | | Body | { "auth": { "identity": { "methods": \[ "password" ], "password": { "user": { "domain": { "name": "default" }, "name": "{username}", "password": "{password}" } } }, "scope": { "project": { "domain": { "name": "default" }, "id": "{projectId}" } } } } | Output: **Response trả về** > "url: " với public interface trong catalog có type "object-store", đây là link dùng cho những request sau này. Trong đó, " *AUTH\_d6f0078021f4417989d6ba8ae4320dea*" tương ứng với một account trong object storage. **Header trả về** > "x-subject-token: gAAAAABdAhsbpeT0CLQiUvTgX3TcVua8c7RLFIY074FlLvDWpGp06EV8SRCbuLGzSL5Q2AnfYogSWydNeZc5dWpRbTKxiwGXuP-wAoPPmIGvBctSkkwnhMF8UQXLBmwlIT43Mudc9ZuHgRLqlW1BT3OmhN9ugKTQHyzgCuzBmHqVgtXp6dRJYr0", đây là thông tin token dùng để xác thực cho những request sau. **Chú ý:** * Token luôn có expired, nếu hết expired vui lòng get token mới **Get token dùng CURL thông qua RESTful API** > curl -i -X POST -H 'Content-Type: application/json; charset=utf-8' \/v3/auth/tokens -d \ > > curl -i -X POST "" \\ > > -H 'Content-Type: application/json; charset=utf-8' \\ > > -d $'{ > > "auth": { > > "scope": { > > "project": { > > "id": "6e89e27c18824e70b84a02487a93c69f", > > "domain": { > > "name": "default" > > } > > } > > }, > > "identity": { > > "methods": \[ > > "password" > > ], > > "password": { > > "user": { > > "name": "${username}", > > "password": "${password}, > > "domain": { > > "name": "default" > > } > > } > > } > > } > > } > > }' #### 2. Create a container | Url | /v1/{account}/{container\_name} | | ------ | ------------------------------- | | Method | PUT | | Header | X-Auth-Token | | Body | (Không bắt buộc) | * In which : \+ Value của header "X-Auth-Token" chính là value của "x-subject-token" được lấy từ mục 3.1 (Get Token). \+ "container\_name" là tên của container, bạn có thể đặt tùy ý. Tuy nhiên để tương thích với tất cả các client tools cũng như tránh các lỗi liên quan đến việc xử lý ký tự đặc biệt hoặc unicode thì tên container chỉ nên chứa các ký tự (a-z, A-Z) hoặc số (0-9). Tên container không nên chứa các ký tự đặc biệt như @, #, $, %, ^, &, \*, ., /, \\, {, }, \[, ], |, ), ( … **Warning:** * Some client tools may encounter errors if the container name contains special characters. * When working with containers (buckets) using the S3 protocol, the names of these containers must contain lowercase letters and numbers, without uppercase letters, special characters, or spaces. * If the request returns a status code of 201, you have successfully created a container (in the example above, the container is successfully created with the name 'container\_name'). * Within each container, you can upload multiple objects for storage (objects here could be, for example, images, any files, or folders). **Create a container using CURL through RESTful API** > curl -i -X PUT -H "X-Auth-Token: \" \/mycontainer > > curl -v -i -X PUT -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/new\_container](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/new_container) #### 3. Upload an object (object size < 5GB) | Url | /v1/{account}/{container}/{name\_object} | | | ------------ | ------------------------------------------------------------------------------------------------------------- | ----------------------------------- | | Method | PUT | | | Header | X-Auth-Token | Token được lấy từ "x-subject-token" | | Content-Type | Chọn content-type phù hợp với object upload (Ví dụ: Content-Type: image/jpeg với file hình có định dạng jpg). | | | Body | Binary file: choose file | | Ví dụ cụ thể: | Url | | fileName.png là tên của object, object này sẽ được lưu trong container "nameContainer" | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | | Method | PUT |


| | Header |

X-Auth-Token: gAAAAABdAhsbpeT0CLQiUvTgX3TcVua8c7RLFIY074FlLvDWpGp06EV8SRCbuLGzSL5Q2AnfYogSWydNeZc5dWpRbTKxiwGXuP-wAoPPmIGvBctSkkwnhMF8UQXLBmwlIT43Mudc9ZuHgRLqlW1BT3OmhN9ugKTQHyzgCuzBmHqVgtXp6dRJYr0

Content-Type: image/png

| Với hình ảnh có định dạng file png tương ứng Content-Type: image/png | | Body | Binary file: choose file | Ví dụ trong postman: chọn body binary, rồi chọn file tương ứng với máy tính local. | **Upload an object using CURL through RESTful API** > curl -i -T myobject -X PUT -H "X-Auth-Token: \" \/mycontainer/myobject > > curl -v -i --data-binary 50GB -X PUT -H "Content-Type:application/octet-stream" -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle/test.txt](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle/test.txt) #### 4. Upload large object (object size > 5GB) | Url | /v1/{account}/{container}/{name\_object}/{segment\_object\_name} | | ------ | ---------------------------------------------------------------- | | Method | POST | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "container" là tên container. \+ "name\_object" tên của object muốn lấy nằm trong container. **Upload an object using CURL through RESTful API** Với các object có kích thước lớn (kích thước > 5GB) thì vStorage không hỗ trợ upload theo flow bình thường. Để có thể tải lên được những object này, cần phải thực hiện các bước sau: * **Bước 1: Tạo segments container** vStorage dùng container segments để lưu trữ danh sách tất cả các segment objects của mỗi large object. Do đó, trước khi upload một large cần phải tạo container nếu nó chưa tồn tại, nếu nó đã tồn tại trước đó, không cần phải tạo lại thêm lần nữa. Tên container này có pattern \ Ví dụ: container bạn muốn lưu trữ large object có tên là: ***\*** thì segments container của nó sẽ có tên là ***\***. Để tạo container, vui lòng tham chiếu đến mục \ * **Bước 2: Chia một large object thành những phần nhỏ hơn (segment a large object into segment objects)** Việc chia một large object thành những phần riêng biệt có thể dùng command line, client tool hoặc library. Ví dụ: Upload object ***myobject*** (10 GB), segment object ***myobject*** này các segment objects: * * 00000001 (2GB) * 00000002 (2GB) * 00000003 (2GB) * 00000004 (2GB) * 00000005 (2GB) * **Bước 3: Upload các phần này lên vStorage dùng RESTful API (uploads the segment objects using RESTful API)** Việc upload các segment objects như upload các small objects dùng Postman, CURL hay bất kỳ client tool, library nào hỗ trợ upload file thông qua HTTP. Sau khi upload từng segment object lên vStorage, response trả về sẽ gồm giá trị Etag, giá trị này được dùng tạo nội dung Json cho manifest. Ví dụ: Upload các segment objects của Object ***myobject*** dùng CURL: > curl -X PUT -H 'X-Auth-Token: \' > > http\://\/container/myobject/00000001 --data-binary '00000001' > > \=> ETAG: etagoftheobjectsegment1 > > curl -X PUT -H 'X-Auth-Token: \' http\://\/container/myobject/00000002 --data-binary '00000002' > > \=> ETAG: etagoftheobjectsegment2 > > curl -X PUT -H 'X-Auth-Token: \' http\://\/container/myobject/00000003 --data-binary '00000003' > > \=> ETAG: etagoftheobjectsegment3 > > curl -X PUT -H 'X-Auth-Token: \' http\://\/container/myobject/00000004 --data-binary '00000004' > > \=> ETAG: etagoftheobjectsegment4 > > curl -X PUT -H 'X-Auth-Token: \' http\://\/container/myobject/00000005 --data-binary '00000005' > > \=> ETAG: etagoftheobjectsegment5 * **Bước 4: Tạo nội dung Json cho manifest (build manifest content)** Nội dung của manifest là một chuỗi Json với các keys sau: | **Key** | **Description** | | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | path | Đường dẫn lưu trữ của segment (the path to the segment object (not including account) /container/object\_name) | | etag | Giá trị checksum của segment object, được trả về sau khi upload thành công 1 segment object lên vStorage (the ETag given back when the segment object was PUT) | | size\_bytes | Kích thước của mỗi segment object với đơn vị bytes (the size of the complete segment object in bytes) | Ví dụ: Tạo nội dung Json cho manifest cho object ***myobject***: > \[{"path": "/container/myobject/00000001", "etag": "etagoftheobjectsegment1", "size\_bytes": 2000000000}, {"path": /container/myobject/00000001", "etag": "etagoftheobjectsegment2", "size\_bytes": 2000000000},{"path": /container/myobject/00000003", "etag": "etagoftheobjectsegment3", "size\_bytes": 2000000000},{"path": /container/myobject/00000004", "etag": "etagoftheobjectsegment4", "size\_bytes": 2000000000},{"path": /container/myobject/00000005", "etag": "etagoftheobjectsegment5", "size\_bytes": 2000000000}] * **Bước 5: Upload nội dung Json của manifest lên vStorage (upload the manifest content in Json form)** Việc upload nội dung manifest như upload bất kỳ một textjson content nào khác lên vStorage dùng Postman, CURL hay bất kỳ client tool, library. > curl -i -X PUT -H "X-Auth-Token: ${\}" ${\}/mybigfilescontainer/file?multipart-manifest=put -d '\[{"path": "/container/myobject/00000001", "etag": "etagoftheobjectsegment1", "size\_bytes": 2000000000}, {"path": /container/myobject/00000001", "etag": "etagoftheobjectsegment2", "size\_bytes": 2000000000},{"path": /container/myobject/00000003", "etag": "etagoftheobjectsegment3", "size\_bytes": 2000000000},{"path": /container/myobject/00000004", "etag": "etagoftheobjectsegment4", "size\_bytes": 2000000000},{"path": /container/myobject/00000005", "etag": "etagoftheobjectsegment5", "size\_bytes": 2000000000}]' **Ví dụ thực tế về upload một large object:** Upload một large object có kích thước là 10 GB với đường dẫn sau ***\*** đến container ***\*** * **Bước 1: Tạo segments container** > curl -i -X PUT -H "x-auth-token: ${\}" ${\}/mybigfilescontainer\_segments * **Bước 2: Chia \ thành nhiều segment objects dùng command line split** > split -b 40000 /home/hientt5/large\_file/largefile > > Lệnh split sẽ segment file ***\*** thành những segment objects sau: > > -rw-r--r-- 1 ron ron 100000000 apr 24 18:21 file > > -rw-r--r-- 1 ron ron 40000000 apr 24 18:39 xaa > > -rw-r--r-- 1 ron ron 40000000 apr 24 18:39 xab > > -rw-r--r-- 1 ron ron 20000000 apr 24 18:39 xac * **Bước 3: Upload những segment objects trên lên vStorage** > curl -i -X PUT -H "x-auth-token: ${\}" ${\}/mybigfilescontainer\_segments/xaa --data-binary @xaa > > \=> ETAG: 48e9a108a3ec623652e7988af2f88867 > > curl -i -X PUT -H "x-auth-token: ${\}" ${\}/mybigfilescontainer\_segments/xab --data-binary @xab > > \=> ETAG: 48e9a108a3ec623652e7988af2f88867 > > curl -i -X PUT -H "x-auth-token: ${\}" ${\}/mybigfilescontainer\_segments/xac --data-binary @xac > > \=> ETAG: 10e4462c9d0b08e7f0b304c4fbfeafa3 * **Bước 4: Tạo nội dung Json cho manifest** > Tạo nội dung Json của manifest như sau: > > \[{"path":"/mybigfilescontainer\_segments/xaa", > > "etag":"48e9a108a3ec623652e7988af2f88867", > > "size\_bytes":4000000000}, > > {"path":"/mybigfilescontainer\_segments/xab", > > "etag":"48e9a108a3ec623652e7988af2f88867", > > "size\_bytes":4000000000}, > > {"path":"/mybigfilescontainer\_segments/xac", > > "etag":"10e4462c9d0b08e7f0b304c4fbfeafa3", > > "size\_bytes":2000000000}] * **Bước 5: Upload nội dung Json của manifest lên vStorage** > curl -i -X PUT -H "X-Auth-Token: ${\}" ${\}/mybigfilescontainer/file?multipart-manifest=put -d '\[{"path":"/mybigfilescontainer\_segments/xaa", > > "etag":"48e9a108a3ec623652e7988af2f88867", > > "size\_bytes":4000000000}, > > {"path":"/mybigfilescontainer\_segments/xab", > > "etag":"48e9a108a3ec623652e7988af2f88867", > > "size\_bytes":4000000000}, > > {"path":"/mybigfilescontainer\_segments/xac", > > "etag":"10e4462c9d0b08e7f0b304c4fbfeafa3", > > "size\_bytes":2000000000}]' * **Upload large object dùng Swift client tool** Việc upload một large object dùng Swift client tool rất đơn giản, về cơ bản, client tool này sẽ hỗ trợ tất cả các bước trên, người dùng chỉ cần truyền vào thông tin token để chứng thực, đường dẫn large object và kích thước của từng segment object. > Ví dụ: swift --os-auth-url --auth-version 3\\ > > \--os-project-name project1 --os-project-domain-name domain1 \\ > > \--os-username user --os-user-domain-name domain1 \\ > > \--os-password password upload test\_container -S 1073741824 large\_file #### 5. Download an object | Url | /v1/{account}/{container}/{name\_object} | | ------ | ---------------------------------------- | | Method | Get | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "container" là tên container. \+ "name\_object" tên của object muốn lấy nằm trong container. **Download an object using CURL through RESTful API** > curl -i -X GET -H "X-Auth-Token: \" \/mycontainer/myobject > > curl -v -i -X GET -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle/test.txt](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle/test.txt) #### 6. Download a large object | Url | /v1/{account}/{container}/{name\_object} | | ------ | ---------------------------------------- | | Method | Get | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "container" là tên container. \+ "name\_object" tên của object muốn lấy nằm trong container. **Upload an object using CURL through RESTful API** > curl -i -X GET -H "X-Auth-Token: \" \/mycontainer/myobject?multipart-manifest=get > > curl -v -i -X GET -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle/test.txt?multipart-manifest=get](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle/test.txt?multipart-manifest=get) #### 7. Delete a large object | Url | /v1/{account}/{container}/{name\_object}?multipart-manifest=delete | | ------ | ------------------------------------------------------------------ | | Method | Delete | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "container" là tên container. \+ "name\_object" tên của object muốn lấy nằm trong container. **Delete a large object using CURL through RESTful API** > curl -i -X DELETE -H "X-Auth-Token: \" \/mycontainer/myobject?multipart-manifest=delete > > curl -v -i -X GET -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle/test.txt?multipart-manifest=delete](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle/test.txt?multipart-manifest=delete) #### 8. Delete an object | Url | /v1/{account}/{container}/{name\_object} | | ------ | ---------------------------------------- | | Method | Delete | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "container" là tên container. \+ "name\_object" tên của object muốn xóa nằm trong container. **Delete an object using CURL through RESTful API** > curl -i -X DELETE -H "X-Auth-Token: \" \/mycontainer/myobject > > curl -v -i -X DELETE -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle/test.txt](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle/test.txt) #### 9. Copy an object | Url | /v1/{account}/{container}/{name\_object} | | ----------- | ---------------------------------------- | | Method | COPY | | Header | X-Auth-Token | | Destination | {dest\_container}/{name\_object} | | Body | (Optional) | * Trong đó: \+ "container" là tên container. \+ "name\_object" tên của object muốn copy nằm trong container. \+ “dest\_container” tên của destination container **Copy an object using CURL through RESTful API** > curl -i -X COPY -H "X-Auth-Token: \" -H "Destination: anothercontainer/myobject" \/mycontainer/myobject > > curl -v -i -X COPY -H "Destination: lifecycle/test.txt" -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle/test.txt](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle/test.txt) #### 10. Delete a container | Url | /v1/{account}/{container} | | ------ | ------------------------- | | Method | Delete | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "container" là tên container cần được xóa. **Delete a container using CURL through RESTful API** > curl -s -S -X DELETE -H "X-Auth-Token: \" \/mycontainer > > curl -v -i -X DELETE -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle) #### 11. Rename an object | Url | /v1/{account}/{container}/{name\_object} | | ------ | ---------------------------------------- | | Method | COPY and DELETE | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "container" là tên container chứa đối tượng cần rename. \+ “name\_object” là tên của đối tượng cần được rename. * Để rename một object, cần thực hiện hai bước sau: \+ Copy object đó với tên mới \+ Xóa object cũ **Rename an object using CURL through RESTful API** > curl -i -X COPY -H "X-Auth-Token: \" -H "Destination: anothercontainer/new\_myobject" \/mycontainer/myobject > > curl -i -X DELETE -H "X-Auth-Token: \" \/mycontainer/myobject > > curl -v -i -X COPY -H "Destination: lifecycle/new\_test.txt" -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle/test.txt](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle/test.txt) > > curl -v -i -X DELETE -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle/test.txt](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle/test.txt) #### 12. List all containers | Url | /v1/{account} | | ------ | ------------- | | Method | GET | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "account" là tên hoặc ID của account cần liệt kê danh sách containers. **List all container using CURL through RESTful API** > curl -s -S -X GET -H "X-Auth-Token: \" \ > > curl -v -i -X GET -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399) #### 13. List content of a container | Url | /v1/{account}/{container} | | ------ | ------------------------- | | Method | GET | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "account" là tên hoặc ID của account cần liệt kê danh sách containers. \+ "container" là tên của container cần liệt kê nội dung. **List contents of a container using CURL through RESTful API** > curl -s -S -X GET -H "X-Auth-Token: \" \/mycontainer > > curl -v -i -X GET -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle) #### 14. Get tempURL of an object | Url | /v1/{account}/{container}/{name\_object} | | ------ | ---------------------------------------- | | Method | GET | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "account" là tên hoặc ID của account cần liệt kê danh sách containers. \+ "container" là tên của container cần liệt kê nội dung. \+ “name\_object” là tên đối tượng cần tạo tempurl. * Để tạo một tempurl của một object, cần thực hiện các bước sau: \+ Lấy về secret key của container chứa object đó. \+ Tạo tempurl dựa trên secret key đó. **Get secret key từ giá trị của field \_X-Account-Meta-Temp-URL-Key**\_\*\* của meta-data của container dùng CURL thông qua RESTful API\*\* > curl -s -S -X GET -H "X-Auth-Token: \" \/mycontainer > > curl -v -i -X GET -H "X-Auth-Token: gAAAAABdQQ8uIM6CWmA85hKi6MtOvuGP1qok8OJzp0-h74QAn9ptncjT16sg0pxxilUSCPgFeb9NKpNfmkD9kDLYRAPkymOB9wlNWNTkiz20m2uZpCeTIDUpPMO110rSXBMaE8Gszq9BLiKFyuHVmTEKeyoQ3qEFxitXilEwIg201IRtbJFiCa0" \\ > > [https://\/v1/AUTH\_a5bf65ca71594d85a60dc73cf9fc8399/test\_lifecycle](https://sw-hcm-1.vinadata.vn/v1/AUTH_a5bf65ca71594d85a60dc73cf9fc8399/test_lifecycle) **Get tempurl use script sau** > \#!/bin/bash > > seconds=\ > > method=GET > > expires=$(( $(date '+%s') + $seconds )) > > path='\/\' > > fullpath=\`echo $OS\_STORAGE\_URL | sed 's/http.\*\\/v1/\\/v1/'\`"/"$path > > key=${secret\_key} > > sig=\`printf '%s\n%s\n%s' $method $expires $fullpath | openssl sha1 -hmac $key | awk '{print $2}'\` > > \# print the URL > > echo "${OS\_STORAGE\_URL}/${path}?temp\_url\_sig=${sig}\&temp\_url\_expires=$ > > {expires}" #### 15. Create a folder | Url | /v1/{account}/{container}/{new\_folder} | | ------ | --------------------------------------- | | Method | PUT | | Header | X-Auth-Token | | Body | (Optional) | * Trong đó: \+ "account" là tên hoặc ID của account cần liệt kê danh sách containers. \+ "container" là tên của container cần liệt kê nội dung. \+ “new\_folder” là tên của thư mục mới cần tạo. **Create a folder using CURL through RESTful API** > curl -s -S -X PUT -H "X-Auth-Token: \" -H “Content-Length: 0” -H “Content-Type: application/directory” \/mycontainer/newfolder > > curl -X PUT -i [https://\/v1/AUTH\_f0a1d142185e4f8dae22ae67764d099b/syncdata1/newfolder/](https://sw-hcm-1.vinadata.vn/v1/AUTH_f0a1d142185e4f8dae22ae67764d099b/syncdata1/newfolder/) -H "Content-Length:0" -H "Content-Type:application/directory" -H "X-Auth-Token: gAAAAABfKhbKq-9EVUhbSjPMJEMiPh7yJ0fXCZ33\_\_J1dIQJaN58UPWKg96mAx9VGp3X7H-LyJhT0S5bN4dqKOCPERRQ8zw2Mo0zVRxlOG861vEWGKR1vkMbykAWTETa8cMnrXK6W2LYXkCpefJw75Q62UDIt1dmjT7WidpnICowW26FKp7B9WM" --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.vngcloud.vn/vng-cloud-document/vstorage/object-storage/vstorage-hcm03/api-developers/vstorage-swift-rest-api/using-swift-rest-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.