Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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.
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 |
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 |
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 |
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 |
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 |
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 |
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 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 |
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 |
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 |
Ś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 |
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.