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

MemoryStoreSortedMapItem

แทนที่ไอเทมภายในโครงสร้างแผนที่ที่เรียงลําดับไว้

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของไอเทมแผนที่ที่จัดเรียงของคลังหน่วยความจํา

รูปแบบ: universes/{universe_id}/memory-store/sorted-maps/{memory_store_sorted_map_id}/items/{memory_store_sorted_map_item_id}.

valueJSON value

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

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

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

เซิร์ฟเวอร์สร้างแท็กของไอเทม.

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

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

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

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

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

idstring

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

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

stringSortKeystring

รายการจะถูกจัดเรียงตามตัวอักษรตามสตริงนี้.

numericSortKeynumber

รายการจะถูกจัดเรียงตามหมายเลขนี้.

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

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

รายการหน่วยความจําสตอเรจที่จัดเรียงแผนที่ไอเทม
เวอร์ชัน Beta

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items

รับและส่งสิ่งของในแผนที่ด้วยลำดับและตัวกรองที่กำหนดไว้

ขอบเขต
universe.memory-store.sorted-map:read
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

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

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

ID แผนที่เรียงลําดับ.

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

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

pageTokenstring

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

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

orderBystring

หากระบุไว้ ผลลัพธ์จะถูกจัดเรียงตามช่องที่ระบุ

ค่าต้องเป็นรายการแยกกับจุลภาคของฟิลด์ที่มี "desc" เป็นส่วนท้ายที่เลือกได้เพื่อเรียงลําดับตามลําดับลงแทนที่จะเรียงลําดับตามมูลค่าเพิ่มขึ้นคุณสามารถเข้าถึงสนามย่อยด้วยตัวประกอบ .

ผลลัพธ์สามารถจัดเรียงตามฟิลด์ต่อไปนี้: id

ตัวอย่าง: "id desc".

filterstring

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

การกรองสอดคล้องกับภาษาการแสดงออกร่วม (CEL)สนับสนุนเฉพาะฟิลด์ id และ sortKey เท่านั้นในแง่ของผู้ดำเนินการเฉพาะ < , > และ && เท่านั้นที่อนุญาต

ตัวอย่าง: id > "key-001" && id < "key-100".

การตอบกลับ

รายการ MemoryStoreSortedMapItems ในคอลเลกชันราก

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

รายการ MemoryStoreSortedMap จาก MemoryStoreSortedMap ที่ระบุ.

nextPageTokenstring

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

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items?maxPageSize=1&pageToken={string}&orderBy={string}&filter={string}' \

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

  "memoryStoreSortedMapItems": [

    {

      "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

      "value": "JSON value",

      "etag": "string",

      "id": "string",

      "stringSortKey": "string"

    }

  ],

  "nextPageToken": "string"

}

MemoryStoreSortedMapItem

สร้างไอเทมแผนที่ความทรงจำที่จัดเรียงได้
เวอร์ชัน Beta

POST /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items

สร้างรายการแผนที่ที่กำหนดไว้หากไม่มีอยู่

ขอบเขต
universe.memory-store.sorted-map:write
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

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

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

ID แผนที่เรียงลําดับ.

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

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

ค่านี้ควรเป็นสตริงตัวอักษร 1-127 ที่สนับสนุนตัวอักษรภาษาอังกฤษและตัวอักษรพิเศษรหัสนี้มีความไวกับตัวอักษรใหญ่เล็กรหัสต้องถูกเข้ารหัสเป็น URL หากมี URL ที่มีตัวอักษรพิเศษที่ถูกทำลาย.

เนื้อหาคำขอMemoryStoreSortedMapItem
การตอบกลับMemoryStoreSortedMapItem
POST /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items?id=Hello!' \

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

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

  --data '{

  "value": "JSON value",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

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

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

รับไอเทมแผนที่เรียงลําดับคลังหน่วยความจํา
เวอร์ชัน Beta

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

รับและส่งค่าของกุญแจที่กำหนดในแผนที่

ขอบเขต
universe.memory-store.sorted-map:read
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

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

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

ID แผนที่เรียงลําดับ.

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

รหัสรายการ.

การตอบกลับMemoryStoreSortedMapItem
GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}' \

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

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

ลบไอเทมแผนที่คัดเลือกของคลังหน่วยความจํา
เวอร์ชัน Beta

DELETE /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

ลบรายการที่ระบุจากแผนที่

ขอบเขต
universe.memory-store.sorted-map:write
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

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

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

ID แผนที่เรียงลําดับ.

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

รหัสรายการ.

DELETE /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}' \

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

MemoryStoreSortedMapItem

อัปเดตรายการแผนที่ความทรงจำของร้านค้าที่จัดเรียง
เวอร์ชัน Beta

PATCH /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

อัปเดตรายการแผนที่ที่กำหนดไว้

ขอบเขต
universe.memory-store.sorted-map:write
คำขอพารามิเตอร์เส้นทาง
universe_idstring
จำเป็นต้องมี

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

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

ID แผนที่เรียงลําดับ.

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

รหัสรายการ.

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

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

เนื้อหาคำขอMemoryStoreSortedMapItem
การตอบกลับMemoryStoreSortedMapItem
PATCH /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}?allowMissing={boolean}' \

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

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

  --data '{

  "value": "JSON value",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

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

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}