Services - Get

Service:

Search Management

API Version:

2023-11-01

Ottiene il servizio di ricerca con il nome specificato nel gruppo di risorse specificato.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}?api-version=2023-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione corrente. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
searchServiceName	path	True	string	Nome del servizio di ricerca associato al gruppo di risorse specificato.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure. È possibile ottenere questo valore dall'API Resource Manager di Azure, dagli strumenti da riga di comando o dal portale.
api-version	query	True	string	Versione dell'API da usare per ogni richiesta.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-request-id		string uuid	Valore GUID generato dal client che identifica la richiesta. Se specificato, verrà incluso nelle informazioni di risposta come modo per tenere traccia della richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	SearchService	La definizione del servizio di ricerca è stata recuperata correttamente e si trova nella risposta. Se si esegue il polling per il completamento di un'operazione di provisioning o scalabilità, è possibile controllarne lo stato tramite la proprietà provisioningState.
Other Status Codes	CloudError	HTTP 404 (Non trovato): impossibile trovare la sottoscrizione, il gruppo di risorse o il nome del servizio di ricerca.

Sicurezza

azure_auth

Microsoft Entra ID flusso di autorizzazione OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

SearchGetService

Sample Request

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2023-11-01

Java

/** Samples for Services GetByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchGetService.json
     */
    /**
     * Sample code: SearchGetService.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void searchGetService(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.searchServices().manager().serviceClient().getServices().getByResourceGroupWithResponse("rg1",
            "mysearchservice", null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

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

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-search
# USAGE
    python search_get_service.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SearchManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.services.get(
        resource_group_name="rg1",
        search_service_name="mysearchservice",
    )
    print(response)


# x-ms-original-file: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchGetService.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armsearch_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/search/armsearch"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7e29dd59eef13ef347d09e41a63f2585be77b3ca/specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchGetService.json
func ExampleServicesClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsearch.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewServicesClient().Get(ctx, "rg1", "mysearchservice", &armsearch.SearchManagementRequestOptions{ClientRequestID: nil}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Service = armsearch.Service{
	// 	Name: to.Ptr("mysearchservice"),
	// 	Type: to.Ptr("Microsoft.Search/searchServices"),
	// 	ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"app-name": to.Ptr("My e-commerce app"),
	// 	},
	// 	Properties: &armsearch.ServiceProperties{
	// 		HostingMode: to.Ptr(armsearch.HostingModeDefault),
	// 		NetworkRuleSet: &armsearch.NetworkRuleSet{
	// 			IPRules: []*armsearch.IPRule{
	// 			},
	// 		},
	// 		PartitionCount: to.Ptr[int32](1),
	// 		PrivateEndpointConnections: []*armsearch.PrivateEndpointConnection{
	// 		},
	// 		ProvisioningState: to.Ptr(armsearch.ProvisioningStateSucceeded),
	// 		PublicNetworkAccess: to.Ptr(armsearch.PublicNetworkAccessEnabled),
	// 		ReplicaCount: to.Ptr[int32](3),
	// 		Status: to.Ptr(armsearch.SearchServiceStatusRunning),
	// 		StatusDetails: to.Ptr(""),
	// 	},
	// 	SKU: &armsearch.SKU{
	// 		Name: to.Ptr(armsearch.SKUNameStandard),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { SearchManagementClient } = require("@azure/arm-search");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets the search service with the given name in the given resource group.
 *
 * @summary Gets the search service with the given name in the given resource group.
 * x-ms-original-file: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchGetService.json
 */
async function searchGetService() {
  const subscriptionId = process.env["SEARCH_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["SEARCH_RESOURCE_GROUP"] || "rg1";
  const searchServiceName = "mysearchservice";
  const credential = new DefaultAzureCredential();
  const client = new SearchManagementClient(credential, subscriptionId);
  const result = await client.services.get(resourceGroupName, searchServiceName);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Search;
using Azure.ResourceManager.Search.Models;

// Generated from example definition: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchGetService.json
// this example is just showing the usage of "Services_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SearchServiceResource created on azure
// for more information of creating SearchServiceResource, please refer to the document of SearchServiceResource
string subscriptionId = "subid";
string resourceGroupName = "rg1";
string searchServiceName = "mysearchservice";
ResourceIdentifier searchServiceResourceId = SearchServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, searchServiceName);
SearchServiceResource searchService = client.GetSearchServiceResource(searchServiceResourceId);

// invoke the operation
SearchServiceResource result = await searchService.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SearchServiceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "status": "running",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "succeeded",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": []
  }
}

Definizioni

Nome	Descrizione
AadAuthFailureMode	Descrive la risposta che l'API del piano dati di un servizio di ricerca invia per le richieste che non sono riuscite nell'autenticazione.
ApiKeyOnly	Indica che solo la chiave API può essere usata per l'autenticazione.
CloudError	Contiene informazioni su un errore dell'API.
CloudErrorBody	Descrive un errore dell'API specifico con un codice di errore e un messaggio.
DataPlaneAadOrApiKeyAuthOption	Indica che è possibile usare la chiave API o un token di accesso da un tenant Microsoft Entra ID per l'autenticazione.
DataPlaneAuthOptions	Definisce le opzioni per il modo in cui il servizio di ricerca autentica una richiesta del piano dati. Impossibile impostare se 'disableLocalAuth' è impostato su true.
EncryptionWithCmk	Descrive un criterio che determina il modo in cui le risorse all'interno del servizio di ricerca devono essere crittografate con chiavi customer=managed.
HostingMode	Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che sono molto più elevati rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.
Identity	Identità per la risorsa.
IdentityType	Tipo di identità.
IpRule	Regola di restrizione IP del servizio di ricerca.
NetworkRuleSet	Regole specifiche della rete che determinano la modalità di raggiungimento del servizio di ricerca.
PrivateEndpoint	Risorsa dell'endpoint privato dal provider Microsoft.Network.
PrivateEndpointConnection	Descrive una connessione endpoint privato esistente al servizio di ricerca.
PrivateEndpointConnectionProperties	Descrive le proprietà di una connessione endpoint privato esistente al servizio di ricerca.
PrivateLinkServiceConnectionProvisioningState	Stato di provisioning della connessione al servizio di collegamento privato. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto
PrivateLinkServiceConnectionState	Descrive lo stato corrente di una connessione del servizio collegamento privato esistente all'endpoint privato di Azure.
PrivateLinkServiceConnectionStatus	Stato della connessione al servizio di collegamento privato. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.
ProvisioningState	Stato dell'ultima operazione di provisioning eseguita nel servizio di ricerca. Il provisioning è uno stato intermedio che si verifica quando viene stabilita la capacità del servizio. Dopo la configurazione della capacità, provisioningState viene modificato in "succeeded" o "failed". Le applicazioni client possono eseguire il polling dello stato di provisioning (l'intervallo di polling consigliato è compreso tra 30 secondi e un minuto) usando l'operazione Get Search Service per verificare quando viene completata un'operazione. Se si usa il servizio gratuito, questo valore tende a tornare come "riuscito" direttamente nella chiamata a Crea servizio di ricerca. Ciò avviene perché il servizio gratuito utilizza una capacità che è già configurata.
PublicNetworkAccess	Questo valore può essere impostato su "abilitato" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.
SearchEncryptionComplianceStatus	Descrive se il servizio di ricerca è conforme o meno rispetto alla presenza di risorse non crittografate dal cliente. Se un servizio ha più di una risorsa non crittografata dal cliente e "Applicazione" è "abilitata", il servizio verrà contrassegnato come 'non Conforme'.
SearchEncryptionWithCmk	Descrive in che modo un servizio di ricerca deve applicare una o più risorse non crittografate dal cliente.
SearchSemanticSearch	Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di ricerca in determinate posizioni.
SearchService	Descrive un servizio di ricerca e il relativo stato corrente.
SearchServiceStatus	Stato del servizio di ricerca. I valori possibili includono: 'running': il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': viene effettuato il provisioning o la riduzione del servizio di ricerca. 'delete': il servizio di ricerca viene eliminato. "degradato": il servizio di ricerca è danneggiato. Ciò può verificarsi quando le unità di ricerca sottostanti non sono integre. Il servizio di ricerca è molto probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabled': il servizio di ricerca è disabilitato. In questo stato, il servizio rifiuterà tutte le richieste API. 'error': il servizio di ricerca si trova in uno stato di errore. Se il servizio si trova negli stati di errore, disabilitati o degradati, Microsoft sta esaminando attivamente il problema sottostante. I servizi dedicati in questi stati sono ancora addebitabili in base al numero di unità di ricerca di cui è stato effettuato il provisioning.
SharedPrivateLinkResource	Descrive un collegamento privato risorsa condivisa gestita dal servizio di ricerca.
SharedPrivateLinkResourceProperties	Descrive le proprietà di un collegamento privato risorsa condivisa esistente gestita dal servizio di ricerca.
SharedPrivateLinkResourceProvisioningState	Stato di provisioning della risorsa collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Non riuscita, Operazione riuscita o Incompleta.
SharedPrivateLinkResourceStatus	Stato della risorsa collegamento privato condiviso. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.
Sku	Definisce lo SKU di un servizio di ricerca, che determina i limiti di fatturazione e capacità.
SkuName	SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni.

AadAuthFailureMode

Descrive la risposta che l'API del piano dati di un servizio di ricerca invia per le richieste che non sono riuscite nell'autenticazione.

Nome	Tipo	Descrizione
http401WithBearerChallenge	string	Indica che le richieste di autenticazione non riuscite devono essere presentate con un codice di stato HTTP pari a 401 (non autorizzato) e presentare una sfida di orso.
http403	string	Indica che le richieste di autenticazione non riuscite devono essere presentate con un codice di stato HTTP pari a 403 (non consentito).

ApiKeyOnly

Indica che solo la chiave API può essere usata per l'autenticazione.

CloudError

Contiene informazioni su un errore dell'API.

Nome	Tipo	Descrizione
error	CloudErrorBody	Descrive un particolare errore dell'API con un codice di errore e un messaggio.

CloudErrorBody

Descrive un errore dell'API specifico con un codice di errore e un messaggio.

Nome	Tipo	Descrizione
code	string	Codice di errore che descrive la condizione di errore più precisamente di un codice di stato HTTP. Può essere usato per gestire casi di errore specifici a livello di codice.
details	CloudErrorBody[]	Contiene errori annidati correlati a questo errore.
message	string	Messaggio che descrive l'errore in dettaglio e fornisce informazioni di debug.
target	string	Destinazione dell'errore specifico, ad esempio il nome della proprietà in errore.

DataPlaneAadOrApiKeyAuthOption

Indica che è possibile usare la chiave API o un token di accesso da un tenant Microsoft Entra ID per l'autenticazione.

Nome	Tipo	Descrizione
aadAuthFailureMode	AadAuthFailureMode	Descrive la risposta che l'API del piano dati di un servizio di ricerca invia per le richieste che non sono riuscite nell'autenticazione.

DataPlaneAuthOptions

Definisce le opzioni per il modo in cui il servizio di ricerca autentica una richiesta del piano dati. Impossibile impostare se 'disableLocalAuth' è impostato su true.

Nome	Tipo	Descrizione
aadOrApiKey	DataPlaneAadOrApiKeyAuthOption	Indica che è possibile usare la chiave API o un token di accesso da un tenant Microsoft Entra ID per l'autenticazione.
apiKeyOnly	ApiKeyOnly	Indica che solo la chiave API può essere usata per l'autenticazione.

EncryptionWithCmk

Descrive un criterio che determina il modo in cui le risorse all'interno del servizio di ricerca devono essere crittografate con chiavi customer=managed.

Nome	Tipo	Descrizione
encryptionComplianceStatus	SearchEncryptionComplianceStatus	Descrive se il servizio di ricerca è conforme o meno rispetto alla presenza di risorse non crittografate dal cliente. Se un servizio ha più di una risorsa non crittografata dal cliente e "Applicazione" è "abilitata", il servizio verrà contrassegnato come 'non Conforme'.
enforcement	SearchEncryptionWithCmk	Descrive in che modo un servizio di ricerca deve applicare una o più risorse non crittografate dal cliente.

HostingMode

Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che sono molto più elevati rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.

Nome	Tipo	Descrizione
default	string	Il limite per il numero di indici è determinato dai limiti predefiniti per lo SKU.
highDensity	string	Solo l'applicazione per lo SKU Standard3, in cui il servizio di ricerca può avere fino a 1000 indici.

Identity

Identità per la risorsa.

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità assegnata dal sistema del servizio di ricerca.
tenantId	string	ID tenant dell'identità assegnata dal sistema del servizio di ricerca.
type	IdentityType	Tipo di identità.

IdentityType

Tipo di identità.

Nome	Tipo	Descrizione
None	string
SystemAssigned	string

IpRule

Regola di restrizione IP del servizio di ricerca.

Nome	Tipo	Descrizione
value	string	Valore corrispondente a un singolo indirizzo IPv4 (ad esempio, 123.1.2.3) o un intervallo IP in formato CIDR (ad esempio, 123.1.2.3/24) da consentire.

NetworkRuleSet

Regole specifiche della rete che determinano la modalità di raggiungimento del servizio di ricerca.

Nome	Tipo	Descrizione
ipRules	IpRule[]	Elenco delle regole di restrizione IP usate per un firewall IP. Tutti gli INDIRIZZI IP che non corrispondono alle regole vengono bloccati dal firewall. Queste regole vengono applicate solo quando il 'publicNetworkAccess' del servizio di ricerca è 'abilitato'.

PrivateEndpoint

Risorsa dell'endpoint privato dal provider Microsoft.Network.

Nome	Tipo	Descrizione
id	string	ID risorsa della risorsa dell'endpoint privato dal provider Microsoft.Network.

PrivateEndpointConnection

Descrive una connessione endpoint privato esistente al servizio di ricerca.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nome della risorsa.
properties	PrivateEndpointConnectionProperties	Descrive le proprietà di una connessione dell'endpoint privato esistente al servizio di ricerca.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProperties

Descrive le proprietà di una connessione endpoint privato esistente al servizio di ricerca.

Nome	Tipo	Descrizione
groupId	string	L'ID gruppo del provider della risorsa per la connessione al servizio collegamento privato è per.
privateEndpoint	PrivateEndpoint	Risorsa dell'endpoint privato dal provider Microsoft.Network.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Descrive lo stato corrente di una connessione del servizio collegamento privato esistente all'endpoint privato di Azure.
provisioningState	PrivateLinkServiceConnectionProvisioningState	Stato di provisioning della connessione al servizio di collegamento privato. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto

PrivateLinkServiceConnectionProvisioningState

Stato di provisioning della connessione al servizio di collegamento privato. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto

Nome	Tipo	Descrizione
Canceled	string	La richiesta di provisioning per la risorsa di connessione al servizio di collegamento privato è stata annullata
Deleting	string	La connessione al servizio di collegamento privato è in corso di eliminazione.
Failed	string	Impossibile eseguire il provisioning o l'eliminazione della connessione al servizio collegamento privato.
Incomplete	string	La richiesta di provisioning per la risorsa di connessione al servizio collegamento privato è stata accettata, ma il processo di creazione non è ancora iniziato.
Succeeded	string	Il provisioning della connessione al servizio collegamento privato è stato completato ed è pronto per l'approvazione.
Updating	string	La connessione al servizio collegamento privato è in corso di creazione insieme ad altre risorse per renderla completamente funzionale.

PrivateLinkServiceConnectionState

Descrive lo stato corrente di una connessione del servizio collegamento privato esistente all'endpoint privato di Azure.

Nome	Tipo	Valore predefinito	Descrizione
actionsRequired	string	None	Descrizione di eventuali azioni aggiuntive che possono essere necessarie.
description	string		Descrizione per lo stato di connessione del servizio di collegamento privato.
status	PrivateLinkServiceConnectionStatus		Stato della connessione al servizio collegamento privato. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.

PrivateLinkServiceConnectionStatus

Stato della connessione al servizio di collegamento privato. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.

Nome	Tipo	Descrizione
Approved	string	La connessione all'endpoint privato è approvata ed è pronta per l'uso.
Disconnected	string	La connessione all'endpoint privato è stata rimossa dal servizio.
Pending	string	La connessione all'endpoint privato è stata creata ed è in attesa di approvazione.
Rejected	string	La connessione all'endpoint privato è stata rifiutata e non può essere usata.

ProvisioningState

Stato dell'ultima operazione di provisioning eseguita nel servizio di ricerca. Il provisioning è uno stato intermedio che si verifica quando viene stabilita la capacità del servizio. Dopo la configurazione della capacità, provisioningState viene modificato in "succeeded" o "failed". Le applicazioni client possono eseguire il polling dello stato di provisioning (l'intervallo di polling consigliato è compreso tra 30 secondi e un minuto) usando l'operazione Get Search Service per verificare quando viene completata un'operazione. Se si usa il servizio gratuito, questo valore tende a tornare come "riuscito" direttamente nella chiamata a Crea servizio di ricerca. Ciò avviene perché il servizio gratuito utilizza una capacità che è già configurata.

Nome	Tipo	Descrizione
failed	string	L'ultima operazione di provisioning non è riuscita.
provisioning	string	Il servizio di ricerca viene eseguito il provisioning o la scalabilità orizzontale o in basso.
succeeded	string	L'ultima operazione di provisioning è stata completata correttamente.

PublicNetworkAccess

Questo valore può essere impostato su "abilitato" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.

Nome	Tipo	Descrizione
disabled	string
enabled	string

SearchEncryptionComplianceStatus

Descrive se il servizio di ricerca è conforme o meno rispetto alla presenza di risorse non crittografate dal cliente. Se un servizio ha più di una risorsa non crittografata dal cliente e "Applicazione" è "abilitata", il servizio verrà contrassegnato come 'non Conforme'.

Nome	Tipo	Descrizione
Compliant	string	Indica che il servizio di ricerca è conforme, poiché il numero di risorse non crittografate dal cliente è zero o l'applicazione è disabilitata.
NonCompliant	string	Indica che il servizio di ricerca ha più risorse non crittografate dal cliente.

SearchEncryptionWithCmk

Descrive in che modo un servizio di ricerca deve applicare una o più risorse non crittografate dal cliente.

Nome	Tipo	Descrizione
Disabled	string	Nessuna applicazione verrà eseguita e il servizio di ricerca può avere risorse non crittografate dal cliente.
Enabled	string	servizio di ricerca verrà contrassegnato come non conforme se sono presenti una o più risorse non crittografate dal cliente.
Unspecified	string	I criteri di imposizione non vengono specificati in modo esplicito, con il comportamento uguale a se fosse impostato su "Disabilitato".

SearchSemanticSearch

Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di ricerca in determinate posizioni.

Nome	Tipo	Descrizione
disabled	string	Indica che la classificazione semantica è disabilitata per il servizio di ricerca.
free	string	Abilita la classificazione semantica in un servizio di ricerca e indica che deve essere usata entro i limiti del livello gratuito. Questo limiterebbe il volume delle richieste di classificazione semantica e viene offerto senza alcun costo aggiuntivo. Si tratta dell'impostazione predefinita per i nuovi servizi di ricerca con provisioning.
standard	string	Abilita la classificazione semantica in un servizio di ricerca come funzionalità fatturabile, con una velocità effettiva e un volume superiore di richieste di classificazione semantica.

SearchService

Descrive un servizio di ricerca e il relativo stato corrente.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identità della risorsa.
location	string		Posizione geografica in cui risiede la risorsa
name	string		nome della risorsa.
properties.authOptions	DataPlaneAuthOptions		Definisce le opzioni per il modo in cui l'API del piano dati di un servizio di ricerca autentica le richieste. Questa impostazione non può essere impostata se 'disableLocalAuth' è impostato su true.
properties.disableLocalAuth	boolean		Se impostato su true, le chiamate al servizio di ricerca non saranno autorizzate a usare le chiavi API per l'autenticazione. Questa impostazione non può essere impostata su true se sono definiti "dataPlaneAuthOptions".
properties.encryptionWithCmk	EncryptionWithCmk		Specifica i criteri relativi alla crittografia delle risorse (ad esempio gli indici) usando le chiavi del customer manager all'interno di un servizio di ricerca.
properties.hostingMode	HostingMode	default	Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che sono molto più elevati rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.
properties.networkRuleSet	NetworkRuleSet		Regole specifiche della rete che determinano la modalità di raggiungimento del servizio di ricerca.
properties.partitionCount	integer	1	Numero di partizioni nel servizio di ricerca; se specificato, può essere 1, 2, 3, 4, 6 o 12. I valori maggiori di 1 sono validi solo per gli SKU standard. Per i servizi 'standard3' con hostingMode impostato su 'highDensity', i valori consentiti sono compresi tra 1 e 3.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Elenco di connessioni endpoint privato al servizio di ricerca.
properties.provisioningState	ProvisioningState		Stato dell'ultima operazione di provisioning eseguita nel servizio di ricerca. Il provisioning è uno stato intermedio che si verifica quando viene stabilita la capacità del servizio. Dopo la configurazione della capacità, provisioningState viene modificato in "succeeded" o "failed". Le applicazioni client possono eseguire il polling dello stato di provisioning (l'intervallo di polling consigliato è compreso tra 30 secondi e un minuto) usando l'operazione Get Search Service per verificare quando viene completata un'operazione. Se si usa il servizio gratuito, questo valore tende a tornare come "riuscito" direttamente nella chiamata a Crea servizio di ricerca. Ciò avviene perché il servizio gratuito utilizza una capacità che è già configurata.
properties.publicNetworkAccess	PublicNetworkAccess	enabled	Questo valore può essere impostato su "abilitato" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.
properties.replicaCount	integer	1	Numero di repliche nel servizio di ricerca. Se specificato, deve essere un valore compreso tra 1 e 12 inclusi per GLI SKU standard o compreso tra 1 e 3 inclusi per lo SKU basic.
properties.semanticSearch	SearchSemanticSearch		Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di ricerca in determinate posizioni.
properties.sharedPrivateLinkResources	SharedPrivateLinkResource[]		Elenco di risorse di collegamento privato condiviso gestite dal servizio di ricerca.
properties.status	SearchServiceStatus		Stato del servizio di ricerca. I valori possibili includono: 'running': il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': viene effettuato il provisioning o la riduzione del servizio di ricerca. 'delete': il servizio di ricerca viene eliminato. "degradato": il servizio di ricerca è danneggiato. Ciò può verificarsi quando le unità di ricerca sottostanti non sono integre. Il servizio di ricerca è molto probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabled': il servizio di ricerca è disabilitato. In questo stato, il servizio rifiuterà tutte le richieste API. 'error': il servizio di ricerca si trova in uno stato di errore. Se il servizio si trova negli stati di errore, disabilitati o degradati, Microsoft sta esaminando attivamente il problema sottostante. I servizi dedicati in questi stati sono ancora addebitabili in base al numero di unità di ricerca di cui è stato effettuato il provisioning.
properties.statusDetails	string		Dettagli dello stato del servizio di ricerca.
sku	Sku		SKU del servizio di ricerca, che determina i limiti di fatturazione e capacità. Questa proprietà è necessaria quando si crea un nuovo servizio di ricerca.
tags	object		Tag delle risorse.
type	string		Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SearchServiceStatus

Stato del servizio di ricerca. I valori possibili includono: 'running': il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': viene effettuato il provisioning o la riduzione del servizio di ricerca. 'delete': il servizio di ricerca viene eliminato. "degradato": il servizio di ricerca è danneggiato. Ciò può verificarsi quando le unità di ricerca sottostanti non sono integre. Il servizio di ricerca è molto probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabled': il servizio di ricerca è disabilitato. In questo stato, il servizio rifiuterà tutte le richieste API. 'error': il servizio di ricerca si trova in uno stato di errore. Se il servizio si trova negli stati di errore, disabilitati o degradati, Microsoft sta esaminando attivamente il problema sottostante. I servizi dedicati in questi stati sono ancora addebitabili in base al numero di unità di ricerca di cui è stato effettuato il provisioning.

Nome	Tipo	Descrizione
degraded	string	Il servizio di ricerca è danneggiato perché le unità di ricerca sottostanti non sono integre.
deleting	string	Il servizio di ricerca viene eliminato.
disabled	string	Il servizio di ricerca è disabilitato e tutte le richieste API verranno rifiutate.
error	string	Lo stato del servizio di ricerca è in stato di errore, che indica un errore durante il provisioning o l'eliminazione.
provisioning	string	È in corso il provisioning del servizio di ricerca o l'aumento o la riduzione delle prestazioni.
running	string	Il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning.

SharedPrivateLinkResource

Descrive un collegamento privato risorsa condivisa gestita dal servizio di ricerca.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nome della risorsa.
properties	SharedPrivateLinkResourceProperties	Descrive le proprietà di una risorsa condivisa collegamento privato gestita dal servizio di ricerca.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Descrive le proprietà di un collegamento privato risorsa condivisa esistente gestita dal servizio di ricerca.

Nome	Tipo	Descrizione
groupId	string	L'ID gruppo del provider della risorsa di collegamento privato condiviso è per.
privateLinkResourceId	string	L'ID risorsa della risorsa per la risorsa di collegamento privato condiviso è per.
provisioningState	SharedPrivateLinkResourceProvisioningState	Stato di provisioning della risorsa di collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto.
requestMessage	string	Messaggio di richiesta per richiedere l'approvazione della risorsa di collegamento privato condiviso.
resourceRegion	string	facoltativo. Può essere usato per specificare la posizione di Azure Resource Manager della risorsa a cui creare un collegamento privato condiviso. Questa operazione è necessaria solo per queste risorse la cui configurazione DNS è a livello di area (ad esempio servizio Azure Kubernetes).
status	SharedPrivateLinkResourceStatus	Stato della risorsa di collegamento privato condiviso. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.

SharedPrivateLinkResourceProvisioningState

Stato di provisioning della risorsa collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Non riuscita, Operazione riuscita o Incompleta.

Nome	Tipo	Descrizione
Deleting	string
Failed	string
Incomplete	string
Succeeded	string
Updating	string

SharedPrivateLinkResourceStatus

Stato della risorsa collegamento privato condiviso. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.

Nome	Tipo	Descrizione
Approved	string
Disconnected	string
Pending	string
Rejected	string

Sku

Definisce lo SKU di un servizio di ricerca, che determina i limiti di fatturazione e capacità.

Nome	Tipo	Descrizione
name	SkuName	SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni".

SkuName

SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni.

Nome	Tipo	Descrizione
basic	string	Livello fatturabile per un servizio dedicato con un massimo di 3 repliche.
free	string	Livello gratuito, senza garanzie di contratto di servizio e un subset delle funzionalità offerte su livelli fatturabili.
standard	string	Livello fatturabile per un servizio dedicato con un massimo di 12 partizioni e 12 repliche.
standard2	string	Simile a "standard", ma con una maggiore capacità per ogni unità di ricerca.
standard3	string	L'offerta Standard più grande con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity').
storage_optimized_l1	string	Livello fatturabile per un servizio dedicato che supporta 1 TB per partizione, fino a 12 partizioni.
storage_optimized_l2	string	Livello fatturabile per un servizio dedicato che supporta 2 TB per partizione, fino a 12 partizioni.