Services - List By Subscription

Servizio:

Search Management

Versione API:

2023-11-01

Ottiene un elenco di tutti i servizi di ricerca nella sottoscrizione specificata.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure. È possibile ottenere questo valore dall'API di Azure Resource Manager, dagli strumenti della 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, questa operazione verrà inclusa nelle informazioni di risposta come modo per tenere traccia della richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	SearchServiceListResult	Operazione completata. La risposta contiene l'elenco di tutte le definizioni del servizio di ricerca per la sottoscrizione specificata.
Other Status Codes	CloudError	Si è verificato un errore imprevisto durante l'operazione.

Sicurezza

azure_auth

Microsoft Entra ID flusso di autorizzazione OAuth2.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

SearchListServicesBySubscription

Esempio di richiesta

HTTP

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

Java

/**
 * Samples for Services List.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/
     * SearchListServicesBySubscription.json
     */
    /**
     * Sample code: SearchListServicesBySubscription.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void searchListServicesBySubscription(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.searchServices().manager().serviceClient().getServices().list(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_list_services_by_subscription.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.list_by_subscription()
    for item in response:
        print(item)


# x-ms-original-file: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchListServicesBySubscription.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/SearchListServicesBySubscription.json
func ExampleServicesClient_NewListBySubscriptionPager() {
	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)
	}
	pager := clientFactory.NewServicesClient().NewListBySubscriptionPager(&armsearch.SearchManagementRequestOptions{ClientRequestID: nil}, nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.ServiceListResult = armsearch.ServiceListResult{
		// 	Value: []*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),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("mysearchservice2"),
		// 			Type: to.Ptr("Microsoft.Search/searchServices"),
		// 			ID: to.Ptr("/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Search/searchServices/mysearchservice2"),
		// 			Location: to.Ptr("eastus"),
		// 			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](1),
		// 				Status: to.Ptr(armsearch.SearchServiceStatusRunning),
		// 				StatusDetails: to.Ptr(""),
		// 			},
		// 			SKU: &armsearch.SKU{
		// 				Name: to.Ptr(armsearch.SKUNameBasic),
		// 			},
		// 	}},
		// }
	}
}

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 a list of all Search services in the given subscription.
 *
 * @summary Gets a list of all Search services in the given subscription.
 * x-ms-original-file: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchListServicesBySubscription.json
 */
async function searchListServicesBySubscription() {
  const subscriptionId = process.env["SEARCH_SUBSCRIPTION_ID"] || "subid";
  const credential = new DefaultAzureCredential();
  const client = new SearchManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.services.listBySubscription()) {
    resArray.push(item);
  }
  console.log(resArray);
}

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/SearchListServicesBySubscription.json
// this example is just showing the usage of "Services_ListBySubscription" 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 SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "subid";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
await foreach (SearchServiceResource item in subscriptionResource.GetSearchServicesAsync())
{
    // the variable item 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 = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

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

Risposta di esempio

Codice di stato:

200

{
  "value": [
    {
      "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": []
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg2/providers/Microsoft.Search/searchServices/mysearchservice2",
      "name": "mysearchservice2",
      "location": "eastus",
      "type": "Microsoft.Search/searchServices",
      "tags": {
        "app-name": "My e-commerce app"
      },
      "sku": {
        "name": "basic"
      },
      "properties": {
        "replicaCount": 1,
        "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 hanno avuto esito negativo 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. Questa impostazione non può essere impostata se 'disableLocalAuth' è impostato su true.
EncryptionWithCmk	Descrive un criterio che determina la modalità di crittografia delle risorse all'interno del servizio di ricerca con chiavi gestite da 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 superiori agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "predefinito" o "highDensity". Per tutti gli altri SKU, questo valore deve essere "predefinito".
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 come è possibile raggiungere il servizio di ricerca.
PrivateEndpoint	Risorsa 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 al servizio collegamento privato esistente all'endpoint privato di Azure.
PrivateLinkServiceConnectionStatus	Stato della connessione al servizio collegamento privato. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.
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 sulle risorse e i modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private sarebbero 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 "Imposizione" è "abilitato", il servizio verrà contrassegnato come "non Conforme".
SearchEncryptionWithCmk	Descrive in che modo un servizio di ricerca deve applicare la presenza di 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 lo stato corrente.
SearchServiceListResult	Risposta contenente un elenco di servizi di ricerca.
SearchServiceStatus	Stato del servizio di ricerca. I valori possibili includono: "in esecuzione": il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': il servizio di ricerca viene effettuato il provisioning o il ridimensionamento o la riduzione. '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 è probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabilitato': 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 attivamente esaminando 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 una risorsa di collegamento privato condivisa gestita dal servizio di ricerca.
SharedPrivateLinkResourceProperties	Descrive le proprietà di una risorsa di collegamento privato condivisa esistente gestita dal servizio di ricerca.
SharedPrivateLinkResourceProvisioningState	Stato di provisioning della risorsa di collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto.
SharedPrivateLinkResourceStatus	Stato della risorsa di collegamento privato condiviso. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.
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 hanno avuto esito negativo nell'autenticazione.

Nome	Tipo	Descrizione
http401WithBearerChallenge	string	Indica che le richieste che non hanno superato l'autenticazione devono essere presentate con un codice di stato HTTP 401 (non autorizzato) e presentano una Richiesta di connessione.
http403	string	Indica che le richieste di autenticazione non riuscite devono essere presentate con un codice di stato HTTP 403 (Accesso negato).

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 errore dell'API specifico 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 hanno avuto esito negativo nell'autenticazione.

DataPlaneAuthOptions

Definisce le opzioni per il modo in cui il servizio di ricerca autentica una richiesta del piano dati. Questa impostazione non può essere impostata 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 la modalità di crittografia delle risorse all'interno del servizio di ricerca con chiavi gestite da 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 "Imposizione" è "abilitato", il servizio verrà contrassegnato come "non Conforme".
enforcement	SearchEncryptionWithCmk	Descrive in che modo un servizio di ricerca deve applicare la presenza di 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 superiori agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "predefinito" o "highDensity". Per tutti gli altri SKU, questo valore deve essere "predefinito".

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 a un intervallo IP in formato CIDR (ad esempio, 123.1.2.3/24) da consentire.

NetworkRuleSet

Regole specifiche della rete che determinano come è possibile raggiungere il servizio di ricerca.

Nome	Tipo	Descrizione
ipRules	IpRule[]	Elenco di regole di restrizione IP usate per un firewall IP. Gli indirizzi IP che non corrispondono alle regole vengono bloccati dal firewall. Queste regole vengono applicate solo quando "publicNetworkAccess" del servizio di ricerca è "abilitato".

PrivateEndpoint

Risorsa endpoint privato dal provider Microsoft.Network.

Nome	Tipo	Descrizione
id	string	ID risorsa della risorsa dell'endpoint privato del 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. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nome della risorsa.
properties	PrivateEndpointConnectionProperties	Descrive le proprietà di una connessione di 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 di collegamento privato è per.
privateEndpoint	PrivateEndpoint	Risorsa endpoint privato dal provider Microsoft.Network.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Descrive lo stato corrente di una connessione al 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, Non riuscita, Operazione riuscita o Incompleta

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 del servizio collegamento privato è stata annullata
Deleting	string	La connessione al servizio 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	La connessione al servizio collegamento privato ha completato il provisioning ed è pronta 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 al 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 dello stato di connessione del servizio di collegamento privato.
status	PrivateLinkServiceConnectionStatus		Stato della connessione al servizio di collegamento privato. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.

PrivateLinkServiceConnectionStatus

Stato della connessione al servizio collegamento privato. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.

Nome	Tipo	Descrizione
Approved	string	La connessione dell'endpoint privato è approvata ed è pronta per l'uso.
Disconnected	string	La connessione dell'endpoint privato è stata rimossa dal servizio.
Pending	string	La connessione dell'endpoint privato è stata creata ed è in attesa di approvazione.
Rejected	string	La connessione dell'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	È in corso il provisioning del servizio di ricerca o l'aumento o la riduzione delle prestazioni.
succeeded	string	L'ultima operazione di provisioning è stata completata correttamente.

PublicNetworkAccess

Questo valore può essere impostato su "abilitato" per evitare modifiche di rilievo sulle risorse e i modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private sarebbero 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 "Imposizione" è "abilitato", il servizio verrà contrassegnato come "non Conforme".

Nome	Tipo	Descrizione
Compliant	string	Indica che il servizio di ricerca è conforme perché il numero di risorse non crittografate dal cliente è zero o l'imposizione è disabilitata.
NonCompliant	string	Indica che il servizio di ricerca ha più di una risorsa non crittografata dal cliente.

SearchEncryptionWithCmk

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

Nome	Tipo	Descrizione
Disabled	string	Non verrà eseguita alcuna imposizione 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 che corrisponde 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 di richieste di classificazione semantica e viene offerto senza costi aggiuntivi. Si tratta dell'impostazione predefinita per i servizi di ricerca di cui è stato appena effettuato il provisioning.
standard	string	Abilita la classificazione semantica in un servizio di ricerca come funzionalità fatturabile, con una velocità effettiva e un volume più elevato di richieste di classificazione semantica.

SearchService

Descrive un servizio di ricerca e lo stato corrente.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identità della risorsa.
location	string		Posizione geografica in cui vive 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. Impossibile impostare se 'disableLocalAuth' è impostato su true.
properties.disableLocalAuth	boolean		Se impostato su true, le chiamate al servizio di ricerca non saranno consentite per l'uso delle chiavi API per l'autenticazione. Impossibile impostare su true se sono definiti 'dataPlaneAuthOptions'.
properties.encryptionWithCmk	EncryptionWithCmk		Specifica tutti 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 superiori agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "predefinito" o "highDensity". Per tutti gli altri SKU, questo valore deve essere "predefinito".
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 SKU standard. Per i servizi 'standard3' con hostingMode impostato su 'highDensity', i valori consentiti sono compresi tra 1 e 3.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Elenco delle connessioni endpoint private 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 aver configurato la capacità, provisioningState cambia in "riuscito" o "non riuscito". 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 sulle risorse e i modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private sarebbero 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 SKU standard o tra 1 e 3 inclusi per SKU di base.
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 delle risorse di collegamento privato condivise gestite dal servizio di ricerca.
properties.status	SearchServiceStatus		Stato del servizio di ricerca. I valori possibili includono: "in esecuzione": il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': il servizio di ricerca viene effettuato il provisioning o il ridimensionamento o la riduzione. '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 è probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabilitato': 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 attivamente esaminando 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 di risorse.
type	string		Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SearchServiceListResult

Risposta contenente un elenco di servizi di ricerca.

Nome	Tipo	Descrizione
nextLink	string	URL della richiesta che può essere usato per eseguire query sulla pagina successiva dei servizi di ricerca. Restituito quando il numero totale di servizi di ricerca richiesti supera le dimensioni massime della pagina.
value	SearchService[]	Elenco dei servizi di ricerca.

SearchServiceStatus

Stato del servizio di ricerca. I valori possibili includono: "in esecuzione": il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning. 'provisioning': il servizio di ricerca viene effettuato il provisioning o il ridimensionamento o la riduzione. '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 è probabilmente operativo, ma le prestazioni potrebbero essere lente e alcune richieste potrebbero essere eliminate. 'disabilitato': 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 attivamente esaminando 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	Il servizio di ricerca viene eseguito il provisioning o la scalabilità orizzontale o in basso.
running	string	Il servizio di ricerca è in esecuzione e non sono in corso operazioni di provisioning.

SharedPrivateLinkResource

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

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

SharedPrivateLinkResourceProperties

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

Nome	Tipo	Descrizione
groupId	string	L'ID gruppo del provider della risorsa per la risorsa di collegamento privato condiviso è per.
privateLinkResourceId	string	L'ID risorsa della risorsa a cui è destinata la risorsa collegamento privato condiviso.
provisioningState	SharedPrivateLinkResourceProvisioningState	Stato di provisioning della risorsa collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Non riuscita, Operazione riuscita o Incompleta.
requestMessage	string	Messaggio di richiesta per richiedere l'approvazione della risorsa di collegamento privato condiviso.
resourceRegion	string	facoltativo. Può essere usato per specificare il percorso di azure Resource Manager della risorsa in cui deve essere creato un collegamento privato condiviso. Questa operazione è necessaria solo per le risorse la cui configurazione DNS è a livello di area, ad esempio servizio Azure Kubernetes.
status	SharedPrivateLinkResourceStatus	Stato della risorsa collegamento privato condiviso. I valori validi sono In sospeso, Approvato, Rifiutato o Disconnesso.

SharedPrivateLinkResourceProvisioningState

Stato di provisioning della risorsa di collegamento privato condiviso. I valori validi sono Aggiornamento, Eliminazione, Errore, Esito positivo o Incompleto.

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

SharedPrivateLinkResourceStatus

Stato della risorsa di collegamento privato condiviso. I valori validi sono in sospeso, approvati, rifiutati o disconnessi.

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 nei 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	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	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.