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

DataStore

데이터 상점나타냅니다.

특성

pathstring

데이터 상점리소스 경로.

형식: universes/{universe_id}/data-stores/{data_store_id}.

createTimestring
출력 전용

데이터 저장소가 생성된 시점의 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.

idstring
출력 전용

데이터 상점ID. 경로의 마지막 부분과 일치합니다.

기본 URL
https://apis.roblox.com
DataStore 리소스
{

  "path": "universes/123/data-stores/some-data-store",

  "createTime": "2023-07-05T12:34:56Z",

  "id": "string"

}

DataStore

List Data Stores
베타

GET /cloud/v2/universes/{universe_id}/data-stores

데이터 저장소 목록을 반환합니다.

범위
universe-datastores.control:list
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

쿼리 매개 변수
maxPageSizenumber

반환할 데이터 저장소 최대 수.서비스는 이 값보다 적은 값을 반환할 수 있습니다.지정되지 않으면 최대 10개의 데이터 저장소가 반환됩니다.최대 값은 100이며 더 높은 값은 100으로 설정됩니다.

pageTokenstring

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

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

filterstring

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

filter 필드는 CEL의 아주 작은 하위 집합을 지원합니다:

  • 오직 id 필드만 지원됩니다.
  • 오직 startsWith 함수만 사용할 수 있으며 다른 연산자나 빌트인은 지원되지 않습니다.

예제 필터: id.startsWith("foo").

응답

부모 컬렉션의 DataStore 목록.

dataStoresarray<DataStore>

지정된 우주의 데이터 저장소.

nextPageTokenstring

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

GET /cloud/v2/universes/{universe_id}/data-stores
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores?maxPageSize=10&pageToken={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
응답
{

  "dataStores": [

    {

      "path": "universes/123/data-stores/some-data-store",

      "createTime": "2023-07-05T12:34:56Z",

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

DataStore

Snapshot Data Stores
베타

POST /cloud/v2/universes/{universe_id}/data-stores:snapshot

경험의 데이터 저장소에 대한 새 스냅샷을 생성합니다.

스냅샷 이후, 경험의 모든 키에 대한 다음 쓰기는 마지막 쓰기 시간과 상관없이 이전 데이터의 버전 백업을 생성합니다.

결과적으로 스냅샷 시점의 모든 데이터는 최소 30일 동안 버전 백업으로 사용할 수 있도록 보장됩니다.

스냅샷은 UTC 일 당 한 번, 경험당 얻을 수 있습니다.최신 스냅샷이 UTC 동일 날짜 내에 캡처되었으면 이 작업은 실행되지 않고 최신 스냅샷의 시간이 반환됩니다.

스냅샷을 사용하는 자세한 정보는 데이터 저장소 엔진 가이드를 참조하십시오.

범위
universe-datastores.control:snapshot
요청경로 매개 변수
universe_idstring
필수

유니버스 ID.

요청 본문
응답

새 스냅샷이 캡처되었는지 여부와 작업 후 최신 스냅샷의 시간(새 스냅샷이 캡처되었는지 여부에 관계없음)을 반환합니다.

newSnapshotTakenboolean

이 작업에 의해 새로운 스냅샷이 캡처되었는지 여부(UTC 날마다 경험당 하나의 스냅샷만 캡처할 수 있음).

latestSnapshotTimestring

작업 후의 최신 스냅샷 시간(새 스냅샷이 생성되었는지 여부에 관계없이). 이 시간은 UTC로 항상 반환됩니다. 이 문자열은 Timestamp 형식으로 지정됩니다.

POST /cloud/v2/universes/{universe_id}/data-stores:snapshot
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores:snapshot' \

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

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

  --data '{}'
응답
{

  "newSnapshotTaken": true,

  "latestSnapshotTime": "2023-07-05T12:34:56Z"

}