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

MemoryStoreSortedMapItem

정렬된 맵 구조 내의 아이템을 나타냅니다.

특성

pathstring

메모리 저장소 정렬된 맵 항목의 리소스 경로.

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

valueJSON value

항목의 값.

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

etagstring
출력 전용

서버가 항목의 태그를 생성했습니다.

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

ttlstring
입력 전용

아이템의 TTL.

expireTimestring
출력 전용

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

idstring

항목의 이름.

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

stringSortKeystring

항목은 이 문자열에 따라 알파벳순으로 정렬됩니다.

numericSortKeynumber

항목은 이 번호에 따라 정렬됩니다.

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

메모리 저장소 정렬된 맵 항목 목록
베타

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

지정된 순서와 필터로 맵에서 아이템을 가져오고 반환합니다.

범위
universe.memory-store.sorted-map:read
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

sorted_map_idstring
필수

정렬된 맵 ID.

쿼리 매개 변수
maxPageSizenumber

반환할 메모리 저장소 정렬된 맵 항목의 최대 수.서비스는 이 값보다 적은 값을 반환할 수 있습니다.지정되지 않으면 최대 1개의 메모리 저장소 정렬된 맵 항목이 반환됩니다.최대 값은 100이며 더 높은 값은 100으로 설정됩니다.

pageTokenstring

이전 호출에서 받은 페이지 토큰으로, 이후 페이지를 검색합니다.

페이징할 때 후속 호출에 제공된 모든 다른 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

orderBystring

지정된 경우 결과는 지정된 필드에 따라 순서가 지정됩니다.

값은 쉼표로 구분된 필드 목록이어야 하며, 선택적으로 필드마다 "desc" 접미사를 사용하여 값이 오름차순이 아닌 내림차순으로 정렬됩니다.. 연산자를 사용하여 하위 필드에 액세스할 수 있습니다.

결과는 다음 필드로 정렬될 수 있습니다: id.

예: "id desc".

filterstring

이 필드는 반환된 리소스를 필터링하기 위해 설정될 수 있습니다.

필터링은 일반 식 언어(CEL)에 부합합니다.오직 id 및 sortKey 필드만 지원됩니다.운영자로 볼 때, < , > 및 && 만 허용됩니다'

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

응답

부모 컬렉션의 MemoryStoreSortedMapItems 목록.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

지정된 MemoryStoreSortedMap의 MemoryStoreSortedMap 항목입니다.

nextPageTokenstring

다음 페이지를 검색하기 위해 pageToken 매개변수로 보낼 수 있는 토큰입니다. 이 필드가 생략되면 후속 페이지가 없습니다.

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

  "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

메모리 저장소 정렬된 맵 아이템 만들기
베타

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

존재하지 않으면 지정된 맵 항목을 생성합니다.

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

유니버스 ID.

sorted_map_idstring
필수

정렬된 맵 ID.

쿼리 매개 변수
idstring

메모리 저장소 정렬 맵 항목에 사용할 ID로, 메모리 저장소 정렬 맵 항목의 최종 구성 요소가 되는 리소스 경로가 됩니다.

이 값은 알파벳과 특수 문자를 지원하는 1-127자 문자열이어야 합니다.이 ID는 대/소문자를 구분합니다.특수 문자를 포함하는 URL이 있으면 URL을 인코딩해야 합니다.The id must be url encoded if it contains any URL breaking special characters.

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

}'
응답
{

  "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

메모리 저장소 정렬된 맵 아이템 가져오기
베타

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

맵에서 지정된 키의 값을 가져오고 반환합니다.

범위
universe.memory-store.sorted-map:read
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

sorted_map_idstring
필수

정렬된 맵 ID.

item_idstring
필수

아이템 ID.

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

  "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

메모리 저장소 정렬된 맵 항목 삭제
베타

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

지도에서 지정된 항목을 삭제합니다.

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

유니버스 ID.

sorted_map_idstring
필수

정렬된 맵 ID.

item_idstring
필수

아이템 ID.

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

메모리 저장소 정렬된 맵 항목 업데이트
베타

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

지정된 맵 항목을 업데이트합니다.

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

유니버스 ID.

sorted_map_idstring
필수

정렬된 맵 ID.

item_idstring
필수

아이템 ID.

쿼리 매개 변수
allowMissingboolean

설정된 경우 true이고 메모리 저장소에서 정렬된 맵 항목이 찾을 수 없으면 메모리 저장소에서 정렬된 맵 항목이 생성됩니다.

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

}'
응답
{

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

}