Udostępnij przez


Microsoft.Cache Redis 2016-04-01

Definicja zasobu Bicep

Typ zasobu Usługi Redis można wdrożyć przy użyciu operacji docelowych:

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

Format zasobu

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

resource symbolicname 'Microsoft.Cache/Redis@2016-04-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    enableNonSslPort: bool
    redisConfiguration: {
      {customized property}: 'string'
    }
    shardCount: int
    sku: {
      capacity: int
      family: 'string'
      name: 'string'
    }
    staticIP: 'string'
    subnetId: 'string'
    tenantSettings: {
      {customized property}: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Wartości właściwości

Microsoft.Cache/Redis

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości pamięci podręcznej Redis Cache. RedisCreatePropertiesOrRedisResourceProperties (wymagane)
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

RedisCreatePropertiesOrRedisResourceProperties

Nazwa Opis Wartość
enableNonSslPort (włącz dostęp do NonSslPort) Określa, czy port serwera Redis innego niż ssl (6379) jest włączony. Bool
Konfiguracja redisConfiguration Wszystkie ustawienia usługi Redis. Kilka możliwych kluczy: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slower-than,slowlog-max-len,list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value itp. RedisPropertiesRedisConfiguration
shardCount (liczba odłamków) Liczba fragmentów do utworzenia w pamięci podręcznej klastra w warstwie Premium. Int
Numer jednostki magazynowej Jednostka SKU pamięci podręcznej Redis do wdrożenia. sku (wymagane)
staticIP (adres internetowy) Statyczny adres IP. Wymagane podczas wdrażania pamięci podręcznej Redis w istniejącej sieci wirtualnej platformy Azure. struna

Ograniczenia:
Wzorzec = ^\d+\.\d+\.\d+\.\d+$
subnetId (identyfikator podsieci) Pełny identyfikator zasobu podsieci w sieci wirtualnej w celu wdrożenia pamięci podręcznej Redis Cache. Przykładowy format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Sieć|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1/subnet1 struna

Ograniczenia:
Wzorzec = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings (Ustawienia dzierżawy) tenantSettings (Ustawienia dzierżawy) RedisPropertiesTenantSettings

RedisPropertiesRedisConfiguration

Nazwa Opis Wartość

RedisPropertiesTenantSettings

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Numer jednostki magazynowej

Nazwa Opis Wartość
dyspozycyjność Rozmiar pamięci podręcznej Redis do wdrożenia. Prawidłowe wartości: dla rodziny C (Podstawowa/Standardowa) (0, 1, 2, 3, 4, 5, 6), dla rodziny P (Premium) (1, 2, 3, 4). int (wymagane)
rodzina Rodzina jednostek SKU do użycia. Prawidłowe wartości: (C, P). (C = Podstawowa/Standardowa, P = Premium). "C"
"P" (wymagane)
nazwa Typ pamięci podręcznej Redis do wdrożenia. Prawidłowe wartości: (Podstawowa, Standardowa, Premium) "Podstawowa"
"Premium"
"Standardowa" (wymagana)

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
pamięci podręcznej Redis Cache Moduł zasobów AVM dla pamięci podręcznej Redis Cache

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
Tworzenie pamięci podręcznej Redis Cache w warstwie Premium z klastrowaniem Ten szablon przedstawia sposób konfigurowania klastrowania w wystąpieniu usługi Azure Redis Cache w warstwie Premium.
Tworzenie pamięci podręcznej Redis Przy użyciu szablonu Ten szablon tworzy pamięć podręczną Azure Redis Cache z danymi diagnostycznymi przechowywanymi na koncie magazynu.
utwórz pamięć podręczną Redis Cache przy użyciu uwierzytelniania entra firmy Microsoft. Ten szablon tworzy pamięć podręczną Redis Cache. Następnie przypisuje wbudowane zasady dostępu do użytkownika usługi Redis. Następnie tworzy niestandardowe zasady dostępu. Następnie przypisuje niestandardowe zasady dostępu do innego użytkownika usługi Redis.
Tworzenie aplikacji internetowej i pamięci podręcznej Redis Cache przy użyciu szablonu Ten szablon tworzy aplikację internetową platformy Azure z pamięcią podręczną Redis Cache.
Tworzenie pamięci podręcznej Redis Cache w warstwie Premium wdrożonej w sieci wirtualnej Ten szablon przedstawia sposób wdrażania wystąpienia usługi Azure Redis Cache w warstwie Premium w istniejącej sieci wirtualnej
Tworzenie pamięci podręcznej Redis Cache w warstwie Premium z trwałością danych W tym szablonie pokazano, jak skonfigurować trwałość w wystąpieniu usługi Azure Redis Cache w warstwie Premium.
wdrażanie usługi API Management za pomocą zewnętrznej pamięci podręcznej Azure Cache for Redis Ten szablon przedstawia sposób tworzenia wystąpienia usługi Azure API Management w warstwie Zużycie z zewnętrznym wystąpieniem usługi Azure Cache for Redis jako zewnętrzną pamięcią podręczną usługi API Management.

Definicja zasobu szablonu usługi ARM

Typ zasobu Usługi Redis można wdrożyć przy użyciu operacji docelowych:

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

Format zasobu

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

{
  "type": "Microsoft.Cache/Redis",
  "apiVersion": "2016-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "enableNonSslPort": "bool",
    "redisConfiguration": {
      "{customized property}": "string"
    },
    "shardCount": "int",
    "sku": {
      "capacity": "int",
      "family": "string",
      "name": "string"
    },
    "staticIP": "string",
    "subnetId": "string",
    "tenantSettings": {
      "{customized property}": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Wartości właściwości

Microsoft.Cache/Redis

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API '2016-04-01'
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości pamięci podręcznej Redis Cache. RedisCreatePropertiesOrRedisResourceProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.Cache/Redis"

RedisCreatePropertiesOrRedisResourceProperties

Nazwa Opis Wartość
enableNonSslPort (włącz dostęp do NonSslPort) Określa, czy port serwera Redis innego niż ssl (6379) jest włączony. Bool
Konfiguracja redisConfiguration Wszystkie ustawienia usługi Redis. Kilka możliwych kluczy: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slower-than,slowlog-max-len,list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value itp. RedisPropertiesRedisConfiguration
shardCount (liczba odłamków) Liczba fragmentów do utworzenia w pamięci podręcznej klastra w warstwie Premium. Int
Numer jednostki magazynowej Jednostka SKU pamięci podręcznej Redis do wdrożenia. sku (wymagane)
staticIP (adres internetowy) Statyczny adres IP. Wymagane podczas wdrażania pamięci podręcznej Redis w istniejącej sieci wirtualnej platformy Azure. struna

Ograniczenia:
Wzorzec = ^\d+\.\d+\.\d+\.\d+$
subnetId (identyfikator podsieci) Pełny identyfikator zasobu podsieci w sieci wirtualnej w celu wdrożenia pamięci podręcznej Redis Cache. Przykładowy format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Sieć|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1/subnet1 struna

Ograniczenia:
Wzorzec = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings (Ustawienia dzierżawy) tenantSettings (Ustawienia dzierżawy) RedisPropertiesTenantSettings

RedisPropertiesRedisConfiguration

Nazwa Opis Wartość

RedisPropertiesTenantSettings

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Numer jednostki magazynowej

Nazwa Opis Wartość
dyspozycyjność Rozmiar pamięci podręcznej Redis do wdrożenia. Prawidłowe wartości: dla rodziny C (Podstawowa/Standardowa) (0, 1, 2, 3, 4, 5, 6), dla rodziny P (Premium) (1, 2, 3, 4). int (wymagane)
rodzina Rodzina jednostek SKU do użycia. Prawidłowe wartości: (C, P). (C = Podstawowa/Standardowa, P = Premium). "C"
"P" (wymagane)
nazwa Typ pamięci podręcznej Redis do wdrożenia. Prawidłowe wartości: (Podstawowa, Standardowa, Premium) "Podstawowa"
"Premium"
"Standardowa" (wymagana)

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
Tworzenie pamięci podręcznej Redis Cache w warstwie Premium z klastrowaniem

wdrażanie w usłudze Azure
Ten szablon przedstawia sposób konfigurowania klastrowania w wystąpieniu usługi Azure Redis Cache w warstwie Premium.
Tworzenie pamięci podręcznej Redis Przy użyciu szablonu

wdrażanie w usłudze Azure
Ten szablon tworzy pamięć podręczną Azure Redis Cache z danymi diagnostycznymi przechowywanymi na koncie magazynu.
utwórz pamięć podręczną Redis Cache przy użyciu uwierzytelniania entra firmy Microsoft.

wdrażanie w usłudze Azure
Ten szablon tworzy pamięć podręczną Redis Cache. Następnie przypisuje wbudowane zasady dostępu do użytkownika usługi Redis. Następnie tworzy niestandardowe zasady dostępu. Następnie przypisuje niestandardowe zasady dostępu do innego użytkownika usługi Redis.
tworzenie aplikacji internetowej i pamięci podręcznej Redis i bazy danych SQL DB przy użyciu szablonu

wdrażanie w usłudze Azure
Ten szablon tworzy aplikację internetową platformy Azure z pamięcią podręczną Redis Cache i usługą SQL Database.
Tworzenie aplikacji internetowej i pamięci podręcznej Redis Cache przy użyciu szablonu

wdrażanie w usłudze Azure
Ten szablon tworzy aplikację internetową platformy Azure z pamięcią podręczną Redis Cache.
Tworzenie pamięci podręcznej Redis Cache w warstwie Premium wdrożonej w sieci wirtualnej

wdrażanie w usłudze Azure
Ten szablon przedstawia sposób wdrażania wystąpienia usługi Azure Redis Cache w warstwie Premium w istniejącej sieci wirtualnej
Tworzenie pamięci podręcznej Redis Cache w warstwie Premium z trwałością danych

wdrażanie w usłudze Azure
W tym szablonie pokazano, jak skonfigurować trwałość w wystąpieniu usługi Azure Redis Cache w warstwie Premium.
Tworzenie dwóch geograficznie replikowanych pamięci podręcznych w sieci wirtualnej

wdrażanie w usłudze Azure
Ten szablon przedstawia sposób wdrażania dwóch wystąpień usługi Azure Cache for Redis w warstwie Premium w oddzielnych sieciach wirtualnych i łączenia ich z replikacją geograficzną.
wdrażanie usługi API Management za pomocą zewnętrznej pamięci podręcznej Azure Cache for Redis

wdrażanie w usłudze Azure
Ten szablon przedstawia sposób tworzenia wystąpienia usługi Azure API Management w warstwie Zużycie z zewnętrznym wystąpieniem usługi Azure Cache for Redis jako zewnętrzną pamięcią podręczną usługi API Management.
witryna internetowa eShop z środowiska ASE z wewnętrznym modułem równoważenia obciążenia

wdrażanie w usłudze Azure
Środowisko App Service Environment to opcja planu usługi Premium usługi Azure App Service, która zapewnia w pełni izolowane i dedykowane środowisko do bezpiecznego uruchamiania aplikacji usługi Azure App Service na dużą skalę, w tym usług Web Apps, Mobile Apps i API Apps.
skalowalna aplikacja internetowa Umbraco CMS

wdrażanie w usłudze Azure
Ten szablon umożliwia łatwe wdrażanie aplikacji internetowej umbraco CMS w usłudze Azure App Service Web Apps.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu Usługi Redis można wdrożyć przy użyciu operacji docelowych:

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

Format zasobu

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Cache/Redis@2016-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      enableNonSslPort = bool
      redisConfiguration = {
        {customized property} = "string"
      }
      shardCount = int
      sku = {
        capacity = int
        family = "string"
        name = "string"
      }
      staticIP = "string"
      subnetId = "string"
      tenantSettings = {
        {customized property} = "string"
      }
    }
  }
}

Wartości właściwości

Microsoft.Cache/Redis

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości Właściwości pamięci podręcznej Redis Cache. RedisCreatePropertiesOrRedisResourceProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.Cache/Redis@2016-04-01"

RedisCreatePropertiesOrRedisResourceProperties

Nazwa Opis Wartość
enableNonSslPort (włącz dostęp do NonSslPort) Określa, czy port serwera Redis innego niż ssl (6379) jest włączony. Bool
Konfiguracja redisConfiguration Wszystkie ustawienia usługi Redis. Kilka możliwych kluczy: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slower-than,slowlog-max-len,list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value itp. RedisPropertiesRedisConfiguration
shardCount (liczba odłamków) Liczba fragmentów do utworzenia w pamięci podręcznej klastra w warstwie Premium. Int
Numer jednostki magazynowej Jednostka SKU pamięci podręcznej Redis do wdrożenia. sku (wymagane)
staticIP (adres internetowy) Statyczny adres IP. Wymagane podczas wdrażania pamięci podręcznej Redis w istniejącej sieci wirtualnej platformy Azure. struna

Ograniczenia:
Wzorzec = ^\d+\.\d+\.\d+\.\d+$
subnetId (identyfikator podsieci) Pełny identyfikator zasobu podsieci w sieci wirtualnej w celu wdrożenia pamięci podręcznej Redis Cache. Przykładowy format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Sieć|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1/subnet1 struna

Ograniczenia:
Wzorzec = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$
tenantSettings (Ustawienia dzierżawy) tenantSettings (Ustawienia dzierżawy) RedisPropertiesTenantSettings

RedisPropertiesRedisConfiguration

Nazwa Opis Wartość

RedisPropertiesTenantSettings

Nazwa Opis Wartość

Tagi zasobów

Nazwa Opis Wartość

Numer jednostki magazynowej

Nazwa Opis Wartość
dyspozycyjność Rozmiar pamięci podręcznej Redis do wdrożenia. Prawidłowe wartości: dla rodziny C (Podstawowa/Standardowa) (0, 1, 2, 3, 4, 5, 6), dla rodziny P (Premium) (1, 2, 3, 4). int (wymagane)
rodzina Rodzina jednostek SKU do użycia. Prawidłowe wartości: (C, P). (C = Podstawowa/Standardowa, P = Premium). "C"
"P" (wymagane)
nazwa Typ pamięci podręcznej Redis do wdrożenia. Prawidłowe wartości: (Podstawowa, Standardowa, Premium) "Podstawowa"
"Premium"
"Standardowa" (wymagana)

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania usługi Redis Cache.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "eastus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "redis" {
  type      = "Microsoft.Cache/redis@2023-04-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      sku = {
        capacity = 2
        family   = "C"
        name     = "Standard"
      }
      enableNonSslPort  = true
      minimumTlsVersion = "1.2"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
pamięci podręcznej Redis Cache Moduł zasobów AVM dla pamięci podręcznej Redis Cache