Redis - Update

서비스:: Redis Cache

API 버전:: 2024-11-01

기존 Redis 캐시를 업데이트합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redis/{name}?api-version=2024-11-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
name	path	True	string	RedisResource의 이름
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
identity	ManagedServiceIdentity	리소스의 ID입니다.
properties.disableAccessKeyAuthentication	boolean	액세스 키를 통한 Redis 인증은 true로 설정하면 비활성화됩니다. 기본값은 false입니다.
properties.enableNonSslPort	boolean	비 ssl Redis 서버 포트(6379)를 사용할 수 있는지 여부를 지정합니다.
properties.minimumTlsVersion	TlsVersion	선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결하도록 요구합니다(예: '1.0', '1.1', '1.2').
properties.publicNetworkAccess	PublicNetworkAccess	이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다.
properties.redisConfiguration	RedisCommonPropertiesRedisConfiguration	모든 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 등.
properties.redisVersion	string	Redis 버전입니다. 이는 'major[.minor]' 형식('major'만 필요) 또는 사용 가능한 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다.
properties.replicasPerMaster	integer (int32)	주 복제본당 만들 복제본 수입니다.
properties.replicasPerPrimary	integer (int32)	주 복제본당 만들 복제본 수입니다.
properties.shardCount	integer (int32)	프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다.
properties.sku	Sku	배포할 Redis 캐시의 SKU입니다.
properties.tenantSettings	object	테넌트 설정의 사전
properties.updateChannel	UpdateChannel	선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다.
properties.zonalAllocationPolicy	ZonalAllocationPolicy	선택 사항: 가용성 영역이 Redis 캐시에 할당되는 방법을 지정합니다. '자동'은 영역 중복을 사용하도록 설정하고 Azure는 지역 가용성 및 용량에 따라 영역을 자동으로 선택합니다. 'UserDefined'는 'zones' 매개 변수를 사용하여 전달된 가용성 영역을 선택합니다. 'NoZones'는 영역이 아닌 캐시를 생성합니다. 'zonalAllocationPolicy'가 전달되지 않으면 영역이 전달될 때 '사용자 정의'로 설정되고, 그렇지 않으면 영역이 지원되는 지역에서는 '자동'으로 설정되고 영역이 지원되지 않는 지역에서는 'NoZones'로 설정됩니다.
tags	object	리소스 태그.

응답

Name	형식	Description
200 OK	RedisResource	요청이 성공했습니다.
202 Accepted	RedisResource	처리를 위해 요청이 수락되었지만 처리가 아직 완료되지 않았습니다. 헤더 Location: string
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

RedisResource

요청이 성공했습니다.

202 Accepted

RedisResource

처리를 위해 요청이 수락되었지만 처리가 아직 완료되지 않았습니다.

헤더

Location: string

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

RedisCacheUpdate

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/redis/cache1?api-version=2024-11-01

{
  "properties": {
    "enableNonSslPort": true,
    "replicasPerPrimary": 2
  }
}

샘플 응답

상태 코드:: 200

{
  "name": "cache1",
  "type": "Microsoft.Cache/Redis",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/Redis/cache1",
  "location": "East US",
  "properties": {
    "accessKeys": {
      "primaryKey": "<primaryKey>",
      "secondaryKey": "<secondaryKey>"
    },
    "enableNonSslPort": true,
    "hostName": "cache1.redis.cache.windows.net",
    "instances": [
      {
        "isMaster": true,
        "isPrimary": true,
        "nonSslPort": 13000,
        "sslPort": 15000
      },
      {
        "isMaster": false,
        "isPrimary": false,
        "nonSslPort": 13001,
        "sslPort": 15001
      },
      {
        "isMaster": false,
        "isPrimary": false,
        "nonSslPort": 13002,
        "sslPort": 15002
      }
    ],
    "port": 6379,
    "provisioningState": "Succeeded",
    "redisConfiguration": {
      "maxclients": "1000",
      "maxmemory-delta": "50",
      "maxmemory-reserved": "50"
    },
    "redisVersion": "3.0",
    "replicasPerMaster": 2,
    "replicasPerPrimary": 2,
    "sku": {
      "name": "Premium",
      "capacity": 1,
      "family": "P"
    },
    "sslPort": 6380,
    "updateChannel": "Stable",
    "zonalAllocationPolicy": "Automatic"
  },
  "tags": {}
}

상태 코드:: 202

location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Cache/...pathToOperationResult...

{
  "name": "cache1",
  "type": "Microsoft.Cache/Redis",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/Redis/cache1",
  "location": "East US",
  "properties": {
    "accessKeys": {
      "primaryKey": "<primaryKey>",
      "secondaryKey": "<secondaryKey>"
    },
    "enableNonSslPort": true,
    "hostName": "cache1.redis.cache.windows.net",
    "instances": [
      {
        "isMaster": true,
        "isPrimary": true,
        "nonSslPort": 13000,
        "sslPort": 15000
      },
      {
        "isMaster": false,
        "isPrimary": false,
        "nonSslPort": 13001,
        "sslPort": 15001
      },
      {
        "isMaster": false,
        "isPrimary": false,
        "nonSslPort": 13002,
        "sslPort": 15002
      }
    ],
    "port": 6379,
    "provisioningState": "Succeeded",
    "redisConfiguration": {
      "maxclients": "1000",
      "maxmemory-delta": "50",
      "maxmemory-reserved": "50"
    },
    "redisVersion": "3.0",
    "replicasPerMaster": 2,
    "replicasPerPrimary": 2,
    "sku": {
      "name": "Premium",
      "capacity": 1,
      "family": "P"
    },
    "sslPort": 6380,
    "updateChannel": "Stable",
    "zonalAllocationPolicy": "Automatic"
  },
  "tags": {}
}

정의

Name	Description
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ManagedServiceIdentity	관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)
ManagedServiceIdentityType	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
PrivateEndpoint	프라이빗 엔드포인트 리소스입니다.
PrivateEndpointConnection	프라이빗 엔드포인트 연결 리소스입니다.
PrivateEndpointConnectionProvisioningState	현재 프로비저닝 상태입니다.
PrivateEndpointServiceConnectionStatus	프라이빗 엔드포인트 연결 상태입니다.
PrivateLinkServiceConnectionState	서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.
ProvisioningState	Redis 인스턴스 프로비저닝 상태입니다.
PublicNetworkAccess	이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다.
RedisAccessKeys	Redis 캐시 액세스 키입니다.
RedisCommonPropertiesRedisConfiguration	모든 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 등.
RedisInstanceDetails	Redis의 단일 인스턴스에 대한 세부 정보입니다.
RedisLinkedServer	연결된 서버 ID
RedisResource	목록 또는 가져오기 작업의 단일 Redis 항목입니다.
RedisUpdateParameters	Redis 업데이트 작업에 제공된 매개 변수입니다.
Sku	Redis 만들기 작업에 제공된 SKU 매개 변수입니다.
SkuFamily	사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = 기본/표준, P = 프리미엄).
SkuName	배포할 Redis 캐시의 형식입니다. 유효한 값: (Basic, Standard, Premium)
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
TlsVersion	선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결하도록 요구합니다(예: '1.0', '1.1', '1.2').
UpdateChannel	선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다.
UserAssignedIdentity	사용자 할당 ID 속성
ZonalAllocationPolicy	선택 사항: 가용성 영역이 Redis 캐시에 할당되는 방법을 지정합니다. '자동'은 영역 중복을 사용하도록 설정하고 Azure는 지역 가용성 및 용량에 따라 영역을 자동으로 선택합니다. 'UserDefined'는 'zones' 매개 변수를 사용하여 전달된 가용성 영역을 선택합니다. 'NoZones'는 영역이 아닌 캐시를 생성합니다. 'zonalAllocationPolicy'가 전달되지 않으면 영역이 전달될 때 '사용자 정의'로 설정되고, 그렇지 않으면 영역이 지원되는 지역에서는 '자동'으로 설정되고 영역이 지원되지 않는 지역에서는 'NoZones'로 설정됩니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

ManagedServiceIdentity

Object

관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)

Name	형식	Description
principalId	string (uuid)	시스템 할당 ID의 서비스 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
tenantId	string (uuid)	시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
type	ManagedServiceIdentityType	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned ID 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

ManagedServiceIdentityType

열거형

관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).

값	Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

PrivateEndpoint

Object

프라이빗 엔드포인트 리소스입니다.

Name	형식	Description
id	string	프라이빗 엔드포인트에 대한 ARM 식별자입니다.

PrivateEndpointConnection

Object

프라이빗 엔드포인트 연결 리소스입니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties.groupIds	string[]	프라이빗 엔드포인트 리소스의 그룹 ID입니다.
properties.privateEndpoint	PrivateEndpoint	프라이빗 엔드포인트 리소스입니다.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	프라이빗 엔드포인트 연결 리소스의 프로비전 상태입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

열거형

현재 프로비저닝 상태입니다.

값	Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

열거형

프라이빗 엔드포인트 연결 상태입니다.

값	Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Object

서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.

Name	형식	Description
actionsRequired	string	서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.
description	string	연결의 승인/거부 이유입니다.
status	PrivateEndpointServiceConnectionStatus	서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다.

ProvisioningState

열거형

Redis 인스턴스 프로비저닝 상태입니다.

값	Description
Creating	만들기 작업이 진행 중입니다.
Deleting	삭제 작업이 진행 중입니다.
Disabled	캐시가 비활성화되어 사용할 수 없습니다.
Failed	만들기 또는 업데이트와 같은 작업이 실패했습니다. 캐시를 만들지 못하면 사용 가능한 상태가 아니므로 삭제하고 다시 만들어야 합니다.
Linking	지역 복제 링크가 진행 중입니다.
Provisioning	작업이 진행 중입니다.
RecoveringScaleFailure	크기 조정 작업에 오류가 발생했으며 복구가 진행 중입니다.
Scaling	크기 조정 작업이 진행 중입니다.
Succeeded	가장 최근 작업이 성공적으로 완료되었습니다.
Unlinking	지역 복제 연결 해제가 진행 중입니다.
Unprovisioning	캐시가 비활성화되었을 수 있습니다.
Updating	업데이트 작업이 진행 중입니다.
ConfiguringAAD	AAD 구성 업데이트 작업이 진행 중입니다.

PublicNetworkAccess

열거형

이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다.

값	Description
Enabled	공용 IP 주소를 통해 캐시에 대한 공용 인터넷 액세스가 활성화됩니다. 연결은 모든 네트워크 경로를 사용할 수 있습니다.
Disabled	공용 IP 주소를 통해 캐시에 대한 공용 인터넷 액세스가 비활성화됩니다. 연결은 프라이빗 엔드포인트를 통해 이루어져야 합니다.

RedisAccessKeys

Object

Redis 캐시 액세스 키입니다.

Name	형식	Description
primaryKey	string	클라이언트가 Redis 캐시를 사용하여 인증하는 데 사용할 수 있는 현재 기본 키입니다.
secondaryKey	string	클라이언트가 Redis 캐시를 사용하여 인증하는 데 사용할 수 있는 현재 보조 키입니다.

RedisCommonPropertiesRedisConfiguration

Object

모든 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 등.

Name	형식	Description
aad-enabled	string	캐시에 대해 AAD 기반 인증을 사용하도록 설정했는지 여부를 지정합니다.
aof-backup-enabled	string	aof 백업을 사용할 수 있는지 여부를 지정합니다.
aof-storage-connection-string-0	string	첫 번째 스토리지 계정 연결 문자열
aof-storage-connection-string-1	string	두 번째 스토리지 계정 연결 문자열
authnotrequired	string	인증을 사용하지 않도록 설정할지 여부를 지정합니다. 이 속성을 설정하는 것은 보안 관점에서 매우 권장되지 않습니다. 이 속성을 사용하여 인증을 비활성화해서는 안 됩니다!
maxclients	string	최대 클라이언트 구성
maxfragmentationmemory-reserved	string	분할당 조각화를 위해 예약된 값(메가바이트)
maxmemory-delta	string	분할된 데이터베이스당 비 캐시 사용(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다.
maxmemory-policy	string	데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다.
maxmemory-reserved	string	분할된 데이터베이스당 비 캐시 사용(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다.
notify-keyspace-events	string	모니터링해야 하는 키스페이스 이벤트입니다.
preferred-data-archive-auth-method	string	데이터 보관에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하는 기본 인증 방법, 기본값은 SAS입니다.
preferred-data-persistence-auth-method	string	데이터 지속성에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하는 기본 인증 방법, 기본값은 SAS입니다.
rdb-backup-enabled	string	RDB 백업을 사용하도록 설정할지 여부를 지정합니다
rdb-backup-frequency	string	몇 분 안에 rdb 백업을 만드는 빈도를 지정합니다. 유효한 값: (15, 30, 60, 360, 720, 1440)
rdb-backup-max-snapshot-count	string	rdb 백업에 대한 최대 스냅샷 수를 지정합니다.
rdb-storage-connection-string	string	rdb 파일을 저장하기 위한 스토리지 계정 연결 문자열
storage-subscription-id	string	ManagedIdentity를 사용하는 지속성(aof/rdb)에 대한 스토리지 계정의 SubscriptionId입니다.
zonal-configuration	string	영역 구성

RedisInstanceDetails

Object

Redis의 단일 인스턴스에 대한 세부 정보입니다.

Name	형식	Description
isMaster	boolean	인스턴스가 주 노드인지 여부를 지정합니다.
isPrimary	boolean	인스턴스가 주 노드인지 여부를 지정합니다.
nonSslPort	integer (int32)	enableNonSslPort가 true이면 Redis 인스턴스 비 SSL 포트를 제공합니다.
shardId	integer (int32)	클러스터링을 사용하는 경우 Redis Instance의 분할된 데이터베이스 ID
sslPort	integer (int32)	Redis 인스턴스 SSL 포트입니다.
zone	string	캐시에서 가용성 영역을 사용하는 경우 이 인스턴스가 있는 가용성 영역을 지정합니다.

RedisLinkedServer

Object

연결된 서버 ID

Name	형식	Description
id	string	연결된 서버 ID입니다.

RedisResource

Object

목록 또는 가져오기 작업의 단일 Redis 항목입니다.

Name	형식	Default value	Description
disableAccessKeyAuthentication	boolean	False	액세스 키를 통한 Redis 인증은 true로 설정하면 비활성화됩니다. 기본값은 false입니다.
enableNonSslPort	boolean	False	비 ssl Redis 서버 포트(6379)를 사용할 수 있는지 여부를 지정합니다.
id	string (arm-id)		리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity		이 리소스에 할당된 관리 서비스 ID입니다.
location	string		리소스가 있는 지리적 위치
minimumTlsVersion	TlsVersion		선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결하도록 요구합니다(예: '1.0', '1.1', '1.2').
name	string		리소스의 이름
properties.accessKeys	RedisAccessKeys		Redis 캐시의 키 - 이 개체가 Create 또는 Update redis Cache에 대한 응답이 아닌 경우 설정되지 않음
properties.hostName	string		Redis 호스트 이름입니다.
properties.instances	RedisInstanceDetails[]		캐시와 연결된 Redis 인스턴스 목록
properties.linkedServers	RedisLinkedServer[]		캐시와 연결된 연결된 서버 목록
properties.port	integer (int32)		Redis 비 SSL 포트입니다.
properties.privateEndpointConnections	PrivateEndpointConnection[]		지정된 redis 캐시와 연결된 프라이빗 엔드포인트 연결 목록
properties.provisioningState	ProvisioningState		Redis 인스턴스 프로비저닝 상태입니다.
properties.sku	Sku		배포할 Redis 캐시의 SKU입니다.
properties.sslPort	integer (int32)		Redis SSL 포트.
properties.staticIP	string pattern: ^\d+\.\d+\.\d+\.\d+$		고정 IP 주소입니다. 필요에 따라 기존 Azure Virtual Network 내에 Redis 캐시를 배포할 때 지정할 수 있습니다. 자동 할당은 기본적으로 할당됩니다.
properties.subnetId	string pattern: ^/subscriptions/[^/]/resourceGroups/[^/]/providers/Microsoft.(ClassicNetwork\|Network)/virtualNetworks/[^/]/subnets/[^/]$		Redis 캐시를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다. 예제 형식: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network\|ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1
publicNetworkAccess	PublicNetworkAccess		이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다.
redisConfiguration	RedisCommonPropertiesRedisConfiguration		모든 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 등.
redisVersion	string		Redis 버전입니다. 이는 'major[.minor]' 형식('major'만 필요) 또는 사용 가능한 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다.
replicasPerMaster	integer (int32)		주 복제본당 만들 복제본 수입니다.
replicasPerPrimary	integer (int32)		주 복제본당 만들 복제본 수입니다.
shardCount	integer (int32)		프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다.
systemData	systemData		createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object		리소스 태그.
tenantSettings	object		테넌트 설정의 사전
type	string		리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"
updateChannel	UpdateChannel		선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다.
zonalAllocationPolicy	ZonalAllocationPolicy		선택 사항: 가용성 영역이 Redis 캐시에 할당되는 방법을 지정합니다. '자동'은 영역 중복을 사용하도록 설정하고 Azure는 지역 가용성 및 용량에 따라 영역을 자동으로 선택합니다. 'UserDefined'는 'zones' 매개 변수를 사용하여 전달된 가용성 영역을 선택합니다. 'NoZones'는 영역이 아닌 캐시를 생성합니다. 'zonalAllocationPolicy'가 전달되지 않으면 영역이 전달될 때 '사용자 정의'로 설정되고, 그렇지 않으면 영역이 지원되는 지역에서는 '자동'으로 설정되고 영역이 지원되지 않는 지역에서는 'NoZones'로 설정됩니다.
zones	string[]		가용성 영역입니다.

RedisUpdateParameters

Object

Redis 업데이트 작업에 제공된 매개 변수입니다.

Name	형식	Default value	Description
identity	ManagedServiceIdentity		리소스의 ID입니다.
properties.disableAccessKeyAuthentication	boolean	False	액세스 키를 통한 Redis 인증은 true로 설정하면 비활성화됩니다. 기본값은 false입니다.
properties.enableNonSslPort	boolean	False	비 ssl Redis 서버 포트(6379)를 사용할 수 있는지 여부를 지정합니다.
properties.minimumTlsVersion	TlsVersion		선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결하도록 요구합니다(예: '1.0', '1.1', '1.2').
properties.publicNetworkAccess	PublicNetworkAccess		이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다.
properties.redisConfiguration	RedisCommonPropertiesRedisConfiguration		모든 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 등.
properties.redisVersion	string		Redis 버전입니다. 이는 'major[.minor]' 형식('major'만 필요) 또는 사용 가능한 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다.
properties.replicasPerMaster	integer (int32)		주 복제본당 만들 복제본 수입니다.
properties.replicasPerPrimary	integer (int32)		주 복제본당 만들 복제본 수입니다.
properties.shardCount	integer (int32)		프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다.
properties.sku	Sku		배포할 Redis 캐시의 SKU입니다.
properties.tenantSettings	object		테넌트 설정의 사전
properties.updateChannel	UpdateChannel		선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다.
properties.zonalAllocationPolicy	ZonalAllocationPolicy		선택 사항: 가용성 영역이 Redis 캐시에 할당되는 방법을 지정합니다. '자동'은 영역 중복을 사용하도록 설정하고 Azure는 지역 가용성 및 용량에 따라 영역을 자동으로 선택합니다. 'UserDefined'는 'zones' 매개 변수를 사용하여 전달된 가용성 영역을 선택합니다. 'NoZones'는 영역이 아닌 캐시를 생성합니다. 'zonalAllocationPolicy'가 전달되지 않으면 영역이 전달될 때 '사용자 정의'로 설정되고, 그렇지 않으면 영역이 지원되는 지역에서는 '자동'으로 설정되고 영역이 지원되지 않는 지역에서는 'NoZones'로 설정됩니다.
tags	object		리소스 태그.

Sku

Object

Redis 만들기 작업에 제공된 SKU 매개 변수입니다.

Name	형식	Description
capacity	integer (int32)	배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4).
family	SkuFamily	사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = 기본/표준, P = 프리미엄).
name	SkuName	배포할 Redis 캐시의 형식입니다. 유효한 값: (Basic, Standard, Premium)

SkuFamily

열거형

사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = 기본/표준, P = 프리미엄).

값	Description
C	사용할 SKU 제품군은 기본/표준 SKU redis 캐시의 경우 'C'여야 합니다.
P	사용할 SKU 제품군은 프리미엄 SKU redis 캐시의 경우 'P'여야 합니다.

SkuName

열거형

배포할 Redis 캐시의 형식입니다. 유효한 값: (Basic, Standard, Premium)

값	Description
Basic	Azure Cache for Redis에 대해 잘 알려진 '기본' SKU입니다. 기본 SKU에는 가용성 SLA가 없습니다.
Standard	Azure Cache for Redis에 대해 잘 알려진 '표준' SKU입니다. 표준 SKU에는 가용성 SLA가 있습니다.
Premium	Azure Cache for Redis에 대해 잘 알려진 '프리미엄' SKU입니다. 프리미엄 SKU에는 가용성 SLA가 있으며, 표준 SKU에 비해 더 높은 성능 계층 및 더 많은 기능이 있습니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

TlsVersion

열거형

선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결하도록 요구합니다(예: '1.0', '1.1', '1.2').

값	Description
1.0	TLS 프로토콜 버전 1.0 -- 보안상의 이유로 더 이상 사용되지 않습니다. 새 캐시에는 이 값을 사용하지 마십시오.
1.1	TLS 프로토콜 버전 1.1 -- 보안상의 이유로 더 이상 사용되지 않습니다. 새 캐시에는 이 값을 사용하지 마십시오.
1.2	TLS 프로토콜 버전 1.2 -- 새 캐시에 대해 이 값 이상을 사용합니다. 또는 캐시가 권장 기본값을 사용하도록 지정하지 마십시오

UpdateChannel

열거형

선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 'Stable'입니다.

값	Description
Stable	안정 채널은 미리보기 채널보다 늦게 중요한 보안 및 안정성 업데이트를 포함할 수 있는 업데이트를 받습니다.
Preview	미리 보기 채널은 일반적으로 안정 채널 전에 업데이트를 받으며 비프로덕션 워크로드에 권장되는 채널입니다.

UserAssignedIdentity

Object

사용자 할당 ID 속성

Name	형식	Description
clientId	string (uuid)	할당된 ID의 클라이언트 ID입니다.
principalId	string (uuid)	할당된 ID의 보안 주체 ID입니다.

ZonalAllocationPolicy

열거형

선택 사항: 가용성 영역이 Redis 캐시에 할당되는 방법을 지정합니다. '자동'은 영역 중복을 사용하도록 설정하고 Azure는 지역 가용성 및 용량에 따라 영역을 자동으로 선택합니다. 'UserDefined'는 'zones' 매개 변수를 사용하여 전달된 가용성 영역을 선택합니다. 'NoZones'는 영역이 아닌 캐시를 생성합니다. 'zonalAllocationPolicy'가 전달되지 않으면 영역이 전달될 때 '사용자 정의'로 설정되고, 그렇지 않으면 영역이 지원되는 지역에서는 '자동'으로 설정되고 영역이 지원되지 않는 지역에서는 'NoZones'로 설정됩니다.

값	Description
Automatic	캐시의 영역은 가용성 및 용량에 따라 자동으로 선택됩니다.
UserDefined	UserDefined는 캐시의 영역이 'zones' 속성을 사용하여 수동으로 구성되며 자동으로 선택할 수 없음을 의미합니다.
NoZones	캐시는 여러 가용성 영역을 사용하지 않습니다.

다음을 통해 공유

Redis - Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

RedisCacheUpdate

샘플 요청

샘플 응답

정의

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedServiceIdentity

ManagedServiceIdentityType

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

ProvisioningState

PublicNetworkAccess

RedisAccessKeys

RedisCommonPropertiesRedisConfiguration

RedisInstanceDetails

RedisLinkedServer

RedisResource

RedisUpdateParameters

Sku

SkuFamily

SkuName

systemData

TlsVersion

UpdateChannel

UserAssignedIdentity

ZonalAllocationPolicy