*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

MemoryStoreSortedMapItem

Sıralanmış bir harita yapısı içinde bir öğeyi temsil eder.

Nitelikler

pathstring

Hafıza depolama sıralı harita öğesinin kaynak yolu.

Biçim: universes/{universe_id}/memory-store/sorted-maps/{memory_store_sorted_map_id}/items/{memory_store_sorted_map_item_id}.

valueJSON value

Öğenin değeri.

JSON değeri null, boolean, string, number, array ya da object olabilir.

etagstring
Yalnızca Çıkış

Sunucu bir öğenin etiketini oluşturdu.

expiration için şunlardan biri:

ttlstring
Yalnızca Giriş

Öğe için TTL.

expireTimestring
Yalnızca Çıkış

Öğenin sona erme süresi. Bu dizi Timestamp olarak biçimlendirilmiş.

idstring

Öğenin adı.

sortKey için şunlardan biri:

stringSortKeystring

Öğe, bu dizeye göre leksikografik olarak sıralanacaktır.

numericSortKeynumber

Öğe bu sayıya göre sıralanacaktır.

Taban URL
https://apis.roblox.com
MemoryStoreSortedMapItem Kaynağı
{

  "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

Hafıza Depolama Düzenlenmiş Harita Öğeleri Listesi
Beta

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

Verilen bir düzen ve filtre ile haritadaki öğeleri alır ve iade eder.

Kapsamlar
universe.memory-store.sorted-map:read
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

sorted_map_idstring
Gerekli

Sıralanmış harita ID'si.

Sorgu Parametreleri
maxPageSizenumber

Geri döndürülmesi gereken bellek depolama sıralamasındaki maksimum sayı.Hizmet bu değerden daha azını iade edebilir.Belirtilmediğinde, en fazla 1 bellek depolama sıralı harita öğesi geri döndürülür.Maksimum değer 100'dür ve daha yüksek değerler 100 olarak ayarlanır.

pageTokenstring

Bir önceki çağrıdan alınan bir sayfa jetonu, sonraki bir sayfa almak için.

Sayfa numaralandırırken, sonraki çağrıya verilen tüm diğer parametler, sayfa jetonu sağlayan çağrıya eşleşmelidir.

orderBystring

Eğer belirtilirse, sonuçlar belirtilen alanlara göre sıralanır.

Değerler, artış değerleri yerine düşüş değerlerine göre sıralamak için isteğe bağlı, her alan için "desc" ekini ile ayrılmış bir alan listesi olmalıdır.Values must be a comma-separated list of fields, with an optional, per-field "desc" suffix to sort by descending rather than ascending values.Bir . operatörü ile alt alanlara erişebilirsiniz.

Sonuçlar aşağıdaki alanlara göre sıralanabilir: id.

Örnek: "id desc".

filterstring

Bu alan, döndürülen kaynakları filtrelemek için ayarlanabilir.

Filtreleme Sıradan İfade Dili'ne (CEL) uyuyor.Sadece id ve sortKey alanları desteklenir.Operatörler açısından, yalnızca <, > ve && izinlidir'

Örnek: id > "key-001" && id < "key-100".

Yanıt

Ebeveyn koleksiyonundaki MemoryStoreSortedMapItems listesi.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

Belirtilen MemoryStoreSortedMap'ten MemoryStoreSortedMap'a ait öğeler.

nextPageTokenstring

Bir sonraki sayfayı almak için bir pageToken çözümleyici olarak gönderebileceğiniz bir jeton. Bu alan atlanırsa, sonraki sayfalar yoktur.

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}'
Yanıt
{

  "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

Hafıza Deposu Sıralı Harita Öğesi Oluştur
Beta

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

Eğer mevcut değilse, belirtilen harita öğesini oluşturur.

Kapsamlar
universe.memory-store.sorted-map:write
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

sorted_map_idstring
Gerekli

Sıralanmış harita ID'si.

Sorgu Parametreleri
idstring

Hafıza deposu sıralı harita öğesi için kullanılacak kimlik, hafıza deposu sıralı harita öğesinin kaynak yolunun son bileşeni olacak.

Bu değer alfanumerik ve özel karakterleri destekleyen 1-127 karakterli bir dize olmalıdır.Bu kimlik büyük/küçük harfli.Herhangi bir URL'yi kıran özel karakterler içeriyorsa, id URL olarak kodlanmalıdır.

Talep GövdesiMemoryStoreSortedMapItem
YanıtMemoryStoreSortedMapItem
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"

}'
Yanıt
{

  "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

Hafıza Deposu Sıralı Harita Öğesi Alın
Beta

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

Haritada verilen anahtarın değerini alır ve geri döndürür.

Kapsamlar
universe.memory-store.sorted-map:read
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

sorted_map_idstring
Gerekli

Sıralanmış harita ID'si.

item_idstring
Gerekli

Eşya ID'si.

YanıtMemoryStoreSortedMapItem
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}'
Yanıt
{

  "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

Hafıza Depolama Sıralı Harita Öğesini Sil
Beta

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

Belirtilen öğeyi haritadan siler.

Kapsamlar
universe.memory-store.sorted-map:write
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

sorted_map_idstring
Gerekli

Sıralanmış harita ID'si.

item_idstring
Gerekli

Eşya ID'si.

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

Hafıza Depolama Sıralı Harita Öğesini Güncelle
Beta

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

Belirtilen harita öğesini günceller.

Kapsamlar
universe.memory-store.sorted-map:write
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

sorted_map_idstring
Gerekli

Sıralanmış harita ID'si.

item_idstring
Gerekli

Eşya ID'si.

Sorgu Parametreleri
allowMissingboolean

Doğru ayarlanırsa ve hafıza depolama sıralı harita öğesi bulunmazsa, bir hafıza depolama sıralı harita öğesi oluşturulur.

Talep GövdesiMemoryStoreSortedMapItem
YanıtMemoryStoreSortedMapItem
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"

}'
Yanıt
{

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

}