*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

MemoryStoreSortedMapItem

Mewakili item dalam struktur peta yang disortir.

Atribut

pathstring

Jalur sumber daya dari toko memori memilah item peta.

Format: universes/{universe_id}/memory-store/sorted-maps/{memory_store_sorted_map_id}/items/{memory_store_sorted_map_item_id}.

valueJSON value

Nilai dari item.

Nilai JSON dapat berupa null, boolean, string, number, array, atau object.

etagstring
Hanya Output

Server menghasilkan tag item.

Salah satu dari yang berikut untuk expiration:

ttlstring
Hanya Input

The TTL untuk item.

expireTimestring
Hanya Output

Waktu kedaluwarsa item. String ini diformat sebagai Timestamp.

idstring

Nama item.

Salah satu dari yang berikut untuk sortKey:

stringSortKeystring

Item akan disortir leksikografis sesuai dengan string ini.

numericSortKeynumber

Item akan disortir sesuai dengan nomor ini.

Base URL
https://apis.roblox.com
Resource 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

Daftar Item Memori Toko Terurut
Beta

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

Mendapatkan dan mengembalikan item di peta dengan urutan dan filter yang diberikan.

Cakupan
universe.memory-store.sorted-map:read
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

sorted_map_idstring
Diperlukan

ID peta yang disortir.

Parameter Kueri
maxPageSizenumber

Jumlah maksimum item peta penyimpanan memori yang disortir untuk dikembalikan.Layanan mungkin kembali kurang dari nilai ini.Jika tidak ditentukan, paling banyak 1 item peta penyimpanan memori diurutkan dikembalikan.Nilai maksimum adalah 100 dan nilai yang lebih tinggi ditetapkan ke 100.

pageTokenstring

Token halaman, diterima dari panggilan sebelumnya, untuk mengambil halaman berikutnya.

Saat paginasi, semua parameter lain yang disediakan untuk panggilan berikutnya harus cocok dengan panggilan yang memberikan token halaman.

orderBystring

Jika ditentukan, hasil diurutkan sesuai dengan bidang yang ditentukan.

Nilai harus menjadi daftar terpisah koma dari bidang, dengan prefiks "desc" opsional per bidang untuk disortir berdasarkan nilai menurun daripada naik.Anda dapat mengakses subbidang dengan operator ..

Hasil dapat diurutkan oleh bidang berikut: id.

Contoh: "id desc".

filterstring

Bidang ini dapat ditetapkan untuk memfilter sumber daya yang dikembalikan.

Filterisasi sesuai dengan Bahasa Ekspresi Bersama (CEL).Hanya bidang id dan sortKey yang didukung.Dalam hal operator, hanya < , > dan && yang diizinkan

Contoh: id > "key-001" && id < "key-100".

Respons

Daftar Item MemoriStoreSortedMap di koleksi orangtua.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

MemoriStoreSortedMapItems dari MemoriStoreSortedMap yang ditentukan.

nextPageTokenstring

Token yang dapat Anda kirim sebagai parameter pageToken untuk mengambil halaman berikutnya. Jika bidang ini diabaikan, tidak ada halaman berikutnya.

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}'
Respons
{

  "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

Buat Item Peta Penyimpanan Memori Terurut
Beta

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

Membuat item peta yang ditentukan jika tidak ada.

Cakupan
universe.memory-store.sorted-map:write
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

sorted_map_idstring
Diperlukan

ID peta yang disortir.

Parameter Kueri
idstring

ID untuk digunakan untuk item peta penyimpanan memori yang disortir, yang akan menjadi komponen terakhir dari jalur sumber daya penyimpanan memori yang disortir.

Nilai ini harus menjadi string karakter 1-127 yang mendukung karakter alfanumerik dan khusus.ID ini sensitif huruf besar.ID harus dienkodekan menjadi URL jika berisi URL yang memecah karakter khusus.

Request BodyMemoryStoreSortedMapItem
ResponsMemoryStoreSortedMapItem
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"

}'
Respons
{

  "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

Dapatkan Item Peta Penyimpanan Memori Terurut
Beta

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

Mendapatkan dan mengembalikan nilai kunci yang diberikan di peta.

Cakupan
universe.memory-store.sorted-map:read
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

sorted_map_idstring
Diperlukan

ID peta yang disortir.

item_idstring
Diperlukan

ID barang.

ResponsMemoryStoreSortedMapItem
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}'
Respons
{

  "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

Hapus Item Peta Toko Memori Terurut
Beta

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

Menghapus item yang ditentukan dari peta.

Cakupan
universe.memory-store.sorted-map:write
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

sorted_map_idstring
Diperlukan

ID peta yang disortir.

item_idstring
Diperlukan

ID barang.

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

Perbarui Item Peta Penyimpanan Memori Diurutkan
Beta

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

Memperbarui item peta yang ditentukan.

Cakupan
universe.memory-store.sorted-map:write
PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

sorted_map_idstring
Diperlukan

ID peta yang disortir.

item_idstring
Diperlukan

ID barang.

Parameter Kueri
allowMissingboolean

Jika diatur ke benar, dan item peta penyimpanan memori tidak ditemukan, item peta penyimpanan memori diatur dibuat.

Request BodyMemoryStoreSortedMapItem
ResponsMemoryStoreSortedMapItem
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"

}'
Respons
{

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

}