Csatlakozás Azure AI Keresés kulcsokkal

1. Nyissa meg a keresőszolgáltatást a Azure portálon.

2. A bal oldali panelen válassza a Beállítások>kulcsok lehetőséget a rendszergazdai és lekérdezési kulcsok megtekintéséhez.

   

Futtassa a következő parancsokat a rendszergazdai és lekérdezési API-kulcsok visszaadásához. A REST szolgáltatással kapcsolatos segítségért lásd: A Azure AI Keresés szolgáltatás kezelése REST API-kkal.

1. Rendszergazdai kulcsok visszaküldése:

   POST https://management.azure.com/subscriptions/{{subscriptionId}}/resourceGroups/{{resource-group}}/providers//Microsoft.Search/searchServices/{{search-service-name}}/listAdminKeys?api-version=2025-05-01
   

2. Lekérdezési kulcsok visszaadása:

   POST https://management.azure.com/subscriptions/{{subscriptionId}}/resourceGroups/{{resource-group}}/providers//Microsoft.Search/searchServices/{{search-service-name}}/listAdminKeys?api-version=2025-05-01
   

Referencia:Rendszergazdai kulcsok – Lekérés, Lekérdezési kulcsok – Listázás keresési szolgáltatás szerint

Az Azure SDK for Python használatával kérje le programozottan az API-kulcsokat. Telepítse a felügyeleti SDK-t:

pip install azure-mgmt-search azure-identity

Futtassa a következő kódot a rendszergazdai és lekérdezési API-kulcsok visszaadásához:

import os
from azure.identity import DefaultAzureCredential
from azure.mgmt.search import SearchManagementClient

# Set up variables
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]
resource_group = "your-resource-group"
search_service_name = "your-search-service"

# Create the management client
credential = DefaultAzureCredential()
client = SearchManagementClient(credential, subscription_id)

# Get admin keys
admin_keys = client.admin_keys.get(resource_group, search_service_name)
print(f"Primary admin key: {admin_keys.primary_key}")
print(f"Secondary admin key: {admin_keys.secondary_key}")

# Get query keys
query_keys = client.query_keys.list_by_search_service(resource_group, search_service_name)
for key in query_keys:
    print(f"Query key '{key.name}': {key.key}")

Referencia:SearchManagementClient | AdminKeys | QueryKeys

Futtassa a következő parancsokat a rendszergazdai és lekérdezési API-kulcsok visszaadásához. A PowerShell-lel kapcsolatos segítségért lásd: A Azure AI Keresés szolgáltatás kezelése a PowerShell használatával.

1. Telepítse a modult Az.Search :

   Install-Module Az.Search
   

2. Rendszergazdai kulcsok visszaküldése:

   Get-AzSearchAdminKeyPair -ResourceGroupName <resource-group-name> -ServiceName <search-service-name>
   

3. Lekérdezési kulcsok visszaadása:

   Get-AzSearchQueryKey -ResourceGroupName <resource-group-name> -ServiceName <search-service-name>
   

Futtassa a következő parancsokat a rendszergazdai és lekérdezési API-kulcsok visszaadásához. A Azure CLI kapcsolatos segítségért lásd: A Azure AI Keresés szolgáltatás kezelése a Azure CLI használatával.

1. Rendszergazdai kulcsok visszaküldése:

   az search admin-key show --resource-group <myresourcegroup> --service-name <myservice>
   

2. Lekérdezési kulcsok visszaadása:

   az search query-key list --resource-group <myresourcegroup> --service-name <myservice>
   

Ne feledje, hogy a kulcshitelesítés alapértelmezés szerint engedélyezve van, és támogatja az adatsík-műveleteket, például az indexelést és a lekérdezéseket.

Azonban ha letiltja az API-kulcsokat, és szerepkör-hozzárendeléseket állít be, az Azure portál szerepkör-hozzárendeléseket használ.

Állítson be egy rendszergazdai kulcsot a kérelem fejlécében. Nem adhat át rendszergazdai kulcsokat az URI-n vagy a kérés törzsében.

Íme egy példa a rendszergazdai API-kulcsok használatára egy index létrehozása iránti kérelemben:

@baseUrl=https://my-demo-search-service.search.windows.net
@adminApiKey=aaaabbbb-0000-cccc-1111-dddd2222eeee

### Create an index
POST {{baseUrl}}/indexes?api-version=2026-04-01  HTTP/1.1
  Content-Type: application/json
  api-key: {{adminApiKey}}

    {
        "name": "my-new-index",  
        "fields": [
            {"name": "docId", "type": "Edm.String", "key": true, "filterable": true},
            {"name": "Name", "type": "Edm.String", "searchable": true }
         ]
   }

Állítson be egy lekérdezéskulcsot a POST kérelemfejlécében vagy a GET URI-jában. A lekérdezési kulcsok a gyűjteményt célzó index/docs műveletekhez használhatók: Dokumentumok keresése, Automatikus kiegészítés, Javaslat vagy GET dokumentum.

Íme egy példa a lekérdezési API-kulcs használatára a keresési dokumentumok (GET) kéréseken:

### Query an index
GET /indexes/my-new-index/docs?search=*&api-version=2026-04-01&api-key={{queryApiKey}}

Ajánlott eljárás az API-kulcs környezeti változóként való beállítása, de az egyszerűség kedvéért ez a példa sztringként jeleníti meg. A példa lekérdezési API-kulcsot használ egy lekérdezési művelethez.

# Import libraries
from azure.search.documents import SearchClient
from azure.core.credentials import AzureKeyCredential
from azure.identity import DefaultAzureCredential, AzureAuthorityHosts

# Variables for endpoint, keys, index
search_endpoint: str = "https://<Put your search service NAME here>.search.windows.net/"
credential = AzureKeyCredential("Your search service query key")
index_name: str = "hotels-quickstart-python"

# Set up the client
search_client = SearchClient(endpoint=search_endpoint,
                      index_name=index_name,
                      credential=credential)

# Run the query
results =  search_client.search(query_type='simple',
    search_text="*" ,
    select='HotelName,Description,Tags',
    include_total_count=True)

print ('Total Documents Matching Query:', results.get_count())
for result in results:
    print(result["@search.score"])
    print(result["HotelName"])
    print(result["Tags"])
    print(f"Description: {result['Description']}")

Állítsd be az API kulcsokat a kérés fejléceiben a következő szintaxissal:

$headers = @{
'api-key' = '<YOUR-ADMIN-OR-QUERY-API-KEY>'
'Content-Type' = 'application/json' 
'Accept' = 'application/json' }

Használjon változót a teljes minősített lekérdezéshez:

$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2026-04-01&search=attached restaurant&searchFields=Description,Tags&$select=HotelId,HotelName,Tags,Description&$count=true'

Küldje el a kérést a keresési szolgáltatásnak:

Invoke-RestMethod -Uri $url -Headers $headers | ConvertTo-Json

További szkriptpéldákat a Gyorsútmutató: Azure AI Keresés index létrehozása PowerShellben REST API-k használatával találhat.

1. Nyissa meg a keresőszolgáltatást a Azure portálon.

2. A bal oldali panelen válassza a Beállítások>kulcsok lehetőséget az API-kulcsok megtekintéséhez.

3. A Lekérdezési kulcsok kezelése területen használja a szolgáltatáshoz már létrehozott lekérdezési kulcsot, vagy hozzon létre új lekérdezési kulcsokat. Az alapértelmezett lekérdezési kulcs nincs elnevezve, de más generált lekérdezési kulcsok is elnevezhetők a kezelhetőség érdekében.

   

A Lekérdezési kulcsok létrehozása funkciót használja a Felügyeleti REST API-ban.

Az API-kulcsok létrehozásához vagy kezeléséhez érvényes szerepkör-hozzárendeléssel kell rendelkeznie. Az Azure AI Keresés szolgáltatás kezelése REST API-kkal című útmutató segítséget nyújt a szerepkör-követelmények REST API-kon keresztüli teljesítéséhez.

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

A lekérdezési kulcsok létrehozásakor vagy törlésekor az API-kulcsok használatát bemutató példaszkript található.

A lekérdezési kulcsok használatát bemutató példaszkript a lekérdezési kulcsok létrehozásakor vagy törlésekor található.