*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

DataStore

Đại diện cho một kho lưu trữ dữ liệu.

Thuộc Tính

pathstring

Con đường tài nguyên của kho dữ liệu.

Định dạng: universes/{universe_id}/data-stores/{data_store_id}.

createTimestring
Chỉ Xuất

Thời gian chạy khi kho dữ liệu được tạo. Chuỗi này được định dạng là Dấu thời gian.

idstring
Chỉ Xuất

ID của kho dữ liệu. Phù hợp với phần cuối cùng của con đường.

URL Cơ Sở
https://apis.roblox.com
Tài nguyên DataStore
{

  "path": "universes/123/data-stores/some-data-store",

  "createTime": "2023-07-05T12:34:56Z",

  "id": "string"

}

DataStore

Danh sách kho dữ liệu
Bản Beta

GET /cloud/v2/universes/{universe_id}/data-stores

Trả về một danh sách các kho lưu trữ dữ liệu.

Phạm Vi
universe-datastores.control:list
Giới Hạn
  • Khóa API: 5000 yêu cầu mỗi phút cho tất cả khóa API của một người dùng hoặc nhóm

Lưu ý: Trong các giai đoạn cao điểm, giới hạn về tần suất có thể thấp hơn. Một số điểm cuối có giới hạn tần suất bổ sung. Tìm hiểu thêm về giới hạn tần suất.

Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

Tham Số Truy Vấn
maxPageSizenumber

Số lượng tối đa các kho dữ liệu để trả về.Dịch vụ có thể trả về ít hơn giá trị này.Nếu không được xác định, tối đa 10 kho lưu trữ dữ liệu được trả về.Giá trị tối đa là 100 và giá trị cao hơn được đặt thành 100.

pageTokenstring

Một token trang, nhận từ cuộc gọi trước, để lấy lại trang tiếp theo.

Khi paginate, tất cả các tham số khác được cung cấp cho cuộc gọi tiếp theo phải phù hợp với cuộc gọi cung cấp token trang.

filterstring

Trường này có thể được đặt để lọc các tài nguyên được trả về.

Trường filter hỗ trợ một phần rất nhỏ của CEL:

  • Chỉ có trường id hỗ trợ.
  • Chỉ có chức năng startsWith có sẵn; không có nhà vận hành khác hoặc xây dựng bên trong được hỗ trợ.

Ví dụ bộ lọc: id.startsWith("foo").

Phản Hồi

Một danh sách Kho dữ liệu trong bộ sưu tập cha.

dataStoresarray<DataStore>

Các Kho Dữ Liệu từ Vũ Trụ được chỉ định.

nextPageTokenstring

Một token mà bạn có thể gửi như một tham số pageToken để lấy trang tiếp theo. Nếu trường này bị bỏ qua, không có trang tiếp theo.

GET /cloud/v2/universes/{universe_id}/data-stores
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores?maxPageSize=10&pageToken={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
Phản Hồi
{

  "dataStores": [

    {

      "path": "universes/123/data-stores/some-data-store",

      "createTime": "2023-07-05T12:34:56Z",

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

DataStore

Kho lưu trữ dữ liệu ảnh chụp
Bản Beta

POST /cloud/v2/universes/{universe_id}/data-stores:snapshot

Lấy một bức ảnh mới của các kho dữ liệu trong một trải nghiệm.

Sau một bản lưu ảnh, viết tiếp theo cho mọi chìa khóa trong trải nghiệm sẽ tạo một bản sao lưu có phiên bản của dữ liệu trước đó, bất kể thời gian của lần viết cuối cùng.

Trên thực tế, tất cả dữ liệu hiện tại tại thời điểm bản sao lưu được đảm bảo có sẵn như một bản sao lưu có phiên bản trong vòng ít nhất 30 ngày.

Các bản lưu có thể được thực hiện một lần mỗi ngày UTC, theo kinh nghiệm.Nếu bản lưu mới nhất được thực hiện trong cùng ngày UTC, hoạt động này là không có gì và thời gian của bản lưu mới nhất sẽ được trả lại.

Để biết thêm thông tin về việc sử dụng bản sao lưu, hãy xem hướng dẫn Kho lưu trữ dữ liệu.

Phạm Vi
universe-datastores.control:snapshot
Giới Hạn
  • Khóa API: 60 yêu cầu mỗi phút cho tất cả khóa API của một người dùng hoặc nhóm

Lưu ý: Trong các giai đoạn cao điểm, giới hạn về tần suất có thể thấp hơn. Một số điểm cuối có giới hạn tần suất bổ sung. Tìm hiểu thêm về giới hạn tần suất.

Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

Yêu Cầu Cơ Thể
Phản Hồi

Trả về xem có bắt được một bản lưu mới hay không và thời gian của bản lưu mới nhất sau khi thực hiện (dù có bắt được bản lưu mới hay không).

newSnapshotTakenboolean

Liệu có bản lưu mới được thực hiện bởi hoạt động này hay không. (Chỉ có một bản lưu có thể được thực hiện cho mỗi trải nghiệm mỗi ngày UTC.).

latestSnapshotTimestring

Thời gian của bản sao lưu mới nhất sau khi thực hiện (dù có tạo bản sao lưu mới hay không). Thời gian này luôn được trả về UTC. Chuỗi này được định dạng là Dấu thời gian.

POST /cloud/v2/universes/{universe_id}/data-stores:snapshot
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores:snapshot' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{}'
Phản Hồi
{

  "newSnapshotTaken": true,

  "latestSnapshotTime": "2023-07-05T12:34:56Z"

}