Package version:

Interface WebApiSkill

A skill that can call a Web API endpoint, allowing you to extend a skillset by having it call your custom code.

interface WebApiSkill {
    authIdentity?: SearchIndexerDataIdentity;
    authResourceId?: string;
    batchSize?: number;
    context?: string;
    degreeOfParallelism?: number;
    description?: string;
    httpHeaders?: {
        [propertyName: string]: string;
    };
    httpMethod?: string;
    inputs: InputFieldMappingEntry[];
    name?: string;
    odatatype: "#Microsoft.Skills.Custom.WebApiSkill";
    outputs: OutputFieldMappingEntry[];
    timeout?: string;
    uri: string;
}

Hierarchy (view full)

Properties

authIdentity? authResourceId? batchSize? context? degreeOfParallelism? description? httpHeaders? httpMethod? inputs name? odatatype outputs timeout? uri

Properties

OptionalauthIdentity

authIdentity?: SearchIndexerDataIdentity

The user-assigned managed identity used for outbound connections. If an authResourceId is provided and it's not specified, the system-assigned managed identity is used. On updates to the indexer, if the identity is unspecified, the value remains unchanged. If undefined, the value of this property is cleared.

OptionalauthResourceId

authResourceId?: string

Applies to custom skills that connect to external code in an Azure function or some other application that provides the transformations. This value should be the application ID created for the function or app when it was registered with Azure Active Directory. When specified, the custom skill connects to the function or app using a managed ID (either system or user-assigned) of the search service and the access token of the function or app, using this value as the resource id for creating the scope of the access token.

OptionalbatchSize

batchSize?: number

The desired batch size which indicates number of documents.

Optionalcontext

context?: string

Represents the level at which operations take place, such as the document root or document content (for example, /document or /document/content). The default is /document.

OptionaldegreeOfParallelism

degreeOfParallelism?: number

If set, the number of parallel calls that can be made to the Web API.

Optionaldescription

description?: string

The description of the skill which describes the inputs, outputs, and usage of the skill.

OptionalhttpHeaders

httpHeaders?: {
    [propertyName: string]: string;
}

The headers required to make the http request.

OptionalhttpMethod

httpMethod?: string

The method for the http request.

inputs

inputs: InputFieldMappingEntry[]

Inputs of the skills could be a column in the source data set, or the output of an upstream skill.

Optionalname

name?: string

The name of the skill which uniquely identifies it within the skillset. A skill with no name defined will be given a default name of its 1-based index in the skills array, prefixed with the character '#'.

odatatype

odatatype

Polymorphic discriminator, which specifies the different types this object can be

outputs

outputs: OutputFieldMappingEntry[]

The output of a skill is either a field in a search index, or a value that can be consumed as an input by another skill.

Optionaltimeout

timeout?: string

The desired timeout for the request. Default is 30 seconds.

uri

uri: string

The url for the Web API.

Settings

Member Visibility