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

MemoryStoreQueueItem

Reprezentuje przedmiot w strukturze kolejki.

Atrybuty

pathstring

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

Format: universes/{universe_id}/memory-store/queues/{memory_store_queue_id}/items/{memory_store_queue_item_id}.

dataJSON value

Wartość przedmiotu kolejki.

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

prioritynumber

Priorytet przedmiotu w kolejce.

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
Tylko dane wyjściowe

Nazwa przedmiotu.

Podstawowy adres URL
https://apis.roblox.com
Zasób MemoryStoreQueueItem
{

  "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

  "data": "JSON value",

  "priority": "number",

  "ttl": "3s",

  "id": "string"

}

MemoryStoreQueueItem

Utwórz przedmiot kolejki przechowywania pamięci
Beta

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items

Tworzy nowy element kolejki.

Jeśli ttl jest ustawione, element zostanie automatycznie usunięty z kolejki po określonym czasie odstępu.

Jeśli ustawiono liczbowy priority, przedmiot zostanie wstawiony do kolejki na podstawie wartości priorytetu.Im wyższa wartość, tym bliżej frontu kolejki będzie przedmiot.Jeśli wartości priorytetowe są takie same, przedmiot zostanie wstawiony po istniejących wartościach o takim samym priorytecie.

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

ID wszechświata.

queue_idstring
Wymagane

ID kolejki.

Treść żądaniaMemoryStoreQueueItem
Odpowiedź:MemoryStoreQueueItem
POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items' \

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

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

  --data '{

  "data": "JSON value",

  "priority": "number",

  "ttl": "3s"

}'
Odpowiedź:
{

  "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

  "data": "JSON value",

  "priority": "number",

  "id": "string"

}

MemoryStoreQueueItem

Wyrzuć przedmioty z kolejki przechowywania pamięci
Beta

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard

Odrzuca odczytuje przedmioty z przodu kolejki.

Bierze readId z poprzedniej operacji Read.

Zakresy
universe.memory-store.queue:discard
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

queue_idstring
Wymagane

ID kolejki.

Treść żądania
readIdstring

The readId z poprzedniej operacji odczytu, dla której należy odrzucić przedmioty odczytu.

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard' \

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

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

  --data '{

  "readId": "string"

}'

MemoryStoreQueueItem

Przeczytaj przedmioty kolejki przechowywania pamięci
Beta

GET /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read

Zwraca określoną liczbę przedmiotów na początku kolejki.

Zakresy
universe.memory-store.queue:dequeue
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

queue_idstring
Wymagane

ID kolejki.

Parametry zapytania
countnumber

Liczba przedmiotów do odczytania z kolejki Jeśli nie zostanie określona, zostanie zwrócony 1 przedmiot. Maksymalna wartość to 200; wartości powyżej 200 zostaną zmuszone do 200.

allOrNothingboolean

Jeśli all_or_nothing jest prawdą i żądana liczba obiektów nie jest dostępna, zwróci błąd 404.

W przeciwnym razie zwróci ścieżkę i read_id operacji odczytu oraz listę elementów kolejki MemoryStoreQueue.

invisibilityWindowstring

Okno niewidzialności dla przeczytanych przedmiotów, w sekundach.

Przeczytane przedmioty są niewidoczne w kolejnych odczytach podczas okresu trwania okna niewidzialności.

Musi być napisany w sekundach większych niż 0 i zakończyć się s.

Domyślnie do 30s.

Odpowiedź:

Zwraca określoną liczbę przedmiotów na początku kolejki.

readIdstring

Identyfikator operacji odczytu

Można to przekazać do :discard w celu oznaczenia elementów jako przetworzone.

GET /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read?count={integer}&allOrNothing={boolean}&invisibilityWindow={string}' \

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

  "readId": "string",

  "items": [

    {

      "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

      "data": "JSON value",

      "priority": "number",

      "id": "string"

    }

  ]

}