Microsoft.Search SearchServices 2020-03-13

Definicja zasobu Bicep

Typ zasobu searchServices można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Search/searchServices, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.Search/searchServices@2020-03-13' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  identity: {
    type: 'string'
  }
  properties: {
    hostingMode: 'string'
    networkRuleSet: {
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    publicNetworkAccess: 'string'
    replicaCount: int
  }
}

Wartości właściwości

searchServices

Nazwa Opis Wartość
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja geograficzna zasobu. Musi to być jeden z obsługiwanych i zarejestrowanych regionów geograficznych platformy Azure (na przykład Zachodnie stany USA, Wschodnie stany USA, Azja Południowo-Wschodnia itd.). Ta właściwość jest wymagana podczas tworzenia nowego zasobu. ciąg
tags Tagi ułatwiające kategoryzowanie zasobu w Azure Portal. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
sku Jednostka SKU usługi search, która określa warstwę cenową i limity pojemności. Ta właściwość jest wymagana podczas tworzenia nowej usługi wyszukiwania. Numer jednostki magazynowej
identity Tożsamość zasobu. Tożsamość
properties Właściwości usługa wyszukiwania. Właściwości usługi wyszukiwania

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości. "Brak"
"SystemAssigned" (wymagane)

Właściwości usługi wyszukiwania

Nazwa Opis Wartość
hostingMode Dotyczy tylko jednostki SKU w warstwie Standardowa3. Tę właściwość można ustawić tak, aby umożliwić maksymalnie 3 partycje o wysokiej gęstości, które zezwalają na maksymalnie 1000 indeksów, co jest znacznie wyższe niż maksymalna liczba indeksów dozwolonych dla dowolnej innej jednostki SKU. W przypadku jednostki SKU w warstwie Standardowa3 wartość to "default" lub "highDensity". W przypadku wszystkich innych jednostek SKU ta wartość musi mieć wartość domyślną. "default"
"highDensity"
networkRuleSet Reguły specyficzne dla sieci, które określają, jak można uzyskać dostęp do usługi Azure Cognitive Search. NetworkRuleSet
partitionCount Liczba partycji w usługa wyszukiwania; jeśli jest określona, może to być 1, 2, 3, 4, 6 lub 12. Wartości większe niż 1 są prawidłowe tylko dla standardowych jednostek SKU. W przypadku usług "standard3" z hostMode ustawionym na wartość "highDensity" dozwolone wartości to od 1 do 3. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 12
publicNetworkAccess Tę wartość można ustawić na wartość "włączone", aby uniknąć zmian powodujących niezgodność istniejących zasobów i szablonów klientów. W przypadku ustawienia wartości "disabled" ruch za pośrednictwem interfejsu publicznego jest niedozwolony, a połączenia prywatnych punktów końcowych będą wyłączną metodą dostępu. "wyłączone"
"włączone"
replicaCount Liczba replik w usługa wyszukiwania. Jeśli jest określona, musi być wartością z zakresu od 1 do 12 włącznie dla standardowych jednostek SKU lub od 1 do 3 włącznie dla podstawowej jednostki SKU. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 12

NetworkRuleSet

Nazwa Opis Wartość
adresy IPRules Lista reguł ograniczeń adresów IP, które definiują sieci przychodzące z zezwoleniem na dostęp do punktu końcowego usługi wyszukiwania. W międzyczasie wszystkie inne publiczne sieci IP są blokowane przez zaporę. Te reguły ograniczeń są stosowane tylko wtedy, gdy wartość "publicNetworkAccess" usługi wyszukiwania jest włączona; w przeciwnym razie ruch za pośrednictwem interfejsu publicznego nie jest dozwolony nawet w przypadku żadnych reguł publicznego adresu IP, a połączenia prywatnych punktów końcowych będą wyłączną metodą dostępu. IpRule[]

Adres IPRule

Nazwa Opis Wartość
wartość Wartość odpowiadająca pojedynczemu adresowi IPv4 (np. 123.1.2.3) lub zakresowi adresów IP w formacie CIDR (np. 123.1.2.3/24) może być dozwolona. ciąg

SKU

Nazwa Opis Wartość
name Jednostka SKU usługa wyszukiwania. Prawidłowe wartości to: "bezpłatna": usługa udostępniona. "basic": Dedykowana usługa z maksymalnie 3 replikami. "Standardowa": Dedykowana usługa z maksymalnie 12 partycjami i 12 replikami. "standard2": podobny do standardowego, ale z większą pojemnością na jednostkę wyszukiwania. "standard3": największa oferta w warstwie Standardowa z maksymalnie 12 partycjami i 12 replikami (lub maksymalnie 3 partycje z większą większa większa liczba indeksów, jeśli ustawisz również właściwość hostingMode na "highDensity"). "storage_optimized_l1": obsługuje 1 TB na partycję, maksymalnie 12 partycji. "storage_optimized_l2": obsługuje 2 TB na partycję, maksymalnie 12 partycji. "basic"
"za darmo"
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Aplikacja internetowa z SQL Database, Azure Cosmos DB, Azure Search

Wdróż na platformie Azure
Ten szablon aprowizuje aplikację internetową, SQL Database, Azure Cosmos DB, Azure Search i Application Insights.
usługa Azure Cognitive Search

Wdróż na platformie Azure
Ten szablon tworzy usługę Azure Cognitive Search
usługa Azure Cognitive Search z prywatnym punktem końcowym

Wdróż na platformie Azure
Ten szablon tworzy usługę Azure Cognitive Search z prywatnym punktem końcowym.

Definicja zasobu szablonu usługi ARM

Typ zasobu searchServices można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Search/searchServices, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2020-03-13",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "identity": {
    "type": "string"
  },
  "properties": {
    "hostingMode": "string",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "partitionCount": "int",
    "publicNetworkAccess": "string",
    "replicaCount": "int"
  }
}

Wartości właściwości

searchServices

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Search/searchServices"
apiVersion Wersja interfejsu API zasobów '2020-03-13'
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja geograficzna zasobu. Musi to być jeden z obsługiwanych i zarejestrowanych regionów geograficznych platformy Azure (na przykład Zachodnie stany USA, Wschodnie stany USA, Azja Południowo-Wschodnia itd.). Ta właściwość jest wymagana podczas tworzenia nowego zasobu. ciąg
tags Tagi ułatwiające kategoryzowanie zasobu w Azure Portal. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
sku Jednostka SKU usługi search, która określa warstwę cenową i limity pojemności. Ta właściwość jest wymagana podczas tworzenia nowej usługi wyszukiwania. Numer jednostki magazynowej
identity Tożsamość zasobu. Tożsamość
properties Właściwości usługa wyszukiwania. Właściwości usługi wyszukiwania

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości. "Brak"
"SystemAssigned" (wymagane)

Właściwości usługi wyszukiwania

Nazwa Opis Wartość
hostingMode Dotyczy tylko jednostki SKU w warstwie Standardowa3. Tę właściwość można ustawić tak, aby umożliwić maksymalnie 3 partycje o wysokiej gęstości, które zezwalają na maksymalnie 1000 indeksów, co jest znacznie wyższe niż maksymalna liczba indeksów dozwolonych dla dowolnej innej jednostki SKU. W przypadku jednostki SKU w warstwie Standardowa3 wartość to "default" lub "highDensity". W przypadku wszystkich innych jednostek SKU ta wartość musi mieć wartość domyślną. "default"
"highDensity"
networkRuleSet Reguły specyficzne dla sieci, które określają, jak można uzyskać dostęp do usługi Azure Cognitive Search. NetworkRuleSet
partitionCount Liczba partycji w usługa wyszukiwania; jeśli jest określona, może to być 1, 2, 3, 4, 6 lub 12. Wartości większe niż 1 są prawidłowe tylko dla standardowych jednostek SKU. W przypadku usług "standard3" z hostMode ustawionym na wartość "highDensity" dozwolone wartości to od 1 do 3. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 12
publicNetworkAccess Tę wartość można ustawić na wartość "włączone", aby uniknąć zmian powodujących niezgodność istniejących zasobów i szablonów klientów. W przypadku ustawienia wartości "disabled" ruch za pośrednictwem interfejsu publicznego jest niedozwolony, a połączenia prywatnych punktów końcowych będą wyłączną metodą dostępu. "wyłączone"
"włączone"
replicaCount Liczba replik w usługa wyszukiwania. Jeśli jest określona, musi być wartością z zakresu od 1 do 12 włącznie dla standardowych jednostek SKU lub od 1 do 3 włącznie dla podstawowej jednostki SKU. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 12

NetworkRuleSet

Nazwa Opis Wartość
adresy IPRules Lista reguł ograniczeń adresów IP, które definiują sieci przychodzące z zezwoleniem na dostęp do punktu końcowego usługi wyszukiwania. W międzyczasie wszystkie inne publiczne sieci IP są blokowane przez zaporę. Te reguły ograniczeń są stosowane tylko wtedy, gdy wartość "publicNetworkAccess" usługi wyszukiwania jest włączona; w przeciwnym razie ruch za pośrednictwem interfejsu publicznego nie jest dozwolony nawet w przypadku żadnych reguł publicznego adresu IP, a połączenia prywatnych punktów końcowych będą wyłączną metodą dostępu. IpRule[]

Adres IPRule

Nazwa Opis Wartość
wartość Wartość odpowiadająca pojedynczemu adresowi IPv4 (np. 123.1.2.3) lub zakresowi adresów IP w formacie CIDR (np. 123.1.2.3/24) może być dozwolona. ciąg

SKU

Nazwa Opis Wartość
name Jednostka SKU usługa wyszukiwania. Prawidłowe wartości to: "bezpłatna": usługa udostępniona. "basic": Dedykowana usługa z maksymalnie 3 replikami. "Standardowa": Dedykowana usługa z maksymalnie 12 partycjami i 12 replikami. "standard2": podobny do standardowego, ale z większą pojemnością na jednostkę wyszukiwania. "standard3": największa oferta w warstwie Standardowa z maksymalnie 12 partycjami i 12 replikami (lub maksymalnie 3 partycje z większą większa większa liczba indeksów, jeśli ustawisz również właściwość hostingMode na "highDensity"). "storage_optimized_l1": obsługuje 1 TB na partycję, maksymalnie 12 partycji. "storage_optimized_l2": obsługuje 2 TB na partycję, maksymalnie 12 partycji. "basic"
"za darmo"
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Aplikacja internetowa z SQL Database, Azure Cosmos DB, Azure Search

Wdróż na platformie Azure
Ten szablon aprowizuje aplikację internetową, SQL Database, Azure Cosmos DB, Azure Search i Application Insights.
usługa Azure Cognitive Search

Wdróż na platformie Azure
Ten szablon tworzy usługę Azure Cognitive Search
usługa Azure Cognitive Search z prywatnym punktem końcowym

Wdróż na platformie Azure
Ten szablon tworzy usługę Azure Cognitive Search z prywatnym punktem końcowym.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu searchServices można wdrożyć z operacjami docelowymi:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Search/searchServices, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2020-03-13"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "SystemAssigned"
  }
  body = jsonencode({
    properties = {
      hostingMode = "string"
      networkRuleSet = {
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      publicNetworkAccess = "string"
      replicaCount = int
    }
    sku = {
      name = "string"
    }
  })
}

Wartości właściwości

searchServices

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Search/searchServices@2020-03-13"
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja geograficzna zasobu. Musi to być jeden z obsługiwanych i zarejestrowanych regionów geograficznych platformy Azure (na przykład Zachodnie stany USA, Wschodnie stany USA, Azja Południowo-Wschodnia itd.). Ta właściwość jest wymagana podczas tworzenia nowego zasobu. ciąg
parent_id Aby przeprowadzić wdrożenie w grupie zasobów, użyj identyfikatora tej grupy zasobów. ciąg (wymagany)
tags Tagi ułatwiające kategoryzowanie zasobu w Azure Portal. Słownik nazw tagów i wartości.
sku Jednostka SKU usługi search, która określa warstwę cenową i limity pojemności. Ta właściwość jest wymagana podczas tworzenia nowej usługi wyszukiwania. Numer jednostki magazynowej
identity Tożsamość zasobu. Tożsamość
properties Właściwości usługa wyszukiwania. Właściwości usługi wyszukiwania

Tożsamość

Nazwa Opis Wartość
typ Typ tożsamości. "SystemAssigned" (wymagane)

Właściwości usługi wyszukiwania

Nazwa Opis Wartość
hostingMode Dotyczy tylko jednostki SKU w warstwie Standardowa3. Tę właściwość można ustawić tak, aby umożliwić maksymalnie 3 partycje o wysokiej gęstości, które umożliwiają maksymalnie 1000 indeksów, co jest znacznie wyższe niż maksymalne indeksy dozwolone dla dowolnej innej jednostki SKU. W przypadku jednostki SKU w warstwie Standardowa3 wartość to "default" lub "highDensity". Dla wszystkich innych jednostek SKU ta wartość musi być "domyślna". "default"
"highDensity"
networkRuleSet Reguły specyficzne dla sieci, które określają, jak można osiągnąć usługę Azure Cognitive Search. NetworkRuleSet
partitionCount Liczba partycji w usługa wyszukiwania; jeśli zostanie określona, może to być 1, 2, 3, 4, 6 lub 12. Wartości większe niż 1 są prawidłowe tylko dla standardowych jednostek SKU. W przypadku usług "standard3" z hostMode ustawionym na wartość "highDensity" dozwolone wartości to od 1 do 3. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 12
publicNetworkAccess Tę wartość można ustawić na "włączone", aby uniknąć zmian powodujących niezgodność istniejących zasobów i szablonów klientów. Jeśli ustawiono wartość "disabled", ruch za pośrednictwem interfejsu publicznego jest niedozwolony, a prywatne połączenia punktu końcowego będą metodą wyłącznego dostępu. "wyłączone"
"włączone"
replicaCount Liczba replik w usługa wyszukiwania. W przypadku określenia musi to być wartość z zakresu od 1 do 12 włącznie dla standardowych jednostek SKU lub od 1 do 3 włącznie dla podstawowej jednostki SKU. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 12

NetworkRuleSet

Nazwa Opis Wartość
ipRules Lista reguł ograniczeń adresów IP definiujących sieci przychodzące z zezwoleniem na dostęp do punktu końcowego usługi wyszukiwania. W międzyczasie wszystkie inne publiczne sieci IP są blokowane przez zaporę. Te reguły ograniczeń są stosowane tylko wtedy, gdy "publicNetworkAccess" usługi wyszukiwania jest "włączona"; w przeciwnym razie ruch za pośrednictwem interfejsu publicznego nie jest dozwolony nawet w przypadku żadnych reguł publicznego adresu IP, a połączenia prywatnego punktu końcowego byłyby metodą wyłącznego dostępu. IpRule[]

IpRule

Nazwa Opis Wartość
wartość Wartość odpowiadająca pojedynczemu adresowi IPv4 (np. 123.1.2.3) lub zakresowi adresów IP w formacie CIDR (np. 123.1.2.3/24) może być dozwolona. ciąg

SKU

Nazwa Opis Wartość
name Jednostka SKU usługa wyszukiwania. Prawidłowe wartości to: "bezpłatna": usługa udostępniona. "basic": Dedykowana usługa z maksymalnie 3 replikami. "Standardowa": Dedykowana usługa z maksymalnie 12 partycjami i 12 replikami. "standard2": podobnie jak w warstwie Standardowa, ale z większą pojemnością na jednostkę wyszukiwania. "standard3": największa oferta w warstwie Standardowa z maksymalnie 12 partycjami i 12 replikami (lub maksymalnie 3 partycje o większej godzinie, jeśli ustawisz również właściwość hostingMode na "highDensity"). "storage_optimized_l1": obsługuje 1 TB na partycję, maksymalnie 12 partycji. "storage_optimized_l2": obsługuje 2 TB na partycję, do 12 partycji. "basic"
"bezpłatnie"
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"