Query Keys - List By Search Service
Gibt die Liste der Abfrage-API-Schlüssel für den angegebenen Azure AI Search-Dienst zurück.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listQueryKeys?api-version=2025-05-01
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Der Name der Ressourcengruppe innerhalb des aktuellen Abonnements. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen. |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
Der Name des Azure AI Search-Diensts, der der angegebenen Ressourcengruppe zugeordnet ist. |
|
subscription
|
path | True |
string |
Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen. |
|
api-version
|
query | True |
string |
Die API-Version, die für jede Anforderung verwendet werden soll. |
Anforderungsheader
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
Ein vom Client generierter GUID-Wert, der diese Anforderung identifiziert. Wenn angegeben, wird dies in Antwortinformationen eingeschlossen, um die Anforderung nachzuverfolgen. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Alle Abfrageschlüssel für den angegebenen Suchdienst wurden erfolgreich abgerufen und befinden sich in der Antwort. Sie können jeden der Abfrageschlüssel als Wert des Parameters "api-key" in der REST-API des Azure AI Search Service oder SDK verwenden, um schreibgeschützte Vorgänge für Ihre Suchindizes auszuführen, z. B. Abfragen und Nachschlagen von Dokumenten nach ID. |
|
| Other Status Codes |
HTTP 404 (Nicht gefunden): Das Abonnement, die Ressourcengruppe oder der Suchdienst konnte nicht gefunden werden. HTTP 409 (Konflikt): Das angegebene Abonnement ist deaktiviert. |
Sicherheit
azure_auth
Gibt einen impliziten Genehmigungsfluss an, der auf der Microsoft Identity Platform unterstützt wird.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
SearchListQueryKeysBySearchService
Beispielanforderung
Beispiel für eine Antwort
{
"value": [
{
"name": "Query key for browser-based clients",
"key": "<a query API key>"
},
{
"name": "Query key for mobile clients",
"key": "<another query API key>"
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Cloud |
Enthält Informationen zu einem API-Fehler. |
|
Cloud |
Beschreibt einen bestimmten API-Fehler mit einem Fehlercode und einer Meldung. |
|
List |
Antwort, die die Abfrage-API-Schlüssel für einen bestimmten Azure AI Search-Dienst enthält. |
|
Query |
Beschreibt einen API-Schlüssel für einen bestimmten Azure AI Search-Dienst, der schreibgeschützte Berechtigungen für die Docs-Auflistung eines Indexes vermittelt. |
CloudError
Enthält Informationen zu einem API-Fehler.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Beschreibt einen bestimmten API-Fehler mit einem Fehlercode und einer Meldung. |
|
| message |
string |
Eine kurze Beschreibung des Fehlers, der darauf hinweist, was schief gelaufen ist (details/Debugginginformationen beziehen sich auf die Eigenschaft "error.message"). |
CloudErrorBody
Beschreibt einen bestimmten API-Fehler mit einem Fehlercode und einer Meldung.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Ein Fehlercode, der die Fehlerbedingung genauer beschreibt als ein HTTP-Statuscode. Kann verwendet werden, um bestimmte Fehlerfälle programmgesteuert zu behandeln. |
| details |
Enthält geschachtelte Fehler, die mit diesem Fehler zusammenhängen. |
|
| message |
string |
Eine Meldung, die den Fehler detailliert beschreibt und Debuginformationen bereitstellt. |
| target |
string |
Das Ziel des bestimmten Fehlers (z. B. der Name der Eigenschaft im Fehler). |
ListQueryKeysResult
Antwort, die die Abfrage-API-Schlüssel für einen bestimmten Azure AI Search-Dienst enthält.
| Name | Typ | Beschreibung |
|---|---|---|
| nextLink |
string |
Anforderungs-URL, die zum Abfragen der nächsten Seite von Abfrageschlüsseln verwendet werden kann. Wird zurückgegeben, wenn die Gesamtanzahl der angeforderten Abfrageschlüssel die maximale Seitengröße überschreitet. |
| value |
Query |
Die Abfrageschlüssel für den Azure AI Search-Dienst. |
QueryKey
Beschreibt einen API-Schlüssel für einen bestimmten Azure AI Search-Dienst, der schreibgeschützte Berechtigungen für die Docs-Auflistung eines Indexes vermittelt.
| Name | Typ | Beschreibung |
|---|---|---|
| key |
string |
Der Wert des Abfrage-API-Schlüssels. |
| name |
string |
Der Name des Abfrage-API-Schlüssels. Abfragenamen sind optional, aber das Zuweisen eines Namens kann Ihnen helfen, sich zu merken, wie sie verwendet wird. |