*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

MemoryStoreSortedMapItem

Reprezentuje przedmiot w strukturze mapy sortowanej.

Atrybuty

pathstring

Ścieżka zasobów przechowywania pamięci przetworzonej mapy przedmiotu.

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

valueJSON value

Wartość przedmiotu.

Wartość JSON może być typu „null”, „boolean”, „string”, „number”, „array” lub „object”.

etagstring
Tylko dane wyjściowe

Serwer wygenerował tag przedmiotu.

Jedna z następujących dla expiration:

ttlstring
Tylko dane wejściowe

TTL dla przedmiotu.

expireTimestring
Tylko dane wyjściowe

Czas wygaścia przedmiotu. Ten ciąg jest sformatowany jako Timestamp.

idstring

Nazwa przedmiotu.

Jedna z następujących dla sortKey:

stringSortKeystring

Przedmiot zostanie posegregowany leksykograficznie według tej struny.

numericSortKeynumber

Przedmiot zostanie sortowany według tej liczby.

Podstawowy adres URL
https://apis.roblox.com
Zasób 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

Lista przechowywanych w magazynie pamięci przedmiotów mapowanych
Beta

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

Zdobywa i zwraca przedmioty na mapie z danym kolejnością i filtrem.

Zakresy
universe.memory-store.sorted-map:read
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

sorted_map_idstring
Wymagane

ID sortowanej mapy.

Parametry zapytania
maxPageSizenumber

Maksymalna liczba przedmiotów mapy przechowywanej w pamięci, które należy zwrócić.Usługa może zwrócić mniej niż tę wartość.Jeśli nie zostanie określone, zwracane są maksymalnie 1 przedmioty mapy przetworzone w magazynie pamięci.Maksymalna wartość wynosi 100, a wyższe wartości są ustawione na 100.

pageTokenstring

Żeton strony, otrzymany z poprzedniego wezwania, aby odzyskać następną stronę.

Podczas paginowania wszystkie pozostałe parametry dostarczone do następnego wezwania muszą pasować do wezwania, które dostarczyło token strony.

orderBystring

Jeśli zostanie określone, wyniki są sortowane według określonych pól.

Wartości muszą być oddzieloną przecinkami listą pól, z opcjonalnym prefiksem "desc" na polu, aby sortować według malejących wartości, a nie według wzrostowych.Możesz uzyskać dostęp do podpól za pomocą operatora ..

Wyniki mogą być sortowane według następujących pól: id.

Przykład: "id desc".

filterstring

Pole to można ustawić w celu filtrowania zasobów zwrotnych.

Filtracja zgodna jest z Wspólnym językiem wyrażeń (CEL).Wspierane są tylko pola id i sortKey.Pod względem operatorów dozwolone są tylko <, > i &&

Przykład: id > "key-001" && id < "key-100".

Odpowiedź:

Lista przedmiotów MemoryStoreSortedMap w kolekcji rodzic.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

Przedmioty Mapy Sortowanej Magazynu Pamięci z określonej Mapy Magazynu Pamięci.

nextPageTokenstring

Token, który możesz wysłać jako parametr pageToken w celu odzyskania następnej strony. Jeśli to pole zostanie pominięte, nie ma następnych stron.

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}'
Odpowiedź:
{

  "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

Utwórz przedmiot mapy przechowywania pamięci sortowany według kolejności
Beta

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

Tworzy określony element mapy, jeśli nie istnieje.

Zakresy
universe.memory-store.sorted-map:write
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

sorted_map_idstring
Wymagane

ID sortowanej mapy.

Parametry zapytania
idstring

ID do użycia dla przedmiotu mapy pamięci, który stanie się ostateczną częścią ścieżki zasobów przedmiotu mapy pamięci sortowanej.

Wartość ta powinna być ciągiem znaków 1-127, który wspiera znaki alfanumeryczne i specjalne.Ta identyfikator jest wrażliwy na dużą literę.Id musi być zakodowane w URL, jeśli zawiera jakiekolwiek łamanie specjalnych znaków URL.

Treść żądaniaMemoryStoreSortedMapItem
Odpowiedź: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"

}'
Odpowiedź:
{

  "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

Zdobądź przedmiot mapy sortowanej w magazynie pamięci
Beta

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

Otrzymuje i zwraca wartość danego klucza w mapie.

Zakresy
universe.memory-store.sorted-map:read
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

sorted_map_idstring
Wymagane

ID sortowanej mapy.

item_idstring
Wymagane

ID przedmiotu.

Odpowiedź: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}'
Odpowiedź:
{

  "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

Usuń przedmiot mapy przechowywania pamięci sortowany według kolejności
Beta

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

Usuwa określony element z mapy.

Zakresy
universe.memory-store.sorted-map:write
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

sorted_map_idstring
Wymagane

ID sortowanej mapy.

item_idstring
Wymagane

ID przedmiotu.

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

Aktualizacja przechowywania pamięci Sortowana mapa przedmiotu
Beta

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

Aktualizuje określony element mapy.

Zakresy
universe.memory-store.sorted-map:write
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

sorted_map_idstring
Wymagane

ID sortowanej mapy.

item_idstring
Wymagane

ID przedmiotu.

Parametry zapytania
allowMissingboolean

Jeśli ustawiono na prawdę, a przedmiot mapy przechowywany w pamięci nie został znaleziony, tworzony jest przedmiot mapy przechowywany w pamięci.

Treść żądaniaMemoryStoreSortedMapItem
Odpowiedź: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"

}'
Odpowiedź:
{

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

}