Services - List By Resource Group

Service:

Search Management

API Version:

2023-11-01

Obtém uma lista de todos os serviços de Pesquisa no grupo de recursos especificado.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos dentro da assinatura atual. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
subscriptionId	path	True	string	O identificador exclusivo de uma assinatura do Microsoft Azure. Você pode obter esse valor da API de Resource Manager do Azure, das ferramentas de linha de comando ou do portal.
api-version	query	True	string	A versão da API a ser usada para cada solicitação.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
x-ms-client-request-id		string uuid	Um valor de GUID gerado pelo cliente que identifica esta solicitação. Se especificado, isso será incluído nas informações de resposta como uma maneira de acompanhar a solicitação.

Respostas

Nome	Tipo	Description
200 OK	SearchServiceListResult	A operação foi realizada com êxito. A resposta contém a lista de todas as definições de serviço de pesquisa para o grupo de recursos determinado.
Other Status Codes	CloudError	Erro inesperado durante operação.

Segurança

azure_auth

Microsoft Entra ID fluxo de autorização OAuth2.

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

SearchListServicesByResourceGroup

Sample Request

HTTP

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

Java

/** Samples for Services ListByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/
     * SearchListServicesByResourceGroup.json
     */
    /**
     * Sample code: SearchListServicesByResourceGroup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void searchListServicesByResourceGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.searchServices().manager().serviceClient().getServices().listByResourceGroup("rg1", 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_resource_group.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_resource_group(
        resource_group_name="rg1",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchListServicesByResourceGroup.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/SearchListServicesByResourceGroup.json
func ExampleServicesClient_NewListByResourceGroupPager() {
	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().NewListByResourceGroupPager("rg1", &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/rg1/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 resource group.
 *
 * @summary Gets a list of all Search services in the given resource group.
 * x-ms-original-file: specification/search/resource-manager/Microsoft.Search/stable/2023-11-01/examples/SearchListServicesByResourceGroup.json
 */
async function searchListServicesByResourceGroup() {
  const subscriptionId = process.env["SEARCH_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["SEARCH_RESOURCE_GROUP"] || "rg1";
  const credential = new DefaultAzureCredential();
  const client = new SearchManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.services.listByResourceGroup(resourceGroupName)) {
    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/SearchListServicesByResourceGroup.json
// this example is just showing the usage of "Services_ListByResourceGroup" 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 ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "subid";
string resourceGroupName = "rg1";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this SearchServiceResource
SearchServiceCollection collection = resourceGroupResource.GetSearchServices();

// invoke the operation and iterate over the result
await foreach (SearchServiceResource item in collection.GetAllAsync())
{
    // 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

Sample Response

Status code:

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

Definições

Nome	Description
AadAuthFailureMode	Descreve qual resposta a API do plano de dados de um serviço de pesquisa enviaria para solicitações que falharam na autenticação.
ApiKeyOnly	Indica que somente a chave de API pode ser usada para autenticação.
CloudError	Contém informações sobre um erro de API.
CloudErrorBody	Descreve um erro de API específico com um código de erro e uma mensagem.
DataPlaneAadOrApiKeyAuthOption	Indica que a chave de API ou um token de acesso de um locatário Microsoft Entra ID pode ser usado para autenticação.
DataPlaneAuthOptions	Define as opções de como o serviço de pesquisa autentica uma solicitação de plano de dados. Isso não poderá ser definido se 'disableLocalAuth' estiver definido como true.
EncryptionWithCmk	Descreve uma política que determina como os recursos dentro do serviço de pesquisa devem ser criptografados com customer=managed keys.
HostingMode	Aplicável somente para o SKU standard3. Você pode definir essa propriedade para habilitar até três partições de alta densidade que permitem até 1000 índices, o que é muito maior do que o máximo de índices permitidos para qualquer outro SKU. Para o SKU standard3, o valor é 'default' ou 'highDensity'. Para todos os outros SKUs, esse valor deve ser 'default'.
Identity	Identidade do recurso.
IdentityType	O tipo de identidade.
IpRule	A regra de restrição de IP do serviço de pesquisa.
NetworkRuleSet	Regras específicas da rede que determinam como o serviço de pesquisa pode ser acessado.
PrivateEndpoint	O recurso de ponto de extremidade privado do provedor Microsoft.Network.
PrivateEndpointConnection	Descreve uma conexão de ponto de extremidade privado existente com o serviço de pesquisa.
PrivateEndpointConnectionProperties	Descreve as propriedades de uma conexão de ponto de extremidade privado existente com o serviço de pesquisa.
PrivateLinkServiceConnectionProvisioningState	O estado de provisionamento da conexão de serviço de link privado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto
PrivateLinkServiceConnectionState	Descreve o estado atual de uma conexão de serviço Link Privado existente com o ponto de extremidade privado do Azure.
PrivateLinkServiceConnectionStatus	Status da conexão de serviço de link privado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado.
ProvisioningState	O estado da última operação de provisionamento executada no serviço de pesquisa. O provisionamento é um estado intermediário que ocorre enquanto a capacidade de serviço está sendo estabelecida. Depois que a capacidade é configurada, provisioningState é alterado para 'bem-sucedido' ou 'falhou'. Os aplicativos cliente podem sondar o provisionamento status (o intervalo de sondagem recomendado é de 30 segundos a um minuto) usando a operação Obter Serviço de Pesquisa para ver quando uma operação é concluída. Se você estiver usando o serviço gratuito, esse valor tende a voltar como "bem-sucedido" diretamente na chamada para Criar serviço de pesquisa. Isso ocorre porque o serviço gratuito usa a capacidade que já está configurada.
PublicNetworkAccess	Esse valor pode ser definido como "habilitado" para evitar alterações interruptivas em modelos e recursos existentes do cliente. Se definido como "desabilitado", o tráfego pela interface pública não será permitido e as conexões de ponto de extremidade privado serão o método de acesso exclusivo.
SearchEncryptionComplianceStatus	Descreve se o serviço de pesquisa está em conformidade ou não em relação a ter recursos não criptografados pelo cliente. Se um serviço tiver mais de um recurso não criptografado pelo cliente e "Imposição" estiver "habilitado", o serviço será marcado como "não compatível".
SearchEncryptionWithCmk	Descreve como um serviço de pesquisa deve impor ter um ou mais recursos não criptografados pelo cliente.
SearchSemanticSearch	Define opções que controlam a disponibilidade da pesquisa semântica. Essa configuração só é possível para determinados SKUs de pesquisa em determinados locais.
SearchService	Descreve um serviço de pesquisa e seu estado atual.
SearchServiceListResult	Resposta que contém uma lista de serviços de pesquisa.
SearchServiceStatus	O status do serviço de pesquisa. Os valores possíveis incluem: 'running': o serviço de pesquisa está em execução e nenhuma operação de provisionamento está em andamento. 'provisioning': o serviço de pesquisa está sendo provisionado ou dimensionado para cima ou para baixo. 'deleting': o serviço de pesquisa está sendo excluído. 'degradado': o serviço de pesquisa está degradado. Isso pode ocorrer quando as unidades de pesquisa subjacentes não estão íntegras. O serviço de pesquisa provavelmente está operacional, mas o desempenho pode ser lento e algumas solicitações podem ser descartadas. 'desabilitado': o serviço de pesquisa está desabilitado. Nesse estado, o serviço rejeita todas as solicitações da API. 'error': o serviço de pesquisa está em um estado de erro. Se o serviço estiver nos estados degradados, desabilitados ou de erro, a Microsoft está investigando ativamente o problema subjacente. Serviços dedicados nesses estados ainda são passíveis de cobrança com base no número de unidades de pesquisa provisionadas.
SharedPrivateLinkResource	Descreve um Recurso de Link Privado Compartilhado gerenciado pelo serviço de pesquisa.
SharedPrivateLinkResourceProperties	Descreve as propriedades de um Recurso de Link Privado Compartilhado existente gerenciado pelo serviço de pesquisa.
SharedPrivateLinkResourceProvisioningState	O estado de provisionamento do recurso de link privado compartilhado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto.
SharedPrivateLinkResourceStatus	Status do recurso de link privado compartilhado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado.
Sku	Define o SKU de um serviço de pesquisa, que determina a taxa de cobrança e os limites de capacidade.
SkuName	A SKU do serviço de pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até três réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até três partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': dá suporte a 2 TB por partição, até 12 partições.

AadAuthFailureMode

Descreve qual resposta a API do plano de dados de um serviço de pesquisa enviaria para solicitações que falharam na autenticação.

Nome	Tipo	Description
http401WithBearerChallenge	string	Indica que as solicitações que falharam na autenticação devem ser apresentadas com um código HTTP status 401 (Não autorizado) e apresentar um desafio de portador.
http403	string	Indica que as solicitações que falharam na autenticação devem ser apresentadas com um código HTTP status 403 (Proibido).

ApiKeyOnly

Indica que somente a chave de API pode ser usada para autenticação.

CloudError

Contém informações sobre um erro de API.

Nome	Tipo	Description
error	CloudErrorBody	Descreve um erro de API específico com um código de erro e uma mensagem.

CloudErrorBody

Descreve um erro de API específico com um código de erro e uma mensagem.

Nome	Tipo	Description
code	string	Um código de erro que descreve a condição de erro com mais precisão do que um código de status HTTP. Pode ser usado para lidar programaticamente com casos de erro específicos.
details	CloudErrorBody[]	Contém erros aninhados relacionados a esse erro.
message	string	Uma mensagem que descreve o erro em detalhes e fornece informações de depuração.
target	string	O destino do erro específico (por exemplo, o nome da propriedade em erro).

DataPlaneAadOrApiKeyAuthOption

Indica que a chave de API ou um token de acesso de um locatário Microsoft Entra ID pode ser usado para autenticação.

Nome	Tipo	Description
aadAuthFailureMode	AadAuthFailureMode	Descreve qual resposta a API do plano de dados de um serviço de pesquisa enviaria para solicitações que falharam na autenticação.

DataPlaneAuthOptions

Define as opções de como o serviço de pesquisa autentica uma solicitação de plano de dados. Isso não poderá ser definido se 'disableLocalAuth' estiver definido como true.

Nome	Tipo	Description
aadOrApiKey	DataPlaneAadOrApiKeyAuthOption	Indica que a chave de API ou um token de acesso de um locatário Microsoft Entra ID pode ser usado para autenticação.
apiKeyOnly	ApiKeyOnly	Indica que somente a chave de API pode ser usada para autenticação.

EncryptionWithCmk

Descreve uma política que determina como os recursos dentro do serviço de pesquisa devem ser criptografados com customer=managed keys.

Nome	Tipo	Description
encryptionComplianceStatus	SearchEncryptionComplianceStatus	Descreve se o serviço de pesquisa está em conformidade ou não em relação a ter recursos não criptografados pelo cliente. Se um serviço tiver mais de um recurso não criptografado pelo cliente e "Imposição" estiver "habilitado", o serviço será marcado como "não compatível".
enforcement	SearchEncryptionWithCmk	Descreve como um serviço de pesquisa deve impor ter um ou mais recursos não criptografados pelo cliente.

HostingMode

Aplicável somente para o SKU standard3. Você pode definir essa propriedade para habilitar até três partições de alta densidade que permitem até 1000 índices, o que é muito maior do que o máximo de índices permitidos para qualquer outro SKU. Para o SKU standard3, o valor é 'default' ou 'highDensity'. Para todos os outros SKUs, esse valor deve ser 'default'.

Nome	Tipo	Description
default	string	O limite no número de índices é determinado pelos limites padrão para o SKU.
highDensity	string	Somente aplicativo para SKU Standard3, em que o serviço de pesquisa pode ter até 1000 índices.

Identity

Identidade do recurso.

Nome	Tipo	Description
principalId	string	A ID da entidade de segurança da identidade atribuída pelo sistema do serviço de pesquisa.
tenantId	string	A ID do locatário da identidade atribuída pelo sistema do serviço de pesquisa.
type	IdentityType	O tipo de identidade.

IdentityType

O tipo de identidade.

Nome	Tipo	Description
None	string
SystemAssigned	string

IpRule

A regra de restrição de IP do serviço de pesquisa.

Nome	Tipo	Description
value	string	Valor correspondente a um único endereço IPv4 (por exemplo, 123.1.2.3) ou um intervalo de IP no formato CIDR (por exemplo, 123.1.2.3/24) a ser permitido.

NetworkRuleSet

Regras específicas da rede que determinam como o serviço de pesquisa pode ser acessado.

Nome	Tipo	Description
ipRules	IpRule[]	Uma lista de regras de restrição de IP usadas para um firewall de IP. Todos os IPs que não correspondem às regras são bloqueados pelo firewall. Essas regras só são aplicadas quando o 'publicNetworkAccess' do serviço de pesquisa está 'habilitado'.

PrivateEndpoint

O recurso de ponto de extremidade privado do provedor Microsoft.Network.

Nome	Tipo	Description
id	string	A ID do recurso de ponto de extremidade privado do provedor Microsoft.Network.

PrivateEndpointConnection

Descreve uma conexão de ponto de extremidade privado existente com o serviço de pesquisa.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties	PrivateEndpointConnectionProperties	Descreve as propriedades de uma conexão de ponto de extremidade privado existente com o serviço de pesquisa.
type	string	Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProperties

Descreve as propriedades de uma conexão de ponto de extremidade privado existente com o serviço de pesquisa.

Nome	Tipo	Description
groupId	string	A ID do grupo do provedor de recursos para o qual a conexão de serviço de link privado se destina.
privateEndpoint	PrivateEndpoint	O recurso de ponto de extremidade privado do provedor Microsoft.Network.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Descreve o estado atual de uma conexão de serviço Link Privado existente com o ponto de extremidade privado do Azure.
provisioningState	PrivateLinkServiceConnectionProvisioningState	O estado de provisionamento da conexão de serviço de link privado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto

PrivateLinkServiceConnectionProvisioningState

O estado de provisionamento da conexão de serviço de link privado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto

Nome	Tipo	Description
Canceled	string	A solicitação de provisionamento para o recurso de conexão do serviço de link privado foi cancelada
Deleting	string	A conexão de serviço de link privado está em processo de exclusão.
Failed	string	Falha ao provisionar ou excluir a conexão do serviço de link privado.
Incomplete	string	A solicitação de provisionamento para o recurso de conexão de serviço de link privado foi aceita, mas o processo de criação ainda não começou.
Succeeded	string	A conexão de serviço de link privado concluiu o provisionamento e está pronta para aprovação.
Updating	string	A conexão de serviço de link privado está em processo de criação junto com outros recursos para que ela seja totalmente funcional.

PrivateLinkServiceConnectionState

Descreve o estado atual de uma conexão de serviço Link Privado existente com o ponto de extremidade privado do Azure.

Nome	Tipo	Valor padrão	Description
actionsRequired	string	None	Uma descrição de todas as ações extras que podem ser necessárias.
description	string		A descrição do estado de conexão do serviço de link privado.
status	PrivateLinkServiceConnectionStatus		Status da conexão de serviço de link privado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado.

PrivateLinkServiceConnectionStatus

Status da conexão de serviço de link privado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado.

Nome	Tipo	Description
Approved	string	A conexão de ponto de extremidade privado é aprovada e está pronta para uso.
Disconnected	string	A conexão de ponto de extremidade privado foi removida do serviço.
Pending	string	A conexão de ponto de extremidade privado foi criada e está com aprovação pendente.
Rejected	string	A conexão de ponto de extremidade privado foi rejeitada e não pode ser usada.

ProvisioningState

O estado da última operação de provisionamento executada no serviço de pesquisa. O provisionamento é um estado intermediário que ocorre enquanto a capacidade de serviço está sendo estabelecida. Depois que a capacidade é configurada, provisioningState é alterado para 'bem-sucedido' ou 'falhou'. Os aplicativos cliente podem sondar o provisionamento status (o intervalo de sondagem recomendado é de 30 segundos a um minuto) usando a operação Obter Serviço de Pesquisa para ver quando uma operação é concluída. Se você estiver usando o serviço gratuito, esse valor tende a voltar como "bem-sucedido" diretamente na chamada para Criar serviço de pesquisa. Isso ocorre porque o serviço gratuito usa a capacidade que já está configurada.

Nome	Tipo	Description
failed	string	A última operação de provisionamento falhou.
provisioning	string	O serviço de pesquisa está sendo provisionado ou dimensionado para cima ou para baixo.
succeeded	string	A última operação de provisionamento foi concluída com êxito.

PublicNetworkAccess

Esse valor pode ser definido como "habilitado" para evitar alterações interruptivas em modelos e recursos existentes do cliente. Se definido como "desabilitado", o tráfego pela interface pública não será permitido e as conexões de ponto de extremidade privado serão o método de acesso exclusivo.

Nome	Tipo	Description
disabled	string
enabled	string

SearchEncryptionComplianceStatus

Descreve se o serviço de pesquisa está em conformidade ou não em relação a ter recursos não criptografados pelo cliente. Se um serviço tiver mais de um recurso não criptografado pelo cliente e "Imposição" estiver "habilitado", o serviço será marcado como "não compatível".

Nome	Tipo	Description
Compliant	string	Indica que o serviço de pesquisa está em conformidade, seja porque o número de recursos não criptografados pelo cliente é zero ou a imposição está desabilitada.
NonCompliant	string	Indica que o serviço de pesquisa tem mais de um recurso não criptografado pelo cliente.

SearchEncryptionWithCmk

Descreve como um serviço de pesquisa deve impor ter um ou mais recursos não criptografados pelo cliente.

Nome	Tipo	Description
Disabled	string	Nenhuma imposição será feita e o serviço de pesquisa poderá ter recursos não criptografados pelo cliente.
Enabled	string	serviço Pesquisa serão marcados como não compatíveis se houver um ou mais recursos não criptografados pelo cliente.
Unspecified	string	A política de imposição não é especificada explicitamente, com o comportamento sendo o mesmo que se fosse definido como 'Desabilitado'.

SearchSemanticSearch

Define opções que controlam a disponibilidade da pesquisa semântica. Essa configuração só é possível para determinados SKUs de pesquisa em determinados locais.

Nome	Tipo	Description
disabled	string	Indica que a classificação semântica está desabilitada para o serviço de pesquisa.
free	string	Habilita a classificação semântica em um serviço de pesquisa e indica que ele deve ser usado dentro dos limites da camada gratuita. Isso limitaria o volume de solicitações de classificação semântica e é oferecido sem custo adicional. Esse é o padrão para serviços de pesquisa provisionados recentemente.
standard	string	Habilita a classificação semântica em um serviço de pesquisa como um recurso faturável, com maior taxa de transferência e volume de solicitações de classificação semântica.

SearchService

Descreve um serviço de pesquisa e seu estado atual.

Nome	Tipo	Valor padrão	Description
id	string		ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		A identidade do recurso.
location	string		A localização geográfica em que o recurso reside
name	string		O nome do recurso
properties.authOptions	DataPlaneAuthOptions		Define as opções de como a API do plano de dados de um serviço de pesquisa autentica solicitações. Isso não poderá ser definido se 'disableLocalAuth' estiver definido como true.
properties.disableLocalAuth	boolean		Quando definido como true, as chamadas para o serviço de pesquisa não terão permissão para utilizar chaves de API para autenticação. Isso não poderá ser definido como true se 'dataPlaneAuthOptions' estiver definido.
properties.encryptionWithCmk	EncryptionWithCmk		Especifica qualquer política relativa à criptografia de recursos (como índices) usando chaves do gerenciador de clientes em um serviço de pesquisa.
properties.hostingMode	HostingMode	default	Aplicável somente para o SKU standard3. Você pode definir essa propriedade para habilitar até três partições de alta densidade que permitem até 1000 índices, o que é muito maior do que o máximo de índices permitidos para qualquer outro SKU. Para o SKU standard3, o valor é 'default' ou 'highDensity'. Para todos os outros SKUs, esse valor deve ser 'default'.
properties.networkRuleSet	NetworkRuleSet		Regras específicas da rede que determinam como o serviço de pesquisa pode ser alcançado.
properties.partitionCount	integer	1	O número de partições no serviço de pesquisa; se especificado, pode ser 1, 2, 3, 4, 6 ou 12. Valores maiores que 1 são válidos apenas para SKUs padrão. Para serviços 'standard3' com hostingMode definido como 'highDensity', os valores permitidos estão entre 1 e 3.
properties.privateEndpointConnections	PrivateEndpointConnection[]		A lista de conexões de ponto de extremidade privado com o serviço de pesquisa.
properties.provisioningState	ProvisioningState		O estado da última operação de provisionamento executada no serviço de pesquisa. O provisionamento é um estado intermediário que ocorre enquanto a capacidade de serviço está sendo estabelecida. Depois que a capacidade é configurada, provisioningState é alterado para 'bem-sucedido' ou 'falhou'. Os aplicativos cliente podem sondar o provisionamento status (o intervalo de sondagem recomendado é de 30 segundos a um minuto) usando a operação Obter Serviço de Pesquisa para ver quando uma operação é concluída. Se você estiver usando o serviço gratuito, esse valor tende a voltar como "bem-sucedido" diretamente na chamada para Criar serviço de pesquisa. Isso ocorre porque o serviço gratuito usa a capacidade que já está configurada.
properties.publicNetworkAccess	PublicNetworkAccess	enabled	Esse valor pode ser definido como "habilitado" para evitar alterações interruptivas em modelos e recursos existentes do cliente. Se definido como "desabilitado", o tráfego pela interface pública não será permitido e as conexões de ponto de extremidade privado serão o método de acesso exclusivo.
properties.replicaCount	integer	1	O número de réplicas no serviço de pesquisa. Se especificado, ele deve ser um valor entre 1 e 12 inclusive para SKUs padrão ou entre 1 e 3 inclusive para SKU básico.
properties.semanticSearch	SearchSemanticSearch		Define opções que controlam a disponibilidade da pesquisa semântica. Essa configuração só é possível para determinados SKUs de pesquisa em determinados locais.
properties.sharedPrivateLinkResources	SharedPrivateLinkResource[]		A lista de recursos de link privado compartilhado gerenciados pelo serviço de pesquisa.
properties.status	SearchServiceStatus		O status do serviço de pesquisa. Os valores possíveis incluem: 'running': o serviço de pesquisa está em execução e nenhuma operação de provisionamento está em andamento. 'provisioning': o serviço de pesquisa está sendo provisionado ou dimensionado para cima ou para baixo. 'deleting': o serviço de pesquisa está sendo excluído. 'degradado': o serviço de pesquisa está degradado. Isso pode ocorrer quando as unidades de pesquisa subjacentes não estão íntegras. O serviço de pesquisa provavelmente está operacional, mas o desempenho pode ser lento e algumas solicitações podem ser descartadas. 'desabilitado': o serviço de pesquisa está desabilitado. Nesse estado, o serviço rejeita todas as solicitações da API. 'error': o serviço de pesquisa está em um estado de erro. Se o serviço estiver nos estados degradados, desabilitados ou de erro, a Microsoft está investigando ativamente o problema subjacente. Serviços dedicados nesses estados ainda são passíveis de cobrança com base no número de unidades de pesquisa provisionadas.
properties.statusDetails	string		Os detalhes do serviço de pesquisa status.
sku	Sku		O SKU do serviço de pesquisa, que determina a taxa de cobrança e os limites de capacidade. Essa propriedade é necessária ao criar um novo serviço de pesquisa.
tags	object		Marcas de recurso.
type	string		Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SearchServiceListResult

Resposta que contém uma lista de serviços de pesquisa.

Nome	Tipo	Description
nextLink	string	URL de solicitação que pode ser usada para consultar a próxima página dos serviços de pesquisa. Retornado quando o número total de serviços de pesquisa solicitados excede o tamanho máximo da página.
value	SearchService[]	A lista de serviços de pesquisa.

SearchServiceStatus

O status do serviço de pesquisa. Os valores possíveis incluem: 'running': o serviço de pesquisa está em execução e nenhuma operação de provisionamento está em andamento. 'provisioning': o serviço de pesquisa está sendo provisionado ou dimensionado para cima ou para baixo. 'deleting': o serviço de pesquisa está sendo excluído. 'degradado': o serviço de pesquisa está degradado. Isso pode ocorrer quando as unidades de pesquisa subjacentes não estão íntegras. O serviço de pesquisa provavelmente está operacional, mas o desempenho pode ser lento e algumas solicitações podem ser descartadas. 'desabilitado': o serviço de pesquisa está desabilitado. Nesse estado, o serviço rejeita todas as solicitações da API. 'error': o serviço de pesquisa está em um estado de erro. Se o serviço estiver nos estados degradados, desabilitados ou de erro, a Microsoft está investigando ativamente o problema subjacente. Serviços dedicados nesses estados ainda são passíveis de cobrança com base no número de unidades de pesquisa provisionadas.

Nome	Tipo	Description
degraded	string	O serviço de pesquisa está degradado porque as unidades de pesquisa subjacentes não estão íntegras.
deleting	string	O serviço de pesquisa está sendo excluído.
disabled	string	O serviço de pesquisa está desabilitado e todas as solicitações de API serão rejeitadas.
error	string	O serviço de pesquisa está em estado de erro, indicando uma falha ao provisionar ou ser excluído.
provisioning	string	O serviço de pesquisa está sendo provisionado ou dimensionado para cima ou para baixo.
running	string	O serviço de pesquisa está em execução e nenhuma operação de provisionamento está em andamento.

SharedPrivateLinkResource

Descreve um Recurso de Link Privado Compartilhado gerenciado pelo serviço de pesquisa.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties	SharedPrivateLinkResourceProperties	Descreve as propriedades de um Recurso de Link Privado Compartilhado gerenciado pelo serviço de pesquisa.
type	string	Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Descreve as propriedades de um Recurso de Link Privado Compartilhado existente gerenciado pelo serviço de pesquisa.

Nome	Tipo	Description
groupId	string	A ID do grupo do provedor de recursos para o qual o recurso de link privado compartilhado é usado.
privateLinkResourceId	string	A ID do recurso para o qual o recurso de link privado compartilhado é usado.
provisioningState	SharedPrivateLinkResourceProvisioningState	O estado de provisionamento do recurso de link privado compartilhado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto.
requestMessage	string	A mensagem de solicitação para solicitar a aprovação do recurso de link privado compartilhado.
resourceRegion	string	Opcional. Pode ser usado para especificar o local Resource Manager do Azure do recurso ao qual um link privado compartilhado deve ser criado. Isso só é necessário para os recursos cuja configuração de DNS é regional (como Serviço de Kubernetes do Azure).
status	SharedPrivateLinkResourceStatus	Status do recurso de link privado compartilhado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado.

SharedPrivateLinkResourceProvisioningState

O estado de provisionamento do recurso de link privado compartilhado. Os valores válidos são Atualização, Exclusão, Falha, Êxito ou Incompleto.

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

SharedPrivateLinkResourceStatus

Status do recurso de link privado compartilhado. Os valores válidos são Pendente, Aprovado, Rejeitado ou Desconectado.

Nome	Tipo	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

Sku

Define o SKU de um serviço de pesquisa, que determina a taxa de cobrança e os limites de capacidade.

Nome	Tipo	Description
name	SkuName	A SKU do serviço de pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até três réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até três partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': dá suporte a 2 TB por partição, até 12 partições.

SkuName

A SKU do serviço de pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até três réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até três partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': dá suporte a 2 TB por partição, até 12 partições.

Nome	Tipo	Description
basic	string	Camada faturável para um serviço dedicado com até três réplicas.
free	string	Camada gratuita, sem garantias de SLA e um subconjunto dos recursos oferecidos em camadas faturáveis.
standard	string	Camada faturável para um serviço dedicado com até 12 partições e 12 réplicas.
standard2	string	Semelhante a "padrão", mas com mais capacidade por unidade de pesquisa.
standard3	string	A maior oferta Standard com até 12 partições e 12 réplicas (ou até três partições com mais índices se você também definir a propriedade hostingMode como 'highDensity').
storage_optimized_l1	string	Camada faturável para um serviço dedicado que dá suporte a 1 TB por partição, até 12 partições.
storage_optimized_l2	string	Camada faturável para um serviço dedicado que dá suporte a 2 TB por partição, até 12 partições.