*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

DataStore

แทนที่เก็บข้อมูล

คุณลักษณะ

pathstring

ร้านค้า

รูปแบบ: universes/{universe_id}/data-stores/{data_store_id}.

createTimestring
เอาต์พุตเท่านั้น

เวลาที่สร้างไดเรกทอรีข้อมูลเมื่อสร้างคลังข้อมูล. สตริงนี้มีรูปแบบประทับเวลา

idstring
เอาต์พุตเท่านั้น

ID ร้านค้าตรงกับส่วนสุดท้ายของเส้นทาง.

URL หลัก
https://apis.roblox.com
แหล่งข้อมูล DataStore
{

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

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

  "id": "string"

}

DataStore

List Data Stores
เวอร์ชัน Beta

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

ส่งคืนรายการของคลังข้อมูล

ขอบเขต
universe-datastores.control:list
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

ID ของจักรวาล.

พารามิเตอร์คิวรี
maxPageSizenumber

จํานวนสโตร์ข้อมูลสูงสุดที่จะส่งคืนบริการอาจ返回值น้อยกว่านี้หากไม่ระบุ จะมีการคืนค่าสถานที่เก็บข้อมูลสูงสุด 10 แห่งมูลค่าสูงสุดคือ 100 และมูลค่าที่สูงกว่าจะถูกตั้งเป็น 100.

pageTokenstring

โทเค็นหน้าที่ได้รับจากการโทรก่อนหน้านี้เพื่อดึงหน้าต่อไป

เมื่อจัดหน้า พารามิเตอร์อื่น ๆ ทั้งหมดที่ให้กับการโทรต่อไปจะต้องตรงกับการโทรที่ให้โทเค็นหน้า.

filterstring

ฟิลด์นี้อาจถูกตั้งค่าเพื่อกรองทรัพยากรที่ส่งคืน

ฟิลด์ filter สนับสนุนส่วนย่อยที่เล็กมากของ CEL:

  • สนับสนุนเฉพาะฟิลด์ id เท่านั้น
  • มีฟังก์ชัน startsWith เท่านั้นที่สามารถใช้ได้; ไม่มีตัวประกอบอื่นหรือสร้างในตัวเองไม่สนับสนุน

ตัวกรองตัวอย่าง: id.startsWith("foo").

การตอบกลับ

รายการของ DataStores ในคอลเลกชันรากฐาน

dataStoresarray<DataStore>

คลังข้อมูลจากจักรวาลที่ระบุ.

nextPageTokenstring

โทเคนที่คุณสามารถส่งเป็นพารามิเตอร์ pageToken เพื่อดึงหน้าถัดไป หากฟิลด์นี้ถูกข้ามไป จะไม่มีหน้าต่อไป.

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}'
การตอบกลับ
{

  "dataStores": [

    {

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

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

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

DataStore

Snapshot Data Stores
เวอร์ชัน Beta

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

สร้างสแน็ปช็อตใหม่ของคลังข้อมูลในประสบการณ์

หลังจากสแน็ปช็อตแล้ว การเขียนครั้งต่อไปในทุกคีย์ในประสบการณ์จะสร้างการสำรองข้อมูลที่มีเวอร์ชันตามเวลาของการเขียนครั้งล่าสุด ไม่ว่าจะเป็นเวลาใด

ในความเป็นจริงทั้งหมดข้อมูลปัจจุบันในเวลาของสแน็ปช็อตจะได้รับประกันว่าจะมีอยู่เป็นการสำรองข้อมูลที่มีเวอร์ชันอย่างน้อย 30 วัน

สามารถถ่ายภาพสแน็ปช็อตได้วันละครั้งต่อ UTC ต่อประสบการณ์หากสแน็ปช็อตล่าสุดถูกดำเนินการภายในวัน UTC เดียวกัน การดำเนินการนี้จะไม่มีผลและเวลาของสแน็ปช็อตล่าสุดจะถูกส่งคืน

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้สแน็ปช็อตดูคู่มือ เครื่องเก็บข้อมูล

ขอบเขต
universe-datastores.control:snapshot
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

ID ของจักรวาล.

เนื้อหาคำขอ
การตอบกลับ

คืนว่าได้รับภาพถ่ายใหม่หรือไม่และเวลาของภาพถ่ายล่าสุดหลังการดำเนินการ (ไม่ว่าจะมีภาพถ่ายใหม่หรือไม่ก็ตาม)

newSnapshotTakenboolean

ว่าสแน็ปช็อตใหม่ถูกจับโดยการดำเนินการนี้หรือไม่ (สามารถจับสแน็ปช็อตได้เพียงครั้งเดียวต่อประสบการณ์ต่อวัน UTC).

latestSnapshotTimestring

เวลาของสแน็ปช็อตล่าสุดหลังการดำเนินการ (ไม่ว่าจะสร้างสแน็ปช็อตใหม่หรือไม่) เวลานี้จะถูกส่งคืนเสมอใน UTC. สตริงนี้มีรูปแบบประทับเวลา

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 '{}'
การตอบกลับ
{

  "newSnapshotTaken": true,

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

}