*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.

MemoryStoreSortedMapItem

Đại diện cho một mục trong cấu trúc bản đồ được sắp xếp.

Thuộc Tính

pathstring

Con đường tài nguyên của kho lưu trữ bản đồ được sắp xếp theo thứ tự.

Định dạng: universes/{universe_id}/memory-store/sorted-maps/{memory_store_sorted_map_id}/items/{memory_store_sorted_map_item_id}.

valueJSON value

Giá trị của mục.

Giá trị JSON có thể là null, boolean, string, number, array hoặc object.

etagstring
Chỉ Xuất

Máy chủ đã tạo thẻ của một mục.

Một trong những thông tin sau đây cho expiration:

ttlstring
Chỉ Nhập

TTL cho mục.

expireTimestring
Chỉ Xuất

Thời gian hết hạn của mục. Chuỗi này được định dạng là Dấu thời gian.

idstring

Tên của mục.

Một trong những thông tin sau đây cho sortKey:

stringSortKeystring

Vật phẩm sẽ được sắp xếp theo chữ cái theo chuỗi này.

numericSortKeynumber

Vật phẩm sẽ được sắp xếp theo số này.

URL Cơ Sở
https://apis.roblox.com
Tài nguyên 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

Danh sách Kho lưu trữ bộ nhớ sắp xếp các mục bản đồ
Bản Beta

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

Nhận và trả vật phẩm trong bản đồ với một trật tự và bộ lọc đã cho.

Phạm Vi
universe.memory-store.sorted-map:read
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

sorted_map_idstring
Bắt Buộc

ID bản đồ được sắp xếp.

Tham Số Truy Vấn
maxPageSizenumber

Số lượng tối đa của các mục bản đồ kho lưu trữ bộ nhớ được sắp xếp để 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 1 vị trí lưu trữ bản đồ được sắp xếp đượ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.

orderBystring

Nếu được xác định, kết quả được sắp xếp theo các trường được xác định.

Giá trị phải là một danh sách phân cách bằng dấu phẩy của các trường, với một chữ "desc" tùy chọn cho mỗi trường để sắp xếp theo thứ tự giảm dần chứ không phải tăng dần giá trị.Bạn có thể truy cập các trường con với một . operator.

Kết quả có thể được sắp xếp theo các trường sau: id.

Ví dụ: "id desc".

filterstring

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

Lọc phù hợp với Ngôn ngữ Biểu hiện Chung (CEL).Chỉ có các trường id và sortKey được hỗ trợ.Về các vận hành viên, chỉ < , > và && được phép'

Ví dụ: id > "key-001" && id < "key-100".

Phản Hồi

Một danh sách MemoryStoreSortedMapItems trong bộ sưu tập cha.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

Các mục MemoryStoreSortedMap từ MemoryStoreSortedMap đượ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}/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}'
Phản Hồi
{

  "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

Tạo vật phẩm bản đồ lưu trữ bộ nhớ sắp xếp
Bản Beta

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

Tạo vật phẩm bản đồ được chỉ định nếu nó không tồn tại.

Phạm Vi
universe.memory-store.sorted-map:write
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

sorted_map_idstring
Bắt Buộc

ID bản đồ được sắp xếp.

Tham Số Truy Vấn
idstring

ID để sử dụng cho vị trí bản đồ lưu trữ bộ nhớ, sẽ trở thành thành phần cuối cùng của con đường tài nguyên của vị trí bản đồ lưu trữ bộ nhớ.

Giá trị này nên là một chuỗi 1-127 ký tự hỗ trợ các ký tự alphanumeric và đặc biệt.ID này là nhạy cảm với chữ hoa.ID phải được mã hóa URL nếu nó chứa bất kỳ URL phá vỡ các ký tự đặc biệt nào.

Yêu Cầu Cơ ThểMemoryStoreSortedMapItem
Phản HồiMemoryStoreSortedMapItem
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"

}'
Phản Hồi
{

  "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

Nhận vật phẩm bản đồ lưu trữ bộ nhớ
Bản Beta

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

Nhận và trả giá trị của chìa khóa được cho trong bản đồ.

Phạm Vi
universe.memory-store.sorted-map:read
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

sorted_map_idstring
Bắt Buộc

ID bản đồ được sắp xếp.

item_idstring
Bắt Buộc

ID của mục.

Phản HồiMemoryStoreSortedMapItem
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}'
Phản Hồi
{

  "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

Xóa mục bản đồ lưu trữ bộ nhớ được sắp xếp
Bản Beta

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

Xóa mục được chỉ định khỏi bản đồ.

Phạm Vi
universe.memory-store.sorted-map:write
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

sorted_map_idstring
Bắt Buộc

ID bản đồ được sắp xếp.

item_idstring
Bắt Buộc

ID của mục.

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

Cập nhật vị trí bản đồ lưu trữ bộ nhớ Các mục được sắp xếp
Bản Beta

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

Cập nhật mục bản đồ được chỉ định.

Phạm Vi
universe.memory-store.sorted-map:write
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

sorted_map_idstring
Bắt Buộc

ID bản đồ được sắp xếp.

item_idstring
Bắt Buộc

ID của mục.

Tham Số Truy Vấn
allowMissingboolean

Nếu được đặt thành true, và không tìm thấy mục bản đồ lưu trữ bộ nhớ, một mục bản đồ lưu trữ bộ nhớ được sắp xếp được tạo ra.

Yêu Cầu Cơ ThểMemoryStoreSortedMapItem
Phản HồiMemoryStoreSortedMapItem
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"

}'
Phản Hồi
{

  "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"

}