*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

MemoryStoreQueueItem

큐 구조 내의 아이템을 나타냅니다.

특성

pathstring

메모리 저장소 큐 항목의 리소스 경로.

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

dataJSON value

큐 아이템의 값.

JSON 값은 null, boolean, string, number, array, object일 수 있습니다.

prioritynumber

큐 항목의 우선 순위.

expiration에 대해 다음 중 하나 선택 가능:

ttlstring
입력 전용

아이템의 TTL.

expireTimestring
출력 전용

아이템의 만료 시간. 이 문자열은 Timestamp 형식으로 지정됩니다.

idstring
출력 전용

항목의 이름.

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

메모리 저장소 큐 항목 생성
베타

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

새 큐열 항목을 생성합니다.

ttl가 설정되어 있으면 지정된 시간 간격 후에 항목이 자동으로 큐에서 제거됩니다.

숫자 priority가 설정되면 아이템이 우선 순위 값에 따라 큐에 삽입됩니다.값이 높을수록 큐의 앞쪽에 아이템이 더 가까워집니다.우선 순위 값이 동일하면 항목이 동일한 우선 순위의 기존 값 뒤에 삽입됩니다.

범위
universe.memory-store.queue:write
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

queue_idstring
필수

대기열 ID.

요청 본문MemoryStoreQueueItem
응답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"

}'
응답
{

  "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

메모리 저장소 큐 항목 삭제
베타

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

디스카드는 대기열 앞에서 아이템을 읽습니다.

이전의 작업에서 가져옵니다.

범위
universe.memory-store.queue:discard
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

queue_idstring
필수

대기열 ID.

요청 본문
readIdstring

읽기 아이템을 삭제할 이전 읽기 작업의 readId.

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

메모리 저장소 큐 항목 읽기
베타

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

대기열 앞에서 지정된 수의 항목을 반환합니다.

범위
universe.memory-store.queue:dequeue
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

queue_idstring
필수

대기열 ID.

쿼리 매개 변수
countnumber

큐에서 읽을 아이템 수 지정되지 않으면 1개가 반환됩니다. 최대값은 200입니다; 200 이상의 값은 200으로 강제됩니다.

allOrNothingboolean

if all_or_nothing가 true이고 요청된 개체 수가 사용할 수 없으면 404 오류가 반환됩니다.

그렇지 않으면 읽기 작업의 경로와 read_id 및 MemoryStoreQueue 항목 목록을 반환합니다.

invisibilityWindowstring

아이템 읽기용 투명화 창, 몇 초 후에.

읽은 항목은 투명화 창 기간 동안 후속 읽기에서 보이지 않습니다.

0보다 큰 0초 이상으로 작성되고 s로 끝나야 합니다.

기본값은 30s 입니다.

응답

대기열 앞에서 지정된 수의 항목을 반환합니다.

readIdstring

읽기 작업의 식별자

이를 처리된 항목으로 표시하기 위해 :discard에 전달할 수 있습니다.

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}'
응답
{

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

    }

  ]

}