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 |
|---|---|---|---|---|
|
resource
|
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. |
|
search
|
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. |
|
subscription
|
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 |
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 |
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
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 |
|---|---|
|
Cloud |
Innehåller information om ett API-fel. |
|
Cloud |
Beskriver ett visst API-fel med en felkod och ett meddelande. |
|
List |
Svar som innehåller fråge-API-nycklar för en viss Azure AI Search-tjänst. |
|
Query |
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 |
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 |
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 |
Query |
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. |