swagger: '2.0' info: title: Microsoft Azure Microsoft Cognitive Language Service - Analyze Text Authoring version: 2023-04-15-preview description: >- The language service API is a suite of natural language processing (NLP) skills built with best-in-class Microsoft machine learning algorithms. The API can be used to analyze unstructured text for tasks such as sentiment analysis, key phrase extraction, language detection and question answering. Further documentation can be found in https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/overview. securityDefinitions: AADToken: type: oauth2 authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize flow: implicit description: >- These are the [Azure Active Directory OAuth2](https://docs.microsoft.com/azure/active-directory/develop/v1-overview) Flows. When paired with [Azure role-based access](https://docs.microsoft.com/azure/role-based-access-control/overview) control it can be used to control access to Azure Maps REST APIs. Azure role-based access controls are used to designate access to one or more Azure Maps resource account or sub-resources. Any user, group, or service principal can be granted access via a built-in role or a custom role composed of one or more permissions to Azure Maps REST APIs. To implement scenarios, we recommend viewing [authentication concepts](https://aka.ms/amauth). In summary, this security definition provides a solution for modeling application(s) via objects capable of access control on specific APIs and scopes. #### Notes * This security definition **requires** the use of the `x-ms-client-id` header to indicate which Azure Maps resource the application is requesting access to. This can be acquired from the [Maps management API](https://aka.ms/amauthdetails). * The `Authorization URL` is specific to the Azure public cloud instance. Sovereign clouds have unique Authorization URLs and Azure Active directory configurations. * The Azure role-based access control is configured from the [Azure management plane](https://aka.ms/amrbac) via Azure portal, PowerShell, CLI, Azure SDKs, or REST APIs. * Usage of the [Azure Maps Web SDK](https://aka.ms/amaadmc) allows for configuration based setup of an application for multiple use cases. * Currently, Azure Active Directory [v1.0 or v2.0](https://docs.microsoft.com/azure/active-directory/develop/azure-ad-endpoint-comparison) supports Work, School, and Guests but does not support Personal accounts. scopes: https://cognitiveservices.azure.com/.default: https://cognitiveservices.azure.com/.default apim_key: type: apiKey description: A subscription key for a Language service resource. name: Ocp-Apim-Subscription-Key in: header security: - AADToken: - https://cognitiveservices.azure.com/.default - apim_key: [] x-ms-parameterized-host: hostTemplate: '{Endpoint}/language' useSchemePrefix: false parameters: - $ref: common.json#/parameters/Endpoint paths: /authoring/analyze-text/projects: get: description: Lists the existing projects. operationId: microsoftAzureTextanalysisauthoringListprojects produces: - application/json parameters: - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The metadata of projects. schema: $ref: '#/definitions/TextAnalysisAuthoringProjectsMetadata' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful List Projects: $ref: ./examples/analyzetext-authoring/SuccessfulListProjects.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects tags: - Authoring /authoring/analyze-text/projects/{projectName}: patch: description: Creates a new project or updates an existing one. operationId: microsoftAzureTextanalysisauthoringCreateproject consumes: - application/merge-patch+json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - in: body name: body description: The project parameters. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringCreateProjectOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The metadata of the updated project, if it already exists. schema: $ref: '#/definitions/TextAnalysisAuthoringProjectMetadata' '201': description: The metadata of the created project. schema: $ref: '#/definitions/TextAnalysisAuthoringProjectMetadata' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Create Project: $ref: ./examples/analyzetext-authoring/SuccessfulCreateProject.json summary: Microsoft Azure Patch Authoring Analyze Text Projects Projectname tags: - Authoring get: description: Gets the details of a project. operationId: microsoftAzureTextanalysisauthoringGetproject produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The metadata of the project. schema: $ref: '#/definitions/TextAnalysisAuthoringProjectMetadata' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Project: $ref: ./examples/analyzetext-authoring/SuccessfulGetProject.json summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname tags: - Authoring delete: description: Deletes a project. operationId: microsoftAzureTextanalysisauthoringDeleteproject produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Delete Project: $ref: ./examples/analyzetext-authoring/SuccessfulDeleteProject.json x-ms-long-running-operation: true summary: Microsoft Azure Delete Authoring Analyze Text Projects Projectname tags: - Authoring /authoring/analyze-text/projects/{projectName}/:authorize-copy: post: description: >- Generates a copy project operation authorization to the current target Azure resource. operationId: microsoftAzureTextanalysisauthoringCopyprojectauthorization consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - in: body name: body description: The copy project authorization info. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringCopyAuthorizationOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: Payload to send to source resource to initiate project copying. schema: $ref: '#/definitions/TextAnalysisAuthoringCopyProjectOptions' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Copy Project Authorization: $ref: >- ./examples/analyzetext-authoring/SuccessfulCopyProjectAuthorization.json summary: Microsoft Azure Post Authoring Analyze Text Projects Projectname :authorize Copy tags: - Authoring /authoring/analyze-text/projects/{projectName}/:copy: post: description: Copies an existing project to another Azure resource. operationId: microsoftAzureTextanalysisauthoringCopyproject consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - in: body name: body description: The copy project info. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringCopyProjectOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Copy Project: $ref: ./examples/analyzetext-authoring/SuccessfulCopyProject.json x-ms-long-running-operation: true summary: Microsoft Azure Post Authoring Analyze Text Projects Projectname :copy tags: - Authoring /authoring/analyze-text/projects/{projectName}/:export: post: description: Triggers a job to export a project's data. operationId: microsoftAzureTextanalysisauthoringExport produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringStringIndexTypeQueryParameter' - in: query name: assetKind description: Kind of asset to export. type: string x-ms-parameter-location: method - in: query name: trainedModelLabel description: >- Trained model label to export. If the trainedModelLabel is null, the default behavior is to export the current working copy. type: string x-ms-parameter-location: method - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Export Project: $ref: ./examples/analyzetext-authoring/SuccessfulExportProject.json x-ms-long-running-operation: true summary: Microsoft Azure Post Authoring Analyze Text Projects Projectname :export tags: - Authoring /authoring/analyze-text/projects/{projectName}/:import: post: description: >- Triggers a job to import a project. If a project with the same name already exists, the data of that project is replaced. operationId: microsoftAzureTextanalysisauthoringImport consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - in: header name: format description: >- The format of the project to import. The currently supported formats are json and aml formats. If not provided, the default is set to json. type: string x-ms-parameter-location: method - in: body name: body description: The project data to import. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringExportedProject' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Import Project: $ref: ./examples/analyzetext-authoring/SuccessfulImportProject.json x-ms-long-running-operation: true summary: Microsoft Azure Post Authoring Analyze Text Projects Projectname :import tags: - Authoring /authoring/analyze-text/projects/{projectName}/:train: post: description: Triggers a training job for a project. operationId: microsoftAzureTextanalysisauthoringTrain consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - in: body name: body description: The training input parameters. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringTrainingJobOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Train Project: $ref: ./examples/analyzetext-authoring/SuccessfulTrainProject.json x-ms-long-running-operation: true summary: Microsoft Azure Post Authoring Analyze Text Projects Projectname :train tags: - Authoring /authoring/analyze-text/projects/{projectName}/copy/jobs/{jobId}: get: description: Gets the status of an existing copy project job. operationId: microsoftAzureTextanalysisauthoringGetcopyprojectstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The status of the long running operation. schema: $ref: '#/definitions/TextAnalysisAuthoringCopyProjectJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Copy Project Status: $ref: ./examples/analyzetext-authoring/SuccessfulGetCopyProjectStatus.json summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Copy Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/deployments: get: description: Lists the deployments belonging to a project. operationId: microsoftAzureTextanalysisauthoringListdeployments produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: List of all deployments. schema: $ref: '#/definitions/TextAnalysisAuthoringProjectDeployments' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful List Deployments: $ref: ./examples/analyzetext-authoring/SuccessfulListDeployments.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Deployments tags: - Authoring /authoring/analyze-text/projects/{projectName}/deployments/:swap: post: description: Swaps two existing deployments with each other. operationId: microsoftAzureTextanalysisauthoringSwapdeployments consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - in: body name: body description: The job object to swap two deployments. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringSwapDeploymentsOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Swap Deployments: $ref: ./examples/analyzetext-authoring/SuccessfulSwapDeployments.json x-ms-long-running-operation: true summary: Microsoft Azure Post Authoring Analyze Text Projects Projectname Deployments :swap tags: - Authoring /authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}: get: description: Gets the details of a deployment. operationId: microsoftAzureTextanalysisauthoringGetdeployment produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/DeploymentNamePathParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The Deployment info. schema: $ref: '#/definitions/TextAnalysisAuthoringProjectDeployment' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Deployment: $ref: ./examples/analyzetext-authoring/SuccessfulGetDeployment.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Deployments Deploymentname tags: - Authoring put: description: Creates a new deployment or replaces an existing one. operationId: microsoftAzureTextanalysisauthoringDeployproject consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/DeploymentNamePathParameter - in: body name: body description: The new deployment info. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringCreateDeploymentOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Deploy Project: $ref: ./examples/analyzetext-authoring/SuccessfulDeployProject.json x-ms-long-running-operation: true summary: >- Microsoft Azure Put Authoring Analyze Text Projects Projectname Deployments Deploymentname tags: - Authoring delete: description: Deletes a project deployment. operationId: microsoftAzureTextanalysisauthoringDeletedeployment produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/DeploymentNamePathParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Delete Deployment: $ref: ./examples/analyzetext-authoring/SuccessfulDeleteDeployment.json x-ms-long-running-operation: true summary: >- Microsoft Azure Delete Authoring Analyze Text Projects Projectname Deployments Deploymentname tags: - Authoring /authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}/:delete-from-resources: post: description: Deletes a project deployment from the specified assigned resources. operationId: microsoftAzureTextanalysisauthoringDeletedeploymentfromresources consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/DeploymentNamePathParameter - in: body name: body description: The options for deleting the deployment. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringDeleteDeploymentOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Delete Deployment: $ref: >- ./examples/analyzetext-authoring/SuccessfulDeleteDeploymentFromResources.json x-ms-long-running-operation: true summary: >- Microsoft Azure Post Authoring Analyze Text Projects Projectname Deployments Deploymentname :delete From Resources tags: - Authoring /authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}/delete-from-resources/jobs/{jobId}: get: description: >- Gets the status of an existing delete deployment from specific resources job. operationId: >- microsoftAzureTextanalysisauthoringGetdeploymentdeletefromresourcesstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/DeploymentNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The deployment job result. schema: $ref: '#/definitions/TextAnalysisAuthoringDeploymentJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Deployment Status: $ref: ./examples/analyzetext-authoring/SuccessfulGetDeploymentStatus.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Deployments Deploymentname Delete From Resources Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}/jobs/{jobId}: get: description: Gets the status of an existing deployment job. operationId: microsoftAzureTextanalysisauthoringGetdeploymentstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/DeploymentNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The deployment job result. schema: $ref: '#/definitions/TextAnalysisAuthoringDeploymentJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Deployment Status: $ref: ./examples/analyzetext-authoring/SuccessfulGetDeploymentStatus.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Deployments Deploymentname Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/deployments/swap/jobs/{jobId}: get: description: Gets the status of an existing swap deployment job. operationId: microsoftAzureTextanalysisauthoringGetswapdeploymentsstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The swap deployment job result. schema: $ref: '#/definitions/TextAnalysisAuthoringDeploymentJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Swap Deployments Status: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetSwapDeploymentsStatus.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Deployments Swap Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/export/jobs/{jobId}: get: description: >- Gets the status of an export job. Once job completes, returns the project metadata, and assets. operationId: microsoftAzureTextanalysisauthoringGetexportstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The status of the long running operation. schema: $ref: '#/definitions/TextAnalysisAuthoringExportProjectJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Export Status: $ref: ./examples/analyzetext-authoring/SuccessfulGetExportStatus.json summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Export Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/exported-models: get: description: Lists the exported models belonging to a project. operationId: microsoftAzureTextanalysisauthoringListexportedmodels produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: List of all exported models. schema: $ref: '#/definitions/TextAnalysisAuthoringExportedTrainedModels' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful List Exported Models: $ref: ./examples/analyzetext-authoring/SuccessfulListExportedModels.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Exported Models tags: - Authoring /authoring/analyze-text/projects/{projectName}/exported-models/{exportedModelName}: get: description: Gets the details of an exported model. operationId: microsoftAzureTextanalysisauthoringGetexportedmodel produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringExportedModelNamePathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: Exported model info schema: $ref: '#/definitions/TextAnalysisAuthoringExportedTrainedModel' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Exported Model: $ref: ./examples/analyzetext-authoring/SuccessfulGetExportedModel.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Exported Models Exportedmodelname tags: - Authoring delete: description: Deletes an existing exported model. operationId: microsoftAzureTextanalysisauthoringDeleteexportedmodel produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringExportedModelNamePathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results in triggering the deletion of the exported model. headers: operation-location: description: The location of the status API for monitoring the deletion job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Delete Exported Model: $ref: ./examples/analyzetext-authoring/SuccessfulDeleteExportedModel.json x-ms-long-running-operation: true summary: >- Microsoft Azure Delete Authoring Analyze Text Projects Projectname Exported Models Exportedmodelname tags: - Authoring put: description: Creates a new exported model or replaces an existing one. operationId: microsoftAzureTextanalysisauthoringCreateorupdateexportedmodel consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringExportedModelNamePathParameter' - in: body name: body description: The exported model info. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringExportedModelOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results in loading the working directory with the snapshot of the model provided. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Load Snapshot: $ref: ./examples/analyzetext-authoring/SuccessfulCreateExportedModel.json x-ms-long-running-operation: true summary: >- Microsoft Azure Put Authoring Analyze Text Projects Projectname Exported Models Exportedmodelname tags: - Authoring /authoring/analyze-text/projects/{projectName}/exported-models/{exportedModelName}/jobs/{jobId}: get: description: >- Gets the status for an existing job to create or update an exported model. operationId: microsoftAzureTextanalysisauthoringGetexportedmodeljobstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringExportedModelNamePathParameter' - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The details of the long running operation. schema: $ref: '#/definitions/TextAnalysisAuthoringExportedModelJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Exported Model Status: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetExportedModelStatus.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Exported Models Exportedmodelname Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/exported-models/{exportedModelName}/manifest: get: description: Gets the details and URL needed to download the exported model. operationId: microsoftAzureTextanalysisauthoringGetexportedmodelmanifest produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringExportedModelNamePathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The exported model manifest. schema: $ref: '#/definitions/TextAnalysisAuthoringExportedModelManifest' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Exported Model Manifest: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetExportedModelManifest.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Exported Models Exportedmodelname Manifest tags: - Authoring /authoring/analyze-text/projects/{projectName}/import/jobs/{jobId}: get: description: Gets the status for an import. operationId: microsoftAzureTextanalysisauthoringGetimportstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The details of the long running operation. schema: $ref: '#/definitions/TextAnalysisAuthoringImportProjectJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Import Status: $ref: ./examples/analyzetext-authoring/SuccessfulGetImportStatus.json summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Import Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/models: get: description: Lists the trained models belonging to a project. operationId: microsoftAzureTextanalysisauthoringListtrainedmodels produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: List of all trained models. schema: $ref: '#/definitions/TextAnalysisAuthoringProjectTrainedModels' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful List Models: $ref: ./examples/analyzetext-authoring/SuccessfulListModels.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Models tags: - Authoring /authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}: get: description: Gets the details of a trained model. operationId: microsoftAzureTextanalysisauthoringGettrainedmodel produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringTrainedModelLabelPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: Trained model info schema: $ref: '#/definitions/TextAnalysisAuthoringProjectTrainedModel' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Model: $ref: ./examples/analyzetext-authoring/SuccessfulGetModel.json summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Models Trainedmodellabel tags: - Authoring delete: description: Deletes an existing trained model. operationId: microsoftAzureTextanalysisauthoringDeletetrainedmodel produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringTrainedModelLabelPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '204': description: Deleted successfully. default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Delete Model: $ref: ./examples/analyzetext-authoring/SuccessfulDeleteModel.json summary: >- Microsoft Azure Delete Authoring Analyze Text Projects Projectname Models Trainedmodellabel tags: - Authoring /authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/:evaluate: post: description: Triggers evaluation operation on a trained model. operationId: microsoftAzureTextanalysisauthoringEvaluatemodel consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringTrainedModelLabelPathParameter' - in: body name: body description: The training input parameters. required: true schema: $ref: '#/definitions/TextAnalysisAuthoringEvaluationOptions' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Evaluation: $ref: ./examples/analyzetext-authoring/SuccessfulEvaluationProject.json x-ms-long-running-operation: true summary: >- Microsoft Azure Post Authoring Analyze Text Projects Projectname Models Trainedmodellabel :evaluate tags: - Authoring /authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/:load-snapshot: post: description: >- Restores the snapshot of this trained model to be the current working directory of the project. operationId: microsoftAzureTextanalysisauthoringLoadsnapshot produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringTrainedModelLabelPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results in loading the working directory with the snapshot of the model provided. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Load Snapshot: $ref: ./examples/analyzetext-authoring/SuccessfulLoadSnapshot.json x-ms-long-running-operation: true summary: >- Microsoft Azure Post Authoring Analyze Text Projects Projectname Models Trainedmodellabel :load Snapshot tags: - Authoring /authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluate/jobs/{jobId}: get: description: Gets the status for an evaluation job. operationId: microsoftAzureTextanalysisauthoringGetevaluationstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringTrainedModelLabelPathParameter' - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The evaluation job result. schema: $ref: '#/definitions/TextAnalysisAuthoringEvaluationJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Evaluation Status: $ref: ./examples/analyzetext-authoring/SuccessfulGetEvaluationStatus.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Models Trainedmodellabel Evaluate Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluation/result: get: description: >- Gets the detailed results of the evaluation for a trained model. This includes the raw inference results for the data included in the evaluation process. operationId: microsoftAzureTextanalysisauthoringGetmodelevaluationresults produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringTrainedModelLabelPathParameter' - $ref: '#/parameters/TextAnalysisAuthoringStringIndexTypeQueryParameter' - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: List of the evaluation results. schema: $ref: '#/definitions/TextAnalysisAuthoringEvaluationResults' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Model Evaluation: $ref: ./examples/analyzetext-authoring/SuccessfulGetModelEvaluation.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Models Trainedmodellabel Evaluation Result tags: - Authoring /authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/evaluation/summary-result: get: description: >- Gets the evaluation summary of a trained model. The summary includes high level performance measurements of the model e.g., F1, Precision, Recall, etc. operationId: microsoftAzureTextanalysisauthoringGetmodelevaluationsummary produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringTrainedModelLabelPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: List of all evaluation results. schema: $ref: '#/definitions/TextAnalysisAuthoringEvaluationSummary' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Model Evaluation Summary: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetModelEvaluationSummary.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Models Trainedmodellabel Evaluation Summary Result tags: - Authoring /authoring/analyze-text/projects/{projectName}/models/{trainedModelLabel}/load-snapshot/jobs/{jobId}: get: description: Gets the status for loading a snapshot. operationId: microsoftAzureTextanalysisauthoringGetloadsnapshotstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringTrainedModelLabelPathParameter' - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The details of the long running operation. schema: $ref: '#/definitions/TextAnalysisAuthoringLoadSnapshotJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Load Snapshot Status: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetLoadSnapshotStatus.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Models Trainedmodellabel Load Snapshot Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/resources: get: description: Lists the deployments resources assigned to the project. operationId: microsoftAzureTextanalysisauthoringListdeploymentresources produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The assigned deployment resources. schema: $ref: '#/definitions/TextAnalysisAuthoringAssignedDeploymentResources' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful List Deployment Resources: $ref: >- ./examples/analyzetext-authoring/SuccessfulListDeploymentResources.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Resources tags: - Authoring /authoring/analyze-text/projects/{projectName}/resources/:assign: post: description: >- Assign new Azure resources to a project to allow deploying new deployments to them. This API is available only via AAD authentication and not supported via subscription key authentication. For more details about AAD authentication, check here: https://learn.microsoft.com/en-us/azure/cognitive-services/authentication?tabs=powershell#authenticate-with-azure-active-directory operationId: microsoftAzureTextanalysisauthoringAssigndeploymentresources consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - in: body name: body description: The new project resources info. required: true schema: $ref: >- #/definitions/TextAnalysisAuthoringAssignDeploymentResourcesOptions - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Assign Deployment Resources: $ref: >- ./examples/analyzetext-authoring/SuccessfulAssignDeploymentResources.json x-ms-long-running-operation: true summary: Microsoft Azure Post Authoring Analyze Text Projects Projectname Resources :assign tags: - Authoring /authoring/analyze-text/projects/{projectName}/resources/:unassign: post: description: >- Unassign resources from a project. This disallows deploying new deployments to these resources, and deletes existing deployments assigned to them. operationId: microsoftAzureTextanalysisauthoringUnassigndeploymentresources consumes: - application/json produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - in: body name: body description: The info for the deployment resources to be deleted. required: true schema: $ref: >- #/definitions/TextAnalysisAuthoringUnassignDeploymentResourcesOptions - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: The location of the status API for monitoring the created job. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Unassign Deployment Resources: $ref: >- ./examples/analyzetext-authoring/SuccessfulUnassignDeploymentResources.json x-ms-long-running-operation: true summary: Microsoft Azure Post Authoring Analyze Text Projects Projectname Resources :unassign tags: - Authoring /authoring/analyze-text/projects/{projectName}/resources/assign/jobs/{jobId}: get: description: Gets the status of an existing assign deployment resources job. operationId: microsoftAzureTextanalysisauthoringGetassigndeploymentresourcesstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The assign deployment resources job result. schema: $ref: '#/definitions/TextAnalysisAuthoringDeploymentResourcesJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Assign Deployment Resources Status: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetAssignDeploymentResourcesStatus.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Resources Assign Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/resources/unassign/jobs/{jobId}: get: description: Gets the status of an existing unassign deployment resources job. operationId: microsoftAzureTextanalysisauthoringGetunassigndeploymentresourcesstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The unassign deployment resources job result. schema: $ref: '#/definitions/TextAnalysisAuthoringDeploymentResourcesJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Unassign Deployment Resources Status: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetUnassignDeploymentResourcesStatus.json summary: >- Microsoft Azure Get Authoring Analyze Text Projects Projectname Resources Unassign Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/train/jobs: get: description: Lists the non-expired training jobs created for a project. operationId: microsoftAzureTextanalysisauthoringListtrainingjobs produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: List of the training jobs. schema: $ref: '#/definitions/TextAnalysisAuthoringTrainingJobs' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful List Training Jobs: $ref: ./examples/analyzetext-authoring/SuccessfulListTrainingJobs.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Train Jobs tags: - Authoring /authoring/analyze-text/projects/{projectName}/train/jobs/{jobId}: get: description: Gets the status for a training job. operationId: microsoftAzureTextanalysisauthoringGettrainingstatus produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The training job result. schema: $ref: '#/definitions/TextAnalysisAuthoringTrainingJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Train Status: $ref: ./examples/analyzetext-authoring/SuccessfulGetTrainStatus.json summary: Microsoft Azure Get Authoring Analyze Text Projects Projectname Train Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/{projectName}/train/jobs/{jobId}/:cancel: post: description: Triggers a cancellation for a running training job. operationId: microsoftAzureTextanalysisauthoringCanceltrainingjob produces: - application/json parameters: - $ref: common.json#/parameters/ProjectNamePathParameter - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '202': description: >- A successful call results with an Operation-Location header used to check the status of the job. headers: operation-location: description: >- The location of the status API for monitoring the job cancellation. type: string default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Cancel Training Job: $ref: ./examples/analyzetext-authoring/SuccessfulCancelTrainingJob.json x-ms-long-running-operation: true summary: >- Microsoft Azure Post Authoring Analyze Text Projects Projectname Train Jobs Jobid :cancel tags: - Authoring /authoring/analyze-text/projects/global/deletion-jobs/{jobId}: get: description: Gets the status for a project deletion job. operationId: microsoftAzureTextanalysisauthoringGetprojectdeletionstatus produces: - application/json parameters: - $ref: '#/parameters/TextAnalysisAuthoringJobIdPathParameter' - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The project deletion job result. schema: $ref: '#/definitions/TextAnalysisAuthoringProjectDeletionJobState' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Project Deletion Status: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetProjectDeletionStatus.json summary: Microsoft Azure Get Authoring Analyze Text Projects Global Deletion Jobs Jobid tags: - Authoring /authoring/analyze-text/projects/global/deployments/resources: get: description: >- Lists the deployments to which an Azure resource is assigned. This doesn't return deployments belonging to projects owned by this resource. It only returns deployments belonging to projects owned by other resources. operationId: microsoftAzureTextanalysisauthoringListassignedresourcedeployments produces: - application/json parameters: - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The assigned deployments metadata for the resource. schema: $ref: >- #/definitions/TextAnalysisAuthoringAssignedResourceDeploymentsMetadata default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful List Assigned Resource Deployments: $ref: >- ./examples/analyzetext-authoring/SuccessfulListAssignedResourceDeployments.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Global Deployments Resources tags: - Authoring /authoring/analyze-text/projects/global/languages: get: description: Lists the supported languages. operationId: microsoftAzureTextanalysisauthoringGetsupportedlanguages produces: - application/json parameters: - $ref: '#/parameters/TextAnalysisAuthoringProjectKindQueryOptionalParameter' - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The list of supported languages. schema: $ref: '#/definitions/TextAnalysisAuthoringSupportedLanguages' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Supported Languages: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetSupportedLanguages.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Global Languages tags: - Authoring /authoring/analyze-text/projects/global/prebuilt-entities: get: description: >- Lists the supported prebuilt entities that can be used while creating composed entities. operationId: microsoftAzureTextanalysisauthoringGetsupportedprebuiltentities produces: - application/json parameters: - $ref: '#/parameters/TextAnalysisAuthoringProjectKindQueryOptionalParameter' - in: query name: language description: >- The language to get supported prebuilt entities for. Required if multilingual is false. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string x-ms-parameter-location: method - in: query name: multilingual description: >- Whether to get the support prebuilt entities for multilingual or monolingual projects. If true, the language parameter is ignored. type: string x-ms-parameter-location: method - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: The list of supported prebuilt entities. schema: $ref: '#/definitions/TextAnalysisAuthoringPrebuiltEntities' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Supported Prebuilt Entities: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetSupportedPrebuiltEntities.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Global Prebuilt Entities tags: - Authoring /authoring/analyze-text/projects/global/training-config-versions: get: description: Lists the support training config version for a given project type. operationId: microsoftAzureTextanalysisauthoringListtrainingconfigversions produces: - application/json parameters: - $ref: '#/parameters/TextAnalysisAuthoringProjectKindQueryParameter' - $ref: common.json#/parameters/TopParameter - $ref: common.json#/parameters/SkipParameter - $ref: common.json#/parameters/MaxPageSizeParameter - $ref: common.json#/parameters/ApiVersionParameter responses: '200': description: List of all trained models. schema: $ref: '#/definitions/TextAnalysisAuthoringTrainingConfigVersions' default: description: Error response. schema: $ref: common.json#/definitions/ErrorResponse x-ms-examples: Successful Get Supported Training Config Versions: $ref: >- ./examples/analyzetext-authoring/SuccessfulGetSupportedTrainingConfigVersions.json x-ms-pageable: nextLinkName: nextLink itemName: value summary: Microsoft Azure Get Authoring Analyze Text Projects Global Training Config Versions tags: - Authoring definitions: TextAnalysisAuthoringAssignDeploymentResourcesOptions: description: Represents the options for assigning Azure resources to a project. required: - resourcesMetadata type: object properties: resourcesMetadata: description: Represents the metadata for the resources to be assigned. type: array items: $ref: '#/definitions/TextAnalysisAuthoringResourceMetadata' x-ms-client-name: AssignDeploymentResourcesOptions TextAnalysisAuthoringAssignedDeploymentResource: description: Represents the assigned deployment resource. required: - azureResourceId - region type: object properties: azureResourceId: description: The resource ID. type: string region: description: The resource region. type: string x-ms-client-name: AssignedDeploymentResource TextAnalysisAuthoringAssignedDeploymentResources: description: Represents the assigned deployment resources. required: - value - nextLink type: object properties: value: description: The list of assigned deployment resources. type: array items: $ref: '#/definitions/TextAnalysisAuthoringAssignedDeploymentResource' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: AssignedDeploymentResources TextAnalysisAuthoringAssignedProjectDeploymentMetadata: description: Represents the metadata for an assigned deployment required: - deploymentName - lastDeployedDateTime - deploymentExpirationDate type: object properties: deploymentName: description: Represents the deployment name. type: string lastDeployedDateTime: format: date-time description: Represents deployment last deployed time. type: string deploymentExpirationDate: format: date description: Represents deployment expiration date in the runtime. type: string x-ms-client-name: AssignedProjectDeploymentMetadata TextAnalysisAuthoringAssignedProjectDeploymentsMetadata: description: Represents the metadata for assigned deployments for a project. required: - projectName - deploymentsMetadata type: object properties: projectName: description: Represents the project name. type: string deploymentsMetadata: description: Represents the resource region. type: array items: $ref: '#/definitions/TextAnalysisAuthoringAssignedProjectDeploymentMetadata' x-ms-client-name: AssignedProjectDeploymentsMetadata TextAnalysisAuthoringAssignedResourceDeploymentsMetadata: description: Represents the metadata for deployments assigned to a resource. required: - value - nextLink type: object properties: value: description: The list of retrieved assigned project deployments. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringAssignedProjectDeploymentsMetadata nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: AssignedResourceDeploymentsMetadata TextAnalysisAuthoringCompositionSetting: enum: - separateComponents - combineComponents type: string x-ms-enum: name: CompositionSetting modelAsString: true values: - value: separateComponents description: >- Every component's match or prediction is returned as a separate instance of the entity. - value: combineComponents description: >- When two or more components are found in the text and overlap, the components' spans are merged together into one span combining all of them. x-ms-client-name: CompositionSetting TextAnalysisAuthoringConfusionMatrix: type: object additionalProperties: $ref: '#/definitions/TextAnalysisAuthoringConfusionMatrixRow' x-ms-client-name: ConfusionMatrix TextAnalysisAuthoringConfusionMatrixCell: description: Represents a cell in a confusion matrix. required: - normalizedValue - rawValue type: object properties: normalizedValue: format: float description: Represents normalized value in percentages. type: number rawValue: format: float description: Represents raw value. type: number x-ms-client-name: ConfusionMatrixCell TextAnalysisAuthoringConfusionMatrixRow: type: object additionalProperties: $ref: '#/definitions/TextAnalysisAuthoringConfusionMatrixCell' x-ms-client-name: ConfusionMatrixRow TextAnalysisAuthoringCopyAuthorizationOptions: description: >- Represents the options for authorizing a project copy to the current Azure resource. required: - projectKind type: object properties: projectKind: description: Represents the project kind. $ref: '#/definitions/TextAnalysisAuthoringProjectKind' storageInputContainerName: description: The name of the storage container. type: string allowOverwrite: description: >- Whether to allow an existing project to be overwritten using the resulting copy authorization. type: boolean x-ms-client-name: CopyAuthorizationOptions TextAnalysisAuthoringCopyProjectJobState: description: Represents the state of a copy job. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' x-ms-client-name: CopyProjectJobState TextAnalysisAuthoringCopyProjectOptions: description: >- Represents the options for copying an existing project to another Azure resource. required: - projectKind - targetProjectName - accessToken - expiresAt - targetResourceId - targetResourceRegion type: object properties: projectKind: description: Represents the project kind. $ref: '#/definitions/TextAnalysisAuthoringProjectKind' targetProjectName: description: The project name to be copied-into. type: string accessToken: description: The access token. type: string expiresAt: format: date-time description: The expiration of the access token. type: string targetResourceId: description: Represents the target Azure resource ID. type: string targetResourceRegion: description: Represents the target Azure resource region. type: string x-ms-client-name: CopyProjectOptions TextAnalysisAuthoringCreateDeploymentOptions: description: Represents the options for creating or updating a project deployment. required: - trainedModelLabel type: object properties: trainedModelLabel: description: Represents the trained model label. type: string assignedResourceIds: description: |- Represents the resource IDs to be assigned to the deployment. If provided, the deployment will be rolled out to the resources provided here as well as the original resource in which the project is created. type: array items: type: string x-ms-client-name: CreateDeploymentOptions TextAnalysisAuthoringCreateProjectOptions: description: Represents the options used to create or update a project. required: - projectKind - storageInputContainerName - projectName - language type: object properties: projectKind: description: The project kind. $ref: '#/definitions/TextAnalysisAuthoringProjectKind' storageInputContainerName: description: The storage container name. type: string settings: description: The project settings. $ref: '#/definitions/TextAnalysisAuthoringProjectSettings' projectName: description: The new project name. type: string multilingual: description: Whether the project would be used for multiple languages or not. type: boolean description: description: The project description. type: string language: description: >- The project language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string x-ms-client-name: CreateProjectOptions TextAnalysisAuthoringCustomEntityRecognitionDocumentEvaluationResult: description: >- Represents the document evaluation result for a custom entity recognition project. required: - customEntityRecognitionResult type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringDocumentEvaluationResult' properties: customEntityRecognitionResult: description: Represents the evaluation prediction for entity recognition. $ref: >- #/definitions/TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult x-ms-discriminator-value: CustomEntityRecognition x-ms-client-name: CustomEntityRecognitionDocumentEvaluationResult TextAnalysisAuthoringCustomEntityRecognitionEvaluationSummary: description: Represents the evaluation summary for a custom entity recognition project. required: - customEntityRecognitionEvaluation type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringEvaluationSummary' properties: customEntityRecognitionEvaluation: description: Contains the data related to extraction evaluation. $ref: '#/definitions/TextAnalysisAuthoringEntityRecognitionEvaluationSummary' x-ms-discriminator-value: CustomEntityRecognition x-ms-client-name: CustomEntityRecognitionEvaluationSummary TextAnalysisAuthoringCustomHealthcareDocumentEvaluationResult: description: >- Represents the document evaluation result for a custom entity recognition project. required: - customHealthcareResult type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringDocumentEvaluationResult' properties: customHealthcareResult: description: Represents the evaluation prediction for entity recognition. $ref: '#/definitions/TextAnalysisAuthoringDocumentHealthcareEvaluationResult' x-ms-discriminator-value: CustomHealthcare x-ms-client-name: CustomHealthcareDocumentEvaluationResult TextAnalysisAuthoringCustomHealthcareEvaluationSummary: description: Represents the evaluation summary for a custom health care project. required: - customHealthcareEvaluation type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringEvaluationSummary' properties: customHealthcareEvaluation: description: Contains the data related to health care evaluation. $ref: '#/definitions/TextAnalysisAuthoringEntityRecognitionEvaluationSummary' x-ms-discriminator-value: CustomHealthcare x-ms-client-name: CustomHealthcareEvaluationSummary TextAnalysisAuthoringCustomMultiLabelClassificationDocumentEvaluationResult: description: >- Represents the document evaluation result for a custom multi-label classification project. required: - customMultiLabelClassificationResult type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringDocumentEvaluationResult' properties: customMultiLabelClassificationResult: description: Represents the evaluation prediction for multi label classification. $ref: >- #/definitions/TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult x-ms-discriminator-value: CustomMultiLabelClassification x-ms-client-name: CustomMultiLabelClassificationDocumentEvaluationResult TextAnalysisAuthoringCustomMultiLabelClassificationEvaluationSummary: description: >- Represents the evaluation summary for a custom multi-label classification project. required: - customMultiLabelClassificationEvaluation type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringEvaluationSummary' properties: customMultiLabelClassificationEvaluation: description: Contains the data related to multi label classification evaluation. $ref: >- #/definitions/TextAnalysisAuthoringMultiLabelClassificationEvaluationSummary x-ms-discriminator-value: CustomMultiLabelClassification x-ms-client-name: CustomMultiLabelClassificationEvaluationSummary TextAnalysisAuthoringCustomSingleLabelClassificationDocumentEvaluationResult: description: >- Represents the document evaluation result for a custom single-label classification project. required: - customSingleLabelClassificationResult type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringDocumentEvaluationResult' properties: customSingleLabelClassificationResult: description: Represents the evaluation prediction for single label classification. $ref: >- #/definitions/TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult x-ms-discriminator-value: CustomSingleLabelClassification x-ms-client-name: CustomSingleLabelClassificationDocumentEvaluationResult TextAnalysisAuthoringCustomSingleLabelClassificationEvaluationSummary: description: >- Represents the evaluation summary for a custom single-label classification project. required: - customSingleLabelClassificationEvaluation type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringEvaluationSummary' properties: customSingleLabelClassificationEvaluation: description: Contains the data related to single label classification evaluation. $ref: >- #/definitions/TextAnalysisAuthoringSingleLabelClassificationEvaluationSummary x-ms-discriminator-value: CustomSingleLabelClassification x-ms-client-name: CustomSingleLabelClassificationEvaluationSummary TextAnalysisAuthoringCustomTextSentimentDocumentEvaluationResult: description: Represents the document evaluation result for a custom sentiment project. required: - customTextSentimentResult type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringDocumentEvaluationResult' properties: customTextSentimentResult: description: Represents the evaluation prediction for text sentiment. $ref: >- #/definitions/TextAnalysisAuthoringDocumentTextSentimentEvaluationResult x-ms-discriminator-value: CustomTextSentiment x-ms-client-name: CustomTextSentimentDocumentEvaluationResult TextAnalysisAuthoringCustomTextSentimentEvaluationSummary: description: Represents the evaluation summary for a custom text sentiment project. required: - customTextSentimentEvaluation type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringEvaluationSummary' properties: customTextSentimentEvaluation: description: Contains the data related to custom sentiment evaluation. $ref: '#/definitions/TextAnalysisAuthoringTextSentimentEvaluationSummary' x-ms-discriminator-value: CustomTextSentiment x-ms-client-name: CustomTextSentimentEvaluationSummary TextAnalysisAuthoringDeleteDeploymentOptions: description: Represents the options for deleting a project deployment. type: object properties: assignedResourceIds: description: |- Represents the resource IDs to delete the deployment from. If not provided, the deployment will be rolled out from all the resources it is deployed to. If provided, it will delete the deployment only from the specified assigned resources, and leave it for the rest. type: array items: type: string x-ms-client-name: DeleteDeploymentOptions TextAnalysisAuthoringDeploymentJobState: description: Represents the state of a deployment job. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' x-ms-client-name: DeploymentJobState TextAnalysisAuthoringDeploymentResource: description: Represents an Azure resource assigned to a deployment. required: - resourceId - region type: object properties: resourceId: description: Represents the Azure resource Id. type: string region: description: Represents the resource region. type: string x-ms-client-name: DeploymentResource TextAnalysisAuthoringDeploymentResourcesJobState: description: Represents the state of a deployment resources job. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' x-ms-client-name: DeploymentResourcesJobState TextAnalysisAuthoringDocumentEntityLabelEvaluationResult: description: Represents an evaluation result entity label. required: - category - offset - length type: object properties: category: description: Represents the entity category. type: string offset: format: int32 description: Represents the entity offset index relative to the original text. type: integer length: format: int32 description: Represents the entity length. type: integer x-ms-client-name: DocumentEntityLabelEvaluationResult TextAnalysisAuthoringDocumentEntityRecognitionEvaluationResult: description: Represents the entity recognition evaluation result for a document. required: - entities type: object properties: entities: description: Represents the document labelled entities. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringDocumentEntityRegionEvaluationResult x-ms-client-name: DocumentEntityRecognitionEvaluationResult TextAnalysisAuthoringDocumentEntityRegionEvaluationResult: description: >- Represents the evaluation comparison between the expected and predicted entities of a document region. required: - expectedEntities - predictedEntities - regionOffset - regionLength type: object properties: expectedEntities: description: Represents the region's expected entity labels. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringDocumentEntityLabelEvaluationResult predictedEntities: description: Represents the region's predicted entity labels. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringDocumentEntityLabelEvaluationResult regionOffset: format: int32 description: Represents the region offset. type: integer regionLength: format: int32 description: Represents the region length. type: integer x-ms-client-name: DocumentEntityRegionEvaluationResult TextAnalysisAuthoringDocumentEvaluationResult: description: Represents the evaluation result of a document. required: - location - language - projectKind type: object properties: location: description: Represents the document path. type: string language: description: >- Represents the document language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string projectKind: description: Represents the project kind. $ref: '#/definitions/TextAnalysisAuthoringProjectKind' discriminator: projectKind x-ms-client-name: DocumentEvaluationResult TextAnalysisAuthoringDocumentHealthcareEvaluationResult: description: Represents the healthcare evaluation result for a document. required: - entities type: object properties: entities: description: Represents the document labelled entities. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringDocumentEntityRegionEvaluationResult x-ms-client-name: DocumentHealthcareEvaluationResult TextAnalysisAuthoringDocumentMultiLabelClassificationEvaluationResult: description: >- Represents the comparison between the expected and predicted classes that are result from the evaluation operation. required: - expectedClasses - predictedClasses type: object properties: expectedClasses: description: Represents the document's expected classes. type: array items: type: string predictedClasses: description: Represents the document's predicted classes. type: array items: type: string x-ms-client-name: DocumentMultiLabelClassificationEvaluationResult TextAnalysisAuthoringDocumentSentimentLabelEvaluationResult: description: Represents an evaluation result Sentiment label. required: - category - offset - length type: object properties: category: description: Represents the sentiment category. $ref: '#/definitions/TextAnalysisAuthoringSentiment' offset: format: int32 description: Represents the sentiment offset index relative to the original text. type: integer length: format: int32 description: Represents the sentiment length. type: integer x-ms-client-name: DocumentSentimentLabelEvaluationResult TextAnalysisAuthoringDocumentSingleLabelClassificationEvaluationResult: description: >- Represents the comparison between the expected and predicted class that result from an evaluation operation. required: - expectedClass - predictedClass type: object properties: expectedClass: description: Represents the document's expected class. type: string predictedClass: description: Represents the document's predicted class. type: string x-ms-client-name: DocumentSingleLabelClassificationEvaluationResult TextAnalysisAuthoringDocumentTextSentimentEvaluationResult: description: >- Represents the comparison between the expected and predicted sentiment that result from an evaluation operation. required: - expectedSentimentSpans - predictedSentimentSpans type: object properties: expectedSentimentSpans: description: Represents the document's expected sentiment labels. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringDocumentSentimentLabelEvaluationResult predictedSentimentSpans: description: Represents the document's predicted sentiment labels. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringDocumentSentimentLabelEvaluationResult x-ms-client-name: DocumentTextSentimentEvaluationResult TextAnalysisAuthoringEntityEvaluationSummary: description: Represents the evaluation summary for an entity. required: - f1 - precision - recall - truePositiveCount - trueNegativeCount - falsePositiveCount - falseNegativeCount type: object properties: f1: format: double description: Represents the model precision type: number precision: format: double description: Represents the model recall type: number recall: format: double description: Represents the model F1 score type: number truePositiveCount: format: int32 description: Represents the count of true positive type: integer trueNegativeCount: format: int32 description: Represents the count of true negative type: integer falsePositiveCount: format: int32 description: Represents the count of false positive type: integer falseNegativeCount: format: int32 description: Represents the count of false negative type: integer x-ms-client-name: EntityEvaluationSummary TextAnalysisAuthoringEntityRecognitionEvaluationSummary: description: Represents the evaluation summary for a custom entity recognition project. required: - confusionMatrix - entities - microF1 - microPrecision - microRecall - macroF1 - macroPrecision - macroRecall type: object properties: confusionMatrix: description: >- Represents the confusion matrix between two entities (the two entities can be the same). The matrix is between the entity that was labelled and the entity that was predicted. $ref: '#/definitions/TextAnalysisAuthoringConfusionMatrix' entities: description: Represents the entities evaluation type: object additionalProperties: $ref: '#/definitions/TextAnalysisAuthoringEntityEvaluationSummary' microF1: format: float description: >- Represents the micro F1. Expected value is a float between 0 and 1 inclusive. type: number microPrecision: format: float description: >- Represents the micro precision. Expected value is a float between 0 and 1 inclusive. type: number microRecall: format: float description: >- Represents the micro recall. Expected value is a float between 0 and 1 inclusive. type: number macroF1: format: float description: >- Represents the macro F1. Expected value is a float between 0 and 1 inclusive. type: number macroPrecision: format: float description: >- Represents the macro precision. Expected value is a float between 0 and 1 inclusive. type: number macroRecall: format: float description: >- Represents the macro recall. Expected value is a float between 0 and 1 inclusive. type: number x-ms-client-name: EntityRecognitionEvaluationSummary TextAnalysisAuthoringEvaluationJobResult: required: - evaluationOptions - modelLabel - trainingConfigVersion - percentComplete type: object properties: evaluationOptions: description: Represents the options used running the evaluation. $ref: '#/definitions/TextAnalysisAuthoringEvaluationOptions' modelLabel: description: Represents trained model label. type: string trainingConfigVersion: description: Represents training config version. type: string percentComplete: format: int32 description: Represents progress percentage. type: integer x-ms-client-name: EvaluationJobResult TextAnalysisAuthoringEvaluationJobState: description: Represents the state of a evaluation job. required: - result type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' properties: result: description: Represents evaluation task detailed result. $ref: '#/definitions/TextAnalysisAuthoringEvaluationJobResult' x-ms-client-name: EvaluationJobState TextAnalysisAuthoringEvaluationKind: enum: - percentage - manual type: string x-ms-enum: name: EvaluationKind modelAsString: true values: - value: percentage description: >- Split the data into training and test sets according to user-defined percentages. - value: manual description: >- Split the data according to the chosen dataset for every example in the data. x-ms-client-name: EvaluationKind TextAnalysisAuthoringEvaluationOptions: description: Represents the options used running the evaluation. type: object properties: kind: description: >- Represents the evaluation kind. By default, the evaluation kind is set to percentage. $ref: '#/definitions/TextAnalysisAuthoringEvaluationKind' trainingSplitPercentage: format: int32 description: >- Represents the training dataset split percentage. Only needed in case the evaluation kind is percentage. type: integer testingSplitPercentage: format: int32 description: >- Represents the testing dataset split percentage. Only needed in case the evaluation kind is percentage. type: integer x-ms-client-name: EvaluationOptions TextAnalysisAuthoringEvaluationResults: description: Represents a list of results for an evaluation operation. required: - value - nextLink type: object properties: value: description: THe list of documents evaluation results. type: array items: $ref: '#/definitions/TextAnalysisAuthoringDocumentEvaluationResult' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: EvaluationResults TextAnalysisAuthoringEvaluationSummary: description: Represents the summary for an evaluation operation. required: - projectKind - evaluationOptions type: object properties: projectKind: description: Represents the project type that the evaluation ran on. $ref: '#/definitions/TextAnalysisAuthoringProjectKind' evaluationOptions: $ref: '#/definitions/TextAnalysisAuthoringEvaluationOptions' discriminator: projectKind x-ms-client-name: EvaluationSummary TextAnalysisAuthoringExportedClass: description: Represents a class of an exported project. type: object properties: category: description: The class category. type: string x-ms-client-name: ExportedClass TextAnalysisAuthoringExportedCompositeEntity: description: >- Represents an entity in an exported project with composite entities enabled. type: object properties: compositionSetting: description: >- The behavior to follow when the entity's components overlap with each other. $ref: '#/definitions/TextAnalysisAuthoringCompositionSetting' list: description: The list component of the entity. $ref: '#/definitions/TextAnalysisAuthoringExportedEntityList' prebuilts: description: The prebuilt entities components. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedPrebuiltEntity' category: description: The entity category. type: string x-ms-client-name: ExportedCompositeEntity TextAnalysisAuthoringExportedCustomAbstractiveSummarizationDocument: description: >- Represents an exported document for a custom abstractive summarization project. required: - summaryLocation type: object properties: summaryLocation: description: >- Represents the summary file location in the blob store container associated with the project. type: string location: description: The location of the document in the storage. type: string language: description: >- Represents the document language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string dataset: description: The dataset for this document. Allowed values are 'Train' and 'Test'. type: string x-ms-client-name: ExportedCustomAbstractiveSummarizationDocument TextAnalysisAuthoringExportedCustomAbstractiveSummarizationProjectAssets: description: Represents the exported assets for an abstractive summarization project. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringExportedProjectAssets' properties: documents: description: The list of documents belonging to this project. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringExportedCustomAbstractiveSummarizationDocument x-ms-discriminator-value: CustomAbstractiveSummarization x-ms-client-name: ExportedCustomAbstractiveSummarizationProjectAssets TextAnalysisAuthoringExportedCustomEntityRecognitionDocument: description: Represents an exported document for a custom entity recognition project. type: object properties: entities: description: The list of entity labels belonging to the document. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedDocumentEntityRegion' location: description: The location of the document in the storage. type: string language: description: >- Represents the document language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string dataset: description: The dataset for this document. Allowed values are 'Train' and 'Test'. type: string x-ms-client-name: ExportedCustomEntityRecognitionDocument TextAnalysisAuthoringExportedCustomEntityRecognitionProjectAssets: description: Represents the exported assets for a entity recognition project. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringExportedProjectAssets' properties: entities: description: The list of entities belonging to the project. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedEntity' documents: description: The list of documents belonging to the project. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringExportedCustomEntityRecognitionDocument x-ms-discriminator-value: CustomEntityRecognition x-ms-client-name: ExportedCustomEntityRecognitionProjectAssets TextAnalysisAuthoringExportedCustomHealthcareDocument: description: Represents an exported document for a CustomHealthcare project. type: object properties: entities: description: The list of entity labels belonging to the document. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedDocumentEntityRegion' location: description: The location of the document in the storage. type: string language: description: >- Represents the document language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string dataset: description: The dataset for this document. Allowed values are 'Train' and 'Test'. type: string x-ms-client-name: ExportedCustomHealthcareDocument TextAnalysisAuthoringExportedCustomHealthcareProjectAssets: description: Represents the exported assets for a CustomHealthcare project. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringExportedProjectAssets' properties: entities: description: The list of entities belonging to the project. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedCompositeEntity' documents: description: The list of documents belonging to the project. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedCustomHealthcareDocument' x-ms-discriminator-value: CustomHealthcare x-ms-client-name: ExportedCustomHealthcareProjectAssets TextAnalysisAuthoringExportedCustomMultiLabelClassificationDocument: description: >- Represents an exported document of a custom multi-label classification project. type: object properties: classes: description: The document classes. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedDocumentClass' location: description: The location of the document in the storage. type: string language: description: >- Represents the document language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string dataset: description: The dataset for this document. Allowed values are 'Train' and 'Test'. type: string x-ms-client-name: ExportedCustomMultiLabelClassificationDocument TextAnalysisAuthoringExportedCustomMultiLabelClassificationProjectAssets: description: >- Represents the exported assets for a custom multi-label classification project. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringExportedProjectAssets' properties: classes: description: The list of classes in the project. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedClass' documents: description: The list of documents in the project. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringExportedCustomMultiLabelClassificationDocument x-ms-discriminator-value: CustomMultiLabelClassification x-ms-client-name: ExportedCustomMultiLabelClassificationProjectAssets TextAnalysisAuthoringExportedCustomSingleLabelClassificationDocument: description: >- Represents an exported document for a custom single-label classification project. type: object properties: class: description: The class of the documents. $ref: '#/definitions/TextAnalysisAuthoringExportedDocumentClass' location: description: The location of the document in the storage. type: string language: description: >- Represents the document language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string dataset: description: The dataset for this document. Allowed values are 'Train' and 'Test'. type: string x-ms-client-name: ExportedCustomSingleLabelClassificationDocument TextAnalysisAuthoringExportedCustomSingleLabelClassificationProjectAssets: description: Represents the exported assets for a single-label classification project. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringExportedProjectAssets' properties: classes: description: The list of classes belonging to this project. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedClass' documents: description: The list of documents belonging to this project. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringExportedCustomSingleLabelClassificationDocument x-ms-discriminator-value: CustomSingleLabelClassification x-ms-client-name: ExportedCustomSingleLabelClassificationProjectAssets TextAnalysisAuthoringExportedCustomTextSentimentDocument: description: Represents an exported document for a custom text sentiment project. type: object properties: sentimentSpans: type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedDocumentSentimentLabel' location: description: The location of the document in the storage. type: string language: description: >- Represents the document language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string dataset: description: The dataset for this document. Allowed values are 'Train' and 'Test'. type: string x-ms-client-name: ExportedCustomTextSentimentDocument TextAnalysisAuthoringExportedCustomTextSentimentProjectAssets: description: Represents the exported assets for a custom text sentiment project. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringExportedProjectAssets' properties: documents: description: The list of documents belonging to the project. type: array items: $ref: >- #/definitions/TextAnalysisAuthoringExportedCustomTextSentimentDocument x-ms-discriminator-value: CustomTextSentiment x-ms-client-name: ExportedCustomTextSentimentProjectAssets TextAnalysisAuthoringExportedDocumentClass: description: Represents a classification label for a document. type: object properties: category: type: string x-ms-client-name: ExportedDocumentClass TextAnalysisAuthoringExportedDocumentEntityLabel: description: Represents an entity label for a document. type: object properties: category: description: The entity category. type: string offset: format: int32 description: Start position for the entity text. type: integer length: format: int32 description: Length for the entity text. type: integer x-ms-client-name: ExportedDocumentEntityLabel TextAnalysisAuthoringExportedDocumentEntityRegion: description: Represents a region in a document for entity labeling. type: object properties: regionOffset: format: int32 description: Start position for the region. type: integer regionLength: format: int32 description: Length for the region text. type: integer labels: description: The list of entity labels belonging to this region. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedDocumentEntityLabel' x-ms-client-name: ExportedDocumentEntityRegion TextAnalysisAuthoringExportedDocumentSentimentLabel: description: Represents an entity label for a document. type: object properties: category: description: The sentiment category. $ref: '#/definitions/TextAnalysisAuthoringSentiment' offset: format: int32 description: Start position for the sentiment text. type: integer length: format: int32 description: Length for the sentiment text. type: integer x-ms-client-name: ExportedDocumentSentimentLabel TextAnalysisAuthoringExportedEntity: description: Represents an entity in an exported project. type: object properties: category: description: The entity category. type: string x-ms-client-name: ExportedEntity TextAnalysisAuthoringExportedEntityList: description: Represents a list component of an entity. type: object properties: sublists: description: The sub-lists of the list component. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedEntitySublist' x-ms-client-name: ExportedEntityList TextAnalysisAuthoringExportedEntityListSynonym: description: Represents a list of synonyms inside a list component type: object properties: language: description: >- Represents the language of the synonyms. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string values: description: The list of synonyms. type: array items: type: string x-ms-client-name: ExportedEntityListSynonym TextAnalysisAuthoringExportedEntitySublist: description: Represents a sub-list inside a list component. type: object properties: listKey: description: The key of the sub-list. type: string synonyms: description: The phrases of that correspond to the sub-list. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedEntityListSynonym' x-ms-client-name: ExportedEntitySublist TextAnalysisAuthoringExportedModelJobState: description: Represents the state of a job to create or updated an exported model. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' x-ms-client-name: ExportedModelJobState TextAnalysisAuthoringExportedModelManifest: description: Represents the properties for the exported model manifest. required: - modelFiles type: object properties: modelFiles: description: The model files belonging to this model. type: array items: $ref: '#/definitions/TextAnalysisAuthoringModelFile' x-ms-client-name: ExportedModelManifest TextAnalysisAuthoringExportedModelOptions: description: Represents the options for creating or replacing an exported model. required: - trainedModelLabel type: object properties: trainedModelLabel: description: The trained model label. type: string x-ms-client-name: ExportedModelOptions TextAnalysisAuthoringExportedPrebuiltEntity: description: Represents an exported prebuilt entity component required: - category type: object properties: category: description: The prebuilt entity category. type: string x-ms-client-name: ExportedPrebuiltEntity TextAnalysisAuthoringExportedProject: description: Represents an exported project. required: - projectFileVersion - stringIndexType - metadata type: object properties: projectFileVersion: description: The version of the exported file. type: string stringIndexType: description: >- Specifies the method used to interpret string offsets. For additional information see https://aka.ms/text-analytics-offsets. $ref: '#/definitions/TextAnalysisAuthoringStringIndexType' metadata: description: Represents the project metadata. $ref: '#/definitions/TextAnalysisAuthoringCreateProjectOptions' assets: description: Represents the project assets. $ref: '#/definitions/TextAnalysisAuthoringExportedProjectAssets' x-ms-client-name: ExportedProject TextAnalysisAuthoringExportedProjectAssets: description: Represents the assets of an exported project. required: - projectKind type: object properties: projectKind: description: The type of the project the assets belong to. $ref: '#/definitions/TextAnalysisAuthoringProjectKind' discriminator: projectKind x-ms-client-name: ExportedProjectAssets TextAnalysisAuthoringExportedTrainedModel: description: Represents an exported trained model. required: - exportedModelName - modelId - lastTrainedDateTime - lastExportedModelDateTime - modelExpirationDate - modelTrainingConfigVersion type: object properties: exportedModelName: description: The exported model name. type: string modelId: description: The model ID. type: string lastTrainedDateTime: format: date-time description: The last trained date time of the model. type: string lastExportedModelDateTime: format: date-time description: The last exported date time of the model. type: string modelExpirationDate: format: date description: The model expiration date. type: string modelTrainingConfigVersion: description: The model training config version. type: string x-ms-client-name: ExportedTrainedModel TextAnalysisAuthoringExportedTrainedModels: description: Represents a list of exported trained models. required: - value - nextLink type: object properties: value: description: The list of exported models. type: array items: $ref: '#/definitions/TextAnalysisAuthoringExportedTrainedModel' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: ExportedTrainedModels TextAnalysisAuthoringExportProjectJobState: description: Represents the state of an export job. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' properties: resultUrl: description: The URL to use in order to download the exported project. type: string x-ms-client-name: ExportProjectJobState TextAnalysisAuthoringImportProjectJobState: description: Represents the state of an import job. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' x-ms-client-name: ImportProjectJobState TextAnalysisAuthoringJobState: description: Represents a job's state. required: - jobId - createdDateTime - lastUpdatedDateTime - status type: object properties: jobId: description: The job ID. type: string createdDateTime: format: date-time description: The creation date time of the job. type: string lastUpdatedDateTime: format: date-time description: The last date time the job was updated. type: string expirationDateTime: format: date-time description: The expiration date time of the job. type: string status: description: The job status. $ref: '#/definitions/TextAnalysisAuthoringJobStatus' warnings: description: The warnings that were encountered while executing the job. type: array items: $ref: '#/definitions/TextAnalysisAuthoringWarning' errors: description: The errors encountered while executing the job. type: array items: $ref: common.json#/definitions/Error x-ms-client-name: JobState TextAnalysisAuthoringJobStatus: enum: - notStarted - running - succeeded - failed - cancelled - cancelling - partiallyCompleted type: string x-ms-enum: name: JobStatus modelAsString: true x-ms-client-name: JobStatus TextAnalysisAuthoringLoadSnapshotJobState: description: Represents the state of loading a snapshot job. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' x-ms-client-name: LoadSnapshotJobState TextAnalysisAuthoringModelFile: description: Represents the properties for the model file. required: - name - contentUri type: object properties: name: description: The name of the file. type: string contentUri: format: uri description: The URI to retrieve the content of the file. type: string x-ms-client-name: ModelFile TextAnalysisAuthoringMultiLabelClassEvaluationSummary: description: >- Represents the evaluation summary of a class in a multi-label classification project. required: - f1 - precision - recall - truePositiveCount - trueNegativeCount - falsePositiveCount - falseNegativeCount type: object properties: f1: format: double description: Represents the model precision type: number precision: format: double description: Represents the model recall type: number recall: format: double description: Represents the model F1 score type: number truePositiveCount: format: int32 description: Represents the count of true positive type: integer trueNegativeCount: format: int32 description: Represents the count of true negative type: integer falsePositiveCount: format: int32 description: Represents the count of false positive type: integer falseNegativeCount: format: int32 description: Represents the count of false negative type: integer x-ms-client-name: MultiLabelClassEvaluationSummary TextAnalysisAuthoringMultiLabelClassificationEvaluationSummary: description: >- Represents the evaluation summary for a multi-label classification project. required: - classes - microF1 - microPrecision - microRecall - macroF1 - macroPrecision - macroRecall type: object properties: classes: description: Represents the classes evaluation type: object additionalProperties: $ref: '#/definitions/TextAnalysisAuthoringMultiLabelClassEvaluationSummary' microF1: format: float description: >- Represents the micro F1. Expected value is a float between 0 and 1 inclusive. type: number microPrecision: format: float description: >- Represents the micro precision. Expected value is a float between 0 and 1 inclusive. type: number microRecall: format: float description: >- Represents the micro recall. Expected value is a float between 0 and 1 inclusive. type: number macroF1: format: float description: >- Represents the macro F1. Expected value is a float between 0 and 1 inclusive. type: number macroPrecision: format: float description: >- Represents the macro precision. Expected value is a float between 0 and 1 inclusive. type: number macroRecall: format: float description: >- Represents the macro recall. Expected value is a float between 0 and 1 inclusive. type: number x-ms-client-name: MultiLabelClassificationEvaluationSummary TextAnalysisAuthoringPrebuiltEntities: description: Represents a list of the retrieved supported prebuilt entities. required: - value - nextLink type: object properties: value: description: The supported prebuilt entities. type: array items: $ref: '#/definitions/TextAnalysisAuthoringPrebuiltEntity' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: PrebuiltEntities TextAnalysisAuthoringPrebuiltEntity: description: Represents a supported prebuilt entity. required: - category - description - examples type: object properties: category: description: The prebuilt entity category. type: string description: description: The description. type: string examples: description: English examples for the entity. type: string x-ms-client-name: PrebuiltEntity TextAnalysisAuthoringProjectDeletionJobState: description: Represents the state of a project deletion job. type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' x-ms-client-name: ProjectDeletionJobState TextAnalysisAuthoringProjectDeployment: description: Represents a project deployment. required: - deploymentName - modelId - lastTrainedDateTime - lastDeployedDateTime - deploymentExpirationDate - modelTrainingConfigVersion - assignedResources type: object properties: deploymentName: description: Represents deployment name. type: string modelId: description: Represents deployment modelId. type: string lastTrainedDateTime: format: date-time description: Represents deployment last trained time. type: string lastDeployedDateTime: format: date-time description: Represents deployment last deployed time. type: string deploymentExpirationDate: format: date description: Represents deployment expiration date in the runtime. type: string modelTrainingConfigVersion: description: Represents model training config version. type: string assignedResources: description: Represents the metadata of the assigned Azure resources. type: array items: $ref: '#/definitions/TextAnalysisAuthoringDeploymentResource' x-ms-client-name: ProjectDeployment TextAnalysisAuthoringProjectDeployments: description: Represents a list of retrieved deployments. required: - value - nextLink type: object properties: value: description: The list of retrieved deployments. type: array items: $ref: '#/definitions/TextAnalysisAuthoringProjectDeployment' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: ProjectDeployments TextAnalysisAuthoringProjectKind: enum: - CustomSingleLabelClassification - CustomMultiLabelClassification - CustomEntityRecognition - CustomAbstractiveSummarization - CustomHealthcare - CustomTextSentiment type: string x-ms-enum: name: ProjectKind modelAsString: true values: - value: CustomSingleLabelClassification description: >- For building a classification model to classify text using your own data. Each file will have only one label. For example, file 1 is classified as A and file 2 is classified as B. - value: CustomMultiLabelClassification description: >- For building a classification model to classify text using your own data. Each file can have one or many labels. For example, file 1 is classified as A, B, and C and file 2 is classified as B and C. - value: CustomEntityRecognition description: >- For building an extraction model to identify your domain categories using your own data. - value: CustomAbstractiveSummarization description: >- For building an abstractive summarization models which are able to summarize long documents. - value: CustomHealthcare description: >- For building an text analytics for health model to identify your health domain data. - value: CustomTextSentiment description: >- For building a sentiment models which are able to extract sentiment for long documents. x-ms-client-name: ProjectKind TextAnalysisAuthoringProjectMetadata: description: Represents the metadata of a project. required: - createdDateTime - lastModifiedDateTime - projectKind - storageInputContainerName - projectName - language type: object properties: createdDateTime: format: date-time description: Represents the project creation datetime. type: string lastModifiedDateTime: format: date-time description: Represents the project last modification datetime. type: string lastTrainedDateTime: format: date-time description: Represents the project last training datetime. type: string lastDeployedDateTime: format: date-time description: Represents the project last deployment datetime. type: string projectKind: description: The project kind. $ref: '#/definitions/TextAnalysisAuthoringProjectKind' storageInputContainerName: description: The storage container name. type: string settings: description: The project settings. $ref: '#/definitions/TextAnalysisAuthoringProjectSettings' projectName: description: The new project name. type: string multilingual: description: Whether the project would be used for multiple languages or not. type: boolean description: description: The project description. type: string language: description: >- The project language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string x-ms-client-name: ProjectMetadata TextAnalysisAuthoringProjectSettings: description: Represents the settings used to define the project behavior. type: object properties: confidenceThreshold: format: float description: >- The threshold of the class with the highest confidence, at which the prediction will automatically be changed to "None". The value of the threshold should be between 0 and 1 inclusive. type: number amlProjectPath: description: The path to the AML connected project. type: string isLabelingLocked: description: Indicates whether the labeling experience can be modified or not. type: boolean runGptPredictions: description: Indicates whether to run GPT predictions or not. type: boolean gptPredictiveLookahead: format: int32 description: >- The predictive lookahead for GPT predictions that is specified by the user. type: integer x-ms-client-name: ProjectSettings TextAnalysisAuthoringProjectsMetadata: description: Represents a list of retrieved projects' metadata. required: - value - nextLink type: object properties: value: description: The list of projects. type: array items: $ref: '#/definitions/TextAnalysisAuthoringProjectMetadata' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: ProjectsMetadata TextAnalysisAuthoringProjectTrainedModel: description: Represents a trained model. required: - label - modelId - lastTrainedDateTime - lastTrainingDurationInSeconds - modelExpirationDate - modelTrainingConfigVersion - hasSnapshot type: object properties: label: description: The trained model label. type: string modelId: description: The model ID. type: string lastTrainedDateTime: format: date-time description: The last trained date time of the model. type: string lastTrainingDurationInSeconds: format: int32 description: The duration of the model's last training request in seconds. type: integer modelExpirationDate: format: date description: The model expiration date. type: string modelTrainingConfigVersion: description: The model training config version. type: string hasSnapshot: description: The flag to indicate if the trained model has a snapshot ready. type: boolean x-ms-client-name: ProjectTrainedModel TextAnalysisAuthoringProjectTrainedModels: description: Represents a list of retrieved trained models. required: - value - nextLink type: object properties: value: description: The list of trained models. type: array items: $ref: '#/definitions/TextAnalysisAuthoringProjectTrainedModel' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: ProjectTrainedModels TextAnalysisAuthoringResourceMetadata: description: Represents metadata for the Azure resource.. required: - azureResourceId - customDomain - region type: object properties: azureResourceId: description: Represents the Azure resource ID. type: string customDomain: description: Represents the Azure resource custom domain. type: string region: description: Represents the Azure resource region. type: string x-ms-client-name: ResourceMetadata TextAnalysisAuthoringSentiment: enum: - positive - negative - neutral type: string x-ms-enum: name: Sentiment modelAsString: true x-ms-client-name: Sentiment TextAnalysisAuthoringSentimentEvaluationSummary: description: >- Represents the evaluation summary for a sentiment in a custom sentiment project. required: - f1 - precision - recall - truePositiveCount - trueNegativeCount - falsePositiveCount - falseNegativeCount type: object properties: f1: format: double description: Represents the model precision type: number precision: format: double description: Represents the model recall type: number recall: format: double description: Represents the model F1 score type: number truePositiveCount: format: int32 description: Represents the count of true positive type: integer trueNegativeCount: format: int32 description: Represents the count of true negative type: integer falsePositiveCount: format: int32 description: Represents the count of false positive type: integer falseNegativeCount: format: int32 description: Represents the count of false negative type: integer x-ms-client-name: SentimentEvaluationSummary TextAnalysisAuthoringSingleLabelClassEvaluationSummary: description: >- Represents the evaluation summary for a class in a single-label classification project. required: - f1 - precision - recall - truePositiveCount - trueNegativeCount - falsePositiveCount - falseNegativeCount type: object properties: f1: format: double description: Represents the model precision type: number precision: format: double description: Represents the model recall type: number recall: format: double description: Represents the model F1 score type: number truePositiveCount: format: int32 description: Represents the count of true positive type: integer trueNegativeCount: format: int32 description: Represents the count of true negative type: integer falsePositiveCount: format: int32 description: Represents the count of false positive type: integer falseNegativeCount: format: int32 description: Represents the count of false negative type: integer x-ms-client-name: SingleLabelClassEvaluationSummary TextAnalysisAuthoringSingleLabelClassificationEvaluationSummary: description: >- Represents the evaluation summary for a custom single-label classification project. required: - confusionMatrix - classes - microF1 - microPrecision - microRecall - macroF1 - macroPrecision - macroRecall type: object properties: confusionMatrix: description: >- Represents the confusion matrix between two classes (the two classes can be the same). The matrix is between the class that was labelled and the class that was predicted. $ref: '#/definitions/TextAnalysisAuthoringConfusionMatrix' classes: description: Represents the classes evaluation type: object additionalProperties: $ref: '#/definitions/TextAnalysisAuthoringSingleLabelClassEvaluationSummary' microF1: format: float description: >- Represents the micro F1. Expected value is a float between 0 and 1 inclusive. type: number microPrecision: format: float description: >- Represents the micro precision. Expected value is a float between 0 and 1 inclusive. type: number microRecall: format: float description: >- Represents the micro recall. Expected value is a float between 0 and 1 inclusive. type: number macroF1: format: float description: >- Represents the macro F1. Expected value is a float between 0 and 1 inclusive. type: number macroPrecision: format: float description: >- Represents the macro precision. Expected value is a float between 0 and 1 inclusive. type: number macroRecall: format: float description: >- Represents the macro recall. Expected value is a float between 0 and 1 inclusive. type: number x-ms-client-name: SingleLabelClassificationEvaluationSummary TextAnalysisAuthoringSpanSentimentEvaluationSummary: description: Represents the evaluation summary for a custom sentiment project. required: - confusionMatrix - sentiments - microF1 - microPrecision - microRecall - macroF1 - macroPrecision - macroRecall type: object properties: confusionMatrix: description: >- Represents the confusion matrix between two sentiments (the two sentiments can be the same). The matrix is between the sentiment that was labelled and the sentiment that was predicted. $ref: '#/definitions/TextAnalysisAuthoringConfusionMatrix' sentiments: description: Represents the sentiment evaluation type: object additionalProperties: $ref: '#/definitions/TextAnalysisAuthoringSentimentEvaluationSummary' microF1: format: float description: >- Represents the micro F1. Expected value is a float between 0 and 1 inclusive. type: number microPrecision: format: float description: >- Represents the micro precision. Expected value is a float between 0 and 1 inclusive. type: number microRecall: format: float description: >- Represents the micro recall. Expected value is a float between 0 and 1 inclusive. type: number macroF1: format: float description: >- Represents the macro F1. Expected value is a float between 0 and 1 inclusive. type: number macroPrecision: format: float description: >- Represents the macro precision. Expected value is a float between 0 and 1 inclusive. type: number macroRecall: format: float description: >- Represents the macro recall. Expected value is a float between 0 and 1 inclusive. type: number x-ms-client-name: SpanSentimentEvaluationSummary TextAnalysisAuthoringStringIndexType: enum: - Utf16CodeUnit type: string x-ms-enum: name: StringIndexType modelAsString: true values: - value: Utf16CodeUnit description: >- The offset and length values will correspond to UTF-16 code units. Use this option if your application is written in a language that support Unicode, for example Java, JavaScript. x-ms-client-name: StringIndexType TextAnalysisAuthoringSubTrainingJobState: description: Represents the detailed state of a training sub-operation. required: - percentComplete - status type: object properties: percentComplete: format: int32 description: Represents progress percentage. type: integer startDateTime: format: date-time description: Represents the start date time. type: string endDateTime: format: date-time description: Represents the end date time. type: string status: description: Represents the status of the sub-operation. $ref: '#/definitions/TextAnalysisAuthoringJobStatus' x-ms-client-name: SubTrainingJobState TextAnalysisAuthoringSupportedLanguage: description: Represents a supported language. required: - languageName - languageCode type: object properties: languageName: description: The language name. type: string languageCode: description: >- The language code. This is BCP-47 representation of a language. For example, "en" for English, "en-gb" for English (UK), "es" for Spanish etc. type: string x-ms-client-name: SupportedLanguage TextAnalysisAuthoringSupportedLanguages: description: Represents a list of retrieved languages. required: - value - nextLink type: object properties: value: description: The list of the languages. type: array items: $ref: '#/definitions/TextAnalysisAuthoringSupportedLanguage' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: SupportedLanguages TextAnalysisAuthoringSwapDeploymentsOptions: description: Represents the options for swapping two deployments together. required: - firstDeploymentName - secondDeploymentName type: object properties: firstDeploymentName: description: Represents the first deployment name. type: string secondDeploymentName: description: Represents the second deployment name. type: string x-ms-client-name: SwapDeploymentsOptions TextAnalysisAuthoringTextSentimentEvaluationSummary: description: Represents the evaluation summary for a custom text sentiment project. required: - spanSentimentsEvaluation - microF1 - microPrecision - microRecall - macroF1 - macroPrecision - macroRecall type: object properties: spanSentimentsEvaluation: description: Represents evaluation of span level sentiments $ref: '#/definitions/TextAnalysisAuthoringSpanSentimentEvaluationSummary' microF1: format: float description: >- Represents the micro F1. Expected value is a float between 0 and 1 inclusive. type: number microPrecision: format: float description: >- Represents the micro precision. Expected value is a float between 0 and 1 inclusive. type: number microRecall: format: float description: >- Represents the micro recall. Expected value is a float between 0 and 1 inclusive. type: number macroF1: format: float description: >- Represents the macro F1. Expected value is a float between 0 and 1 inclusive. type: number macroPrecision: format: float description: >- Represents the macro precision. Expected value is a float between 0 and 1 inclusive. type: number macroRecall: format: float description: >- Represents the macro recall. Expected value is a float between 0 and 1 inclusive. type: number x-ms-client-name: TextSentimentEvaluationSummary TextAnalysisAuthoringTrainingConfigVersion: description: Represents a training config version. required: - trainingConfigVersion - modelExpirationDate type: object properties: trainingConfigVersion: description: Represents the version of the config. type: string modelExpirationDate: format: date description: Represents the training config version expiration date. type: string x-ms-client-name: TrainingConfigVersion TextAnalysisAuthoringTrainingConfigVersions: description: Represents a list of training config versions. required: - value - nextLink type: object properties: value: description: The list of the training config versions. type: array items: $ref: '#/definitions/TextAnalysisAuthoringTrainingConfigVersion' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: TrainingConfigVersions TextAnalysisAuthoringTrainingJobOptions: description: Represents the options for starting a new training job. required: - modelLabel - trainingConfigVersion type: object properties: modelLabel: description: Represents the output model label. type: string trainingConfigVersion: description: Represents training config version. type: string evaluationOptions: description: >- Represents the evaluation options. By default, the evaluation kind is percentage, with training split percentage as 80, and testing split percentage as 20. $ref: '#/definitions/TextAnalysisAuthoringEvaluationOptions' x-ms-client-name: TrainingJobOptions TextAnalysisAuthoringTrainingJobResult: description: Represents the output of a training job. required: - modelLabel - trainingConfigVersion - trainingStatus type: object properties: modelLabel: description: Represents trained model label. type: string trainingConfigVersion: description: Represents training config version. type: string trainingStatus: description: Represents model train status. $ref: '#/definitions/TextAnalysisAuthoringSubTrainingJobState' evaluationStatus: description: Represents model evaluation status. $ref: '#/definitions/TextAnalysisAuthoringSubTrainingJobState' estimatedEndDateTime: format: date-time description: Represents the estimate end date time for training and evaluation. type: string x-ms-client-name: TrainingJobResult TextAnalysisAuthoringTrainingJobs: description: Represents a list of retrieved training jobs. required: - value - nextLink type: object properties: value: description: The list of jobs. type: array items: $ref: '#/definitions/TextAnalysisAuthoringTrainingJobState' nextLink: description: The next page link. type: string x-nullable: true x-ms-client-name: TrainingJobs TextAnalysisAuthoringTrainingJobState: description: Represents the state of a training job. required: - result type: object allOf: - $ref: '#/definitions/TextAnalysisAuthoringJobState' properties: result: description: Represents training tasks detailed result. $ref: '#/definitions/TextAnalysisAuthoringTrainingJobResult' x-ms-client-name: TrainingJobState TextAnalysisAuthoringUnassignDeploymentResourcesOptions: description: Represents the options to unassign Azure resources from a project. required: - assignedResourceIds type: object properties: assignedResourceIds: description: Represents the assigned resource IDs to be unassigned. type: array items: type: string x-ms-client-name: UnassignDeploymentResourcesOptions TextAnalysisAuthoringWarning: description: Represents a warning that was encountered while executing the request. required: - code - message type: object properties: code: description: The warning code. type: string message: description: The warning message. type: string x-ms-client-name: Warning parameters: TextAnalysisAuthoringStringIndexTypeQueryParameter: in: query name: stringIndexType description: >- Specifies the method used to interpret string offsets. For additional information see https://aka.ms/text-analytics-offsets. required: true type: string enum: - Utf16CodeUnit x-ms-enum: name: StringIndexType modelAsString: true values: - value: Utf16CodeUnit description: >- The offset and length values will correspond to UTF-16 code units. Use this option if your application is written in a language that support Unicode, for example Java, JavaScript. x-ms-parameter-location: method TextAnalysisAuthoringJobIdPathParameter: in: path name: jobId description: The job ID. required: true type: string x-ms-parameter-location: method TextAnalysisAuthoringExportedModelNamePathParameter: in: path name: exportedModelName description: The exported model name. required: true type: string x-ms-parameter-location: method TextAnalysisAuthoringTrainedModelLabelPathParameter: in: path name: trainedModelLabel description: The trained model label. required: true type: string x-ms-parameter-location: method TextAnalysisAuthoringProjectKindQueryOptionalParameter: in: query name: projectKind description: The project kind, default value is CustomSingleLabelClassification. type: string enum: - CustomSingleLabelClassification - CustomMultiLabelClassification - CustomEntityRecognition - CustomAbstractiveSummarization - CustomHealthcare - CustomTextSentiment x-ms-enum: name: ProjectKind modelAsString: true values: - value: CustomSingleLabelClassification description: >- For building a classification model to classify text using your own data. Each file will have only one label. For example, file 1 is classified as A and file 2 is classified as B. - value: CustomMultiLabelClassification description: >- For building a classification model to classify text using your own data. Each file can have one or many labels. For example, file 1 is classified as A, B, and C and file 2 is classified as B and C. - value: CustomEntityRecognition description: >- For building an extraction model to identify your domain categories using your own data. - value: CustomAbstractiveSummarization description: >- For building an abstractive summarization models which are able to summarize long documents. - value: CustomHealthcare description: >- For building an text analytics for health model to identify your health domain data. - value: CustomTextSentiment description: >- For building a sentiment models which are able to extract sentiment for long documents. x-ms-parameter-location: method TextAnalysisAuthoringProjectKindQueryParameter: in: query name: projectKind description: The project kind. required: true type: string enum: - CustomSingleLabelClassification - CustomMultiLabelClassification - CustomEntityRecognition - CustomAbstractiveSummarization - CustomHealthcare - CustomTextSentiment x-ms-enum: name: ProjectKind modelAsString: true values: - value: CustomSingleLabelClassification description: >- For building a classification model to classify text using your own data. Each file will have only one label. For example, file 1 is classified as A and file 2 is classified as B. - value: CustomMultiLabelClassification description: >- For building a classification model to classify text using your own data. Each file can have one or many labels. For example, file 1 is classified as A, B, and C and file 2 is classified as B and C. - value: CustomEntityRecognition description: >- For building an extraction model to identify your domain categories using your own data. - value: CustomAbstractiveSummarization description: >- For building an abstractive summarization models which are able to summarize long documents. - value: CustomHealthcare description: >- For building an text analytics for health model to identify your health domain data. - value: CustomTextSentiment description: >- For building a sentiment models which are able to extract sentiment for long documents. x-ms-parameter-location: method tags: - name: Authoring