*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

DataStore

Representa un tiendade datos.

Atributos

pathstring

El camino de recursos del tiendade datos.

Formato: universes/{universe_id}/data-stores/{data_store_id}.

createTimestring
Solo salida

La fecha y hora en que se creó el almacén de datos. Esta cadena está formateada como Timestamp.

idstring
Solo salida

El ID del tiendade datos. Coincide con el último segmento del camino.

URL base

https://apis.roblox.com
El recurso DataStore

{
"path": "universes/123/data-stores/some-data-store",
"createTime": "2023-07-05T12:34:56Z",
"id": "string"
}

DataStore

List Data Stores
Beta

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

Devuelve una lista de almacenes de datos.

Ámbitos
universe-datastores.control:list
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

Parámetros de consulta
maxPageSizenumber

El número máximo de almacenes de datos para devolver.El servicio podría devolver menos que este valor.Si no se especifica, se devuelven un máximo de 10 almacenes de datos.El valor máximo es 100 y los valores más altos se establecen en 100.

pageTokenstring

Una ficha de página, recibida de una llamada anterior, para recuperar una página posterior.

Al paginar, todos los demás parámetros proporcionados a la llamada siguiente deben coincidir con la llamada que proporcionó el token de página.

filterstring

Este campo se puede configurar para filtrar los recursos devueltos.

El campo filter admite un subconjunto muy pequeño de CEL:

  • Solo se soporta el campo id .
  • Solo está disponible la función startsWith ; no se admiten otros operadores ni entradas construidas.

Filtro de filtro: id.startsWith("foo").

Respuesta

Una lista de almacenes de datos en la coleccionespadre.

dataStoresarray<DataStore>

Los almacenes de datos del universo especificado.

nextPageTokenstring

Una token que puedes enviar como parámetro pageToken para recuperar la siguiente página. Si este campo se omite, no hay páginas posteriores.

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}'
Respuesta

{
"dataStores": [
{
"path": "universes/123/data-stores/some-data-store",
"createTime": "2023-07-05T12:34:56Z",
"id": "string"
}
],
"nextPageToken": "string"
}

DataStore

Snapshot Data Stores
Beta

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

Realiza un nuevo punto de instantánea de los almacenes de datos en una experiencia.

Después de un instantáneo, la siguiente escritura a cada clave en la experiencia creará una copia de seguridad versionada de los datos anteriores, independientemente del tiempo del último escrito.

De hecho, todos los datos actuales en el momento del punto de control se garantizan como una copia de seguridad versionada durante al menos 30 días.

Los puntos de control se pueden tomar una vez por día UTC, por experiencia.Si el último punto de control se tomó dentro del mismo día UTC, esta operación es una no-op y se devolverá el tiempo del último punto de control.

Para obtener más información sobre el uso de instantáneas, consulte el Guía del motor de almacenamiento de datos.

Ámbitos
universe-datastores.control:snapshot
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

Solicitar cuerpo
Respuesta

Devuelve si se tomó un nuevo punto de vista y el tiempo del último punto de vista después de la operación (independientemente de si se tomó un nuevo punto de vista).

newSnapshotTakenboolean

Si se tomó un nuevo punto de vista por esta operación. (Solo se puede tomar un punto de vista por experiencia por día UTC).

latestSnapshotTimestring

El tiempo del último punto de control después de la operación (independientemente de si se creó un nuevo punto de control). Este tiempo siempre se devuelve en UTC. Esta cadena está formateada como 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 '{}'
Respuesta

{
"newSnapshotTaken": true,
"latestSnapshotTime": "2023-07-05T12:34:56Z"
}