Analyze Documents Submit Job - Analyze Documents Submit Job

Service:: Azure AI Services

API Version:: 2023-11-15-preview

Submit a collection of text documents for analysis. Specify one or more unique tasks to be executed as a long-running operation.

POST {Endpoint}/language/analyze-documents/jobs?api-version=2023-11-15-preview

URI Parameters

Name	In	Required	Type	Description
Endpoint	path	True	string	Supported Cognitive Services endpoint (e.g., https://<resource-name>.api.cognitiveservices.azure.com).
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Header

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

Request Body

Name	Required	Type	Description
analysisInput	True	MultiLanguageAnalysisInput	Contains the input to be analyzed.
tasks	True	AnalyzeDocumentsLROTask[]: AbstractiveSummarizationLROTask[] ExtractiveSummarizationLROTask[] PiiLROTask[]	List of tasks to be performed as part of the LRO.
defaultLanguage		string	Default language to use for records.
displayName		string	Name for the task.

Responses

Name	Type	Description
202 Accepted		The request has been accepted for processing, but processing has not yet completed. Headers Operation-Location: string
Other Status Codes	ErrorResponse	An unexpected error response. Headers x-ms-error-code: string

Name

Type

Description

202 Accepted

The request has been accepted for processing, but processing has not yet completed.

Headers

Operation-Location: string

Other Status Codes

ErrorResponse

An unexpected error response.

Headers

x-ms-error-code: string

Security

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Examples

SuccessfulAnalyzeDocumentsJobsTaskSubmitRequest

Sample request

HTTP

POST {Endpoint}/language/analyze-documents/jobs?api-version=2023-11-15-preview


{
  "displayName": "Redact PII Example",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "en",
        "source": {
          "location": "https://myblob.blob.core.windows.net/Container/document.txt",
          "kind": "AzureBlob",
          "managedIdentityClientId": "edaa610c-d7e8-4ba2-823a-97d871d661fb"
        },
        "target": {
          "location": "https://myblob.blob.core.windows.net/Container",
          "kind": "AzureBlob"
        }
      }
    ]
  },
  "tasks": [
    {
      "kind": "PiiEntityRecognition",
      "taskName": "Redact PII Task 1",
      "parameters": {
        "redactionCharacter": "-",
        "piiCategories": [
          "Person",
          "Organization"
        ]
      }
    }
  ]
}

Sample response

Status code:: 202

Operation-Location: {endpoint}/language/analyze-documents/jobs/{jobId}?api-version=2023-11-15-preview

Definitions

Name	Description
AbstractiveSummarizationLROTask	An object representing the task definition for an Abstractive Summarization task.
AbstractiveSummarizationTaskParameters	Supported parameters for the pre-built Abstractive Summarization task.
AnalyzeDocumentJobsInput	The input object for the analyze documents LRO.
AnalyzeDocumentsLROTaskKind	The kind of the long running analyze documents tasks supported.
AzureBlobDocumentLocation	Document location for azure blobs.
DocumentLocationKind	Enumeration of supported document locations.
Error	The error response object returned when the service encounters some errors during processing the request.
ErrorCode	Human-readable error code.
ErrorResponse	Error response.
ExtractiveSummarizationLROTask	An object representing the task definition for an Extractive Summarization task.
ExtractiveSummarizationSortingCriteria	Specifies how to sort the extracted summaries.
ExtractiveSummarizationTaskParameters	Supported parameters for an Extractive Summarization task.
InnerErrorCode	Human-readable error code.
InnerErrorModel	An object containing more specific information about the error. As per Microsoft One API guidelines - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
MultiLanguageAnalysisInput	Collection of input documents to be analyzed by the service.
MultiLanguageInput	Contains an input document to be analyzed by the service.
PiiCategoriesExclude	(Optional) describes the PII categories to return
PiiCategory	(Optional) describes the PII categories to return
PiiDomain	Domain for PII task
PiiLROTask	Contains the analyze text PIIEntityRecognition LRO task.
PiiTaskParameters	Supported parameters for a PII Entities Recognition task.
redactionCharacter	Character to be used for redaction. Default in '*'.
StringIndexType	String index type
SummaryLengthBucket	Enum that defines the length of the output summaries.

AbstractiveSummarizationLROTask

Object

An object representing the task definition for an Abstractive Summarization task.

Name	Type	Description
kind	string: AbstractiveSummarization	The kind of task to perform.
parameters	AbstractiveSummarizationTaskParameters	Parameters for the Abstractive Summarization task.
taskName	string	task name

AbstractiveSummarizationTaskParameters

Object

Supported parameters for the pre-built Abstractive Summarization task.

Name	Type	Default value	Description
loggingOptOut	boolean	False	logging opt out
modelVersion	string	latest	model version
query	string		(Optional) If provided, the query will be used to generate the summary.
sentenceCount	integer (int32)		Controls the approximate number of sentences in the output summaries.
stringIndexType	StringIndexType	TextElements_v8	String index type
summaryLength	SummaryLengthBucket		(NOTE: Recommended to use summaryLength over sentenceCount) Controls the approximate length of the output summaries.

AnalyzeDocumentJobsInput

Object

The input object for the analyze documents LRO.

Name	Type	Description
analysisInput	MultiLanguageAnalysisInput	Contains the input to be analyzed.
defaultLanguage	string	Default language to use for records.
displayName	string	Name for the task.
tasks	AnalyzeDocumentsLROTask[]: AbstractiveSummarizationLROTask[] ExtractiveSummarizationLROTask[] PiiLROTask[]	List of tasks to be performed as part of the LRO.

AnalyzeDocumentsLROTaskKind

Enumeration

The kind of the long running analyze documents tasks supported.

Value	Description
PiiEntityRecognition	PII entity recognition task
ExtractiveSummarization	Extractive summarization task
AbstractiveSummarization	Abstractive summarization task

AzureBlobDocumentLocation

Object

Document location for azure blobs.

Name	Type	Description
kind	string: AzureBlob	The kind of the document location.
location	string	The location of the document.
managedIdentityClientId	string	The user managed identity client Id to use to authenticate with the storage account

DocumentLocationKind

Enumeration

Enumeration of supported document locations.

Value	Description
AzureBlob	The document is a URL.

Error

Object

The error response object returned when the service encounters some errors during processing the request.

Name	Type	Description
code	ErrorCode	One of a server-defined set of error codes.
details	Error[]	An array of details about specific errors that led to this reported error.
innererror	InnerErrorModel	An object containing more specific information than the current object about the error.
message	string	A human-readable representation of the error.
target	string	The target of the error.

ErrorCode

Enumeration

Human-readable error code.

Value	Description
InvalidRequest	Invalid request error
InvalidArgument	Invalid argument error
Unauthorized	Unauthorized access error
Forbidden	Forbidden access error
NotFound	Not found error
ProjectNotFound	Project not found error
OperationNotFound	Operation not found error
AzureCognitiveSearchNotFound	Azure Cognitive Search not found error
AzureCognitiveSearchIndexNotFound	Azure Cognitive Search index not found error
TooManyRequests	Too many requests error
AzureCognitiveSearchThrottling	Azure Cognitive Search throttling error
AzureCognitiveSearchIndexLimitReached	Azure Cognitive Search index limit reached error
InternalServerError	Internal server error
ServiceUnavailable	Service unavailable error
Timeout	Timeout error
QuotaExceeded	Quota exceeded error
Conflict	Conflict error
Warning	Warning error

ErrorResponse

Object

Error response.

Name	Type	Description
error	Error	The error object.

ExtractiveSummarizationLROTask

Object

An object representing the task definition for an Extractive Summarization task.

Name	Type	Description
kind	string: ExtractiveSummarization	The kind of task to perform.
parameters	ExtractiveSummarizationTaskParameters	Parameters for the Extractive Summarization task.
taskName	string	task name

ExtractiveSummarizationSortingCriteria

Enumeration

Specifies how to sort the extracted summaries.

Value	Description
Offset	Indicates that results should be sorted in order of appearance in the text.
Rank	Indicates that results should be sorted in order of importance (i.e. rank score) according to the model.

ExtractiveSummarizationTaskParameters

Object

Supported parameters for an Extractive Summarization task.

Name	Type	Default value	Description
loggingOptOut	boolean	False	logging opt out
modelVersion	string	latest	model version
query	string		(Optional) If provided, the query will be used to extract most relevant sentences from the document.
sentenceCount	integer (int64)	3	Specifies the number of sentences in the extracted summary.
sortBy	ExtractiveSummarizationSortingCriteria	Offset	Specifies how to sort the extracted summaries.
stringIndexType	StringIndexType	TextElements_v8	Specifies the method used to interpret string offsets.

InnerErrorCode

Enumeration

Human-readable error code.

Value	Description
InvalidRequest	Invalid request error
InvalidParameterValue	Invalid parameter value error
KnowledgeBaseNotFound	Knowledge base not found error
AzureCognitiveSearchNotFound	Azure Cognitive Search not found error
AzureCognitiveSearchThrottling	Azure Cognitive Search throttling error
ExtractionFailure	Extraction failure error
InvalidRequestBodyFormat	Invalid request body format error
EmptyRequest	Empty request error
MissingInputDocuments	Missing input documents error
InvalidDocument	Invalid document error
ModelVersionIncorrect	Model version incorrect error
InvalidDocumentBatch	Invalid document batch error
UnsupportedLanguageCode	Unsupported language code error
InvalidCountryHint	Invalid country hint error

InnerErrorModel

Object

An object containing more specific information about the error. As per Microsoft One API guidelines - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Type	Description
code	InnerErrorCode	One of a server-defined set of error codes.
details	object	Error details.
innererror	InnerErrorModel	An object containing more specific information than the current object about the error.
message	string	Error message.
target	string	Error target.

MultiLanguageAnalysisInput

Object

Collection of input documents to be analyzed by the service.

Name	Type	Description
documents	MultiLanguageInput[]	The input documents to be analyzed.

MultiLanguageInput

Object

Contains an input document to be analyzed by the service.

Name	Type	Description
id	string	A unique, non-empty document identifier.
language	string	(Optional) This is the 2 letter ISO 639-1 representation of a language. For example, use "en" for English; "es" for Spanish etc. If not set, use "en" for English as default.
source	DocumentLocation: AzureBlobDocumentLocation	The location of the input document to process.
target	DocumentLocation: AzureBlobDocumentLocation	The location where the processed document will be stored.

PiiCategoriesExclude

Enumeration

(Optional) describes the PII categories to return

Value	Description
ABARoutingNumber	ABA Routing number
ARNationalIdentityNumber	AR National Identity Number
AUBankAccountNumber	AT Identity Card
AUDriversLicenseNumber	AU Driver's License Number
AUMedicalAccountNumber	AU Medical Account Number
AUPassportNumber	AU Passport Number
AUTaxFileNumber	AU Tax File Number
AUBusinessNumber	AU Business Number
AUCompanyNumber	AU Company Number
ATIdentityCard	AT Identity Card
ATTaxIdentificationNumber	AT Tax Identification Number
ATValueAddedTaxNumber	AT Value Added Tax Number
AzureDocumentDBAuthKey	Azure Document DB Auth Key
AzureIAASDatabaseConnectionAndSQLString	Azure IAAS Database Connection And SQL String
AzureIoTConnectionString	Azure IoT Connection String
AzurePublishSettingPassword	Azure Publish Setting Password
AzureRedisCacheString	Azure Redis Cache String
AzureSAS	Azure SAS
AzureServiceBusString	Azure Service Bus String
AzureStorageAccountKey	Azure Storage Account Key
AzureStorageAccountGeneric	Azure Storage Account Generic
BENationalNumber	BE National Number
BENationalNumberV2	BE National Number V2
BEValueAddedTaxNumber	BE Value Added Tax Number
BRCPFNumber	BR CPF Number
BRLegalEntityNumber	BR Legal Entity Number
BRNationalIDRG	BR National ID RG
BGUniformCivilNumber	BG Uniform Civil Number
CABankAccountNumber	CA Bank Account Number
CADriversLicenseNumber	CA Driver's License Number
CAHealthServiceNumber	CA Health Service Number
CAPassportNumber	CA Passport Number
CAPersonalHealthIdentification	CA Personal Health Identification
CASocialInsuranceNumber	CA Social Insurance Number
CLIdentityCardNumber	CL Identity Card Number
CNResidentIdentityCardNumber	CN Resident Identity Card Number
CreditCardNumber	Credit Card Number
HRIdentityCardNumber	HR Identity Card Number
HRNationalIDNumber	HR National ID Number
HRPersonalIdentificationNumber	HR Personal Identification Number
HRPersonalIdentificationOIBNumberV2	HR Personal Identification OIB Number V2
CYIdentityCard	CY Identity Card
CYTaxIdentificationNumber	CY Tax Identification Number
CZPersonalIdentityNumber	CZ Personal Identity Number
CZPersonalIdentityV2	CZ Personal Identity V2
DKPersonalIdentificationNumber	DK Personal Identification Number
DKPersonalIdentificationV2	DK Personal Identification V2
DrugEnforcementAgencyNumber	Drug Enforcement Agency Number
EEPersonalIdentificationCode	EE Personal Identification Code
EUDebitCardNumber	EU Debit Card Number
EUDriversLicenseNumber	EU Driver's License Number
EUGPSCoordinates	EU GPS Coordinates
EUNationalIdentificationNumber	EU National Identification Number
EUPassportNumber	EU Passport Number
EUSocialSecurityNumber	EU Social Security Number
EUTaxIdentificationNumber	EU Tax Identification Number
FIEuropeanHealthNumber	FI European Health Number
FINationalID	FI National ID
FINationalIDV2	FI National ID V2
FIPassportNumber	FI Passport Number
FRDriversLicenseNumber	FR Driver's License Number
FRHealthInsuranceNumber	FR Health Insurance Number
FRNationalID	FR National ID
FRPassportNumber	FR Passport Number
FRSocialSecurityNumber	FR Social Security Number
FRTaxIdentificationNumber	FR Tax Identification Number
FRValueAddedTaxNumber	FR Value Added Tax Number
DEDriversLicenseNumber	DE Driver's License Number
DEPassportNumber	DE Passport Number
DEIdentityCardNumber	DE Identity Card Number
DETaxIdentificationNumber	DE Tax Identification Number
DEValueAddedNumber	DE Value Added Number
GRNationalIDCard	GR National ID Card
GRNationalIDV2	GR National ID V2
GRTaxIdentificationNumber	GR Tax Identification Number
HKIdentityCardNumber	HK Identity Card Number
HUValueAddedNumber	HU Value Added Number
HUPersonalIdentificationNumber	HU Personal Identification Number
HUTaxIdentificationNumber	HU Tax Identification Number
INPermanentAccount	IN Permanent Account
INUniqueIdentificationNumber	IN Unique Identification Number
IDIdentityCardNumber	ID Identity Card Number
InternationalBankingAccountNumber	International Banking Account Number
IEPersonalPublicServiceNumber	IE Personal Public Service Number
IEPersonalPublicServiceNumberV2	IE Personal Public Service Number V2
ILBankAccountNumber	IL Bank Account Number
ILNationalID	IL National ID
ITDriversLicenseNumber	IT Driver's License Number
ITFiscalCode	IT Fiscal Code
ITValueAddedTaxNumber	IT Value Added Tax Number
JPBankAccountNumber	JP Bank Account Number
JPDriversLicenseNumber	JP Driver's License Number
JPPassportNumber	JP Passport Number
JPResidentRegistrationNumber	JP Resident Registration Number
JPSocialInsuranceNumber	JP Social Insurance Number
JPMyNumberCorporate	JP My Number Corporate
JPMyNumberPersonal	JP My Number Personal
JPResidenceCardNumber	JP Residence Card Number
LVPersonalCode	LV Personal Code
LTPersonalCode	LT Personal Code
LUNationalIdentificationNumberNatural	LU National Identification Number Natural
LUNationalIdentificationNumberNonNatural	LU National Identification Number Non Natural
MYIdentityCardNumber	MY Identity Card Number
MTIdentityCardNumber	MT Identity Card Number
MTTaxIDNumber	MT Tax ID Number
NLCitizensServiceNumber	NL Citizens Service Number
NLCitizensServiceNumberV2	NL Citizens Service Number V2
NLTaxIdentificationNumber	NL Tax Identification Number
NLValueAddedTaxNumber	NL Value Added Tax Number
NZBankAccountNumber	NZ Bank Account Number
NZDriversLicenseNumber	NZ Driver's License Number
NZInlandRevenueNumber	NZ Inland Revenue Number
NZMinistryOfHealthNumber	NZ Ministry Of Health Number
NZSocialWelfareNumber	NZ Social Welfare Number
NOIdentityNumber	NO Identity Number
PHUnifiedMultiPurposeIDNumber	PH Unified Multi Purpose ID Number
PLIdentityCard	PL Identity Card
PLNationalID	PL National ID
PLNationalIDV2	PL National ID V2
PLPassportNumber	PL Passport Number
PLTaxIdentificationNumber	PL Tax Identification Number
PLREGONNumber	PL REGON Number
PTCitizenCardNumber	PT Citizen Card Number
PTCitizenCardNumberV2	PT Citizen Card Number V2
PTTaxIdentificationNumber	PT Tax Identification Number
ROPersonalNumericalCode	RO Personal Numerical Code
RUPassportNumberDomestic	RU Passport Number Domestic
RUPassportNumberInternational	RU Passport Number International
SANationalID	SA National ID
SGNationalRegistrationIdentityCardNumber	SG National Registration Identity Card Number
SKPersonalNumber	SK Personal Number
SITaxIdentificationNumber	SI Tax Identification Number
SIUniqueMasterCitizenNumber	SI Unique Master Citizen Number
ZAIdentificationNumber	ZA Identification Number
KRResidentRegistrationNumber	KR Resident Registration Number
ESDNI	ES DNI
ESSocialSecurityNumber	ES Social Security Number
ESTaxIdentificationNumber	ES Tax Identification Number
SQLServerConnectionString	SQL Server Connection String
SENationalID	SE National ID
SENationalIDV2	SE National ID V2
SEPassportNumber	SE Passport Number
SETaxIdentificationNumber	SE Tax Identification Number
SWIFTCode	SWIFT Code
CHSocialSecurityNumber	CH Social Security Number
TWNationalID	TW National ID
TWPassportNumber	TW Passport Number
TWResidentCertificate	TW Resident Certificate
THPopulationIdentificationCode	TH Population Identification Code
TRNationalIdentificationNumber	TR National Identification Number
UKDriversLicenseNumber	UK Driver's License Number
UKElectoralRollNumber	UK Electoral Roll Number
UKNationalHealthNumber	UK National Health Number
UKNationalInsuranceNumber	UK National Insurance Number
UKUniqueTaxpayerNumber	UK Unique Taxpayer Number
USUKPassportNumber	US UK Passport Number
USBankAccountNumber	US Bank Account Number
USDriversLicenseNumber	US Driver's License Number
USIndividualTaxpayerIdentification	US Individual Taxpayer Identification
USSocialSecurityNumber	US Social Security Number
UAPassportNumberDomestic	UA Passport Number Domestic
UAPassportNumberInternational	UA Passport Number International
Organization	Organization
Email	Email
URL	URL
Age	Age
PhoneNumber	Phone Number
IPAddress	IP Address
Date	Date
Person	Person
Address	Address

PiiCategory

Enumeration

(Optional) describes the PII categories to return

Value	Description
ABARoutingNumber	ABA Routing number
ARNationalIdentityNumber	AR National Identity Number
AUBankAccountNumber	AT Identity Card
AUDriversLicenseNumber	AU Driver's License Number
AUMedicalAccountNumber	AU Medical Account Number
AUPassportNumber	AU Passport Number
AUTaxFileNumber	AU Tax File Number
AUBusinessNumber	AU Business Number
AUCompanyNumber	AU Company Number
ATIdentityCard	AT Identity Card
ATTaxIdentificationNumber	AT Tax Identification Number
ATValueAddedTaxNumber	AT Value Added Tax Number
AzureDocumentDBAuthKey	Azure Document DB Auth Key
AzureIAASDatabaseConnectionAndSQLString	Azure IAAS Database Connection And SQL String
AzureIoTConnectionString	Azure IoT Connection String
AzurePublishSettingPassword	Azure Publish Setting Password
AzureRedisCacheString	Azure Redis Cache String
AzureSAS	Azure SAS
AzureServiceBusString	Azure Service Bus String
AzureStorageAccountKey	Azure Storage Account Key
AzureStorageAccountGeneric	Azure Storage Account Generic
BENationalNumber	BE National Number
BENationalNumberV2	BE National Number V2
BEValueAddedTaxNumber	BE Value Added Tax Number
BRCPFNumber	BR CPF Number
BRLegalEntityNumber	BR Legal Entity Number
BRNationalIDRG	BR National ID RG
BGUniformCivilNumber	BG Uniform Civil Number
CABankAccountNumber	CA Bank Account Number
CADriversLicenseNumber	CA Driver's License Number
CAHealthServiceNumber	CA Health Service Number
CAPassportNumber	CA Passport Number
CAPersonalHealthIdentification	CA Personal Health Identification
CASocialInsuranceNumber	CA Social Insurance Number
CLIdentityCardNumber	CL Identity Card Number
CNResidentIdentityCardNumber	CN Resident Identity Card Number
CreditCardNumber	Credit Card Number
HRIdentityCardNumber	HR Identity Card Number
HRNationalIDNumber	HR National ID Number
HRPersonalIdentificationNumber	HR Personal Identification Number
HRPersonalIdentificationOIBNumberV2	HR Personal Identification OIB Number V2
CYIdentityCard	CY Identity Card
CYTaxIdentificationNumber	CY Tax Identification Number
CZPersonalIdentityNumber	CZ Personal Identity Number
CZPersonalIdentityV2	CZ Personal Identity V2
DKPersonalIdentificationNumber	DK Personal Identification Number
DKPersonalIdentificationV2	DK Personal Identification V2
DrugEnforcementAgencyNumber	Drug Enforcement Agency Number
EEPersonalIdentificationCode	EE Personal Identification Code
EUDebitCardNumber	EU Debit Card Number
EUDriversLicenseNumber	EU Driver's License Number
EUGPSCoordinates	EU GPS Coordinates
EUNationalIdentificationNumber	EU National Identification Number
EUPassportNumber	EU Passport Number
EUSocialSecurityNumber	EU Social Security Number
EUTaxIdentificationNumber	EU Tax Identification Number
FIEuropeanHealthNumber	FI European Health Number
FINationalID	FI National ID
FINationalIDV2	FI National ID V2
FIPassportNumber	FI Passport Number
FRDriversLicenseNumber	FR Driver's License Number
FRHealthInsuranceNumber	FR Health Insurance Number
FRNationalID	FR National ID
FRPassportNumber	FR Passport Number
FRSocialSecurityNumber	FR Social Security Number
FRTaxIdentificationNumber	FR Tax Identification Number
FRValueAddedTaxNumber	FR Value Added Tax Number
DEDriversLicenseNumber	DE Driver's License Number
DEPassportNumber	DE Passport Number
DEIdentityCardNumber	DE Identity Card Number
DETaxIdentificationNumber	DE Tax Identification Number
DEValueAddedNumber	DE Value Added Number
GRNationalIDCard	GR National ID Card
GRNationalIDV2	GR National ID V2
GRTaxIdentificationNumber	GR Tax Identification Number
HKIdentityCardNumber	HK Identity Card Number
HUValueAddedNumber	HU Value Added Number
HUPersonalIdentificationNumber	HU Personal Identification Number
HUTaxIdentificationNumber	HU Tax Identification Number
INPermanentAccount	IN Permanent Account
INUniqueIdentificationNumber	IN Unique Identification Number
IDIdentityCardNumber	ID Identity Card Number
InternationalBankingAccountNumber	International Banking Account Number
IEPersonalPublicServiceNumber	IE Personal Public Service Number
IEPersonalPublicServiceNumberV2	IE Personal Public Service Number V2
ILBankAccountNumber	IL Bank Account Number
ILNationalID	IL National ID
ITDriversLicenseNumber	IT Driver's License Number
ITFiscalCode	IT Fiscal Code
ITValueAddedTaxNumber	IT Value Added Tax Number
JPBankAccountNumber	JP Bank Account Number
JPDriversLicenseNumber	JP Driver's License Number
JPPassportNumber	JP Passport Number
JPResidentRegistrationNumber	JP Resident Registration Number
JPSocialInsuranceNumber	JP Social Insurance Number
JPMyNumberCorporate	JP My Number Corporate
JPMyNumberPersonal	JP My Number Personal
JPResidenceCardNumber	JP Residence Card Number
LVPersonalCode	LV Personal Code
LTPersonalCode	LT Personal Code
LUNationalIdentificationNumberNatural	LU National Identification Number Natural
LUNationalIdentificationNumberNonNatural	LU National Identification Number Non Natural
MYIdentityCardNumber	MY Identity Card Number
MTIdentityCardNumber	MT Identity Card Number
MTTaxIDNumber	MT Tax ID Number
NLCitizensServiceNumber	NL Citizens Service Number
NLCitizensServiceNumberV2	NL Citizens Service Number V2
NLTaxIdentificationNumber	NL Tax Identification Number
NLValueAddedTaxNumber	NL Value Added Tax Number
NZBankAccountNumber	NZ Bank Account Number
NZDriversLicenseNumber	NZ Driver's License Number
NZInlandRevenueNumber	NZ Inland Revenue Number
NZMinistryOfHealthNumber	NZ Ministry Of Health Number
NZSocialWelfareNumber	NZ Social Welfare Number
NOIdentityNumber	NO Identity Number
PHUnifiedMultiPurposeIDNumber	PH Unified Multi Purpose ID Number
PLIdentityCard	PL Identity Card
PLNationalID	PL National ID
PLNationalIDV2	PL National ID V2
PLPassportNumber	PL Passport Number
PLTaxIdentificationNumber	PL Tax Identification Number
PLREGONNumber	PL REGON Number
PTCitizenCardNumber	PT Citizen Card Number
PTCitizenCardNumberV2	PT Citizen Card Number V2
PTTaxIdentificationNumber	PT Tax Identification Number
ROPersonalNumericalCode	RO Personal Numerical Code
RUPassportNumberDomestic	RU Passport Number Domestic
RUPassportNumberInternational	RU Passport Number International
SANationalID	SA National ID
SGNationalRegistrationIdentityCardNumber	SG National Registration Identity Card Number
SKPersonalNumber	SK Personal Number
SITaxIdentificationNumber	SI Tax Identification Number
SIUniqueMasterCitizenNumber	SI Unique Master Citizen Number
ZAIdentificationNumber	ZA Identification Number
KRResidentRegistrationNumber	KR Resident Registration Number
ESDNI	ES DNI
ESSocialSecurityNumber	ES Social Security Number
ESTaxIdentificationNumber	ES Tax Identification Number
SQLServerConnectionString	SQL Server Connection String
SENationalID	SE National ID
SENationalIDV2	SE National ID V2
SEPassportNumber	SE Passport Number
SETaxIdentificationNumber	SE Tax Identification Number
SWIFTCode	SWIFT Code
CHSocialSecurityNumber	CH Social Security Number
TWNationalID	TW National ID
TWPassportNumber	TW Passport Number
TWResidentCertificate	TW Resident Certificate
THPopulationIdentificationCode	TH Population Identification Code
TRNationalIdentificationNumber	TR National Identification Number
UKDriversLicenseNumber	UK Driver's License Number
UKElectoralRollNumber	UK Electoral Roll Number
UKNationalHealthNumber	UK National Health Number
UKNationalInsuranceNumber	UK National Insurance Number
UKUniqueTaxpayerNumber	UK Unique Taxpayer Number
USUKPassportNumber	US UK Passport Number
USBankAccountNumber	US Bank Account Number
USDriversLicenseNumber	US Driver's License Number
USIndividualTaxpayerIdentification	US Individual Taxpayer Identification
USSocialSecurityNumber	US Social Security Number
UAPassportNumberDomestic	UA Passport Number Domestic
UAPassportNumberInternational	UA Passport Number International
Organization	Organization
Email	Email
URL	URL
Age	Age
PhoneNumber	Phone Number
IPAddress	IP Address
Date	Date
Person	Person
Address	Address
All	All PII categories.
Default	Default PII categories for the language.

PiiDomain

Enumeration

Domain for PII task

Value	Description
phi	Indicates that entities in the Personal Health Information domain should be redacted.
none	Indicates that no domain is specified.

PiiLROTask

Object

Contains the analyze text PIIEntityRecognition LRO task.

Name	Type	Description
kind	string: PiiEntityRecognition	The kind of task to perform.
parameters	PiiTaskParameters	Pii task parameters.
taskName	string	task name

PiiTaskParameters

Object

Supported parameters for a PII Entities Recognition task.

Name	Type	Default value	Description
domain	PiiDomain	none	Domain for PII task
excludePiiCategories	PiiCategoriesExclude[]		Enumeration of PII categories to be excluded in the response.
loggingOptOut	boolean	False	logging opt out
modelVersion	string	latest	model version
piiCategories	PiiCategory[]		Enumeration of PII categories to be returned in the response.
redactionCharacter	redactionCharacter	*	Character to be used for redaction. Default in '*'.
stringIndexType	StringIndexType	TextElements_v8	StringIndexType to be used for analysis.

redactionCharacter

Enumeration

Character to be used for redaction. Default in '*'.

Value	Description
!	Exclamation point character
#	Number sign character
$	Dollar sign character
%	Percent sign character
&	Ampersand character
*	Asterisk character
+	Plus sign character
-	Minus sign character
=	Equals sign character
?	Question mark character
@	At sign character
^	Caret character
_	Underscore character
~	Tilde character

StringIndexType

Enumeration

String index type

Value	Description
TextElements_v8	Returned offset and length values will correspond to textElements (Graphemes and Grapheme clusters) confirming to the Unicode 8.0.0 standard. Use this option if your application is written in .Net Framework or .Net Core and you will be using StringInfo.
UnicodeCodePoint	Returned offset and length values will correspond to Unicode code points. Use this option if your application is written in a language that support Unicode, for example Python.
Utf16CodeUnit	Returned 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.

SummaryLengthBucket

Enumeration

Enum that defines the length of the output summaries.

Value	Description
short	Instructs model to generate shorter length summaries.
medium	Instructs model to generate medium length summaries.
long	Instructs model to generate longer length summaries.

Share via

Analyze Documents Submit Job - Analyze Documents Submit Job

URI Parameters

Request Header

Request Body

Responses

Security

Ocp-Apim-Subscription-Key

Examples

SuccessfulAnalyzeDocumentsJobsTaskSubmitRequest

Sample request

Sample response

Definitions

AbstractiveSummarizationLROTask

AbstractiveSummarizationTaskParameters

AnalyzeDocumentJobsInput

AnalyzeDocumentsLROTaskKind

AzureBlobDocumentLocation

DocumentLocationKind

Error

ErrorCode

ErrorResponse

ExtractiveSummarizationLROTask

ExtractiveSummarizationSortingCriteria

ExtractiveSummarizationTaskParameters

InnerErrorCode

InnerErrorModel

MultiLanguageAnalysisInput

MultiLanguageInput

PiiCategoriesExclude

PiiCategory

PiiDomain

PiiLROTask

PiiTaskParameters

redactionCharacter

StringIndexType

SummaryLengthBucket