Le chemin de ressource du boutiquede données.
Format : universes/{universe_id}/data-stores/{data_store_id}.
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
DataStore
Représente un boutiquede données.
Attributs
La date et l'heure de création du magasin de données. Ce string est formatée en tant que Timestamp.
L'ID du boutiquede données. Correspond au dernier segment du chemin.
URL de base
https://apis.roblox.comLa ressource 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
Renvoie une liste de magasins de données.
universe-datastores.control:list
RequêteParamètres du cheminL'ID de l'univers.
Le nombre maximum de magasins de données à renvoyer.Le service peut retourner moins que cette valeur.Si non spécifié, au maximum 10 magasins de données sont retournés.La valeur maximale est de 100 et les valeurs plus élevées sont réglées sur 100.
Un jeton de page, reçu d'un appel précédent, pour récupérer une page suivante.
Lors de la pagination, tous les autres paramètres fournis à l'appel suivant doivent correspondre à l'appel qui a fourni le jeton de page.
Ce champ peut être défini afin de filtrer les ressources renvoyées.
Le champ filter supporte un sous-ensemble très petit de CEL :
- Seul le champ id est pris en charge.
- Seule la fonction startsWith est disponible ; aucun autre opérateur ni implémentation n'est pris en charge.
Exemple de filtres: id.startsWith("foo").
RéponsedataStoresarray<DataStore> nextPageTokenstring
Une liste de magasins de données dans la collectionsparent.
Les magasins de données de l'univers spécifié.
Un jeton que vous pouvez envoyer en tant que pageToken paramètre pour récupérer la page suivante. Si ce champ est omis, il n'y a pas de pages suivantes.
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}'Réponse
{
"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
Prend une nouvelle capture d'écran des magasins de données dans une expérience.
Après une capture d'écran, la prochaine écriture sur chaque clé de l'expérience créera une sauvegarde versionnée des données précédentes, indépendamment du temps de la dernière écriture.
En effet, toutes les données actuelles au moment de la sauvegarde sont garanties d'être disponibles en tant que sauvegarde versionnée pendant au moins 30 jours.
Les instantanés peuvent être pris une fois par jour UTC, par expérience.Si la dernière sauvegarde a été prise dans la même journée UTC, cette opération est une opération sans opération et le temps de la dernière sauvegarde sera retourné.
Pour plus d'informations sur l'utilisation des captures d'écran, voir le guide du magasin de données.
universe-datastores.control:snapshot
RequêteParamètres du cheminL'ID de l'univers.
RéponsenewSnapshotTakenboolean latestSnapshotTimestring
Renvoie si une nouvelle sauvegarde a été prise et l'heure de la dernière sauvegarde après l'opération (indépendamment du fait qu'une nouvelle sauvegarde ait été prise).
Si une nouvelle capture d'écran a été prise par cette opération. (Une seule capture d'écran peut être prise par expérience par jour UTC.).
Le temps du dernier instantané après l'opération (indépendamment de la création d'un nouvel instantané). Ce temps est toujours renvoyé en UTC. Ce string est formatée en tant que 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 '{}'Réponse
{
"newSnapshotTaken": true,
"latestSnapshotTime": "2023-07-05T12:34:56Z"
}