Operations - List
Lists all of the available REST API operations of the Microsoft.Search provider.
GET https://management.azure.com/providers/Microsoft.Search/operations?api-version=2024-03-01-preview
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
The API version to use for each request. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Success. The response describes the list of operations. |
|
Other Status Codes |
Operations API failed. |
Security
azure_auth
Specifies an implicit grant flow, as supported on the Microsoft Identity platform.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
SearchListOperations
Sample request
GET https://management.azure.com/providers/Microsoft.Search/operations?api-version=2024-03-01-preview
Sample response
{
"value": [
{
"name": "Microsoft.Search/operations/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "List all available operations",
"description": "Lists all of the available operations of the Microsoft.Search provider."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/register/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Register the Search Resource Provider",
"description": "Registers the subscription for the search resource provider and enables the creation of search services."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Set Search Service",
"description": "Creates or updates the search service."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Get Search Service",
"description": "Reads the search service."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Delete Search Service",
"description": "Deletes the search service."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/start/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Start Search Service",
"description": "Starts the search service."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/stop/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Stop Search Service",
"description": "Stops the search service."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/listAdminKeys/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Get Admin Key",
"description": "Reads the admin keys."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/regenerateAdminKey/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Regenerate Admin Key",
"description": "Regenerates the admin key."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/listQueryKeys/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "API Keys",
"operation": "Get Query Keys",
"description": "Returns the list of query API keys for the given Azure AI Search service."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/createQueryKey/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Search Services",
"operation": "Create Query Key",
"description": "Creates the query key."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/deleteQueryKey/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "API Keys",
"operation": "Delete Query Key",
"description": "Deletes the query key."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/checkNameAvailability/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Service Name Availability",
"operation": "Check Service Name Availability",
"description": "Checks availability of the service name."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/diagnosticSettings/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Diagnostic Settings",
"operation": "Get Diagnostic Setting",
"description": "Gets the diganostic setting for the resource."
},
"origin": "system"
},
{
"name": "Microsoft.Search/searchServices/diagnosticSettings/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Diagnostic Settings",
"operation": "Set Diagnostic Setting",
"description": "Creates or updates the diganostic setting for the resource."
},
"origin": "system"
},
{
"name": "Microsoft.Search/searchServices/metricDefinitions/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "The metric definitions for the search service",
"operation": "Read search service metric definitions",
"description": "Gets the available metrics for the search service."
},
"origin": "system",
"properties": {
"serviceSpecification": {
"metricSpecifications": [
{
"name": "SearchLatency",
"displayName": "Search Latency",
"displayDescription": "Average search latency for the search service",
"unit": "Seconds",
"aggregationType": "Average",
"availabilities": [
{
"timeGrain": "PT1M",
"blobDuration": "PT1H"
}
]
},
{
"name": "SearchQueriesPerSecond",
"displayName": "Search queries per second",
"displayDescription": "Search queries per second for the search service.",
"unit": "CountPerSecond",
"aggregationType": "Average",
"availabilities": [
{
"timeGrain": "PT1M",
"blobDuration": "PT1H"
}
]
},
{
"name": "ThrottledSearchQueriesPercentage",
"displayName": "Throttled search queries percentage",
"displayDescription": "Percentage of search queries that were throttled for the search service.",
"unit": "Percent",
"aggregationType": "Average",
"availabilities": [
{
"timeGrain": "PT1M",
"blobDuration": "PT1H"
}
]
}
]
}
}
},
{
"name": "Microsoft.Search/searchServices/logDefinitions/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "The log definition for the search service",
"operation": "Read search service log definitions",
"description": "Gets the available logs for the search service."
},
"origin": "system",
"properties": {
"serviceSpecification": {
"logSpecifications": [
{
"name": "OperationLogs",
"displayName": "Operation Logs",
"blobDuration": "PT1H"
}
]
}
}
},
{
"name": "Microsoft.Search/searchServices/privateEndpointConnectionProxies/validate/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Private Endpoint Connection Proxy",
"operation": "Validate Private Endpoint Connection Proxy",
"description": "Validates a private endpoint connection create call from NRP (Microsoft.Network Resource Provider) side."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/privateEndpointConnectionProxies/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Private Endpoint Connection Proxy",
"operation": "Create Private Endpoint Connection Proxy",
"description": "Creates a private endpoint connection proxy with the specified parameters or updates the properties or tags for the specified private endpoint connection proxy."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/privateEndpointConnectionProxies/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Private Endpoint Connection Proxy",
"operation": "Get Private Endpoint Connection Proxy",
"description": "Returns the list of private endpoint connection proxies or gets the properties for the specified private endpoint connection proxy."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/privateEndpointConnectionProxies/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Private Endpoint Connection Proxy",
"operation": "Delete Private Endpoint Connection Proxy",
"description": "Deletes an existing private endpoint connection proxy."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/privateEndpointConnections/write",
"display": {
"provider": "Microsoft Search",
"resource": "Private Endpoint Connection",
"operation": "Create Private Endpoint Connection",
"description": "Creates a private endpoint connection with the specified parameters or updates the properties or tags for the specified private endpoint connections."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/privateEndpointConnections/read",
"display": {
"provider": "Microsoft Search",
"resource": "Private Endpoint Connection",
"operation": "Get Private Endpoint Connection",
"description": "Returns the list of private endpoint connections or gets the properties for the specified private endpoint connection."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/privateEndpointConnections/delete",
"display": {
"provider": "Microsoft Search",
"resource": "Private Endpoint Connection",
"operation": "Delete Private Endpoint Connection",
"description": "Deletes an existing private endpoint connection."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/sharedPrivateLinkResources/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Shared Private Link Resource",
"operation": "Create Shared Private Link Resource",
"description": "Creates a new shared private link resource with the specified parameters or updates the properties for the specified shared private link resource."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/sharedPrivateLinkResources/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Shared Private Link Resource",
"operation": "Get Shared Private Link Resource",
"description": "Returns the list of shared private link resources or gets the properties for the specified shared private link resource."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/sharedPrivateLinkResources/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Shared Private Link Resource",
"operation": "Delete Shared Private Link Resource",
"description": "Deletes an existing shared private link resource."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/sharedPrivateLinkResources/operationStatuses/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Shared Private Link Resource",
"operation": "Get Operation Status",
"description": "Get the details of a long running shared private link resource operation."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexes/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Indexes",
"operation": "Read Index",
"description": "Return an index or its statistics, return a list of indexes or their statistics, or test the lexical analysis components of an index."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexes/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Indexes",
"operation": "Create or Update Index",
"description": "Create an index or modify its properties."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexes/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Indexes",
"operation": "Delete Index",
"description": "Delete an index."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/synonymMaps/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Synonym Maps",
"operation": "Read Synonym Map",
"description": "Return a synonym map or a list of synonym maps."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/synonymMaps/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Synonym Maps",
"operation": "Create or Update Synonym Map",
"description": "Create a synonym map or modify its properties."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/synonymMaps/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Synonym Maps",
"operation": "Delete Synonym Map",
"description": "Delete a synonym map."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/dataSources/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Data Sources",
"operation": "Read Data Source",
"description": "Return a data source or a list of data sources."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/dataSources/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Data Sources",
"operation": "Create or Update Data Source",
"description": "Create a data source or modify its properties."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/dataSources/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Data Sources",
"operation": "Delete Data Source",
"description": "Delete a data source."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/skillsets/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Skillsets",
"operation": "Read Skillset",
"description": "Return a skillset or a list of skillsets."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/skillsets/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Skillsets",
"operation": "Create or Update Skillset",
"description": "Create a skillset or modify its properties."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/skillsets/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Skillsets",
"operation": "Delete Skillset",
"description": "Delete a skillset."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexers/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Indexers",
"operation": "Read Indexer",
"description": "Return an indexer or its status, or return a list of indexers or their statuses."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexers/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Indexers",
"operation": "Create or Manage Indexer",
"description": "Create an indexer, modify its properties, or manage its execution."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexers/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Indexers",
"operation": "Delete Indexer",
"description": "Delete an indexer."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/debugSessions/read",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Debug Sessions",
"operation": "Read Debug Session",
"description": "Return a debug session or a list of debug sessions."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/debugSessions/write",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Debug Sessions",
"operation": "Create or Update Debug Session",
"description": "Create a debug session or modify its properties."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/debugSessions/delete",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Debug Sessions",
"operation": "Delete Debug Session",
"description": "Delete a debug session."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/debugSessions/execute/action",
"isDataAction": false,
"display": {
"provider": "Microsoft Search",
"resource": "Debug Sessions",
"operation": "Execute Debug Session",
"description": "Use a debug session, get execution data, or evaluate expressions on it."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexes/documents/read",
"isDataAction": true,
"display": {
"provider": "Microsoft Search",
"resource": "Documents",
"operation": "Read Documents",
"description": "Read documents or suggested query terms from an index."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexes/documents/write",
"isDataAction": true,
"display": {
"provider": "Microsoft Search",
"resource": "Documents",
"operation": "Write Documents",
"description": "Upload documents to an index or modify existing documents."
},
"origin": "user,system"
},
{
"name": "Microsoft.Search/searchServices/indexes/documents/delete",
"isDataAction": true,
"display": {
"provider": "Microsoft Search",
"resource": "Documents",
"operation": "Delete Documents",
"description": "Delete documents from an index."
},
"origin": "user,system"
}
]
}
Definitions
Name | Description |
---|---|
Cloud |
Contains information about an API error. |
Cloud |
Describes a particular API error with an error code and a message. |
Display |
The object that describes the operation. |
Operation |
Describes a REST API operation. |
Operation |
Describes a particular availability for the metric specification. |
Operation |
The result of the request to list REST API operations. It contains a list of operations and a URL to get the next set of results. |
Operation |
Specifications of one type of log for this operation. |
Operation |
Describes a particular dimension for the metric specification. |
Operation |
Specifications of one type of metric for this operation. |
Operation |
Describes additional properties for this operation. |
Operation |
Specifications of the service for this operation. |
CloudError
Contains information about an API error.
Name | Type | Description |
---|---|---|
error |
Describes a particular API error with an error code and a message. |
|
message |
string |
A brief description of the error that hints at what went wrong (for details/debugging information refer to the 'error.message' property). |
CloudErrorBody
Describes a particular API error with an error code and a message.
Name | Type | Description |
---|---|---|
code |
string |
An error code that describes the error condition more precisely than an HTTP status code. Can be used to programmatically handle specific error cases. |
details |
Contains nested errors that are related to this error. |
|
message |
string |
A message that describes the error in detail and provides debugging information. |
target |
string |
The target of the particular error (for example, the name of the property in error). |
Display
The object that describes the operation.
Name | Type | Description |
---|---|---|
description |
string |
The friendly name of the operation. |
operation |
string |
The operation type: read, write, delete, listKeys/action, etc. |
provider |
string |
The friendly name of the resource provider. |
resource |
string |
The resource type on which the operation is performed. |
Operation
Describes a REST API operation.
Name | Type | Description |
---|---|---|
display |
The object that describes the operation. |
|
isDataAction |
boolean |
Describes if the specified operation is a data plane API operation. Operations where this value is not true are supported directly by the resource provider. |
name |
string |
The name of the operation. This name is of the form {provider}/{resource}/{operation}. |
origin |
string |
Describes which originating entities are allowed to invoke this operation. |
properties |
Describes additional properties for this operation. |
OperationAvailability
Describes a particular availability for the metric specification.
Name | Type | Description |
---|---|---|
blobDuration |
string |
The blob duration for the dimension. |
timeGrain |
string |
The time grain for the dimension. |
OperationListResult
The result of the request to list REST API operations. It contains a list of operations and a URL to get the next set of results.
Name | Type | Description |
---|---|---|
nextLink |
string |
The URL to get the next set of operation list results, if any. |
value |
The list of operations by Azure AI Search, some supported by the resource provider and others by data plane APIs. |
OperationLogsSpecification
Specifications of one type of log for this operation.
Name | Type | Description |
---|---|---|
blobDuration |
string |
The blob duration for the log specification. |
displayName |
string |
The display name of the log specification. |
name |
string |
The name of the log specification. |
OperationMetricDimension
Describes a particular dimension for the metric specification.
Name | Type | Description |
---|---|---|
displayName |
string |
The display name of the dimension. |
name |
string |
The name of the dimension. |
OperationMetricsSpecification
Specifications of one type of metric for this operation.
Name | Type | Description |
---|---|---|
aggregationType |
string |
The type of aggregation for the metric specification. |
availabilities |
Availabilities for the metric specification. |
|
dimensions |
Dimensions for the metric specification. |
|
displayDescription |
string |
The display description of the metric specification. |
displayName |
string |
The display name of the metric specification. |
name |
string |
The name of the metric specification. |
unit |
string |
The unit for the metric specification. |
OperationProperties
Describes additional properties for this operation.
Name | Type | Description |
---|---|---|
serviceSpecification |
Specifications of the service for this operation. |
OperationServiceSpecification
Specifications of the service for this operation.
Name | Type | Description |
---|---|---|
logSpecifications |
Specifications of logs for this operation. |
|
metricSpecifications |
Specifications of metrics for this operation. |