Udostępnij przez


Microsoft.Cache redis

Definicja zasobu Bicep

Typ zasobu redis można wdrożyć za pomocą operacji, które są przeznaczone:

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@2024-11-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    disableAccessKeyAuthentication: bool
    enableNonSslPort: bool
    minimumTlsVersion: 'string'
    publicNetworkAccess: 'string'
    redisConfiguration: {
      aad-enabled: 'string'
      aof-backup-enabled: 'string'
      aof-storage-connection-string-0: 'string'
      aof-storage-connection-string-1: 'string'
      authnotrequired: 'string'
      maxfragmentationmemory-reserved: 'string'
      maxmemory-delta: 'string'
      maxmemory-policy: 'string'
      maxmemory-reserved: 'string'
      notify-keyspace-events: 'string'
      preferred-data-persistence-auth-method: 'string'
      rdb-backup-enabled: 'string'
      rdb-backup-frequency: 'string'
      rdb-backup-max-snapshot-count: 'string'
      rdb-storage-connection-string: 'string'
      storage-subscription-id: 'string'
    }
    redisVersion: 'string'
    replicasPerMaster: int
    replicasPerPrimary: int
    shardCount: int
    sku: {
      capacity: int
      family: 'string'
      name: 'string'
    }
    staticIP: 'string'
    subnetId: 'string'
    tenantSettings: {
      {customized property}: 'string'
    }
    updateChannel: 'string'
    zonalAllocationPolicy: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Wartości właściwości

Microsoft.Cache/redis

Nazwa Opis Wartość
tożsamość Tożsamość zasobu. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości pamięci podręcznej Redis Cache. RedisCreatePropertiesOrRedisProperties (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
Stref Lista stref dostępności oznaczających miejsce, z którego musi pochodzić zasób. ciąg znakowy[]

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nazwa Opis Wartość
Obsługa algorytmu AAD Określa, czy uwierzytelnianie oparte na usłudze AAD zostało włączone, czy wyłączone dla pamięci podręcznej ciąg
Obsługa kopii zapasowej AOF Określa, czy jest włączona kopia zapasowa aof ciąg
aof-storage-connection-string-0 Pierwsze parametry połączenia konta magazynu ciąg
aof-ciąg-połączenia-magazynu-1 Parametry połączenia drugiego konta magazynu ciąg
authnotrequired (uwierzytelnianie) Określa, czy uwierzytelnianie jest wyłączone. Ustawienie tej właściwości jest zdecydowanie odradzane z punktu widzenia bezpieczeństwa; Nigdy nie należy wyłączać uwierzytelniania przy użyciu tej właściwości! ciąg
maxfragmentationmemory-reserved Wartość w megabajtach zarezerwowana dla fragmentacji na fragmenty ciąg
maxmemory-delta Wartość w megabajtach zarezerwowana dla użycia bez pamięci podręcznej na fragment, np. tryb failover. ciąg
Polityka maksymalnej pamięci Strategia eksmisji używana, gdy dane nie mieszczą się w limicie pamięci. ciąg
maxmemory-reserved (rezerwacja pamięci maksymalnej) Wartość w megabajtach zarezerwowana dla użycia bez pamięci podręcznej na fragment, np. tryb failover. ciąg
powiadomienia-zdarzenia-przestrzeni-kluczowej Zdarzenia przestrzeni kluczy, które powinny być monitorowane. ciąg
preferowana-metoda-uwierzytelniania-trwałości danych Preferowana metoda uwierzytelniania do komunikowania się z kontem magazynu używanym na potrzeby trwałości danych, określ sygnaturę dostępu współdzielonego lub tożsamość zarządzaną, wartość domyślna to SAS ciąg
Obsługa kopii zapasowej bazy danych rdb Określa, czy kopia zapasowa RDB jest włączona ciąg
częstotliwość tworzenia kopii zapasowych RDB Określa częstotliwość tworzenia kopii zapasowej bazy danych rdb w minutach. Prawidłowe wartości: (15, 30, 60, 360, 720, 1440) ciąg
rdb-backup-max-snapshot-count Określa maksymalną liczbę migawek kopii zapasowej bazy danych rdb ciąg
ciąg połączenia do pamięci masowej bazi danych rdb Parametry połączenia konta magazynu do przechowywania pliku rdb ciąg
identyfikator-subskrypcji magazynu SubscriptionId konta magazynu dla trwałości (aof/rdb) przy użyciu identyfikatora ManagedIdentity. ciąg

RedisCommonPropertiesTenantSettings

Nazwa Opis Wartość

RedisCreateParametersTags

Nazwa Opis Wartość

RedisCreatePropertiesOrRedisProperties

Nazwa Opis Wartość
disableAccessKeyAuthentication (Uwierzytelnianie klucza dostępu) Uwierzytelnianie w usłudze Redis za pośrednictwem kluczy dostępu jest wyłączone po ustawieniu wartości true. Wartość domyślna to false. Bool
enableNonSslPort (włącz dostęp do NonSslPort) Określa, czy port serwera Redis innego niż ssl (6379) jest włączony. Bool
minimumTlsVersion Opcjonalnie: wymaga, aby klienci używali określonej wersji protokołu TLS (lub nowszej) do nawiązania połączenia (np. "1.0", "1.1", "1.2") '1.0'
'1.1'
'1.2'
dostęp do sieci publicznej Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tej pamięci podręcznej. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone". Jeśli wartość jest wyłączona, prywatne punkty końcowe są wyłączną metodą dostępu. "Wyłączone"
"Włączone"
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, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 itp. RedisCommonPropertiesRedisConfiguration
redisVersion (wersja redis) Wersja usługi Redis. Powinno to mieć postać "główna[pomocnicza]" (wymagana jest tylko wartość główna) lub wartość "latest", która odnosi się do najnowszej stabilnej wersji usługi Redis, która jest dostępna. Obsługiwane wersje: 4.0, 6.0 (najnowsza wersja). Wartość domyślna to "latest". ciąg
replikiPerMaster Liczba replik do utworzenia na jedną podstawową. Int
replikiPerPrimary Liczba replik do utworzenia na jedną podstawową. Int
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. Opcjonalnie można określić podczas wdrażania pamięci podręcznej Redis w istniejącej sieci wirtualnej platformy Azure; automatycznie przypisane domyślnie. 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) Słownik ustawień dzierżawy RedisCommonPropertiesTenantSettings
Kanał updateChannel Opcjonalnie: określa kanał aktualizacji miesięcznych aktualizacji usługi Redis, które będą odbierane przez pamięć podręczną Redis Cache. Pamięci podręczne korzystające z kanału aktualizacji "Wersja zapoznawcza" pobierają najnowsze aktualizacje usługi Redis co najmniej 4 tygodnie przed pamięciami podręcznymi kanału "Stable". Wartość domyślna to "Stable". "Wersja zapoznawcza"
"Stabilny"
zonalallocationPolicy Opcjonalnie: określa sposób przydzielania stref dostępności do pamięci podręcznej Redis Cache. Opcja "Automatyczne" umożliwia nadmiarowość strefy, a platforma Azure automatycznie wybiera strefy na podstawie dostępności regionalnej i pojemności. Element "UserDefined" wybierze strefy dostępności przekazane za pomocą parametru "zones". Wartość "NoZones" spowoduje utworzenie nieostrej pamięci podręcznej. Jeśli wartość "zonalAllocationPolicy" nie zostanie przekazana, zostanie ona ustawiona na wartość "UserDefined", gdy strefy są przekazywane, w przeciwnym razie zostanie ustawiona wartość "Automatyczna" w regionach, w których strefy są obsługiwane i "NoZones" w regionach, w których strefy nie są obsługiwane. "Automatyczny"
"NoZones"
"UserDefined"

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)

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

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 redis można wdrożyć za pomocą operacji, które są przeznaczone:

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": "2024-11-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "disableAccessKeyAuthentication": "bool",
    "enableNonSslPort": "bool",
    "minimumTlsVersion": "string",
    "publicNetworkAccess": "string",
    "redisConfiguration": {
      "aad-enabled": "string",
      "aof-backup-enabled": "string",
      "aof-storage-connection-string-0": "string",
      "aof-storage-connection-string-1": "string",
      "authnotrequired": "string",
      "maxfragmentationmemory-reserved": "string",
      "maxmemory-delta": "string",
      "maxmemory-policy": "string",
      "maxmemory-reserved": "string",
      "notify-keyspace-events": "string",
      "preferred-data-persistence-auth-method": "string",
      "rdb-backup-enabled": "string",
      "rdb-backup-frequency": "string",
      "rdb-backup-max-snapshot-count": "string",
      "rdb-storage-connection-string": "string",
      "storage-subscription-id": "string"
    },
    "redisVersion": "string",
    "replicasPerMaster": "int",
    "replicasPerPrimary": "int",
    "shardCount": "int",
    "sku": {
      "capacity": "int",
      "family": "string",
      "name": "string"
    },
    "staticIP": "string",
    "subnetId": "string",
    "tenantSettings": {
      "{customized property}": "string"
    },
    "updateChannel": "string",
    "zonalAllocationPolicy": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Wartości właściwości

Microsoft.Cache/redis

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API '2024-11-01'
tożsamość Tożsamość zasobu. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości pamięci podręcznej Redis Cache. RedisCreatePropertiesOrRedisProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.Cache/redis"
Stref Lista stref dostępności oznaczających miejsce, z którego musi pochodzić zasób. ciąg znakowy[]

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nazwa Opis Wartość
Obsługa algorytmu AAD Określa, czy uwierzytelnianie oparte na usłudze AAD zostało włączone, czy wyłączone dla pamięci podręcznej ciąg
Obsługa kopii zapasowej AOF Określa, czy jest włączona kopia zapasowa aof ciąg
aof-storage-connection-string-0 Pierwsze parametry połączenia konta magazynu ciąg
aof-ciąg-połączenia-magazynu-1 Parametry połączenia drugiego konta magazynu ciąg
authnotrequired (uwierzytelnianie) Określa, czy uwierzytelnianie jest wyłączone. Ustawienie tej właściwości jest zdecydowanie odradzane z punktu widzenia bezpieczeństwa; Nigdy nie należy wyłączać uwierzytelniania przy użyciu tej właściwości! ciąg
maxfragmentationmemory-reserved Wartość w megabajtach zarezerwowana dla fragmentacji na fragmenty ciąg
maxmemory-delta Wartość w megabajtach zarezerwowana dla użycia bez pamięci podręcznej na fragment, np. tryb failover. ciąg
Polityka maksymalnej pamięci Strategia eksmisji używana, gdy dane nie mieszczą się w limicie pamięci. ciąg
maxmemory-reserved (rezerwacja pamięci maksymalnej) Wartość w megabajtach zarezerwowana dla użycia bez pamięci podręcznej na fragment, np. tryb failover. ciąg
powiadomienia-zdarzenia-przestrzeni-kluczowej Zdarzenia przestrzeni kluczy, które powinny być monitorowane. ciąg
preferowana-metoda-uwierzytelniania-trwałości danych Preferowana metoda uwierzytelniania do komunikowania się z kontem magazynu używanym na potrzeby trwałości danych, określ sygnaturę dostępu współdzielonego lub tożsamość zarządzaną, wartość domyślna to SAS ciąg
Obsługa kopii zapasowej bazy danych rdb Określa, czy kopia zapasowa RDB jest włączona ciąg
częstotliwość tworzenia kopii zapasowych RDB Określa częstotliwość tworzenia kopii zapasowej bazy danych rdb w minutach. Prawidłowe wartości: (15, 30, 60, 360, 720, 1440) ciąg
rdb-backup-max-snapshot-count Określa maksymalną liczbę migawek kopii zapasowej bazy danych rdb ciąg
ciąg połączenia do pamięci masowej bazi danych rdb Parametry połączenia konta magazynu do przechowywania pliku rdb ciąg
identyfikator-subskrypcji magazynu SubscriptionId konta magazynu dla trwałości (aof/rdb) przy użyciu identyfikatora ManagedIdentity. ciąg

RedisCommonPropertiesTenantSettings

Nazwa Opis Wartość

RedisCreateParametersTags

Nazwa Opis Wartość

RedisCreatePropertiesOrRedisProperties

Nazwa Opis Wartość
disableAccessKeyAuthentication (Uwierzytelnianie klucza dostępu) Uwierzytelnianie w usłudze Redis za pośrednictwem kluczy dostępu jest wyłączone po ustawieniu wartości true. Wartość domyślna to false. Bool
enableNonSslPort (włącz dostęp do NonSslPort) Określa, czy port serwera Redis innego niż ssl (6379) jest włączony. Bool
minimumTlsVersion Opcjonalnie: wymaga, aby klienci używali określonej wersji protokołu TLS (lub nowszej) do nawiązania połączenia (np. "1.0", "1.1", "1.2") '1.0'
'1.1'
'1.2'
dostęp do sieci publicznej Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tej pamięci podręcznej. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone". Jeśli wartość jest wyłączona, prywatne punkty końcowe są wyłączną metodą dostępu. "Wyłączone"
"Włączone"
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, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 itp. RedisCommonPropertiesRedisConfiguration
redisVersion (wersja redis) Wersja usługi Redis. Powinno to mieć postać "główna[pomocnicza]" (wymagana jest tylko wartość główna) lub wartość "latest", która odnosi się do najnowszej stabilnej wersji usługi Redis, która jest dostępna. Obsługiwane wersje: 4.0, 6.0 (najnowsza wersja). Wartość domyślna to "latest". ciąg
replikiPerMaster Liczba replik do utworzenia na jedną podstawową. Int
replikiPerPrimary Liczba replik do utworzenia na jedną podstawową. Int
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. Opcjonalnie można określić podczas wdrażania pamięci podręcznej Redis w istniejącej sieci wirtualnej platformy Azure; automatycznie przypisane domyślnie. 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) Słownik ustawień dzierżawy RedisCommonPropertiesTenantSettings
Kanał updateChannel Opcjonalnie: określa kanał aktualizacji miesięcznych aktualizacji usługi Redis, które będą odbierane przez pamięć podręczną Redis Cache. Pamięci podręczne korzystające z kanału aktualizacji "Wersja zapoznawcza" pobierają najnowsze aktualizacje usługi Redis co najmniej 4 tygodnie przed pamięciami podręcznymi kanału "Stable". Wartość domyślna to "Stable". "Wersja zapoznawcza"
"Stabilny"
zonalallocationPolicy Opcjonalnie: określa sposób przydzielania stref dostępności do pamięci podręcznej Redis Cache. Opcja "Automatyczne" umożliwia nadmiarowość strefy, a platforma Azure automatycznie wybiera strefy na podstawie dostępności regionalnej i pojemności. Element "UserDefined" wybierze strefy dostępności przekazane za pomocą parametru "zones". Wartość "NoZones" spowoduje utworzenie nieostrej pamięci podręcznej. Jeśli wartość "zonalAllocationPolicy" nie zostanie przekazana, zostanie ona ustawiona na wartość "UserDefined", gdy strefy są przekazywane, w przeciwnym razie zostanie ustawiona wartość "Automatyczna" w regionach, w których strefy są obsługiwane i "NoZones" w regionach, w których strefy nie są obsługiwane. "Automatyczny"
"NoZones"
"UserDefined"

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)

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

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 redis można wdrożyć za pomocą operacji, które są przeznaczone:

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@2024-11-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      disableAccessKeyAuthentication = bool
      enableNonSslPort = bool
      minimumTlsVersion = "string"
      publicNetworkAccess = "string"
      redisConfiguration = {
        aad-enabled = "string"
        aof-backup-enabled = "string"
        aof-storage-connection-string-0 = "string"
        aof-storage-connection-string-1 = "string"
        authnotrequired = "string"
        maxfragmentationmemory-reserved = "string"
        maxmemory-delta = "string"
        maxmemory-policy = "string"
        maxmemory-reserved = "string"
        notify-keyspace-events = "string"
        preferred-data-persistence-auth-method = "string"
        rdb-backup-enabled = "string"
        rdb-backup-frequency = "string"
        rdb-backup-max-snapshot-count = "string"
        rdb-storage-connection-string = "string"
        storage-subscription-id = "string"
      }
      redisVersion = "string"
      replicasPerMaster = int
      replicasPerPrimary = int
      shardCount = int
      sku = {
        capacity = int
        family = "string"
        name = "string"
      }
      staticIP = "string"
      subnetId = "string"
      tenantSettings = {
        {customized property} = "string"
      }
      updateChannel = "string"
      zonalAllocationPolicy = "string"
    }
    zones = [
      "string"
    ]
  }
}

Wartości właściwości

Microsoft.Cache/redis

Nazwa Opis Wartość
tożsamość Tożsamość zasobu. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób 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. RedisCreatePropertiesOrRedisProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.Cache/redis@2024-11-01"
Stref Lista stref dostępności oznaczających miejsce, z którego musi pochodzić zasób. ciąg znakowy[]

ManagedServiceIdentity (tożsamość usługi)

Nazwa Opis Wartość
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
tożsamości przypisane użytkownikom Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

RedisCommonPropertiesRedisConfiguration

Nazwa Opis Wartość
Obsługa algorytmu AAD Określa, czy uwierzytelnianie oparte na usłudze AAD zostało włączone, czy wyłączone dla pamięci podręcznej ciąg
Obsługa kopii zapasowej AOF Określa, czy jest włączona kopia zapasowa aof ciąg
aof-storage-connection-string-0 Pierwsze parametry połączenia konta magazynu ciąg
aof-ciąg-połączenia-magazynu-1 Parametry połączenia drugiego konta magazynu ciąg
authnotrequired (uwierzytelnianie) Określa, czy uwierzytelnianie jest wyłączone. Ustawienie tej właściwości jest zdecydowanie odradzane z punktu widzenia bezpieczeństwa; Nigdy nie należy wyłączać uwierzytelniania przy użyciu tej właściwości! ciąg
maxfragmentationmemory-reserved Wartość w megabajtach zarezerwowana dla fragmentacji na fragmenty ciąg
maxmemory-delta Wartość w megabajtach zarezerwowana dla użycia bez pamięci podręcznej na fragment, np. tryb failover. ciąg
Polityka maksymalnej pamięci Strategia eksmisji używana, gdy dane nie mieszczą się w limicie pamięci. ciąg
maxmemory-reserved (rezerwacja pamięci maksymalnej) Wartość w megabajtach zarezerwowana dla użycia bez pamięci podręcznej na fragment, np. tryb failover. ciąg
powiadomienia-zdarzenia-przestrzeni-kluczowej Zdarzenia przestrzeni kluczy, które powinny być monitorowane. ciąg
preferowana-metoda-uwierzytelniania-trwałości danych Preferowana metoda uwierzytelniania do komunikowania się z kontem magazynu używanym na potrzeby trwałości danych, określ sygnaturę dostępu współdzielonego lub tożsamość zarządzaną, wartość domyślna to SAS ciąg
Obsługa kopii zapasowej bazy danych rdb Określa, czy kopia zapasowa RDB jest włączona ciąg
częstotliwość tworzenia kopii zapasowych RDB Określa częstotliwość tworzenia kopii zapasowej bazy danych rdb w minutach. Prawidłowe wartości: (15, 30, 60, 360, 720, 1440) ciąg
rdb-backup-max-snapshot-count Określa maksymalną liczbę migawek kopii zapasowej bazy danych rdb ciąg
ciąg połączenia do pamięci masowej bazi danych rdb Parametry połączenia konta magazynu do przechowywania pliku rdb ciąg
identyfikator-subskrypcji magazynu SubscriptionId konta magazynu dla trwałości (aof/rdb) przy użyciu identyfikatora ManagedIdentity. ciąg

RedisCommonPropertiesTenantSettings

Nazwa Opis Wartość

RedisCreateParametersTags

Nazwa Opis Wartość

RedisCreatePropertiesOrRedisProperties

Nazwa Opis Wartość
disableAccessKeyAuthentication (Uwierzytelnianie klucza dostępu) Uwierzytelnianie w usłudze Redis za pośrednictwem kluczy dostępu jest wyłączone po ustawieniu wartości true. Wartość domyślna to false. Bool
enableNonSslPort (włącz dostęp do NonSslPort) Określa, czy port serwera Redis innego niż ssl (6379) jest włączony. Bool
minimumTlsVersion Opcjonalnie: wymaga, aby klienci używali określonej wersji protokołu TLS (lub nowszej) do nawiązania połączenia (np. "1.0", "1.1", "1.2") '1.0'
'1.1'
'1.2'
dostęp do sieci publicznej Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tej pamięci podręcznej. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone". Jeśli wartość jest wyłączona, prywatne punkty końcowe są wyłączną metodą dostępu. "Wyłączone"
"Włączone"
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, aof-backup-enabled, aof-storage-connection-string-0, aof-storage-connection-string-1 itp. RedisCommonPropertiesRedisConfiguration
redisVersion (wersja redis) Wersja usługi Redis. Powinno to mieć postać "główna[pomocnicza]" (wymagana jest tylko wartość główna) lub wartość "latest", która odnosi się do najnowszej stabilnej wersji usługi Redis, która jest dostępna. Obsługiwane wersje: 4.0, 6.0 (najnowsza wersja). Wartość domyślna to "latest". ciąg
replikiPerMaster Liczba replik do utworzenia na jedną podstawową. Int
replikiPerPrimary Liczba replik do utworzenia na jedną podstawową. Int
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. Opcjonalnie można określić podczas wdrażania pamięci podręcznej Redis w istniejącej sieci wirtualnej platformy Azure; automatycznie przypisane domyślnie. 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) Słownik ustawień dzierżawy RedisCommonPropertiesTenantSettings
Kanał updateChannel Opcjonalnie: określa kanał aktualizacji miesięcznych aktualizacji usługi Redis, które będą odbierane przez pamięć podręczną Redis Cache. Pamięci podręczne korzystające z kanału aktualizacji "Wersja zapoznawcza" pobierają najnowsze aktualizacje usługi Redis co najmniej 4 tygodnie przed pamięciami podręcznymi kanału "Stable". Wartość domyślna to "Stable". "Wersja zapoznawcza"
"Stabilny"
zonalallocationPolicy Opcjonalnie: określa sposób przydzielania stref dostępności do pamięci podręcznej Redis Cache. Opcja "Automatyczne" umożliwia nadmiarowość strefy, a platforma Azure automatycznie wybiera strefy na podstawie dostępności regionalnej i pojemności. Element "UserDefined" wybierze strefy dostępności przekazane za pomocą parametru "zones". Wartość "NoZones" spowoduje utworzenie nieostrej pamięci podręcznej. Jeśli wartość "zonalAllocationPolicy" nie zostanie przekazana, zostanie ona ustawiona na wartość "UserDefined", gdy strefy są przekazywane, w przeciwnym razie zostanie ustawiona wartość "Automatyczna" w regionach, w których strefy są obsługiwane i "NoZones" w regionach, w których strefy nie są obsługiwane. "Automatyczny"
"NoZones"
"UserDefined"

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)

UserAssignedIdentities

Nazwa Opis Wartość

Tożsamość przypisana przez użytkownika

Nazwa Opis Wartość

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