Instance

Represents a data model instance.

Attributs

pathstring

The resource path of the instance.

Format: universes/{universe_id}/places/{place_id}/instances/{instance_id}.

hasChildrenboolean
Sortie seule

whether the instance has any children instance.

engineInstanceobject

the property details of the instance.

URL de base

https://apis.roblox.com
La ressource Instance

{
"path": "universes/123/places/123/instances/0123456789abcdef0123456789abcdef",
"hasChildren": true,
"engineInstance": {
"Id": "string",
"Parent": "string",
"Name": "string",
"Details": {
"Folder": {}
}
}
}

Instance

Get Instance
Bêta

GET /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}

Gets an instance and its property data.

The maximum supported response data size is 500,000 bytes. If this limit is exceeded, the returned Operation will be completed with an error result that has an error code of 422.

Périmètres d'application
universe.place.instance:read
RequêteParamètres du chemin
universe_idstring
Requis

The universe ID.

place_idstring
Requis

The place ID.

instance_idstring
Requis

The instance ID.

Réponse

This method is asynchronous and returns an Operation, which represents the current state of the operation. It contains an endpoint path that you can poll to obtain the real response and applicable metadata. See the documentation on long-running operations for more information.

The following sections describe the response and metadata objects that are provided when an operation completes.

RéponseInstanceMétadonnées

Aucun

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

Update Instance
Bêta

PATCH /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}

Updates an instance's property data.

When updating a Script instance's source property, the maximum supported property size is 200,000 bytes after UTF-8 encoding.

Périmètres d'application
universe.place.instance:write
RequêteParamètres du chemin
universe_idstring
Requis

The universe ID.

place_idstring
Requis

The place ID.

instance_idstring
Requis

The instance ID.

Paramètres de requête
updateMaskstring

The list of fields to update. Cette chaîne est formatée comme un FieldMask.

Corps de la requêteInstance
Réponse

This method is asynchronous and returns an Operation, which represents the current state of the operation. It contains an endpoint path that you can poll to obtain the real response and applicable metadata. See the documentation on long-running operations for more information.

The following sections describe the response and metadata objects that are provided when an operation completes.

RéponseInstanceMétadonnées

Aucun

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

List Instance Children
Bêta

GET /cloud/v2/universes/{universe_id}/places/{place_id}/instances/{instance_id}:listChildren

Lists an instance's children.

The maximum supported response data size is 500,000 bytes. If this limit is exceeded, the returned Operation will be completed with an error result that has an error code of 422.

Périmètres d'application
universe.place.instance:read
RequêteParamètres du chemin
universe_idstring
Requis

The universe ID.

place_idstring
Requis

The place ID.

instance_idstring
Requis

The instance ID.

Paramètres de requête
maxPageSizenumber

The maximum number of child instance to return. The service may return fewer than this value. If unspecified, at most 200 children will be returned. The maximum value is 200; values above 200 will be coerced to 200.

pageTokenstring

A page token, received from a previous ListInstanceChildrenRequest call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListInstanceChildrenRequest must match the call that provided the page token.

Réponse

This method is asynchronous and returns an Operation, which represents the current state of the operation. It contains an endpoint path that you can poll to obtain the real response and applicable metadata. See the documentation on long-running operations for more information.

The following sections describe the response and metadata objects that are provided when an operation completes.

Réponse

Returns a list of the instance's children.

instancesarray<Instance>

A list of children instances.

nextPageTokenstring

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

Métadonnées

Aucun

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