Tích hợp vStorage API
Last updated
Last updated
Địa chỉ
VNG CorporationĐể xem hướng dẫn tích hợp vStorage API, bạn có thể thực hiện qua vStorage Portal theo hướng dẫn bên dưới:
Đăng nhập vào https://vstorage.console.vngcloud.vn.
Chọn thư mục Tích hợp.
Chọn biểu tượng vStorage API.
Tại mục Cấp quyền, bạn cần điền thông tin cần thiết để cấu hình vStorage API của bạn bao gồm:
Nhập Client ID. Một Client ID là một chuỗi ký tự được sử dụng bởi Service API để định danh ứng dụng, đồng thời cũng được dùng để xây dựng "authorization URL" hiển thị phía người dùng. Bạn có thể tạo và quản lý Client ID thông qua hệ thống vIAM. Client ID sẽ được tự động sinh ra khi bạn tạo mới một Service Account. Chi tiết tham khảo tại Khởi tạo tài khoản Service Account.
Nhập Client Secret tương ứng của Client ID vừa nhập. Cặp Client ID và Client Secret được bạn tạo và quản lý thông qua hệ thống vIAM. Bạn có thể chọn Click here to manage your Client ID. để chúng tôi điều hướng bạn tới hệ thống vIAM và chi tiết là các màn hình quản lý Service Account. Chi tiết tham khảo tại Khởi tạo tài khoản Service Account.
Sau khi hoàn tất chọn cấu hình Cấp quyền, chọn Xác thực để chuyển tới màn hình Cấu hình. Bạn luôn có thể quay lại đây để thay đổi thông tin Cấp quyền của mình, sau đó chọn lại Xác thực để cập nhật danh sách S3 Rest API theo thông số mới của bạn.
Để trải nghiệm sử dụng vStorage API, bạn cần có ít nhất 1 Client ID, Client Secret( thông tin này lấy tại Service Account). Để tạo Service Account, tham khảo thêm tại Khởi tạo tài khoản Service Account. Bạn có thể sử dụng Service Account này để tạo (hoặc xóa) nhiều container, container như một đơn vị lưu trữ (giống như một thư mục), trong mỗi container khách hàng có thể upload, get, delete nhiều object tương ứng (object ở đây được hiểu như một file, hoặc một folder con trong container).
Quy trình cơ bản: Xác thực -> Tạo project ->Tạo container -> Upload Object
Chúng tôi cung cấp cho bạn một giao diện thao tác nhanh với vStorage API, sau khi bạn thực hiện tích hợp theo hướng dẫn tại Tích hợp vStorage API, hãy tiếp tục làm theo hướng dẫn:
Chọn Try it out.
Nhập đầu vào cho mỗi API.
Chọn Execute
Kiểm tra kết quả trả về.
Bên dưới là ví dụ về 4 vStorage API cơ bản nhất mà bạn có thể trải nghiệm:
1. Tạo project
Điều kiện cần:
Người dùng trả sau
Kết quả thực hiện:
Project được khởi tạo với các thuộc tính:
Project type: Gold class.
Region: HCM01.
2. Tạo container
API bên dưới sử dụng để bạn có thể khởi tạo một container trong một project.
3. Xóa một container
API bên dưới sử dụng để bạn có thể xóa một container trong một project.
4. Xóa một object
API bên dưới sử dụng để bạn có thể xóa một object trong một container.
Ngoài cách sử dụng nhanh trên vStorage Portal, bạn có thể sử dụng vStorage API tại thiết bị cá nhân theo hướng dẫn tại Sử dụng vStorage API.