# Applicationinstanceproperty The ApplicationInstanceProperty is an element that adds meaning to the [ApplicationInstance](/game-hosting/elements/application/applicationinstance.md) element. These properties are inherited from the [ApplicationBuild](/game-hosting/elements/application/applicationbuild.md) element and their values will be populated according to the actual settings of the ApplicationInstance. One cannot add or edit ApplicationInstanceProperties manually. ## Inheritance example Given that you have the following ApplicationProperty elements with default values for your Application: | Property type (id) | Property name | Property default value | | ------------------------ | ------------- | ---------------------- | | public network port (1) | gamePort | 11000 | | private network port (6) | adminPort | 31000 | | password16 (3) | adminPass | \ | Table 1: ApplicationProperty examples For an ApplicationInstance these values would be substituted with the actual values used for the instance. These are just an illustration of possible values. | Property type (id) | Property name | Property actual value | | ------------------------ | ------------- | --------------------- | | public network port (1) | gamePort | 11005 | | private network port (6) | adminPort | 30530 | | password16 (3) | adminPass | d092FuOIAdFGv329 | Table 2: ApplicationInstanceProperty examples ## Element structure | Property | Value type | Required | Read-only | Description | | ------------- | ---------- | --------------------- | --------- | -------------------------------- | | propertyId | string | N/A | Yes | Unique identifier of the element | | propertyType | int | Yes | No | Type ID of the property | | propertyKey | string | Yes | No | The name of the property | | propertyValue | mixed | Only for network port | No | The value of the property | Table 3: ApplicationInstanceProperty element structure ## propertyKey constraints The characters allowed for a propertyKey are : `a-z, 0-9, -, _` A property key must start with a lowercase character. The maximum length of a propertyKey is 50 characters. ## propertyValue constraints Any UTF-8 character is allowed in a propertyValue. The maximum length of a propertyValue is 150 characters. ## propertyType ApplicationInstanceProperty elements consist of a `propertyType`, a `propertyKey` and a `propertyValue`. The `propertyType` indicates the functionality of the property. The `propertyKey` gives the property a name and the `value` a value. Not all property types require a value. E.g. if you have a property of `propertyType` `password16`, you can leave `propertyValue` empty. This means we will generate a password, in this case with a length of 16 characters. If however you do enter a `propertyValue`, then we take that as the password and the system will not generate a new random password. You can find all available property types and usages in the next chapter. ## Available property types A propertyType is indicated by a numerical ID. The following types are available: | ID | Type | Value type | Value required? | Description | | -- | -------------------------- | ------------------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 0 | raw value | mixed | no | A custom raw value. This property's key and value will be passed to ApplicationBuilds, ApplicationInstances and labels as-is. | | 1 | public network port | A number between: 10240 - 29999 | yes | Indicates a default public network port for your application. When the system deploys a new ApplicationInstance, it will find a unique network port to use, per host. The default value is taken as the initial value and will be incremented by 50 until a free port is found. | | 2 | password8 | string | no | An 8 character password. If no value provided, we generate a unique password for every ApplicationInstance. | | 3 | password16 | string | no | A 16 character password. If no value provided, we generate a unique password for every ApplicationInstance. | | 4 | password24 | string | no | A 24 character password. If no value provided, we generate a unique password for every ApplicationInstance. | | 5 | public network port range | A number between 2 and 200 | yes | A number indicating the size of the desired port range. | | 6 | private network port | A number between: 30000 - 49151 | yes | Indicates a default private network port for your application. When the system deploys a new ApplicationInstance, it will find a unique network port to use, per host. The default value is taken as the initial value and will be incremented by 50 until a free port is found. | | 7 | private network port range | A number between 2 and 200 | yes | A number indicating the size of the desired port range. | Table 4: Property types ## Property inheritance An ApplicationInstance's properties are inherited from the [ApplicationBuild](/game-hosting/elements/application/applicationbuild.md) element it was deployed for. ## Restrictions ApplicationInstanceProperty elements cannot be added / edited manually. They are always inherited from the [ApplicationBuild](/game-hosting/elements/application/applicationbuild.md) element it was deployed for. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.i3d.net/game-hosting/elements/application/applicationinstanceproperty.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.