Versions - List

Service:

Azure AI Services

API Version:

2.0

Gets a list of versions for this application ID.

GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions

With optional parameters:

GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions?skip={skip}&take={take}

URI Parameters

Name	In	Required	Type	Description
appId	path	True	string uuid	The application ID.
Endpoint	path	True	string	Supported Cognitive Services endpoints (protocol and hostname, for example: https://westus.api.cognitive.microsoft.com).
skip	query		integer	The number of entries to skip. Default value is 0.
take	query		integer	The number of entries to return. Maximum page size is 500. Default is 100.

Request Header

Name	Required	Type	Description
Ocp-Apim-Subscription-Key	True	string

Responses

Name	Type	Description
200 OK	VersionInfo[]	A list of all versions of the application.
Other Status Codes	ErrorResponse	Error Response.

Security

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Examples

Successful Get Application Versions info request

Sample request

HTTP

GET {Endpoint}/luis/api/v2.0/apps/363187f1-c573-46b3-bc4c-ae01d686e68e/versions?skip=0&take=100

Sample response

Status code:

200

[
  {
    "version": "0.1",
    "createdDateTime": "2017-08-01T14:34:15Z",
    "lastModifiedDateTime": "2017-11-28T20:12:09Z",
    "lastTrainedDateTime": "2017-11-28T20:12:12Z",
    "lastPublishedDateTime": "2017-11-28T20:12:35Z",
    "endpointUrl": "https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/363187f1-c573-46b3-bc4c-ae01d686e68e",
    "assignedEndpointKey": {
      "SubscriptionKey": "",
      "SubscriptionRegion": "westus",
      "SubscriptionName": ""
    },
    "externalApiKeys": {},
    "intentsCount": 4,
    "entitiesCount": 0,
    "endpointHitsCount": 175,
    "trainingStatus": "Trained"
  }
]

Definitions

Name	Description
ErrorResponse	Error response when invoking an operation on the API.
TrainingStatus	The Training status.
VersionInfo	Object model of an application version.

ErrorResponse

Error response when invoking an operation on the API.

Name	Type	Description
errorType	string

TrainingStatus

The Training status.

Name	Type	Description
Fail	string
InProgress	string
Queued	string
Success	string
UpToDate	string

VersionInfo

Object model of an application version.

Name	Type	Description
assignedEndpointKey	object	The endpoint key.
createdDateTime	string	The version's creation timestamp.
endpointHitsCount	integer	Number of calls made to this endpoint.
endpointUrl	string	The Runtime endpoint URL for this model version.
entitiesCount	integer	Number of entities in this model.
externalApiKeys	object	External keys.
intentsCount	integer	Number of intents in this model.
lastModifiedDateTime	string	Timestamp of the last update.
lastPublishedDateTime	string	Timestamp when was last published.
lastTrainedDateTime	string	Timestamp of the last time the model was trained.
trainingStatus	TrainingStatus	The current training status.
version	string	The version ID. E.g.: "0.1"