Microsoft.Cache redis 2024-11-01
Bicep 리소스 정의
Redis 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Cache/redis 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Cache/redis@2024-11-01' = {
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'
]
}
속성 값
ManagedServiceIdentity
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'(필수) |
| userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | UserAssignedIdentities |
Microsoft.Cache/redis
| 이름 | 묘사 | 값 |
|---|---|---|
| 신원 | 리소스의 ID입니다. | ManagedServiceIdentity |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 이름 | 리소스 이름 | string(필수) |
| 속성 | Redis 캐시 속성입니다. | RedisCreatePropertiesOrRedisProperties(필수) |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
| 영역 | 리소스의 원본 위치를 나타내는 가용성 영역 목록입니다. | string[] |
RedisCommonPropertiesRedisConfiguration
| 이름 | 묘사 | 값 |
|---|---|---|
| aad-enabled | 캐시에 대해 AAD 기반 인증을 사용하도록 설정했는지 여부를 지정합니다. | 문자열 |
| aof-backup-enabled | aof 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| aof-storage-connection-string-0 | 첫 번째 스토리지 계정 연결 문자열 | 문자열 |
| aof-storage-connection-string-1 | 두 번째 스토리지 계정 연결 문자열 | 문자열 |
| authnotrequired | 인증을 사용하지 않도록 설정할지 여부를 지정합니다. 이 속성을 설정하는 것은 보안 관점에서 매우 권장되지 않습니다. | 문자열 |
| maxfragmentationmemory-reserved | 분할당 조각화를 위해 예약된 값(메가바이트) | 문자열 |
| maxmemory-delta | 분할된 데이터베이스당 비 캐시 사용(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| maxmemory-policy | 데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다. | 문자열 |
| maxmemory-reserved | 분할된 데이터베이스당 비 캐시 사용(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| notify-keyspace-events | 모니터링해야 하는 키스페이스 이벤트입니다. | 문자열 |
| preferred-data-persistence-auth-method | 데이터 지속성에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하는 기본 인증 방법, 기본값은 SAS입니다. | 문자열 |
| rdb-backup-enabled | rdb 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| rdb-backup-frequency | 몇 분 안에 rdb 백업을 만드는 빈도를 지정합니다. 유효한 값: (15, 30, 60, 360, 720, 1440) | 문자열 |
| rdb-backup-max-snapshot-count | rdb 백업에 대한 최대 스냅샷 수를 지정합니다. | 문자열 |
| rdb-storage-connection-string | rdb 파일을 저장하기 위한 스토리지 계정 연결 문자열 | 문자열 |
| storage-subscription-id | ManagedIdentity를 사용하는 지속성(aof/rdb)에 대한 스토리지 계정의 SubscriptionId입니다. | 문자열 |
RedisCommonPropertiesTenantSettings
| 이름 | 묘사 | 값 |
|---|
RedisCreateParametersTags
| 이름 | 묘사 | 값 |
|---|
RedisCreatePropertiesOrRedisProperties
| 이름 | 묘사 | 값 | |
|---|---|---|---|
| disableAccessKeyAuthentication | 액세스 키를 통한 Redis 인증은 true로 설정하면 비활성화됩니다. 기본값은 false입니다. | bool | |
| enableNonSslPort | 비 ssl Redis 서버 포트(6379)를 사용할 수 있는지 여부를 지정합니다. | bool | |
| minimumTlsVersion | 선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결하도록 요구합니다(예: '1.0', '1.1', '1.2'). | '1.0' '1.1' '1.2' |
|
| publicNetworkAccess | 이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다. | '사용 안 함' 'Enabled' |
|
| redisConfiguration | 모든 Redis 설정입니다. 몇 가지 가능한 키: 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 등. | RedisCommonPropertiesRedisConfiguration | |
| redisVersion | Redis 버전입니다. 이는 'major[.minor]' 형식('major'만 필요) 또는 사용 가능한 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다. | 문자열 | |
| replicasPerMaster | 주 복제본당 만들 복제본 수입니다. | int | |
| replicasPerPrimary | 주 복제본당 만들 복제본 수입니다. | int | |
| shardCount | 프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다. | int | |
| sku | 배포할 Redis 캐시의 SKU입니다. | Sku(필수) | |
| staticIP | 고정 IP 주소입니다. 필요에 따라 기존 Azure Virtual Network 내에 Redis 캐시를 배포할 때 지정할 수 있습니다. 자동 할당은 기본적으로 할당됩니다. | 문자열 제약 조건: 패턴 = ^\d+\.\d+\.\d+\.\d+$ |
|
| subnetId | Redis 캐시를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다. 예제 형식: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {네트워크 | ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 | 문자열 제약 조건: 패턴 = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |
| tenantSettings | 테넌트 설정의 사전 | RedisCommonPropertiesTenantSettings | |
| updateChannel | 선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다. | '미리 보기' '안정' |
|
| zonalAllocationPolicy | 선택 사항: 가용성 영역이 Redis 캐시에 할당되는 방법을 지정합니다. '자동'은 영역 중복을 사용하도록 설정하고 Azure는 지역 가용성 및 용량에 따라 영역을 자동으로 선택합니다. 'UserDefined'는 'zones' 매개 변수를 사용하여 전달된 가용성 영역을 선택합니다. 'NoZones'는 영역이 아닌 캐시를 생성합니다. 'zonalAllocationPolicy'가 전달되지 않으면 영역이 전달될 때 '사용자 정의'로 설정되고, 그렇지 않으면 영역이 지원되는 지역에서는 '자동'으로 설정되고 영역이 지원되지 않는 지역에서는 'NoZones'로 설정됩니다. | 'Automatic' 'NoZones' 'UserDefined' |
Sku
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | 배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4). | int(필수) |
| 가족 | 사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = Basic/Standard, P = Premium). | 'C' 'P'(필수) |
| 이름 | 배포할 Redis 캐시의 형식입니다. 유효한 값: (Basic, Standard, Premium) | '기본' '프리미엄' 'Standard'(필수) |
UserAssignedIdentities
| 이름 | 묘사 | 값 |
|---|
UserAssignedIdentity
| 이름 | 묘사 | 값 |
|---|
빠른 시작 샘플
다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.
| Bicep 파일 | 묘사 |
|---|---|
| 클러스터링 사용하여 프리미엄 Redis Cache 만들기 | 이 템플릿은 프리미엄 Azure Redis Cache 인스턴스에서 클러스터링을 구성하는 방법을 보여 줍니다. |
| 템플릿 사용하여 Redis Cache 만들기 | 이 템플릿은 스토리지 계정에 유지되는 진단 데이터를 사용하여 Azure Redis Cache를 만듭니다. |
| Microsoft Entra Authentication을 사용하여 Redis Cache를 만듭니다. | 이 템플릿은 Redis Cache를 만듭니다. 그런 다음, Redis 사용자에게 기본 제공 액세스 정책을 할당합니다. 그런 다음 사용자 지정 액세스 정책을 만듭니다. 그런 다음 다른 Redis 사용자에게 사용자 지정 액세스 정책을 할당합니다. |
| 템플릿 사용하여 웹앱 및 Redis Cache 만들기 | 이 템플릿은 Redis 캐시를 사용하여 Azure Web App을 만듭니다. |
| Virtual Network 배포된 프리미엄 Redis Cache 만들기 | 이 템플릿은 프리미엄 Azure Redis Cache 인스턴스를 기존 Virtual Network에 배포하는 방법을 보여 줍니다. |
| 데이터 지속성 사용하여 프리미엄 Redis Cache 만들기 | 이 템플릿은 프리미엄 Azure Redis Cache 인스턴스에서 지속성을 구성하는 방법을 보여 줍니다. |
| 외부 Azure Cache for Redis 사용하여 API Management 배포 |
이 템플릿은 외부 Azure Cache for Redis 인스턴스를 API Management 외부 캐시로 사용하여 소비 계층에서 Azure API Management 인스턴스를 만드는 방법을 보여 줍니다. |
ARM 템플릿 리소스 정의
Redis 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Cache/redis 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"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" ]
}
속성 값
ManagedServiceIdentity
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'(필수) |
| userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | UserAssignedIdentities |
Microsoft.Cache/redis
| 이름 | 묘사 | 값 |
|---|---|---|
| apiVersion | api 버전 | '2024-11-01' |
| 신원 | 리소스의 ID입니다. | ManagedServiceIdentity |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 이름 | 리소스 이름 | string(필수) |
| 속성 | Redis 캐시 속성입니다. | RedisCreatePropertiesOrRedisProperties(필수) |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
| 형 | 리소스 종류 | 'Microsoft.Cache/redis' |
| 영역 | 리소스의 원본 위치를 나타내는 가용성 영역 목록입니다. | string[] |
RedisCommonPropertiesRedisConfiguration
| 이름 | 묘사 | 값 |
|---|---|---|
| aad-enabled | 캐시에 대해 AAD 기반 인증을 사용하도록 설정했는지 여부를 지정합니다. | 문자열 |
| aof-backup-enabled | aof 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| aof-storage-connection-string-0 | 첫 번째 스토리지 계정 연결 문자열 | 문자열 |
| aof-storage-connection-string-1 | 두 번째 스토리지 계정 연결 문자열 | 문자열 |
| authnotrequired | 인증을 사용하지 않도록 설정할지 여부를 지정합니다. 이 속성을 설정하는 것은 보안 관점에서 매우 권장되지 않습니다. | 문자열 |
| maxfragmentationmemory-reserved | 분할당 조각화를 위해 예약된 값(메가바이트) | 문자열 |
| maxmemory-delta | 분할된 데이터베이스당 비 캐시 사용(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| maxmemory-policy | 데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다. | 문자열 |
| maxmemory-reserved | 분할된 데이터베이스당 비 캐시 사용(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| notify-keyspace-events | 모니터링해야 하는 키스페이스 이벤트입니다. | 문자열 |
| preferred-data-persistence-auth-method | 데이터 지속성에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하는 기본 인증 방법, 기본값은 SAS입니다. | 문자열 |
| rdb-backup-enabled | rdb 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| rdb-backup-frequency | 몇 분 안에 rdb 백업을 만드는 빈도를 지정합니다. 유효한 값: (15, 30, 60, 360, 720, 1440) | 문자열 |
| rdb-backup-max-snapshot-count | rdb 백업에 대한 최대 스냅샷 수를 지정합니다. | 문자열 |
| rdb-storage-connection-string | rdb 파일을 저장하기 위한 스토리지 계정 연결 문자열 | 문자열 |
| storage-subscription-id | ManagedIdentity를 사용하는 지속성(aof/rdb)에 대한 스토리지 계정의 SubscriptionId입니다. | 문자열 |
RedisCommonPropertiesTenantSettings
| 이름 | 묘사 | 값 |
|---|
RedisCreateParametersTags
| 이름 | 묘사 | 값 |
|---|
RedisCreatePropertiesOrRedisProperties
| 이름 | 묘사 | 값 | |
|---|---|---|---|
| disableAccessKeyAuthentication | 액세스 키를 통한 Redis 인증은 true로 설정하면 비활성화됩니다. 기본값은 false입니다. | bool | |
| enableNonSslPort | 비 ssl Redis 서버 포트(6379)를 사용할 수 있는지 여부를 지정합니다. | bool | |
| minimumTlsVersion | 선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결하도록 요구합니다(예: '1.0', '1.1', '1.2'). | '1.0' '1.1' '1.2' |
|
| publicNetworkAccess | 이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다. | '사용 안 함' 'Enabled' |
|
| redisConfiguration | 모든 Redis 설정입니다. 몇 가지 가능한 키: 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 등. | RedisCommonPropertiesRedisConfiguration | |
| redisVersion | Redis 버전입니다. 이는 'major[.minor]' 형식('major'만 필요) 또는 사용 가능한 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다. | 문자열 | |
| replicasPerMaster | 주 복제본당 만들 복제본 수입니다. | int | |
| replicasPerPrimary | 주 복제본당 만들 복제본 수입니다. | int | |
| shardCount | 프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다. | int | |
| sku | 배포할 Redis 캐시의 SKU입니다. | Sku(필수) | |
| staticIP | 고정 IP 주소입니다. 필요에 따라 기존 Azure Virtual Network 내에 Redis 캐시를 배포할 때 지정할 수 있습니다. 자동 할당은 기본적으로 할당됩니다. | 문자열 제약 조건: 패턴 = ^\d+\.\d+\.\d+\.\d+$ |
|
| subnetId | Redis 캐시를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다. 예제 형식: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {네트워크 | ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 | 문자열 제약 조건: 패턴 = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |
| tenantSettings | 테넌트 설정의 사전 | RedisCommonPropertiesTenantSettings | |
| updateChannel | 선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다. | '미리 보기' '안정' |
|
| zonalAllocationPolicy | 선택 사항: 가용성 영역이 Redis 캐시에 할당되는 방법을 지정합니다. '자동'은 영역 중복을 사용하도록 설정하고 Azure는 지역 가용성 및 용량에 따라 영역을 자동으로 선택합니다. 'UserDefined'는 'zones' 매개 변수를 사용하여 전달된 가용성 영역을 선택합니다. 'NoZones'는 영역이 아닌 캐시를 생성합니다. 'zonalAllocationPolicy'가 전달되지 않으면 영역이 전달될 때 '사용자 정의'로 설정되고, 그렇지 않으면 영역이 지원되는 지역에서는 '자동'으로 설정되고 영역이 지원되지 않는 지역에서는 'NoZones'로 설정됩니다. | 'Automatic' 'NoZones' 'UserDefined' |
Sku
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | 배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4). | int(필수) |
| 가족 | 사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = Basic/Standard, P = Premium). | 'C' 'P'(필수) |
| 이름 | 배포할 Redis 캐시의 형식입니다. 유효한 값: (Basic, Standard, Premium) | '기본' '프리미엄' 'Standard'(필수) |
UserAssignedIdentities
| 이름 | 묘사 | 값 |
|---|
UserAssignedIdentity
| 이름 | 묘사 | 값 |
|---|
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
| 템플렛 | 묘사 |
|---|---|
|
클러스터링 사용하여 프리미엄 Redis Cache 만들기 Azure 배포 |
이 템플릿은 프리미엄 Azure Redis Cache 인스턴스에서 클러스터링을 구성하는 방법을 보여 줍니다. |
|
템플릿 사용하여 Redis Cache 만들기 Azure 배포 |
이 템플릿은 스토리지 계정에 유지되는 진단 데이터를 사용하여 Azure Redis Cache를 만듭니다. |
|
Microsoft Entra Authentication을 사용하여 Redis Cache를 만듭니다. Azure 배포 |
이 템플릿은 Redis Cache를 만듭니다. 그런 다음, Redis 사용자에게 기본 제공 액세스 정책을 할당합니다. 그런 다음 사용자 지정 액세스 정책을 만듭니다. 그런 다음 다른 Redis 사용자에게 사용자 지정 액세스 정책을 할당합니다. |
|
템플릿 사용하여 웹앱 + Redis Cache + SQL DB 만들기 Azure 배포 |
이 템플릿은 Redis 캐시 및 SQL Database를 사용하여 Azure Web App을 만듭니다. |
|
템플릿 사용하여 웹앱 및 Redis Cache 만들기 Azure 배포 |
이 템플릿은 Redis 캐시를 사용하여 Azure Web App을 만듭니다. |
|
Virtual Network 배포된 프리미엄 Redis Cache 만들기 Azure 배포 |
이 템플릿은 프리미엄 Azure Redis Cache 인스턴스를 기존 Virtual Network에 배포하는 방법을 보여 줍니다. |
|
데이터 지속성 사용하여 프리미엄 Redis Cache 만들기 Azure 배포 |
이 템플릿은 프리미엄 Azure Redis Cache 인스턴스에서 지속성을 구성하는 방법을 보여 줍니다. |
|
Virtual Network 두 개의 지역 복제 캐시 만들기 Azure 배포 |
이 템플릿은 두 개의 프리미엄 계층 Azure Cache for Redis 인스턴스를 별도의 Virtual Network에 배포하고 지역 복제와 연결하는 방법을 보여 줍니다. |
| 외부 Azure Cache for Redis 사용하여 API Management 배포 Azure |
이 템플릿은 외부 Azure Cache for Redis 인스턴스를 API Management 외부 캐시로 사용하여 소비 계층에서 Azure API Management 인스턴스를 만드는 방법을 보여 줍니다. |
| iLB ASE Azure |
App Service Environment는 Web Apps, Mobile Apps 및 API Apps를 포함하여 대규모로 Azure App Service 앱을 안전하게 실행하기 위해 완전히 격리되고 전용된 환경을 제공하는 Azure App Service의 프리미엄 서비스 계획 옵션입니다. |
| 확장 가능한 Umbraco CMS 웹앱 Azure |
이 템플릿은 Azure App Service Web Apps에서 umbraco CMS 웹앱을 배포하는 쉬운 방법을 제공합니다. |
Terraform(AzAPI 공급자) 리소스 정의
Redis 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Cache/redis 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Cache/redis@2024-11-01"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
tags = {
{customized property} = "string"
}
zones = [
"string"
]
body = jsonencode({
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"
}
})
}
속성 값
ManagedServiceIdentity
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'(필수) |
| userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | UserAssignedIdentities |
Microsoft.Cache/redis
| 이름 | 묘사 | 값 |
|---|---|---|
| 신원 | 리소스의 ID입니다. | ManagedServiceIdentity |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 이름 | 리소스 이름 | string(필수) |
| 속성 | Redis 캐시 속성입니다. | RedisCreatePropertiesOrRedisProperties(필수) |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. |
| 형 | 리소스 종류 | "Microsoft.Cache/redis@2024-11-01" |
| 영역 | 리소스의 원본 위치를 나타내는 가용성 영역 목록입니다. | string[] |
RedisCommonPropertiesRedisConfiguration
| 이름 | 묘사 | 값 |
|---|---|---|
| aad-enabled | 캐시에 대해 AAD 기반 인증을 사용하도록 설정했는지 여부를 지정합니다. | 문자열 |
| aof-backup-enabled | aof 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| aof-storage-connection-string-0 | 첫 번째 스토리지 계정 연결 문자열 | 문자열 |
| aof-storage-connection-string-1 | 두 번째 스토리지 계정 연결 문자열 | 문자열 |
| authnotrequired | 인증을 사용하지 않도록 설정할지 여부를 지정합니다. 이 속성을 설정하는 것은 보안 관점에서 매우 권장되지 않습니다. | 문자열 |
| maxfragmentationmemory-reserved | 분할당 조각화를 위해 예약된 값(메가바이트) | 문자열 |
| maxmemory-delta | 분할된 데이터베이스당 비 캐시 사용(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| maxmemory-policy | 데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다. | 문자열 |
| maxmemory-reserved | 분할된 데이터베이스당 비 캐시 사용(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| notify-keyspace-events | 모니터링해야 하는 키스페이스 이벤트입니다. | 문자열 |
| preferred-data-persistence-auth-method | 데이터 지속성에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하는 기본 인증 방법, 기본값은 SAS입니다. | 문자열 |
| rdb-backup-enabled | rdb 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| rdb-backup-frequency | 몇 분 안에 rdb 백업을 만드는 빈도를 지정합니다. 유효한 값: (15, 30, 60, 360, 720, 1440) | 문자열 |
| rdb-backup-max-snapshot-count | rdb 백업에 대한 최대 스냅샷 수를 지정합니다. | 문자열 |
| rdb-storage-connection-string | rdb 파일을 저장하기 위한 스토리지 계정 연결 문자열 | 문자열 |
| storage-subscription-id | ManagedIdentity를 사용하는 지속성(aof/rdb)에 대한 스토리지 계정의 SubscriptionId입니다. | 문자열 |
RedisCommonPropertiesTenantSettings
| 이름 | 묘사 | 값 |
|---|
RedisCreateParametersTags
| 이름 | 묘사 | 값 |
|---|
RedisCreatePropertiesOrRedisProperties
| 이름 | 묘사 | 값 | |
|---|---|---|---|
| disableAccessKeyAuthentication | 액세스 키를 통한 Redis 인증은 true로 설정하면 비활성화됩니다. 기본값은 false입니다. | bool | |
| enableNonSslPort | 비 ssl Redis 서버 포트(6379)를 사용할 수 있는지 여부를 지정합니다. | bool | |
| minimumTlsVersion | 선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결하도록 요구합니다(예: '1.0', '1.1', '1.2'). | '1.0' '1.1' '1.2' |
|
| publicNetworkAccess | 이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다. | '사용 안 함' 'Enabled' |
|
| redisConfiguration | 모든 Redis 설정입니다. 몇 가지 가능한 키: 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 등. | RedisCommonPropertiesRedisConfiguration | |
| redisVersion | Redis 버전입니다. 이는 'major[.minor]' 형식('major'만 필요) 또는 사용 가능한 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다. | 문자열 | |
| replicasPerMaster | 주 복제본당 만들 복제본 수입니다. | int | |
| replicasPerPrimary | 주 복제본당 만들 복제본 수입니다. | int | |
| shardCount | 프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다. | int | |
| sku | 배포할 Redis 캐시의 SKU입니다. | Sku(필수) | |
| staticIP | 고정 IP 주소입니다. 필요에 따라 기존 Azure Virtual Network 내에 Redis 캐시를 배포할 때 지정할 수 있습니다. 자동 할당은 기본적으로 할당됩니다. | 문자열 제약 조건: 패턴 = ^\d+\.\d+\.\d+\.\d+$ |
|
| subnetId | Redis 캐시를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다. 예제 형식: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {네트워크 | ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 | 문자열 제약 조건: 패턴 = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |
| tenantSettings | 테넌트 설정의 사전 | RedisCommonPropertiesTenantSettings | |
| updateChannel | 선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다. | '미리 보기' '안정' |
|
| zonalAllocationPolicy | 선택 사항: 가용성 영역이 Redis 캐시에 할당되는 방법을 지정합니다. '자동'은 영역 중복을 사용하도록 설정하고 Azure는 지역 가용성 및 용량에 따라 영역을 자동으로 선택합니다. 'UserDefined'는 'zones' 매개 변수를 사용하여 전달된 가용성 영역을 선택합니다. 'NoZones'는 영역이 아닌 캐시를 생성합니다. 'zonalAllocationPolicy'가 전달되지 않으면 영역이 전달될 때 '사용자 정의'로 설정되고, 그렇지 않으면 영역이 지원되는 지역에서는 '자동'으로 설정되고 영역이 지원되지 않는 지역에서는 'NoZones'로 설정됩니다. | 'Automatic' 'NoZones' 'UserDefined' |
Sku
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | 배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4). | int(필수) |
| 가족 | 사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = Basic/Standard, P = Premium). | 'C' 'P'(필수) |
| 이름 | 배포할 Redis 캐시의 형식입니다. 유효한 값: (Basic, Standard, Premium) | '기본' '프리미엄' 'Standard'(필수) |
UserAssignedIdentities
| 이름 | 묘사 | 값 |
|---|
UserAssignedIdentity
| 이름 | 묘사 | 값 |
|---|