Services - Get

Servicio:

Search Management

Versión de la API:

2023-11-01

Obtiene el servicio de búsqueda con el nombre especificado en el grupo de recursos especificado.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos dentro de la suscripción actual. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
searchServiceName	path	True	string	Nombre del servicio de búsqueda asociado al grupo de recursos especificado.
subscriptionId	path	True	string	Identificador único de una suscripción de Microsoft Azure. Puede obtener este valor de la API de Azure Resource Manager, las herramientas de línea de comandos o el portal.
api-version	query	True	string	La versión de API que se va a usar para cada solicitud.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
x-ms-client-request-id		string uuid	Un valor GUID generado por el cliente que identifica esta solicitud. Si se especifica, se incluirá en la información de respuesta como una manera de realizar un seguimiento de la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	SearchService	La definición del servicio de búsqueda se recuperó correctamente y se encuentra en la respuesta. Si va a sondear la finalización de una operación de aprovisionamiento o escalado, puede comprobar su estado a través de la propiedad provisioningState.
Other Status Codes	CloudError	HTTP 404 (no encontrado): no se encontró la suscripción, el grupo de recursos o el nombre del servicio de búsqueda.

Seguridad

azure_auth

Microsoft Entra ID flujo de autorización de OAuth2.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

SearchGetService

Solicitud de ejemplo

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

Respuesta de muestra

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": []
  }
}

Definiciones

Nombre	Description
AadAuthFailureMode	Describe qué respuesta enviaría la API del plano de datos de un servicio de búsqueda para las solicitudes con errores de autenticación.
ApiKeyOnly	Indica que solo se puede usar la clave de API para la autenticación.
CloudError	Contiene información sobre un error de API.
CloudErrorBody	Describe un error de API determinado con un código de error y un mensaje.
DataPlaneAadOrApiKeyAuthOption	Indica que se puede usar la clave de API o un token de acceso de un inquilino de Microsoft Entra ID para la autenticación.
DataPlaneAuthOptions	Define las opciones de cómo el servicio de búsqueda autentica una solicitud de plano de datos. No se puede establecer si "disableLocalAuth" está establecido en true.
EncryptionWithCmk	Describe una directiva que determina cómo se cifran los recursos del servicio de búsqueda con claves administradas por customer=managed.
HostingMode	Solo se aplica a la SKU estándar3. Puede establecer esta propiedad para habilitar hasta 3 particiones de alta densidad que permitan hasta 1000 índices, que es mucho mayor que los índices máximos permitidos para cualquier otra SKU. Para la SKU standard3, el valor es "default" o "highDensity". Para todas las demás SKU, este valor debe ser "default".
Identity	Identidad del recurso.
IdentityType	Tipo de identidad.
IpRule	Regla de restricción de IP del servicio de búsqueda.
NetworkRuleSet	Reglas específicas de red que determinan cómo se puede acceder al servicio de búsqueda.
PrivateEndpoint	Recurso de punto de conexión privado del proveedor Microsoft.Network.
PrivateEndpointConnection	Describe una conexión de punto de conexión privado existente al servicio de búsqueda.
PrivateEndpointConnectionProperties	Describe las propiedades de una conexión de punto de conexión privado existente al servicio de búsqueda.
PrivateLinkServiceConnectionProvisioningState	Estado de aprovisionamiento de la conexión del servicio Private Link. Los valores válidos son Actualización, Eliminación, Error, Correcto o Incompleto
PrivateLinkServiceConnectionState	Describe el estado actual de una conexión de servicio Private Link existente al punto de conexión privado de Azure.
PrivateLinkServiceConnectionStatus	Estado de la conexión del servicio Private Link. Los valores válidos son Pendiente, Aprobado, Rechazado o Desconectado.
ProvisioningState	Estado de la última operación de aprovisionamiento realizada en el servicio de búsqueda. El aprovisionamiento es un estado intermedio que se produce cuando se está estableciendo la capacidad de servicio. Una vez configurada la capacidad, provisioningState cambia a "succeeded" o "failed". Las aplicaciones cliente pueden sondear el estado de aprovisionamiento (el intervalo de sondeo recomendado es de 30 segundos a un minuto) mediante la operación Get Search Service para ver cuándo se completa una operación. Si usa el servicio gratuito, este valor tiende a volver como "correcto" directamente en la llamada a Crear servicio de búsqueda. Esto ocurre porque el servicio gratuito usa una capacidad que ya está configurada.
PublicNetworkAccess	Este valor se puede establecer en "habilitado" para evitar cambios importantes en los recursos y plantillas de cliente existentes. Si se establece en "deshabilitado", no se permite el tráfico a través de la interfaz pública y las conexiones de punto de conexión privado serían el método de acceso exclusivo.
SearchEncryptionComplianceStatus	Describe si el servicio de búsqueda es compatible o no con respecto a tener recursos no cifrados por el cliente. Si un servicio tiene más de un recurso no cifrado por el cliente y "Cumplimiento" está "habilitado", el servicio se marcará como "nonCompliant".
SearchEncryptionWithCmk	Describe cómo un servicio de búsqueda debe aplicar tener uno o varios recursos no cifrados por el cliente.
SearchSemanticSearch	Establece las opciones que controlan la disponibilidad de la búsqueda semántica. Esta configuración solo es posible para determinadas SKU de búsqueda en determinadas ubicaciones.
SearchService	Describe un servicio de búsqueda y su estado actual.
SearchServiceStatus	Estado del servicio de búsqueda. Entre los valores posibles se incluyen: "running": el servicio de búsqueda se está ejecutando y no hay ninguna operación de aprovisionamiento en curso. "aprovisionamiento": el servicio de búsqueda se está aprovisionando o escalando verticalmente o verticalmente. 'eliminar': se está eliminando el servicio de búsqueda. 'degradado': el servicio de búsqueda está degradado. Esto puede ocurrir cuando las unidades de búsqueda subyacentes no están en buen estado. El servicio de búsqueda es más probable que esté operativo, pero el rendimiento puede ser lento y es posible que se quiten algunas solicitudes. 'disabled': el servicio de búsqueda está deshabilitado. En este estado, el servicio rechazará todas las solicitudes de API. 'error': el servicio de búsqueda está en estado de error. Si el servicio está en los estados degradados, deshabilitados o de error, Microsoft está investigando activamente el problema subyacente. En estos estados, los servicios dedicados son todavía facturables en función del número de unidades de búsqueda aprovisionado.
SharedPrivateLinkResource	Describe un recurso de Private Link compartido administrado por el servicio de búsqueda.
SharedPrivateLinkResourceProperties	Describe las propiedades de un recurso compartido de Private Link existente administrado por el servicio de búsqueda.
SharedPrivateLinkResourceProvisioningState	Estado de aprovisionamiento del recurso de vínculo privado compartido. Los valores válidos son Actualizar, Eliminar, Error, Correcto o Incompleto.
SharedPrivateLinkResourceStatus	Estado del recurso de vínculo privado compartido. Los valores válidos son Pendiente, Aprobado, Rechazado o Desconectado.
Sku	Define la SKU de un servicio de búsqueda, que determina la tasa de facturación y los límites de capacidad.
SkuName	SKU del servicio de búsqueda. Los valores válidos incluyen: "gratis": servicio compartido. 'basic': servicio dedicado con hasta 3 réplicas. 'estándar': servicio dedicado con hasta 12 particiones y 12 réplicas. 'standard2': similar al estándar, pero con más capacidad por unidad de búsqueda. 'standard3': la oferta estándar más grande con hasta 12 particiones y 12 réplicas (o hasta 3 particiones con más índices si también establece la propiedad hostingMode en 'highDensity'). 'storage_optimized_l1': admite 1 TB por partición, hasta 12 particiones. "storage_optimized_l2": admite 2 TB por partición, hasta 12 particiones".

AadAuthFailureMode

Describe qué respuesta enviaría la API del plano de datos de un servicio de búsqueda para las solicitudes con errores de autenticación.

Nombre	Tipo	Description
http401WithBearerChallenge	string	Indica que las solicitudes con errores de autenticación deben presentarse con un código de estado HTTP de 401 (no autorizado) y presentar un desafío de portador.
http403	string	Indica que las solicitudes con errores de autenticación deben presentarse con un código de estado HTTP de 403 (Prohibido).

ApiKeyOnly

Indica que solo se puede usar la clave de API para la autenticación.

CloudError

Contiene información sobre un error de API.

Nombre	Tipo	Description
error	CloudErrorBody	Describe un error de API determinado con un código de error y un mensaje.

CloudErrorBody

Describe un error de API determinado con un código de error y un mensaje.

Nombre	Tipo	Description
code	string	Código de error que describe la condición de error de forma más precisa que un código de estado HTTP. Se puede usar para controlar mediante programación casos de error específicos.
details	CloudErrorBody[]	Contiene errores anidados relacionados con este error.
message	string	Mensaje que describe el error en detalle y proporciona información de depuración.
target	string	Destino del error determinado (por ejemplo, el nombre de la propiedad en error).

DataPlaneAadOrApiKeyAuthOption

Indica que se puede usar la clave de API o un token de acceso de un inquilino de Microsoft Entra ID para la autenticación.

Nombre	Tipo	Description
aadAuthFailureMode	AadAuthFailureMode	Describe qué respuesta enviaría la API del plano de datos de un servicio de búsqueda para las solicitudes con errores de autenticación.

DataPlaneAuthOptions

Define las opciones de cómo el servicio de búsqueda autentica una solicitud de plano de datos. No se puede establecer si "disableLocalAuth" está establecido en true.

Nombre	Tipo	Description
aadOrApiKey	DataPlaneAadOrApiKeyAuthOption	Indica que se puede usar la clave de API o un token de acceso de un inquilino de Microsoft Entra ID para la autenticación.
apiKeyOnly	ApiKeyOnly	Indica que solo se puede usar la clave de API para la autenticación.

EncryptionWithCmk

Describe una directiva que determina cómo se cifran los recursos del servicio de búsqueda con claves administradas por customer=managed.

Nombre	Tipo	Description
encryptionComplianceStatus	SearchEncryptionComplianceStatus	Describe si el servicio de búsqueda es compatible o no con respecto a tener recursos no cifrados por el cliente. Si un servicio tiene más de un recurso no cifrado por el cliente y "Cumplimiento" está "habilitado", el servicio se marcará como "nonCompliant".
enforcement	SearchEncryptionWithCmk	Describe cómo un servicio de búsqueda debe aplicar tener uno o varios recursos no cifrados por el cliente.

HostingMode

Solo se aplica a la SKU estándar3. Puede establecer esta propiedad para habilitar hasta 3 particiones de alta densidad que permitan hasta 1000 índices, que es mucho mayor que los índices máximos permitidos para cualquier otra SKU. Para la SKU standard3, el valor es "default" o "highDensity". Para todas las demás SKU, este valor debe ser "default".

Nombre	Tipo	Description
default	string	El límite del número de índices viene determinado por los límites predeterminados de la SKU.
highDensity	string	Solo la aplicación para la SKU estándar3, donde el servicio de búsqueda puede tener hasta 1000 índices.

Identity

Identidad del recurso.

Nombre	Tipo	Description
principalId	string	Identificador de entidad de seguridad de la identidad asignada por el sistema del servicio de búsqueda.
tenantId	string	Identificador de inquilino de la identidad asignada por el sistema del servicio de búsqueda.
type	IdentityType	Tipo de identidad.

IdentityType

Tipo de identidad.

Nombre	Tipo	Description
None	string
SystemAssigned	string

IpRule

Regla de restricción de IP del servicio de búsqueda.

Nombre	Tipo	Description
value	string	Valor correspondiente a una única dirección IPv4 (por ejemplo, 123.1.2.3) o un intervalo IP en formato CIDR (por ejemplo, 123.1.2.3/24) que se va a permitir.

NetworkRuleSet

Reglas específicas de red que determinan cómo se puede acceder al servicio de búsqueda.

Nombre	Tipo	Description
ipRules	IpRule[]	Lista de reglas de restricción de IP usadas para un firewall de IP. El firewall bloquea las direcciones IP que no coinciden con las reglas. Estas reglas solo se aplican cuando "publicNetworkAccess" del servicio de búsqueda está "habilitado".

PrivateEndpoint

Recurso de punto de conexión privado del proveedor Microsoft.Network.

Nombre	Tipo	Description
id	string	Identificador de recurso del recurso de punto de conexión privado del proveedor Microsoft.Network.

PrivateEndpointConnection

Describe una conexión de punto de conexión privado existente al servicio de búsqueda.

Nombre	Tipo	Description
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso.
properties	PrivateEndpointConnectionProperties	Describe las propiedades de una conexión de punto de conexión privado existente al servicio de búsqueda.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProperties

Describe las propiedades de una conexión de punto de conexión privado existente al servicio de búsqueda.

Nombre	Tipo	Description
groupId	string	Identificador de grupo del proveedor de recursos para el que está la conexión del servicio Private Link.
privateEndpoint	PrivateEndpoint	Recurso de punto de conexión privado del proveedor Microsoft.Network.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Describe el estado actual de una conexión de servicio Private Link existente al punto de conexión privado de Azure.
provisioningState	PrivateLinkServiceConnectionProvisioningState	Estado de aprovisionamiento de la conexión del servicio Private Link. Los valores válidos son Actualización, Eliminación, Error, Correcto o Incompleto

PrivateLinkServiceConnectionProvisioningState

Estado de aprovisionamiento de la conexión del servicio Private Link. Los valores válidos son Actualización, Eliminación, Error, Correcto o Incompleto

Nombre	Tipo	Description
Canceled	string	Se ha cancelado la solicitud de aprovisionamiento para el recurso de conexión del servicio Private Link.
Deleting	string	La conexión del servicio Private Link está en proceso de eliminación.
Failed	string	No se pudo aprovisionar o eliminar la conexión del servicio private link.
Incomplete	string	Se ha aceptado la solicitud de aprovisionamiento para el recurso de conexión del servicio Private Link, pero aún no se ha iniciado el proceso de creación.
Succeeded	string	La conexión del servicio Private Link ha terminado de aprovisionar y está lista para su aprobación.
Updating	string	La conexión del servicio private link está en proceso de creación junto con otros recursos para que sea totalmente funcional.

PrivateLinkServiceConnectionState

Describe el estado actual de una conexión de servicio Private Link existente al punto de conexión privado de Azure.

Nombre	Tipo	Valor predeterminado	Description
actionsRequired	string	None	Descripción de cualquier acción adicional que pueda ser necesaria.
description	string		Descripción del estado de conexión del servicio Private Link.
status	PrivateLinkServiceConnectionStatus		Estado de la conexión del servicio Private Link. Los valores válidos son Pendiente, Aprobado, Rechazado o Desconectado.

PrivateLinkServiceConnectionStatus

Estado de la conexión del servicio Private Link. Los valores válidos son Pendiente, Aprobado, Rechazado o Desconectado.

Nombre	Tipo	Description
Approved	string	La conexión de punto de conexión privado está aprobada y está lista para su uso.
Disconnected	string	La conexión de punto de conexión privado se ha quitado del servicio.
Pending	string	Se ha creado la conexión de punto de conexión privado y está pendiente de aprobación.
Rejected	string	Se ha rechazado la conexión del punto de conexión privado y no se puede usar.

ProvisioningState

Estado de la última operación de aprovisionamiento realizada en el servicio de búsqueda. El aprovisionamiento es un estado intermedio que se produce cuando se está estableciendo la capacidad de servicio. Una vez configurada la capacidad, provisioningState cambia a "succeeded" o "failed". Las aplicaciones cliente pueden sondear el estado de aprovisionamiento (el intervalo de sondeo recomendado es de 30 segundos a un minuto) mediante la operación Get Search Service para ver cuándo se completa una operación. Si usa el servicio gratuito, este valor tiende a volver como "correcto" directamente en la llamada a Crear servicio de búsqueda. Esto ocurre porque el servicio gratuito usa una capacidad que ya está configurada.

Nombre	Tipo	Description
failed	string	Error en la última operación de aprovisionamiento.
provisioning	string	El servicio de búsqueda se aprovisiona o se escala o reduce verticalmente.
succeeded	string	La última operación de aprovisionamiento se ha completado correctamente.

PublicNetworkAccess

Este valor se puede establecer en "habilitado" para evitar cambios importantes en los recursos y plantillas de cliente existentes. Si se establece en "deshabilitado", no se permite el tráfico a través de la interfaz pública y las conexiones de punto de conexión privado serían el método de acceso exclusivo.

Nombre	Tipo	Description
disabled	string
enabled	string

SearchEncryptionComplianceStatus

Describe si el servicio de búsqueda es compatible o no con respecto a tener recursos no cifrados por el cliente. Si un servicio tiene más de un recurso no cifrado por el cliente y "Cumplimiento" está "habilitado", el servicio se marcará como "nonCompliant".

Nombre	Tipo	Description
Compliant	string	Indica que el servicio de búsqueda es compatible, ya sea porque el número de recursos no cifrados por el cliente es cero o la aplicación está deshabilitada.
NonCompliant	string	Indica que el servicio de búsqueda tiene más de un recurso no cifrado por el cliente.

SearchEncryptionWithCmk

Describe cómo un servicio de búsqueda debe aplicar tener uno o varios recursos no cifrados por el cliente.

Nombre	Tipo	Description
Disabled	string	No se realizará ninguna aplicación y el servicio de búsqueda puede tener recursos no cifrados por el cliente.
Enabled	string	servicio Search se marcará como no compatible si hay uno o varios recursos no cifrados por el cliente.
Unspecified	string	La directiva de cumplimiento no se especifica explícitamente, con el comportamiento que es el mismo que si estuviera establecido en "Deshabilitado".

SearchSemanticSearch

Establece las opciones que controlan la disponibilidad de la búsqueda semántica. Esta configuración solo es posible para determinadas SKU de búsqueda en determinadas ubicaciones.

Nombre	Tipo	Description
disabled	string	Indica que la clasificación semántica está deshabilitada para el servicio de búsqueda.
free	string	Habilita la clasificación semántica en un servicio de búsqueda e indica que se va a usar dentro de los límites del nivel gratis. Esto limitaría el volumen de solicitudes de clasificación semántica y se ofrece sin cargo adicional. Este es el valor predeterminado para los servicios de búsqueda recién aprovisionados.
standard	string	Habilita la clasificación semántica en un servicio de búsqueda como una característica facturable, con un mayor rendimiento y volumen de solicitudes de clasificación semántica.

SearchService

Describe un servicio de búsqueda y su estado actual.

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identidad del recurso.
location	string		Ubicación geográfica donde reside el recurso
name	string		Nombre del recurso.
properties.authOptions	DataPlaneAuthOptions		Define las opciones de cómo la API del plano de datos de un servicio de búsqueda autentica las solicitudes. No se puede establecer si "disableLocalAuth" está establecido en true.
properties.disableLocalAuth	boolean		Cuando se establece en true, no se permitirá que las llamadas al servicio de búsqueda usen claves de API para la autenticación. No se puede establecer en true si se definen "dataPlaneAuthOptions".
properties.encryptionWithCmk	EncryptionWithCmk		Especifica cualquier directiva relativa al cifrado de recursos (como índices) mediante claves de administrador de clientes dentro de un servicio de búsqueda.
properties.hostingMode	HostingMode	default	Solo se aplica a la SKU estándar3. Puede establecer esta propiedad para habilitar hasta 3 particiones de alta densidad que permitan hasta 1000 índices, que es mucho mayor que los índices máximos permitidos para cualquier otra SKU. Para la SKU standard3, el valor es "default" o "highDensity". Para todas las demás SKU, este valor debe ser "default".
properties.networkRuleSet	NetworkRuleSet		Reglas específicas de la red que determinan cómo se puede alcanzar el servicio de búsqueda.
properties.partitionCount	integer	1	Número de particiones en el servicio de búsqueda; si se especifica, puede ser 1, 2, 3, 4, 6 o 12. Los valores mayores que 1 solo son válidos para las SKU estándar. Para los servicios "standard3" con hostingMode establecido en "highDensity", los valores permitidos están comprendidos entre 1 y 3.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Lista de conexiones de punto de conexión privado al servicio de búsqueda.
properties.provisioningState	ProvisioningState		Estado de la última operación de aprovisionamiento realizada en el servicio de búsqueda. El aprovisionamiento es un estado intermedio que se produce cuando se está estableciendo la capacidad de servicio. Una vez configurada la capacidad, provisioningState cambia a "succeeded" o "failed". Las aplicaciones cliente pueden sondear el estado de aprovisionamiento (el intervalo de sondeo recomendado es de 30 segundos a un minuto) mediante la operación Get Search Service para ver cuándo se completa una operación. Si usa el servicio gratuito, este valor tiende a volver como "correcto" directamente en la llamada a Crear servicio de búsqueda. Esto ocurre porque el servicio gratuito usa una capacidad que ya está configurada.
properties.publicNetworkAccess	PublicNetworkAccess	enabled	Este valor se puede establecer en "habilitado" para evitar cambios importantes en los recursos y plantillas de cliente existentes. Si se establece en "deshabilitado", no se permite el tráfico a través de la interfaz pública y las conexiones de punto de conexión privado serían el método de acceso exclusivo.
properties.replicaCount	integer	1	Número de réplicas en el servicio de búsqueda. Si se especifica, debe ser un valor entre 1 y 12 inclusive para las SKU estándar o entre 1 y 3 inclusive para la SKU básica.
properties.semanticSearch	SearchSemanticSearch		Establece las opciones que controlan la disponibilidad de la búsqueda semántica. Esta configuración solo es posible para determinadas SKU de búsqueda en determinadas ubicaciones.
properties.sharedPrivateLinkResources	SharedPrivateLinkResource[]		La lista de recursos de vínculo privado compartido administrados por el servicio de búsqueda.
properties.status	SearchServiceStatus		Estado del servicio de búsqueda. Entre los valores posibles se incluyen: "running": el servicio de búsqueda se está ejecutando y no hay ninguna operación de aprovisionamiento en curso. "aprovisionamiento": el servicio de búsqueda se está aprovisionando o escalando verticalmente o verticalmente. 'eliminar': se está eliminando el servicio de búsqueda. 'degradado': el servicio de búsqueda está degradado. Esto puede ocurrir cuando las unidades de búsqueda subyacentes no están en buen estado. El servicio de búsqueda es más probable que esté operativo, pero el rendimiento puede ser lento y es posible que se quiten algunas solicitudes. 'disabled': el servicio de búsqueda está deshabilitado. En este estado, el servicio rechazará todas las solicitudes de API. 'error': el servicio de búsqueda está en estado de error. Si el servicio está en los estados degradados, deshabilitados o de error, Microsoft está investigando activamente el problema subyacente. En estos estados, los servicios dedicados son todavía facturables en función del número de unidades de búsqueda aprovisionado.
properties.statusDetails	string		Detalles del estado del servicio de búsqueda.
sku	Sku		SKU del servicio de búsqueda, que determina la tasa de facturación y los límites de capacidad. Esta propiedad es necesaria al crear un nuevo servicio de búsqueda.
tags	object		Etiquetas del recurso.
type	string		Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SearchServiceStatus

Estado del servicio de búsqueda. Entre los valores posibles se incluyen: "running": el servicio de búsqueda se está ejecutando y no hay ninguna operación de aprovisionamiento en curso. "aprovisionamiento": el servicio de búsqueda se está aprovisionando o escalando verticalmente o verticalmente. 'eliminar': se está eliminando el servicio de búsqueda. 'degradado': el servicio de búsqueda está degradado. Esto puede ocurrir cuando las unidades de búsqueda subyacentes no están en buen estado. El servicio de búsqueda es más probable que esté operativo, pero el rendimiento puede ser lento y es posible que se quiten algunas solicitudes. 'disabled': el servicio de búsqueda está deshabilitado. En este estado, el servicio rechazará todas las solicitudes de API. 'error': el servicio de búsqueda está en estado de error. Si el servicio está en los estados degradados, deshabilitados o de error, Microsoft está investigando activamente el problema subyacente. En estos estados, los servicios dedicados son todavía facturables en función del número de unidades de búsqueda aprovisionado.

Nombre	Tipo	Description
degraded	string	El servicio de búsqueda se degrada porque las unidades de búsqueda subyacentes no están en buen estado.
deleting	string	El servicio de búsqueda se está eliminando.
disabled	string	El servicio de búsqueda está deshabilitado y se rechazarán todas las solicitudes de API.
error	string	El servicio de búsqueda está en estado de error, lo que indica un error al aprovisionar o eliminarse.
provisioning	string	El servicio de búsqueda se aprovisiona o se escala o reduce verticalmente.
running	string	El servicio de búsqueda se está ejecutando y no hay ninguna operación de aprovisionamiento en curso.

SharedPrivateLinkResource

Describe un recurso de Private Link compartido administrado por el servicio de búsqueda.

Nombre	Tipo	Description
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso.
properties	SharedPrivateLinkResourceProperties	Describe las propiedades de un recurso compartido Private Link administrado por el servicio de búsqueda.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Describe las propiedades de un recurso compartido de Private Link existente administrado por el servicio de búsqueda.

Nombre	Tipo	Description
groupId	string	Identificador de grupo del proveedor de recursos para el que está el recurso de vínculo privado compartido.
privateLinkResourceId	string	Identificador de recurso del recurso para el que está el recurso de vínculo privado compartido.
provisioningState	SharedPrivateLinkResourceProvisioningState	Estado de aprovisionamiento del recurso de vínculo privado compartido. Los valores válidos son Actualizar, Eliminar, Error, Correcto o Incompleto.
requestMessage	string	Mensaje de solicitud para solicitar la aprobación del recurso de vínculo privado compartido.
resourceRegion	string	Opcional. Se puede usar para especificar la ubicación de Azure Resource Manager del recurso al que se va a crear un vínculo privado compartido. Esto solo es necesario para aquellos recursos cuya configuración dns sea regional (por ejemplo, Azure Kubernetes Service).
status	SharedPrivateLinkResourceStatus	Estado del recurso de vínculo privado compartido. Los valores válidos son Pendiente, Aprobado, Rechazado o Desconectado.

SharedPrivateLinkResourceProvisioningState

Estado de aprovisionamiento del recurso de vínculo privado compartido. Los valores válidos son Actualizar, Eliminar, Error, Correcto o Incompleto.

Nombre	Tipo	Description
Deleting	string
Failed	string
Incomplete	string
Succeeded	string
Updating	string

SharedPrivateLinkResourceStatus

Estado del recurso de vínculo privado compartido. Los valores válidos son Pendiente, Aprobado, Rechazado o Desconectado.

Nombre	Tipo	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

Sku

Define la SKU de un servicio de búsqueda, que determina la tasa de facturación y los límites de capacidad.

Nombre	Tipo	Description
name	SkuName	SKU del servicio de búsqueda. Entre los valores válidos se incluyen: "gratis": servicio compartido. "básico": servicio dedicado con hasta 3 réplicas. "estándar": servicio dedicado con hasta 12 particiones y 12 réplicas. 'standard2': similar al estándar, pero con más capacidad por unidad de búsqueda. 'standard3': la oferta estándar más grande con hasta 12 particiones y 12 réplicas (o hasta 3 particiones con más índices si también establece la propiedad hostingMode en 'highDensity'). 'storage_optimized_l1': admite 1 TB por partición, hasta 12 particiones. "storage_optimized_l2": admite 2 TB por partición, hasta 12 particiones".

SkuName

SKU del servicio de búsqueda. Los valores válidos incluyen: "gratis": servicio compartido. 'basic': servicio dedicado con hasta 3 réplicas. 'estándar': servicio dedicado con hasta 12 particiones y 12 réplicas. 'standard2': similar al estándar, pero con más capacidad por unidad de búsqueda. 'standard3': la oferta estándar más grande con hasta 12 particiones y 12 réplicas (o hasta 3 particiones con más índices si también establece la propiedad hostingMode en 'highDensity'). 'storage_optimized_l1': admite 1 TB por partición, hasta 12 particiones. "storage_optimized_l2": admite 2 TB por partición, hasta 12 particiones".

Nombre	Tipo	Description
basic	string	Nivel facturable para un servicio dedicado que tiene hasta 3 réplicas.
free	string	Nivel gratis, sin garantías de Acuerdo de Nivel de Servicio y un subconjunto de las características que se ofrecen en los niveles facturables.
standard	string	Nivel facturable para un servicio dedicado que tiene hasta 12 particiones y 12 réplicas.
standard2	string	Similar a "estándar", pero con más capacidad por unidad de búsqueda.
standard3	string	La oferta estándar más grande con hasta 12 particiones y 12 réplicas (o hasta 3 particiones con más índices si también establece la propiedad hostingMode en "highDensity").
storage_optimized_l1	string	Nivel facturable para un servicio dedicado que admite 1 TB por partición, hasta 12 particiones.
storage_optimized_l2	string	Nivel facturable para un servicio dedicado que admite 2 TB por partición, hasta 12 particiones.