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

MemoryStoreQueueItem

แทนที่ไอเทมภายในโครงสร้างคิว

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของไอเทมคิวสโตร์หน่วยความจํา

รูปแบบ: universes/{universe_id}/memory-store/queues/{memory_store_queue_id}/items/{memory_store_queue_item_id}.

dataJSON value

มูลค่าของรายการคิว.

ค่า JSON จะเป็น null, boolean, string, number, array หรือ object ก็ได้

prioritynumber

ลำดับความสำคัญของรายการคิว.

หนึ่งในรายการต่อไปนี้สำหรับexpiration:

ttlstring
อินพุตเท่านั้น

TTL สำหรับรายการ.

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

เวลาหมดอายุของรายการ. สตริงนี้มีรูปแบบประทับเวลา

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

ชื่อของรายการ.

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

  "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

  "data": "JSON value",

  "priority": "number",

  "ttl": "3s",

  "id": "string"

}

MemoryStoreQueueItem

สร้างไอเทมคิวร้านความทรงจำ
เวอร์ชัน Beta

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items

สร้างรายการคิวใหม่

หาก ttl ถูกตั้งค่าไว้ รายการจะถูกลบออกจากคิวโดยอัตโนมัติหลังจากช่วงเวลาที่ระบุแล้ว

หากตั้งค่าตัวเลข priority จะถูกส่งเข้าสู่คิวตามมูลค่าลําดับความสําคัญยิ่งค่าสูงขึ้นเท่าใด รายการจะอยู่ใกล้กับด้านหน้าของคิวมากขึ้นเท่านั้นหากค่าลําดับความสําคัญเป็นเช่นเดียวกัน รายการจะถูกสอดเข้าหลังค่าที่มีลําดับความสําคัญเดียวกัน

ขอบเขต
universe.memory-store.queue:write
การจำกัด
  • คีย์ API: 1000 คำขอต่อนาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

หมายเหตุ: อัตราสูงสุดอาจต่ำกว่านี้ในช่วงที่มีการใช้งานสูง บาง Endpoints มีอัตราสูงสุดเพิ่มเติม เรียนรู้เพิ่มเติมเกี่ยวกับอัตราสูงสุด

คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

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

queue_idstring
จำเป็นต้องมี

ID คิว.

เนื้อหาคำขอMemoryStoreQueueItem
การตอบกลับMemoryStoreQueueItem
POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items' \

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

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

  --data '{

  "data": "JSON value",

  "priority": "number",

  "ttl": "3s"

}'
การตอบกลับ
{

  "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

  "data": "JSON value",

  "priority": "number",

  "id": "string"

}

MemoryStoreQueueItem

ยกเลิกรายการคิวเก็บหน่วยความจํา
เวอร์ชัน Beta

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard

ดิสการ์ดอ่านรายการจากด้านหน้าของคิว

ใช้เวลา readId จากการดำเนินการก่อนหน้า Read

ขอบเขต
universe.memory-store.queue:discard
การจำกัด
  • คีย์ API: 1000 คำขอต่อนาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

หมายเหตุ: อัตราสูงสุดอาจต่ำกว่านี้ในช่วงที่มีการใช้งานสูง บาง Endpoints มีอัตราสูงสุดเพิ่มเติม เรียนรู้เพิ่มเติมเกี่ยวกับอัตราสูงสุด

คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

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

queue_idstring
จำเป็นต้องมี

ID คิว.

เนื้อหาคำขอ
readIdstring

The readId ของการอ่านก่อนหน้านี้สำหรับการทิ้งรายการอ่าน.

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard' \

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

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

  --data '{

  "readId": "string"

}'

MemoryStoreQueueItem

อ่านรายการคิวของคลังหน่วยความจํา
เวอร์ชัน Beta

GET /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read

คืนจำนวนรายการที่กำหนดไว้ที่ด้านหน้าของคิว

ขอบเขต
universe.memory-store.queue:dequeue
การจำกัด
  • คีย์ API: 1000 คำขอต่อนาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม

หมายเหตุ: อัตราสูงสุดอาจต่ำกว่านี้ในช่วงที่มีการใช้งานสูง บาง Endpoints มีอัตราสูงสุดเพิ่มเติม เรียนรู้เพิ่มเติมเกี่ยวกับอัตราสูงสุด

คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

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

queue_idstring
จำเป็นต้องมี

ID คิว.

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

จํานวนรายการที่จะอ่านจากคิว หากไม่ระบุ จะส่งคืน 1 รายการ ค่าสูงสุดคือ 200; ค่าที่สูงกว่า 200 จะถูกบังคับให้เป็น 200.

allOrNothingboolean

หาก all_or_nothing เป็นจริงและหมายเลขวัตถุที่ร้องขอไม่พร้อมใช้งาน จะส่งคืนข้อผิดพลาด 404

มิฉะนั้นจะคืนเส้นทางและอ่าน_id ของการอ่านข้อมูลและรายการรายชื่อของ MemoryStoreQueue.

invisibilityWindowstring

หน้าต่างล่องหนสำหรับไอเทมที่อ่านในเวลาไม่กี่วินาที

รายการที่อ่านไม่สามารถมองเห็นได้ในการอ่านต่อไปในระหว่างระยะเวลาหน้าต่างที่มองไม่เห็น

ต้องเขียนในวินาทีที่มากกว่า 0 และสิ้นสุดด้วย s

ค่าเริ่มต้นเป็น 30s .

การตอบกลับ

คืนจำนวนรายการที่กำหนดไว้ที่ด้านหน้าของคิว

readIdstring

ตัวระบุการอ่านการดำเนินการ

สิ่งนี้สามารถส่งไปยัง :discard เพื่อที่จะทำเครื่องหมายรายการที่ประมวลผล.

GET /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read?count={integer}&allOrNothing={boolean}&invisibilityWindow={string}' \

  -H 'x-api-key: {your-api-key}'
การตอบกลับ
{

  "readId": "string",

  "items": [

    {

      "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

      "data": "JSON value",

      "priority": "number",

      "id": "string"

    }

  ]

}