El camino de recursos de la instancia.
Formato: universes/{universe_id}/places/{place_id}/instances/{instance_id}.
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Instance
Representa una instancia de modelo de datos.
Atributos
si la instancia tiene algún hijo instancia.
los detalles de la propiedad de la instancia.
URL base
https://apis.roblox.comEl recurso Instance
{
"path": "universes/123/places/123/instances/0123456789abcdef0123456789abcdef",
"hasChildren": true,
"engineInstance": {
"Id": "string",
"Parent": "string",
"Name": "string",
"Details": {
"Folder": {}
}
}
}Instance
Obtener instancia
GET /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}
Obtiene una instancia y sus datos de propiedad.
El tamaño máximo de los datos de respuesta admitidos es de 500,000 bytes.Si se supera este límite, el devuelto Operation se completará con un resultado de error que tenga un código de error de 422.
universe.place.instance:read
SolicitudParámetros de rutaLa identificación del universo.
La identificación del lugar.
La identificación de la instancia.
RespuestaRespuestaInstanceMetadatos
Este método es asíncrono y devuelve una Operación, que representa el estado actual de la operación. Contiene una ruta final que puede sondear para obtener la respuesta real y los metadatos aplicables. Ve la documentation en operaciones de larga duración para más información.
Las siguientes secciones describen la respuesta y los objetos metadatos que se proporcionan cuando una operación termina.
Nada
GET /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}' \
-H 'x-api-key: {your-api-key}'Instance
Actualizar instancia
PATCH /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}
Actualiza los datos de propiedad de una instancia.
Al actualizar la propiedad de fuente de una instancia Script actual, el tamaño máximo de propiedad admitido es de 200,000 bytes después de la codificación UTF-8.
universe.place.instance:write
SolicitudParámetros de rutaLa identificación del universo.
La identificación del lugar.
La identificación de la instancia.
La lista de campos para actualizar. Esta cadena está formateada como Timestamp.
RespuestaRespuestaInstanceMetadatos
Este método es asíncrono y devuelve una Operación, que representa el estado actual de la operación. Contiene una ruta final que puede sondear para obtener la respuesta real y los metadatos aplicables. Ve la documentation en operaciones de larga duración para más información.
Las siguientes secciones describen la respuesta y los objetos metadatos que se proporcionan cuando una operación termina.
Nada
PATCH /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}?updateMask={string}' \
-H 'x-api-key: {your-api-key}' \
-H 'Content-Type: application/json' \
--data '{
"engineInstance": {
"Id": "string",
"Parent": "string",
"Name": "string",
"Details": {
"Folder": {}
}
}
}'Instance
Lista de hijos de instancia
GET /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}:listChildren
Lista los hijos de una instancia.
El tamaño máximo de los datos de respuesta admitidos es de 500,000 bytes.Si se supera este límite, el devuelto Operation se completará con un resultado de error que tenga un código de error de 422.
universe.place.instance:read
SolicitudParámetros de rutaLa identificación del universo.
La identificación del lugar.
La identificación de la instancia.
El número máximo de instancia hija para devolver.El servicio puede devolver menos que este valor.Si no se especifica, se devolverán un máximo de 200 hijos.El valor máximo es 200; los valores por encima de 200 se verán obligados a 200.
Una ficha de página, recibida de una llamada anterior ListInstanceChildrenRequest. Proporcione esto para recuperar la página siguiente.
Al paginar, todos los demás parámetros proporcionados a ListInstanceChildrenRequest deben coincidir con la llamada que proporcionó el token de página.
RespuestaRespuestainstancesarray<Instance> nextPageTokenstring
Este método es asíncrono y devuelve una Operación, que representa el estado actual de la operación. Contiene una ruta final que puede sondear para obtener la respuesta real y los metadatos aplicables. Ve la documentation en operaciones de larga duración para más información.
Las siguientes secciones describen la respuesta y los objetos metadatos que se proporcionan cuando una operación termina.
Devuelve una lista de los hijos de la instancia.
Una lista de instancias hijas.
Una token, que se puede enviar como page_token para recuperar la siguiente página. Si este campo se omite, no hay páginas posteriores.
Nada
GET /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}:listChildren
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}:listChildren?maxPageSize=100&pageToken={string}' \
-H 'x-api-key: {your-api-key}'