Redis Enterprise - Update
기존 Redis Enterprise 클러스터 업데이트
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}?api-version=2025-07-01
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
cluster
|
path | True |
string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$ |
Redis Enterprise 클러스터의 이름입니다. 이름은 1~60자여야 합니다. 허용되는 문자(A-Z, a-z, 0-9) 및 하이픈(-)입니다. 선행 또는 후행 또는 연속 하이픈이 있을 수 없습니다. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
|
subscription
|
path | True |
string minLength: 1 |
대상 구독의 ID입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
요청 본문
| Name | 형식 | Description |
|---|---|---|
| identity |
리소스의 ID입니다. |
|
| properties.encryption |
클러스터에 대한 미사용 암호화 구성입니다. |
|
| properties.highAvailability |
기본적으로 사용하도록 설정됩니다. highAvailability를 사용하지 않도록 설정하면 데이터 집합이 복제되지 않습니다. 이는 가용성 SLA에 영향을 미치며 데이터 손실의 위험을 증가합니다. |
|
| properties.minimumTlsVersion |
지원할 클러스터의 최소 TLS 버전(예: '1.2')입니다. 나중에 최신 버전을 추가할 수 있습니다. 이제 TLS 1.0 및 TLS 1.1이 완전히 사용되지 않으므로 사용할 수 없습니다. 이전 API 버전과의 일관성을 위해서만 언급됩니다. |
|
| properties.publicNetworkAccess |
공용 네트워크 트래픽이 Redis 클러스터에 액세스할 수 있는지 여부입니다. '사용' 또는 '사용 안 함'만 설정할 수 있습니다. null은 이 속성이 없고 설정할 수 없는 이전 API 버전을 사용하여 만든 클러스터에 대해서만 반환됩니다. |
|
| sku |
가격, 성능 및 기능에 영향을 미치는 만들 SKU입니다. |
|
| tags |
object |
리소스 태그. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
클러스터가 업데이트되었습니다. provisioningState 및 resourceState를 확인하여 자세한 상태를 확인합니다. |
|
| 202 Accepted |
클러스터 업데이트 작업이 시작되었습니다. Azure-AsyncOperation 또는 Location 헤더의 URL을 GET하여 업데이트된 상태를 검색합니다. 헤더
|
|
| Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| user_impersonation | 사용자 계정 가장 |
예제
RedisEnterpriseUpdate
샘플 요청
PATCH https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1?api-version=2025-07-01
{
"sku": {
"name": "EnterpriseFlash_F300",
"capacity": 9
},
"properties": {
"minimumTlsVersion": "1.2",
"publicNetworkAccess": "Enabled"
},
"tags": {
"tag1": "value1"
}
}
샘플 응답
{
"id": "/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1",
"name": "cache1",
"type": "Microsoft.Cache/redisEnterprise",
"location": "West US",
"kind": "v1",
"sku": {
"name": "EnterpriseFlash_F300",
"capacity": 9
},
"identity": {
"type": "None"
},
"zones": [
"1",
"2",
"3"
],
"tags": {
"tag1": "value1"
},
"properties": {
"hostName": "cache1.westus.something.azure.com",
"provisioningState": "Updating",
"resourceState": "Updating",
"redisVersion": "5",
"minimumTlsVersion": "1.2",
"publicNetworkAccess": "Enabled"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/providers/Microsoft.Cache/...pathToOperationStatus...
Location: https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/providers/Microsoft.Cache/...pathToOperationResult...
정의
| Name | Description |
|---|---|
| Cluster |
Redis Enterprise 클러스터에 대해 설명합니다. |
|
Cluster |
Redis Enterprise 클러스터에 대한 부분 업데이트 |
|
Cmk |
이 API 버전에서는 userAssignedIdentity만 지원됩니다. 다른 형식은 나중에 지원될 수 있습니다. |
|
Customer |
리소스에 대한 모든 고객 관리형 키 암호화 속성입니다. Microsoft 관리형 키 암호화를 사용하려면 이 개체를 빈 개체로 설정합니다. |
| Encryption |
클러스터에 대한 미사용 암호화 구성입니다. |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
High |
기본적으로 사용하도록 설정됩니다. highAvailability를 사용하지 않도록 설정하면 데이터 집합이 복제되지 않습니다. 이는 가용성 SLA에 영향을 미치며 데이터 손실의 위험을 증가합니다. |
|
Key |
Key Vault를 인증하는 데 사용해야 하는 ID를 정의하는 고객 관리형 키 설정에 대한 모든 ID 구성입니다. |
| Kind |
클러스터의 종류를 구분합니다. 읽기 전용. |
|
Managed |
관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID) |
|
Managed |
관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). |
|
Private |
프라이빗 엔드포인트 리소스입니다. |
|
Private |
프라이빗 엔드포인트 연결 리소스입니다. |
|
Private |
현재 프로비저닝 상태입니다. |
|
Private |
프라이빗 엔드포인트 연결 상태입니다. |
|
Private |
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다. |
|
Provisioning |
현재 프로비저닝 상태 |
|
Public |
공용 네트워크 트래픽이 Redis 클러스터에 액세스할 수 있는지 여부입니다. '사용' 또는 '사용 안 함'만 설정할 수 있습니다. null은 이 속성이 없고 설정할 수 없는 이전 API 버전을 사용하여 만든 클러스터에 대해서만 반환됩니다. |
|
Redundancy |
예상 SLA에 영향을 주는 클러스터의 현재 중복 전략에 대해 설명합니다. |
|
Resource |
현재 자원 상태 |
| Sku |
Redis Enterprise 클러스터 만들기 작업에 제공된 SKU 매개 변수입니다. |
|
Sku |
배포할 Redis Enterprise 클러스터의 수준입니다. 가능한 값: ('Balanced_B5', 'MemoryOptimized_M10', 'ComputeOptimized_X5' 등). SKU에 대한 자세한 내용은 최신 가격 책정 설명서를 참조하세요. 추가 SKU는 나중에 지원될 수 있습니다. |
|
Tls |
지원할 클러스터의 최소 TLS 버전(예: '1.2')입니다. 나중에 최신 버전을 추가할 수 있습니다. 이제 TLS 1.0 및 TLS 1.1이 완전히 사용되지 않으므로 사용할 수 없습니다. 이전 API 버전과의 일관성을 위해서만 언급됩니다. |
|
User |
사용자 할당 ID 속성 |
Cluster
Redis Enterprise 클러스터에 대해 설명합니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| identity |
리소스의 ID입니다. |
|
| kind |
클러스터의 종류를 구분합니다. 읽기 전용. |
|
| location |
string |
리소스가 있는 지리적 위치 |
| name |
string |
리소스의 이름 |
| properties.encryption |
클러스터에 대한 미사용 암호화 구성입니다. |
|
| properties.highAvailability |
기본적으로 사용하도록 설정됩니다. highAvailability를 사용하지 않도록 설정하면 데이터 집합이 복제되지 않습니다. 이는 가용성 SLA에 영향을 미치며 데이터 손실의 위험을 증가합니다. |
|
| properties.hostName |
string |
클러스터 엔드포인트의 DNS 이름 |
| properties.minimumTlsVersion |
지원할 클러스터의 최소 TLS 버전(예: '1.2')입니다. 나중에 최신 버전을 추가할 수 있습니다. 이제 TLS 1.0 및 TLS 1.1이 완전히 사용되지 않으므로 사용할 수 없습니다. 이전 API 버전과의 일관성을 위해서만 언급됩니다. |
|
| properties.privateEndpointConnections |
지정된 Redis Enterprise 클러스터와 연결된 프라이빗 엔드포인트 연결 목록 |
|
| properties.provisioningState |
클러스터의 현재 프로비저닝 상태 |
|
| properties.publicNetworkAccess |
공용 네트워크 트래픽이 Redis 클러스터에 액세스할 수 있는지 여부입니다. '사용' 또는 '사용 안 함'만 설정할 수 있습니다. null은 이 속성이 없고 설정할 수 없는 이전 API 버전을 사용하여 만든 클러스터에 대해서만 반환됩니다. |
|
| properties.redisVersion |
string |
클러스터가 지원하는 redis의 버전(예: '6') |
| properties.redundancyMode |
예상 SLA에 영향을 주는 클러스터의 현재 중복 전략에 대해 설명합니다. |
|
| properties.resourceState |
클러스터의 현재 리소스 상태 |
|
| sku |
가격, 성능 및 기능에 영향을 미치는 만들 SKU입니다. |
|
| tags |
object |
리소스 태그. |
| type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
| zones |
string[] |
이 클러스터를 배포할 가용성 영역입니다. |
ClusterUpdate
Redis Enterprise 클러스터에 대한 부분 업데이트
| Name | 형식 | Description |
|---|---|---|
| identity |
리소스의 ID입니다. |
|
| properties.encryption |
클러스터에 대한 미사용 암호화 구성입니다. |
|
| properties.highAvailability |
기본적으로 사용하도록 설정됩니다. highAvailability를 사용하지 않도록 설정하면 데이터 집합이 복제되지 않습니다. 이는 가용성 SLA에 영향을 미치며 데이터 손실의 위험을 증가합니다. |
|
| properties.hostName |
string |
클러스터 엔드포인트의 DNS 이름 |
| properties.minimumTlsVersion |
지원할 클러스터의 최소 TLS 버전(예: '1.2')입니다. 나중에 최신 버전을 추가할 수 있습니다. 이제 TLS 1.0 및 TLS 1.1이 완전히 사용되지 않으므로 사용할 수 없습니다. 이전 API 버전과의 일관성을 위해서만 언급됩니다. |
|
| properties.privateEndpointConnections |
지정된 Redis Enterprise 클러스터와 연결된 프라이빗 엔드포인트 연결 목록 |
|
| properties.provisioningState |
클러스터의 현재 프로비저닝 상태 |
|
| properties.publicNetworkAccess |
공용 네트워크 트래픽이 Redis 클러스터에 액세스할 수 있는지 여부입니다. '사용' 또는 '사용 안 함'만 설정할 수 있습니다. null은 이 속성이 없고 설정할 수 없는 이전 API 버전을 사용하여 만든 클러스터에 대해서만 반환됩니다. |
|
| properties.redisVersion |
string |
클러스터가 지원하는 redis의 버전(예: '6') |
| properties.redundancyMode |
예상 SLA에 영향을 주는 클러스터의 현재 중복 전략에 대해 설명합니다. |
|
| properties.resourceState |
클러스터의 현재 리소스 상태 |
|
| sku |
가격, 성능 및 기능에 영향을 미치는 만들 SKU입니다. |
|
| tags |
object |
리소스 태그. |
CmkIdentityType
이 API 버전에서는 userAssignedIdentity만 지원됩니다. 다른 형식은 나중에 지원될 수 있습니다.
| 값 | Description |
|---|---|
| systemAssignedIdentity | |
| userAssignedIdentity |
CustomerManagedKeyEncryption
리소스에 대한 모든 고객 관리형 키 암호화 속성입니다. Microsoft 관리형 키 암호화를 사용하려면 이 개체를 빈 개체로 설정합니다.
| Name | 형식 | Description |
|---|---|---|
| keyEncryptionKeyIdentity |
Key Vault를 인증하는 데 사용해야 하는 ID를 정의하는 고객 관리형 키 설정에 대한 모든 ID 구성입니다. |
|
| keyEncryptionKeyUrl |
string |
키 암호화 키 URL, 버전만. 예: |
Encryption
클러스터에 대한 미사용 암호화 구성입니다.
| Name | 형식 | Description |
|---|---|---|
| customerManagedKeyEncryption |
리소스에 대한 모든 고객 관리형 키 암호화 속성입니다. Microsoft 관리형 키 암호화를 사용하려면 이 개체를 빈 개체로 설정합니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
HighAvailability
기본적으로 사용하도록 설정됩니다. highAvailability를 사용하지 않도록 설정하면 데이터 집합이 복제되지 않습니다. 이는 가용성 SLA에 영향을 미치며 데이터 손실의 위험을 증가합니다.
| 값 | Description |
|---|---|
| Enabled | |
| Disabled |
KeyEncryptionKeyIdentity
Key Vault를 인증하는 데 사용해야 하는 ID를 정의하는 고객 관리형 키 설정에 대한 모든 ID 구성입니다.
| Name | 형식 | Description |
|---|---|---|
| identityType |
이 API 버전에서는 userAssignedIdentity만 지원됩니다. 다른 형식은 나중에 지원될 수 있습니다. |
|
| userAssignedIdentityResourceId |
string |
키 암호화 키 URL에 액세스하는 데 사용할 사용자 할당 ID입니다. 예: /subscriptions//resourceGroups/<resource group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. |
Kind
클러스터의 종류를 구분합니다. 읽기 전용.
| 값 | Description |
|---|---|
| v1 | |
| v2 |
ManagedServiceIdentity
관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)
| Name | 형식 | Description |
|---|---|---|
| principalId |
string (uuid) |
시스템 할당 ID의 서비스 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다. |
| tenantId |
string (uuid) |
시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다. |
| type |
관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned ID |
ManagedServiceIdentityType
관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
| 값 | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned, UserAssigned |
PrivateEndpoint
프라이빗 엔드포인트 리소스입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string |
프라이빗 엔드포인트에 대한 ARM 식별자 |
PrivateEndpointConnection
프라이빗 엔드포인트 연결 리소스입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
리소스의 이름 |
| properties.privateEndpoint |
프라이빗 엔드포인트의 리소스입니다. |
|
| properties.privateLinkServiceConnectionState |
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다. |
|
| properties.provisioningState |
프라이빗 엔드포인트 연결 리소스의 프로비전 상태입니다. |
|
| type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProvisioningState
현재 프로비저닝 상태입니다.
| 값 | Description |
|---|---|
| Succeeded | |
| Creating | |
| Deleting | |
| Failed |
PrivateEndpointServiceConnectionStatus
프라이빗 엔드포인트 연결 상태입니다.
| 값 | Description |
|---|---|
| Pending | |
| Approved | |
| Rejected |
PrivateLinkServiceConnectionState
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.
| Name | 형식 | Description |
|---|---|---|
| actionsRequired |
string |
서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다. |
| description |
string |
연결의 승인/거부 이유입니다. |
| status |
서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다. |
ProvisioningState
현재 프로비저닝 상태
| 값 | Description |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Creating | |
| Updating | |
| Deleting |
PublicNetworkAccess
공용 네트워크 트래픽이 Redis 클러스터에 액세스할 수 있는지 여부입니다. '사용' 또는 '사용 안 함'만 설정할 수 있습니다. null은 이 속성이 없고 설정할 수 없는 이전 API 버전을 사용하여 만든 클러스터에 대해서만 반환됩니다.
| 값 | Description |
|---|---|
| Enabled | |
| Disabled |
RedundancyMode
예상 SLA에 영향을 주는 클러스터의 현재 중복 전략에 대해 설명합니다.
| 값 | Description |
|---|---|
| None |
중복이 없습니다. 가용성 손실이 발생합니다. |
| LR |
고가용성을 갖춘 로컬 이중화. |
| ZR |
영역 중복. 더 높은 가용성. |
ResourceState
현재 자원 상태
| 값 | Description |
|---|---|
| Running | |
| Creating | |
| CreateFailed | |
| Updating | |
| UpdateFailed | |
| Deleting | |
| DeleteFailed | |
| Enabling | |
| EnableFailed | |
| Disabling | |
| DisableFailed | |
| Disabled | |
| Scaling | |
| ScalingFailed | |
| Moving |
Sku
Redis Enterprise 클러스터 만들기 작업에 제공된 SKU 매개 변수입니다.
| Name | 형식 | Description |
|---|---|---|
| capacity |
integer (int32) |
이 속성은 Enterprise 및 EnterpriseFlash SKU에서만 사용됩니다. 클러스터의 크기를 결정합니다. 유효한 값은 Enterprise SKU의 경우 (2, 4, 6, ...) 및 EnterpriseFlash SKU의 경우 (3, 9, 15, ...)입니다. |
| name |
배포할 Redis Enterprise 클러스터의 수준입니다. 가능한 값: ('Balanced_B5', 'MemoryOptimized_M10', 'ComputeOptimized_X5' 등). SKU에 대한 자세한 내용은 최신 가격 책정 설명서를 참조하세요. 추가 SKU는 나중에 지원될 수 있습니다. |
SkuName
배포할 Redis Enterprise 클러스터의 수준입니다. 가능한 값: ('Balanced_B5', 'MemoryOptimized_M10', 'ComputeOptimized_X5' 등). SKU에 대한 자세한 내용은 최신 가격 책정 설명서를 참조하세요. 추가 SKU는 나중에 지원될 수 있습니다.
| 값 | Description |
|---|---|
| Enterprise_E1 | |
| Enterprise_E5 | |
| Enterprise_E10 | |
| Enterprise_E20 | |
| Enterprise_E50 | |
| Enterprise_E100 | |
| Enterprise_E200 | |
| Enterprise_E400 | |
| EnterpriseFlash_F300 | |
| EnterpriseFlash_F700 | |
| EnterpriseFlash_F1500 | |
| Balanced_B0 | |
| Balanced_B1 | |
| Balanced_B3 | |
| Balanced_B5 | |
| Balanced_B10 | |
| Balanced_B20 | |
| Balanced_B50 | |
| Balanced_B100 | |
| Balanced_B150 | |
| Balanced_B250 | |
| Balanced_B350 | |
| Balanced_B500 | |
| Balanced_B700 | |
| Balanced_B1000 | |
| MemoryOptimized_M10 | |
| MemoryOptimized_M20 | |
| MemoryOptimized_M50 | |
| MemoryOptimized_M100 | |
| MemoryOptimized_M150 | |
| MemoryOptimized_M250 | |
| MemoryOptimized_M350 | |
| MemoryOptimized_M500 | |
| MemoryOptimized_M700 | |
| MemoryOptimized_M1000 | |
| MemoryOptimized_M1500 | |
| MemoryOptimized_M2000 | |
| ComputeOptimized_X3 | |
| ComputeOptimized_X5 | |
| ComputeOptimized_X10 | |
| ComputeOptimized_X20 | |
| ComputeOptimized_X50 | |
| ComputeOptimized_X100 | |
| ComputeOptimized_X150 | |
| ComputeOptimized_X250 | |
| ComputeOptimized_X350 | |
| ComputeOptimized_X500 | |
| ComputeOptimized_X700 | |
| FlashOptimized_A250 | |
| FlashOptimized_A500 | |
| FlashOptimized_A700 | |
| FlashOptimized_A1000 | |
| FlashOptimized_A1500 | |
| FlashOptimized_A2000 | |
| FlashOptimized_A4500 |
TlsVersion
지원할 클러스터의 최소 TLS 버전(예: '1.2')입니다. 나중에 최신 버전을 추가할 수 있습니다. 이제 TLS 1.0 및 TLS 1.1이 완전히 사용되지 않으므로 사용할 수 없습니다. 이전 API 버전과의 일관성을 위해서만 언급됩니다.
| 값 | Description |
|---|---|
| 1.0 | |
| 1.1 | |
| 1.2 |
UserAssignedIdentity
사용자 할당 ID 속성
| Name | 형식 | Description |
|---|---|---|
| clientId |
string (uuid) |
할당된 ID의 클라이언트 ID입니다. |
| principalId |
string (uuid) |
할당된 ID의 보안 주체 ID입니다. |