Dela via


Query Keys - List By Search Service

Returnerar listan med fråge-API-nycklar för den angivna Azure AI Search-tjänsten.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listQueryKeys?api-version=2025-05-01

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen i den aktuella prenumerationen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

searchServiceName
path True

string

pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$

Namnet på azure AI Search-tjänsten som är associerad med den angivna resursgruppen.

subscriptionId
path True

string

Den unika identifieraren för en Microsoft Azure-prenumeration. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

api-version
query True

string

DEN API-version som ska användas för varje begäran.

Begärandehuvud

Name Obligatorisk Typ Description
x-ms-client-request-id

string (uuid)

Ett klientgenererat GUID-värde som identifierar den här begäran. Om det anges inkluderas detta i svarsinformationen som ett sätt att spåra begäran.

Svar

Name Typ Description
200 OK

ListQueryKeysResult

Alla frågenycklar för den angivna söktjänsten har hämtats och finns i svaret. Du kan använda någon av frågenycklarna som värdet för parametern "api-key" i REST-API:et eller SDK:t för Azure AI Search Service för att utföra skrivskyddade åtgärder på dina sökindex, till exempel genom att fråga och söka efter dokument efter ID.

Other Status Codes

CloudError

HTTP 404 (hittades inte): Det gick inte att hitta prenumerationen, resursgruppen eller söktjänsten. HTTP 409 (konflikt): Den angivna prenumerationen är inaktiverad.

Säkerhet

azure_auth

Anger ett implicit beviljandeflöde som stöds på Microsoft Identity-plattformen.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

SearchListQueryKeysBySearchService

Exempelbegäran

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/listQueryKeys?api-version=2025-05-01

Exempelsvar

{
  "value": [
    {
      "name": "Query key for browser-based clients",
      "key": "<a query API key>"
    },
    {
      "name": "Query key for mobile clients",
      "key": "<another query API key>"
    }
  ]
}

Definitioner

Name Description
CloudError

Innehåller information om ett API-fel.

CloudErrorBody

Beskriver ett visst API-fel med en felkod och ett meddelande.

ListQueryKeysResult

Svar som innehåller fråge-API-nycklar för en viss Azure AI Search-tjänst.

QueryKey

Beskriver en API-nyckel för en viss Azure AI Search-tjänst som förmedlar skrivskyddade behörigheter för dokumentsamlingen för ett index.

CloudError

Innehåller information om ett API-fel.

Name Typ Description
error

CloudErrorBody

Beskriver ett visst API-fel med en felkod och ett meddelande.

message

string

En kort beskrivning av felet som antyder vad som gick fel (mer information/felsökningsinformation finns i egenskapen "error.message").

CloudErrorBody

Beskriver ett visst API-fel med en felkod och ett meddelande.

Name Typ Description
code

string

En felkod som beskriver feltillståndet mer exakt än en HTTP-statuskod. Kan användas för att programmatiskt hantera specifika felfall.

details

CloudErrorBody[]

Innehåller kapslade fel som är relaterade till det här felet.

message

string

Ett meddelande som beskriver felet i detalj och ger felsökningsinformation.

target

string

Målet för det specifika felet (till exempel namnet på egenskapen i fel).

ListQueryKeysResult

Svar som innehåller fråge-API-nycklar för en viss Azure AI Search-tjänst.

Name Typ Description
nextLink

string

Begär URL som kan användas för att fråga nästa sida med frågenycklar. Returneras när det totala antalet begärda frågenycklar överskrider den maximala sidstorleken.

value

QueryKey[]

Frågenycklarna för Azure AI Search-tjänsten.

QueryKey

Beskriver en API-nyckel för en viss Azure AI Search-tjänst som förmedlar skrivskyddade behörigheter för dokumentsamlingen för ett index.

Name Typ Description
key

string

Värdet för fråge-API-nyckeln.

name

string

Namnet på fråge-API-nyckeln. Frågenamn är valfria, men om du tilldelar ett namn kan du komma ihåg hur det används.