*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

MemoryStoreSortedMapItem

Rappresenta un oggetto all'interno di una struttura di mappa ordinata.

Attributi

pathstring

Il percorso delle risorse del deposito di memoria ordinato dell'elemento mappa.

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

valueJSON value

Il valore dell'elemento.

Un valore JSON può essere null, boolean, string, number, array, or object.

etagstring
Solo output

Il tag generato dal server di un oggetto.

Uno dei seguenti per expiration:

ttlstring
Solo input

Il TTL per l'elemento.

expireTimestring
Solo output

Il tempo di scadenza dell'elemento. Questa stringa è formattata come Timestamp.

idstring

Il nome dell'elemento.

Uno dei seguenti per sortKey:

stringSortKeystring

L'elemento verrà ordinato alfabeticamente secondo questa stringa.

numericSortKeynumber

L'elemento verrà ordinato in base a questo numero.

URL di base
https://apis.roblox.com
Risorsa 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

Lista oggetti di memoria ordinati della mappa
Beta

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

Ottiene e restituisce oggetti nella mappa con un ordine e un filtro dato.

Campi
universe.memory-store.sorted-map:read
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

sorted_map_idstring
Necessario

L'ID della mappa ordinata.

Parametri query
maxPageSizenumber

Il numero massimo di oggetti di mappa ordinati del deposito di memoria da restituire.Il servizio potrebbe restituire meno di questo valore.Se non specificato, vengono restituiti al massimo 1 oggetti di mappa ordinati del magazzino di memoria.Il valore massimo è 100 e i valori più alti sono impostati su 100.

pageTokenstring

Un token di pagina, ricevuto da una chiamata precedente, per recuperare una pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti alla chiamata successiva devono corrispondere alla chiamata che ha fornito il token della pagina.

orderBystring

Se specificato, i risultati sono ordinati in base ai campi specificati.

I valori devono essere una lista separata da virgola di campi, con un prefisso "desc" opzionale per campo per ordinare in ordine discendente piuttosto che ascendente.Puoi accedere ai sottocampi con un operatore ..

I risultati possono essere ordinati dai seguenti campi: id.

Esempio: "id desc".

filterstring

Questo campo può essere impostato per filtrare le risorse restituite.

Il filtraggio rispetta il Common Expression Language (CEL).Sono supportati solo i campi id e sortKey .In termini di operatori, solo < , > e && sono consentiti'

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

Risposta

Un elenco di MemoryStoreSortedMapItems nella collezione padre.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

Gli elementi della mappa ordinata del MemoryStoreSortedMap specificati dal MemoryStoreSortedMap specificato.

nextPageTokenstring

Un token che puoi inviare come parametro pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non ci sono pagine successive.

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}'
Risposta
{

  "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

Crea oggetto mappa ordinata del deposito di memoria
Beta

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

Crea l'elemento mappa specificato se non esiste.

Campi
universe.memory-store.sorted-map:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

sorted_map_idstring
Necessario

L'ID della mappa ordinata.

Parametri query
idstring

L'ID da utilizzare per l'elemento mappa ordinata del deposito di memoria, che diventerà il percorso di risorse finale dell'elemento mappa ordinata del deposito di memoria.

Questo valore dovrebbe essere una stringa di caratteri 1-127 che supporta caratteri alfanumerici e speciali.Questo ID è sensibile al caso.L'ID deve essere codificato in URL se contiene qualsiasi URL che contenga caratteri speciali infranti.

Corpo della richiestaMemoryStoreSortedMapItem
RispostaMemoryStoreSortedMapItem
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"

}'
Risposta
{

  "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

Ottieni l'elemento mappa ordinata del magazzino di memoria
Beta

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

Ottiene e restituisce il valore della chiave data nella mappa.

Campi
universe.memory-store.sorted-map:read
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

sorted_map_idstring
Necessario

L'ID della mappa ordinata.

item_idstring
Necessario

L'ID dell'elemento.

RispostaMemoryStoreSortedMapItem
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}'
Risposta
{

  "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

Elimina oggetto mappa ordinata del magazzino di memoria
Beta

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

Elimina l'elemento specificato dalla mappa.

Campi
universe.memory-store.sorted-map:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

sorted_map_idstring
Necessario

L'ID della mappa ordinata.

item_idstring
Necessario

L'ID dell'elemento.

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

Aggiorna oggetto mappa ordinata del memorizzatore di memoria
Beta

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

Aggiorna l'elemento mappa specificato.

Campi
universe.memory-store.sorted-map:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

sorted_map_idstring
Necessario

L'ID della mappa ordinata.

item_idstring
Necessario

L'ID dell'elemento.

Parametri query
allowMissingboolean

Se impostato su vero e l'elemento mappa ordinato del deposito di memoria non viene trovato, viene creato un elemento mappa ordinato del deposito di memoria.

Corpo della richiestaMemoryStoreSortedMapItem
RispostaMemoryStoreSortedMapItem
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"

}'
Risposta
{

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

}