azure.ai.language.conversations.authoring.aio package¶
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.
See https://docs.microsoft.com/rest/api/language/conversational-analysis-authoring for more information about requests and responses you can pass to this client.
- Parameters
endpoint (str) – Supported Cognitive Services endpoint (e.g., https://
<resource-name>
.cognitiveservices.azure.com). Required.credential (AzureKeyCredential or AsyncTokenCredential) – Credential needed for the client to connect to Azure. This can be the an instance of AzureKeyCredential if using a Language API key or a token credential from
azure.identity
.
- Keyword Arguments
api_version (str) – Api Version. Available values are “2022-10-01-preview”, “2022-05-15-preview”, “2022-05-01”. Default value is “2022-10-01-preview”. Note that overriding this default value may result in unsupported behavior.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
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
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/assign-deployment-resources for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
body (JSON or IO) – The new project resources info. Is either a model type or a IO type. Required.
- Keyword Arguments
content_type (str) – Body Parameter content-type. Known values are: ‘application/json’. Default value is None.
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Triggers a cancellation for a running training job.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/cancel-training-job for more information.
- Parameters
- Keyword Arguments
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "result": { "modelLabel": "str", # Represents trained model label. Required. "trainingConfigVersion": "str", # Represents training config version. Required. "trainingStatus": { "percentComplete": 0, # Represents progress percentage. Required. "status": "str", # Represents the status of the sub-operation. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "endDateTime": "2020-02-20 00:00:00", # Optional. Represents the end date time. "startDateTime": "2020-02-20 00:00:00" # Optional. Represents the start date time. }, "estimatedEndDateTime": "2020-02-20 00:00:00", # Optional. Represents the estimated end date time for training and evaluation. "evaluationStatus": { "percentComplete": 0, # Represents progress percentage. Required. "status": "str", # Represents the status of the sub-operation. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "endDateTime": "2020-02-20 00:00:00", # Optional. Represents the end date time. "startDateTime": "2020-02-20 00:00:00" # Optional. Represents the start date time. }, "trainingMode": "str" # Optional. Represents the mode of the training operation. Known values are: "advanced" and "standard". }, "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Deletes a project deployment.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/delete-deployment for more information.
- Parameters
- Keyword Arguments
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Deletes a project deployment from the specified assigned resources.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/delete-deployment-from-resources for more information.
- Parameters
- Keyword Arguments
content_type (str) – Body Parameter content-type. Known values are: ‘application/json’. Default value is None.
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns None
- Return type
- Raises
Deletes a project.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/delete-project for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
- Keyword Arguments
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Creates a new deployment or replaces an existing one.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/deploy-project for more information.
- Parameters
- Keyword Arguments
content_type (str) – Body Parameter content-type. Known values are: ‘application/json’. Default value is None.
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "deploymentExpirationDate": "2020-02-20", # Represents deployment expiration date in the runtime. Required. "deploymentName": "str", # Represents deployment name. Required. "lastDeployedDateTime": "2020-02-20 00:00:00", # Represents deployment last deployed time. Required. "lastTrainedDateTime": "2020-02-20 00:00:00", # Represents deployment last trained time. Required. "modelId": "str", # Represents deployment modelId. Required. "modelTrainingConfigVersion": "str", # Represents model training config version. Required. "assignedResources": [ { "region": "str", # Represents the resource region. Required. "resourceId": "str" # Represents the Azure resource Id. Required. } ] }
Triggers a job to export a project’s data.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/export for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
- Keyword Arguments
string_index_type (str) – Specifies the method used to interpret string offsets. For additional information see https://aka.ms/text-analytics-offsets. “Utf16CodeUnit” Required.
exported_project_format (str) – The format of the exported project file to use. Known values are: “Conversation” and “Luis”. Default value is None.
asset_kind (str) – Kind of asset to export. Default value is None.
trained_model_label (str) – Trained model label to export. If the trainedModelLabel is null, the default behavior is to export the current working copy. Default value is None.
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "resultUrl": "str", # Optional. The URL to use in order to download the exported project. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Triggers a job to import a project. If a project with the same name already exists, the data of that project is replaced.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/import for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
project (JSON or IO) – The project data to import. Is either a model type or a IO type. Required.
- Keyword Arguments
exported_project_format (str) – The format of the exported project file to use. Known values are: “Conversation” and “Luis”. Default value is None.
content_type (str) – Body Parameter content-type. Known values are: ‘application/json’. Default value is None.
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Restores the snapshot of this trained model to be the current working directory of the project.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/load-snapshot for more information.
- Parameters
- Keyword Arguments
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Swaps two existing deployments with each other.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/swap-deployments for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
deployments (JSON or IO) – The job object to swap two deployments. Is either a model type or a IO type. Required.
- Keyword Arguments
content_type (str) – Body Parameter content-type. Known values are: ‘application/json’. Default value is None.
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Triggers a training job for a project.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/train for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
configuration (JSON or IO) – The training input parameters. Is either a model type or a IO type. Required.
- Keyword Arguments
content_type (str) – Body Parameter content-type. Known values are: ‘application/json’. Default value is None.
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "result": { "modelLabel": "str", # Represents trained model label. Required. "trainingConfigVersion": "str", # Represents training config version. Required. "trainingStatus": { "percentComplete": 0, # Represents progress percentage. Required. "status": "str", # Represents the status of the sub-operation. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "endDateTime": "2020-02-20 00:00:00", # Optional. Represents the end date time. "startDateTime": "2020-02-20 00:00:00" # Optional. Represents the start date time. }, "estimatedEndDateTime": "2020-02-20 00:00:00", # Optional. Represents the estimated end date time for training and evaluation. "evaluationStatus": { "percentComplete": 0, # Represents progress percentage. Required. "status": "str", # Represents the status of the sub-operation. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "endDateTime": "2020-02-20 00:00:00", # Optional. Represents the end date time. "startDateTime": "2020-02-20 00:00:00" # Optional. Represents the start date time. }, "trainingMode": "str" # Optional. Represents the mode of the training operation. Known values are: "advanced" and "standard". }, "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Unassign resources from a project. This disallows deploying new deployments to these resources, and deletes existing deployments assigned to them.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/unassign-deployment-resources for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
body (JSON or IO) – The info for the deployment resources to be deleted. Is either a model type or a IO type. Required.
- Keyword Arguments
content_type (str) – Body Parameter content-type. Known values are: ‘application/json’. Default value is None.
continuation_token (str) – A continuation token to restart a poller from a saved state.
polling (bool or AsyncPollingMethod) – By default, your polling method will be AsyncLROBasePolling. Pass in False for this operation to not poll, or pass in your own initialized polling object for a personal polling strategy.
polling_interval (int) – Default waiting time between two polls for LRO operations if no Retry-After header is present.
- Returns
An instance of AsyncLROPoller that returns JSON object
- Return type
AsyncLROPoller[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Creates a new project or updates an existing one.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/create-project for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
project (JSON or IO) – The project parameters. Is either a model type or a IO type. Required.
- Keyword Arguments
content_type (str) – Body Parameter content-type. Known values are: ‘application/merge-patch+json’. Default value is None.
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200, 201 response == { "createdDateTime": "2020-02-20 00:00:00", # Represents the project creation datetime. Required. "language": "str", # 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. Required. "lastModifiedDateTime": "2020-02-20 00:00:00", # Represents the project creation datetime. Required. "projectKind": "str", # Represents the project kind. Required. Known values are: "Conversation", "Orchestration", and "CustomConversationSummarization". "projectName": "str", # The new project name. Required. "description": "str", # Optional. The project description. "lastDeployedDateTime": "2020-02-20 00:00:00", # Optional. Represents the project last deployed datetime. "lastTrainedDateTime": "2020-02-20 00:00:00", # Optional. Represents the project last trained datetime. "multilingual": bool, # Optional. Whether the project would be used for multiple languages or not. "settings": { "confidenceThreshold": 0.0 # The threshold of the intent 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. Required. }, "storageInputContainerName": "str" # Optional. The storage container name in case of conversation summarization. }
Deletes an existing trained model.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/delete-trained-model for more information.
- Parameters
- Returns
None
- Return type
- Raises
Gets the status of an existing assign deployment resources job.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-assign-deployment-resources-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the details of a deployment.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-deployment for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "deploymentExpirationDate": "2020-02-20", # Represents deployment expiration date in the runtime. Required. "deploymentName": "str", # Represents deployment name. Required. "lastDeployedDateTime": "2020-02-20 00:00:00", # Represents deployment last deployed time. Required. "lastTrainedDateTime": "2020-02-20 00:00:00", # Represents deployment last trained time. Required. "modelId": "str", # Represents deployment modelId. Required. "modelTrainingConfigVersion": "str", # Represents model training config version. Required. "assignedResources": [ { "region": "str", # Represents the resource region. Required. "resourceId": "str" # Represents the Azure resource Id. Required. } ] }
Gets the status of an existing delete deployment from specific resources job.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-deployment-delete-from-resources-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the status of an existing deployment job.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-deployment-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the status of an export job. Once job completes, returns the project metadata, and assets.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-export-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "resultUrl": "str", # Optional. The URL to use in order to download the exported project. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the status for an import.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-import-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the status for loading a snapshot.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-load-snapshot-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the evaluation summary of a trained model. The summary includes high level performance measurements of the model e.g., F1, Precision, Recall, etc.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-model-evaluation-summary for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "entitiesEvaluation": { "confusionMatrix": { "str": { "str": { "normalizedValue": 0.0, # Represents normalized value in percentages. Required. "rawValue": 0.0 # Represents raw value. Required. } } }, "entities": { "str": { "f1": 0.0, # Represents the model precision. Required. "falseNegativeCount": 0, # Represents the count of false negative. Required. "falsePositiveCount": 0, # Represents the count of false positive. Required. "precision": 0.0, # Represents the model recall. Required. "recall": 0.0, # Represents the model F1 score. Required. "trueNegativeCount": 0, # Represents the count of true negative. Required. "truePositiveCount": 0 # Represents the count of true positive. Required. } }, "macroF1": 0.0, # Represents the macro F1. Required. "macroPrecision": 0.0, # Represents the macro precision. Required. "macroRecall": 0.0, # Represents the macro recall. Required. "microF1": 0.0, # Represents the micro F1. Required. "microPrecision": 0.0, # Represents the micro precision. Required. "microRecall": 0.0 # Represents the micro recall. Required. }, "intentsEvaluation": { "confusionMatrix": { "str": { "str": { "normalizedValue": 0.0, # Represents normalized value in percentages. Required. "rawValue": 0.0 # Represents raw value. Required. } } }, "intents": { "str": { "f1": 0.0, # Represents the model precision. Required. "falseNegativeCount": 0, # Represents the count of false negative. Required. "falsePositiveCount": 0, # Represents the count of false positive. Required. "precision": 0.0, # Represents the model recall. Required. "recall": 0.0, # Represents the model F1 score. Required. "trueNegativeCount": 0, # Represents the count of true negative. Required. "truePositiveCount": 0 # Represents the count of true positive. Required. } }, "macroF1": 0.0, # Represents the macro F1. Required. "macroPrecision": 0.0, # Represents the macro precision. Required. "macroRecall": 0.0, # Represents the macro recall. Required. "microF1": 0.0, # Represents the micro F1. Required. "microPrecision": 0.0, # Represents the micro precision. Required. "microRecall": 0.0 # Represents the micro recall. Required. }, "evaluationOptions": { "kind": "str", # Optional. Represents the evaluation kind. By default, the evaluation kind is set to percentage. Known values are: "percentage" and "manual". "testingSplitPercentage": 0, # Optional. Represents the testing dataset split percentage. Only needed in case the evaluation kind is percentage. "trainingSplitPercentage": 0 # Optional. Represents the training dataset split percentage. Only needed in case the evaluation kind is percentage. } }
Gets the details of a project.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-project for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # Represents the project creation datetime. Required. "language": "str", # 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. Required. "lastModifiedDateTime": "2020-02-20 00:00:00", # Represents the project creation datetime. Required. "projectKind": "str", # Represents the project kind. Required. Known values are: "Conversation", "Orchestration", and "CustomConversationSummarization". "projectName": "str", # The new project name. Required. "description": "str", # Optional. The project description. "lastDeployedDateTime": "2020-02-20 00:00:00", # Optional. Represents the project last deployed datetime. "lastTrainedDateTime": "2020-02-20 00:00:00", # Optional. Represents the project last trained datetime. "multilingual": bool, # Optional. Whether the project would be used for multiple languages or not. "settings": { "confidenceThreshold": 0.0 # The threshold of the intent 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. Required. }, "storageInputContainerName": "str" # Optional. The storage container name in case of conversation summarization. }
Gets the status for a project deletion job.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-project-deletion-status for more information.
- Parameters
job_id (str) – The job ID. Required.
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the status of an existing swap deployment job.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-swap-deployments-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the details of a trained model.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-trained-model for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "label": "str", # The trained model label. Required. "lastTrainedDateTime": "2020-02-20 00:00:00", # The last trained date time of the model. Required. "lastTrainingDurationInSeconds": 0, # The duration of the model's last training request in seconds. Required. "modelExpirationDate": "2020-02-20", # The model expiration date. Required. "modelId": "str", # The model ID. Required. "modelTrainingConfigVersion": "str", # The model training config version. Required. "hasSnapshot": bool # Optional. The flag to indicate if the trained model has a snapshot ready. }
Gets the status for a training job.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-training-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "result": { "modelLabel": "str", # Represents trained model label. Required. "trainingConfigVersion": "str", # Represents training config version. Required. "trainingStatus": { "percentComplete": 0, # Represents progress percentage. Required. "status": "str", # Represents the status of the sub-operation. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "endDateTime": "2020-02-20 00:00:00", # Optional. Represents the end date time. "startDateTime": "2020-02-20 00:00:00" # Optional. Represents the start date time. }, "estimatedEndDateTime": "2020-02-20 00:00:00", # Optional. Represents the estimated end date time for training and evaluation. "evaluationStatus": { "percentComplete": 0, # Represents progress percentage. Required. "status": "str", # Represents the status of the sub-operation. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "endDateTime": "2020-02-20 00:00:00", # Optional. Represents the end date time. "startDateTime": "2020-02-20 00:00:00" # Optional. Represents the start date time. }, "trainingMode": "str" # Optional. Represents the mode of the training operation. Known values are: "advanced" and "standard". }, "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Gets the status of an existing unassign deployment resources job.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-unassign-deployment-resources-status for more information.
- Parameters
- Returns
JSON object
- Return type
JSON
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
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.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/list-assigned-resource-deployments for more information.
- Keyword Arguments
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "deploymentsMetadata": [ { "deploymentExpirationDate": "2020-02-20", # Represents deployment expiration date in the runtime. Required. "deploymentName": "str", # Represents the deployment name. Required. "lastDeployedDateTime": "2020-02-20 00:00:00" # Represents deployment last deployed time. Required. } ], "projectName": "str" # Represents the project name. Required. }
Lists the deployments resources assigned to the project.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/list-deployment-resources for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
- Keyword Arguments
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "azureResourceId": "str", # The resource ID. Required. "region": "str" # The resource region. Required. }
Lists the deployments belonging to a project.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/list-deployments for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
- Keyword Arguments
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "deploymentExpirationDate": "2020-02-20", # Represents deployment expiration date in the runtime. Required. "deploymentName": "str", # Represents deployment name. Required. "lastDeployedDateTime": "2020-02-20 00:00:00", # Represents deployment last deployed time. Required. "lastTrainedDateTime": "2020-02-20 00:00:00", # Represents deployment last trained time. Required. "modelId": "str", # Represents deployment modelId. Required. "modelTrainingConfigVersion": "str", # Represents model training config version. Required. "assignedResources": [ { "region": "str", # Represents the resource region. Required. "resourceId": "str" # Represents the Azure resource Id. Required. } ] }
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.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-model-evaluation-results for more information.
- Parameters
- Keyword Arguments
string_index_type (str) – Specifies the method used to interpret string offsets. For additional information see https://aka.ms/text-analytics-offsets. “Utf16CodeUnit” Required.
top (int) – The maximum number of resources to return from the collection. Default value is None.
skip (int) – An offset into the collection of the first resource to be returned. Default value is None.
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "entitiesResult": { "expectedEntities": [ { "category": "str", # Represents the entity category. Required. "length": 0, # Represents the entity length. Required. "offset": 0 # Represents the entity offset index relative to the original text. Required. } ], "predictedEntities": [ { "category": "str", # Represents the entity category. Required. "length": 0, # Represents the entity length. Required. "offset": 0 # Represents the entity offset index relative to the original text. Required. } ] }, "intentsResult": { "expectedIntent": "str", # Represents the utterance's expected intent. Required. "predictedIntent": "str" # Represents the utterance's predicted intent. Required. }, "language": "str", # Represents the utterance language. This is BCP-47 representation of a language. For example, use "en" for English, "en-gb" for English (UK), "es" for Spanish etc. Required. "text": "str" # Represents the utterance text. Required. }
Lists the existing projects.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/list-projects for more information.
- Keyword Arguments
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # Represents the project creation datetime. Required. "language": "str", # 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. Required. "lastModifiedDateTime": "2020-02-20 00:00:00", # Represents the project creation datetime. Required. "projectKind": "str", # Represents the project kind. Required. Known values are: "Conversation", "Orchestration", and "CustomConversationSummarization". "projectName": "str", # The new project name. Required. "description": "str", # Optional. The project description. "lastDeployedDateTime": "2020-02-20 00:00:00", # Optional. Represents the project last deployed datetime. "lastTrainedDateTime": "2020-02-20 00:00:00", # Optional. Represents the project last trained datetime. "multilingual": bool, # Optional. Whether the project would be used for multiple languages or not. "settings": { "confidenceThreshold": 0.0 # The threshold of the intent 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. Required. }, "storageInputContainerName": "str" # Optional. The storage container name in case of conversation summarization. }
Lists the supported languages for the given project type.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-supported-languages for more information.
- Keyword Arguments
project_kind (str) – The project kind. Known values are: “Conversation”, “Orchestration”, and “CustomConversationSummarization”. Required.
top (int) – The maximum number of resources to return from the collection. Default value is None.
skip (int) – An offset into the collection of the first resource to be returned. Default value is None.
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "languageCode": "str", # 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. Required. "languageName": "str" # The language name. Required. }
Lists the supported prebuilt entities that can be used while creating composed entities.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/get-supported-prebuilt-entities for more information.
- Keyword Arguments
language (str) – 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. Default value is None.
multilingual (bool) – Whether to get the support prebuilt entities for multilingual or monolingual projects. If true, the language parameter is ignored. Default value is None.
top (int) – The maximum number of resources to return from the collection. Default value is None.
skip (int) – An offset into the collection of the first resource to be returned. Default value is None.
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "category": "str", # The prebuilt entity category. Required. "description": "str", # The description. Required. "examples": "str" # English examples for the entity. Required. }
Lists the trained models belonging to a project.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/list-trained-models for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
- Keyword Arguments
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "label": "str", # The trained model label. Required. "lastTrainedDateTime": "2020-02-20 00:00:00", # The last trained date time of the model. Required. "lastTrainingDurationInSeconds": 0, # The duration of the model's last training request in seconds. Required. "modelExpirationDate": "2020-02-20", # The model expiration date. Required. "modelId": "str", # The model ID. Required. "modelTrainingConfigVersion": "str", # The model training config version. Required. "hasSnapshot": bool # Optional. The flag to indicate if the trained model has a snapshot ready. }
Lists the support training config version for a given project type.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/list-training-config-versions for more information.
- Keyword Arguments
project_kind (str) – The project kind. Known values are: “Conversation”, “Orchestration”, and “CustomConversationSummarization”. Required.
top (int) – The maximum number of resources to return from the collection. Default value is None.
skip (int) – An offset into the collection of the first resource to be returned. Default value is None.
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "modelExpirationDate": "2020-02-20", # Represents the training config version expiration date. Required. "trainingConfigVersion": "str" # Represents the version of the config. Required. }
Lists the non-expired training jobs created for a project.
See https://learn.microsoft.com/rest/api/language/2022-10-01-preview/conversational-analysis-authoring/list-training-jobs for more information.
- Parameters
project_name (str) – The name of the project to use. Required.
- Keyword Arguments
- Returns
An iterator like instance of JSON object
- Return type
AsyncItemPaged[JSON]
- Raises
Example
# response body for status code(s): 200 response == { "createdDateTime": "2020-02-20 00:00:00", # The creation date time of the job. Required. "jobId": "str", # The job ID. Required. "lastUpdatedDateTime": "2020-02-20 00:00:00", # The last date time the job was updated. Required. "result": { "modelLabel": "str", # Represents trained model label. Required. "trainingConfigVersion": "str", # Represents training config version. Required. "trainingStatus": { "percentComplete": 0, # Represents progress percentage. Required. "status": "str", # Represents the status of the sub-operation. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "endDateTime": "2020-02-20 00:00:00", # Optional. Represents the end date time. "startDateTime": "2020-02-20 00:00:00" # Optional. Represents the start date time. }, "estimatedEndDateTime": "2020-02-20 00:00:00", # Optional. Represents the estimated end date time for training and evaluation. "evaluationStatus": { "percentComplete": 0, # Represents progress percentage. Required. "status": "str", # Represents the status of the sub-operation. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "endDateTime": "2020-02-20 00:00:00", # Optional. Represents the end date time. "startDateTime": "2020-02-20 00:00:00" # Optional. Represents the start date time. }, "trainingMode": "str" # Optional. Represents the mode of the training operation. Known values are: "advanced" and "standard". }, "status": "str", # The job status. Required. Known values are: "notStarted", "running", "succeeded", "failed", "cancelled", "cancelling", and "partiallyCompleted". "errors": [ { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidArgument", "Unauthorized", "Forbidden", "NotFound", "ProjectNotFound", "OperationNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchIndexNotFound", "TooManyRequests", "AzureCognitiveSearchThrottling", "AzureCognitiveSearchIndexLimitReached", "InternalServerError", "ServiceUnavailable", "Timeout", "QuotaExceeded", "Conflict", and "Warning". "message": "str", # A human-readable representation of the error. Required. "details": [ ... ], "innererror": { "code": "str", # One of a server-defined set of error codes. Required. Known values are: "InvalidRequest", "InvalidParameterValue", "KnowledgeBaseNotFound", "AzureCognitiveSearchNotFound", "AzureCognitiveSearchThrottling", "ExtractionFailure", "InvalidRequestBodyFormat", "EmptyRequest", "MissingInputDocuments", "InvalidDocument", "ModelVersionIncorrect", "InvalidDocumentBatch", "UnsupportedLanguageCode", and "InvalidCountryHint". "message": "str", # Error message. Required. "details": { "str": "str" # Optional. Error details. }, "innererror": ..., "target": "str" # Optional. Error target. }, "target": "str" # Optional. The target of the error. } ], "expirationDateTime": "2020-02-20 00:00:00", # Optional. The expiration date time of the job. "warnings": [ { "code": "str", # The warning code. Required. "message": "str" # The warning message. Required. } ] }
Runs the network request through the client’s chained policies.
>>> from azure.core.rest import HttpRequest >>> request = HttpRequest("GET", "https://www.example.org/") <HttpRequest [GET], url: 'https://www.example.org/'> >>> response = await client.send_request(request) <AsyncHttpResponse: 200 OK>
For more information on this code flow, see https://aka.ms/azsdk/dpcodegen/python/send_request
- Parameters
request (HttpRequest) – The network request you want to make. Required.
- Keyword Arguments
stream (bool) – Whether the response payload will be streamed. Defaults to False.
- Returns
The response of your network call. Does not do error handling on your response.
- Return type