DataStoreEntry

  • 리소스 경로
  • /cloud/v2/universes/{universe}/data-stores/{data-store}/entries
  • /cloud/v2/universes/{universe}/data-stores/{data-store}/scopes/{scope}/entries

특성

pathstring
createTimestring
출력 전용
revisionIdstring
불변
출력 전용
revisionCreateTimestring
출력 전용
stateEnum<string>
출력 전용
etagstring
valueJSON value
idstring
출력 전용
usersarray<string>
attributesobject
기본 URL
https://apis.roblox.com/cloud
DataStoreEntry 리소스
{

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

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

  "revisionId": "string",

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

  "state": "STATE_UNSPECIFIED",

  "etag": "string",

  "value": "JSON value",

  "id": "string",

  "users": [

    "string"

  ],

  "attributes": "object"

}

DataStoreEntry

List Data Store Entries
베타

GET /cloud/v2/universes/{universe}/data-stores/{data-store}/entries
범위
universe-datastores.objects:list
요청경로 매개 변수
universestring
필수
data-storestring
필수
쿼리 매개 변수
maxPageSizenumber
pageTokenstring
filterstring
showDeletedboolean
응답
nextPageTokenstring
GET /cloud/v2/universes/{universe}/data-stores/{data-store}/entries
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe}/data-stores/{data-store}/entries?maxPageSize=10&pageToken={string}&filter={string}&showDeleted={boolean}' \

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

  "dataStoreEntries": [

    {

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

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

      "revisionId": "string",

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

      "state": "STATE_UNSPECIFIED",

      "etag": "string",

      "value": "JSON value",

      "id": "string",

      "users": [

        "string"

      ],

      "attributes": "object"

    }

  ],

  "nextPageToken": "string"

}

DataStoreEntry

Create Data Store Entry
베타

POST /cloud/v2/universes/{universe}/data-stores/{data-store}/entries
범위
universe-datastores.objects:create
요청경로 매개 변수
universestring
필수
data-storestring
필수
쿼리 매개 변수
idstring
요청 본문DataStoreEntry
응답DataStoreEntry
POST /cloud/v2/universes/{universe}/data-stores/{data-store}/entries
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe}/data-stores/{data-store}/entries?id=my-entry' \

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

  --data '{ \

  "etag": "string", \

  "value": "JSON value", \

  "users": [ \

    "string" \

  ], \

  "attributes": "object" \

}'
응답
{

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

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

  "revisionId": "string",

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

  "state": "STATE_UNSPECIFIED",

  "etag": "string",

  "value": "JSON value",

  "id": "string",

  "users": [

    "string"

  ],

  "attributes": "object"

}

DataStoreEntry

Get Data Store Entry
베타

GET /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}
범위
universe-datastores.objects:read
요청경로 매개 변수
universestring
필수
data-storestring
필수
entrystring
필수
응답DataStoreEntry
GET /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}' \

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

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

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

  "revisionId": "string",

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

  "state": "STATE_UNSPECIFIED",

  "etag": "string",

  "value": "JSON value",

  "id": "string",

  "users": [

    "string"

  ],

  "attributes": "object"

}

DataStoreEntry

Delete Data Store Entry
베타

DELETE /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}
범위
universe-datastores.objects:delete
요청경로 매개 변수
universestring
필수
data-storestring
필수
entrystring
필수
DELETE /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}
curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}' \

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

DataStoreEntry

Update Data Store Entry
베타

PATCH /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}
범위
universe-datastores.objects:update
요청경로 매개 변수
universestring
필수
data-storestring
필수
entrystring
필수
쿼리 매개 변수
allowMissingboolean
요청 본문DataStoreEntry
응답DataStoreEntry
PATCH /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}?allowMissing={boolean}' \

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

  --data '{ \

  "etag": "string", \

  "value": "JSON value", \

  "users": [ \

    "string" \

  ], \

  "attributes": "object" \

}'
응답
{

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

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

  "revisionId": "string",

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

  "state": "STATE_UNSPECIFIED",

  "etag": "string",

  "value": "JSON value",

  "id": "string",

  "users": [

    "string"

  ],

  "attributes": "object"

}

DataStoreEntry

Increment Data Store Entry
베타

POST /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}:increment
범위
universe-datastores.objects:createuniverse-datastores.objects:update
요청경로 매개 변수
universestring
필수
data-storestring
필수
entrystring
필수
요청 본문
amountnumber
usersarray<string>
attributesobject
응답DataStoreEntry
POST /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}:increment
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}:increment' \

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

  --data '{ \

  "amount": "number", \

  "users": [ \

    "string" \

  ], \

  "attributes": "object" \

}'
응답
{

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

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

  "revisionId": "string",

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

  "state": "STATE_UNSPECIFIED",

  "etag": "string",

  "value": "JSON value",

  "id": "string",

  "users": [

    "string"

  ],

  "attributes": "object"

}

DataStoreEntry

List Data Store Entry Revisions
베타

GET /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}:listRevisions
범위
universe-datastores.versions:list
요청경로 매개 변수
universestring
필수
data-storestring
필수
entrystring
필수
쿼리 매개 변수
maxPageSizenumber
pageTokenstring
filterstring
응답
nextPageTokenstring
GET /cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}:listRevisions
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe}/data-stores/{data-store}/entries/{entry}:listRevisions?maxPageSize=10&pageToken={string}&filter={string}' \

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

  "dataStoreEntries": [

    {

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

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

      "revisionId": "string",

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

      "state": "STATE_UNSPECIFIED",

      "etag": "string",

      "value": "JSON value",

      "id": "string",

      "users": [

        "string"

      ],

      "attributes": "object"

    }

  ],

  "nextPageToken": "string"

}