Redis Enterprise - Update

Servicio:: Redis Cache

Versión de la API:: 2025-04-01

Actualiza un clúster de Redis Enterprise existente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cache/redisEnterprise/{clusterName}?api-version=2025-04-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
clusterName	path	True	string pattern: ^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$	Nombre del clúster de Redis Enterprise. El nombre debe tener entre 1 y 60 caracteres. Caracteres permitidos (A-Z, a-z, 0-9) y guion(-). No puede haber guiones iniciales ni finales ni consecutivos
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
identity	ManagedServiceIdentity	Identidad del recurso.
properties.encryption	Encryption	Configuración de cifrado en reposo para el clúster.
properties.highAvailability	HighAvailability	Habilitado de forma predeterminada. Si highAvailability está deshabilitado, el conjunto de datos no se replica. Esto afecta al Acuerdo de Nivel de Servicio de disponibilidad y aumenta el riesgo de pérdida de datos.
properties.minimumTlsVersion	TlsVersion	Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". Las versiones más recientes se pueden agregar en el futuro. Tenga en cuenta que TLS 1.0 y TLS 1.1 ahora están completamente obsoletos; no se pueden usar. Solo se mencionan por motivos de coherencia con las versiones anteriores de la API.
sku	Sku	SKU que se va a crear, lo que afecta al precio, el rendimiento y las características.
tags	object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	Cluster	El clúster se está actualizando. Compruebe provisioningState y resourceState para ver el estado detallado.
202 Accepted		Se inició la operación de actualización del clúster. OBTENGA la dirección URL en los encabezados Azure-AsyncOperation o Location para recuperar el estado actualizado. Encabezados Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Nombre

Tipo

Description

200 OK

Cluster

El clúster se está actualizando. Compruebe provisioningState y resourceState para ver el estado detallado.

202 Accepted

Se inició la operación de actualización del clúster. OBTENGA la dirección URL en los encabezados Azure-AsyncOperation o Location para recuperar el estado actualizado.

Encabezados

Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

RedisEnterpriseUpdate

Solicitud de ejemplo

HTTP

PATCH https://management.azure.com/subscriptions/e7b5a9d2-6b6a-4d2f-9143-20d9a10f5b8f/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1?api-version=2025-04-01

{
  "sku": {
    "name": "EnterpriseFlash_F300",
    "capacity": 9
  },
  "properties": {
    "minimumTlsVersion": "1.2"
  },
  "tags": {
    "tag1": "value1"
  }
}

Respuesta de muestra

status code:: 200

{
  "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",
    "encryption": {}
  }
}

status code:: 202

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...

Definiciones

Nombre	Description
Cluster	Describe el clúster de Redis Enterprise.
ClusterUpdate	Una actualización parcial del clúster de Redis Enterprise
CmkIdentityType	Solo se admite userAssignedIdentity en esta versión de API; Es posible que se admita otros tipos en el futuro.
CustomerManagedKeyEncryption	Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. Establézcalo en un objeto vacío para usar el cifrado de claves administradas por Microsoft.
Encryption	Configuración de cifrado en reposo para el clúster.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
HighAvailability	Habilitado de forma predeterminada. Si highAvailability está deshabilitado, el conjunto de datos no se replica. Esto afecta al Acuerdo de Nivel de Servicio de disponibilidad y aumenta el riesgo de pérdida de datos.
KeyEncryptionKeyIdentity	Toda la configuración de identidad para la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticarse en Key Vault.
Kind	Distingue el tipo de clúster. Solo lectura.
ManagedServiceIdentity	Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)
ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
PrivateEndpoint	El recurso Punto de conexión privado.
PrivateEndpointConnection	El recurso Conexión de punto de conexión privado.
PrivateEndpointConnectionProvisioningState	Estado de aprovisionamiento actual.
PrivateEndpointServiceConnectionStatus	Estado de conexión del punto de conexión privado.
PrivateLinkServiceConnectionState	Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor.
ProvisioningState	Estado de aprovisionamiento actual
RedundancyMode	Explica la estrategia de redundancia actual del clúster, que afecta al Acuerdo de Nivel de Servicio esperado.
ResourceState	Estado actual de los recursos
Sku	Parámetros de SKU proporcionados para la operación de creación de clústeres de Redis Enterprise.
SkuName	Nivel de clúster de Redis Enterprise que se va a implementar. Valores posibles: ("Balanced_B5", "MemoryOptimized_M10", "ComputeOptimized_X5", etc.). Para más información sobre las SKU, consulte la documentación de precios más reciente. Tenga en cuenta que es posible que se admita más SKU en el futuro.
TlsVersion	Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". Las versiones más recientes se pueden agregar en el futuro. Tenga en cuenta que TLS 1.0 y TLS 1.1 ahora están completamente obsoletos; no se pueden usar. Solo se mencionan por motivos de coherencia con las versiones anteriores de la API.
UserAssignedIdentity	Propiedades de identidad asignadas por el usuario

Cluster

Object

Describe el clúster de Redis Enterprise.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identidad del recurso.
kind	Kind	Distingue el tipo de clúster. Solo lectura.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.encryption	Encryption	Configuración de cifrado en reposo para el clúster.
properties.highAvailability	HighAvailability	Habilitado de forma predeterminada. Si highAvailability está deshabilitado, el conjunto de datos no se replica. Esto afecta al Acuerdo de Nivel de Servicio de disponibilidad y aumenta el riesgo de pérdida de datos.
properties.hostName	string	Nombre DNS del punto de conexión del clúster
properties.minimumTlsVersion	TlsVersion	Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". Las versiones más recientes se pueden agregar en el futuro. Tenga en cuenta que TLS 1.0 y TLS 1.1 ahora están completamente obsoletos; no se pueden usar. Solo se mencionan por motivos de coherencia con las versiones anteriores de la API.
properties.privateEndpointConnections	PrivateEndpointConnection[]	Lista de conexiones de punto de conexión privado asociadas al clúster de Redis Enterprise especificado
properties.provisioningState	ProvisioningState	Estado de aprovisionamiento actual del clúster
properties.redisVersion	string	Versión de redis que admite el clúster, por ejemplo, "6".
properties.redundancyMode	RedundancyMode	Explica la estrategia de redundancia actual del clúster, que afecta al Acuerdo de Nivel de Servicio esperado.
properties.resourceState	ResourceState	Estado actual del recurso del clúster
sku	Sku	SKU que se va a crear, lo que afecta al precio, el rendimiento y las características.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
zones	string[]	Availability Zones donde se implementará este clúster.

ClusterUpdate

Object

Una actualización parcial del clúster de Redis Enterprise

Nombre	Tipo	Description
identity	ManagedServiceIdentity	Identidad del recurso.
properties.encryption	Encryption	Configuración de cifrado en reposo para el clúster.
properties.highAvailability	HighAvailability	Habilitado de forma predeterminada. Si highAvailability está deshabilitado, el conjunto de datos no se replica. Esto afecta al Acuerdo de Nivel de Servicio de disponibilidad y aumenta el riesgo de pérdida de datos.
properties.hostName	string	Nombre DNS del punto de conexión del clúster
properties.minimumTlsVersion	TlsVersion	Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". Las versiones más recientes se pueden agregar en el futuro. Tenga en cuenta que TLS 1.0 y TLS 1.1 ahora están completamente obsoletos; no se pueden usar. Solo se mencionan por motivos de coherencia con las versiones anteriores de la API.
properties.privateEndpointConnections	PrivateEndpointConnection[]	Lista de conexiones de punto de conexión privado asociadas al clúster de Redis Enterprise especificado
properties.provisioningState	ProvisioningState	Estado de aprovisionamiento actual del clúster
properties.redisVersion	string	Versión de redis que admite el clúster, por ejemplo, "6".
properties.redundancyMode	RedundancyMode	Explica la estrategia de redundancia actual del clúster, que afecta al Acuerdo de Nivel de Servicio esperado.
properties.resourceState	ResourceState	Estado actual del recurso del clúster
sku	Sku	SKU que se va a crear, lo que afecta al precio, el rendimiento y las características.
tags	object	Etiquetas de recursos.

CmkIdentityType

Enumeración

Solo se admite userAssignedIdentity en esta versión de API; Es posible que se admita otros tipos en el futuro.

Valor	Description
systemAssignedIdentity
userAssignedIdentity

CustomerManagedKeyEncryption

Object

Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. Establézcalo en un objeto vacío para usar el cifrado de claves administradas por Microsoft.

Nombre	Tipo	Description
keyEncryptionKeyIdentity	KeyEncryptionKeyIdentity	Toda la configuración de identidad para la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticarse en Key Vault.
keyEncryptionKeyUrl	string	Dirección URL de clave de cifrado de claves, solo con versiones. Ejemplo: `https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78`

Encryption

Object

Configuración de cifrado en reposo para el clúster.

Nombre	Tipo	Description
customerManagedKeyEncryption	CustomerManagedKeyEncryption	Todas las propiedades de cifrado de claves administradas por el cliente para el recurso. Establézcalo en un objeto vacío para usar el cifrado de claves administradas por Microsoft.

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

HighAvailability

Enumeración

Habilitado de forma predeterminada. Si highAvailability está deshabilitado, el conjunto de datos no se replica. Esto afecta al Acuerdo de Nivel de Servicio de disponibilidad y aumenta el riesgo de pérdida de datos.

Valor	Description
Disabled
Enabled

KeyEncryptionKeyIdentity

Object

Toda la configuración de identidad para la configuración de clave administrada por el cliente que define qué identidad se debe usar para autenticarse en Key Vault.

Nombre	Tipo	Description
identityType	CmkIdentityType	Solo se admite userAssignedIdentity en esta versión de API; Es posible que se admita otros tipos en el futuro.
userAssignedIdentityResourceId	string	Identidad asignada por el usuario que se usará para acceder a la dirección URL de la clave de cifrado de claves. Por ejemplo: /subscriptions/_{/resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId.}

Kind

Enumeración

Distingue el tipo de clúster. Solo lectura.

Valor	Description
v1
v2

ManagedServiceIdentity

Object

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)

Nombre	Tipo	Description
principalId	string (uuid)	Identificador de entidad de servicio de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
tenantId	string (uuid)	Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
type	ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identidades de User-Assigned Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.

ManagedServiceIdentityType

Enumeración

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Valor	Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

PrivateEndpoint

Object

El recurso Punto de conexión privado.

Nombre	Tipo	Description
id	string	Identificador de ARM para punto de conexión privado

PrivateEndpointConnection

Object

El recurso Conexión de punto de conexión privado.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso
properties.privateEndpoint	PrivateEndpoint	Recurso del punto de conexión privado.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Estado de aprovisionamiento del recurso de conexión de punto de conexión privado.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Enumeración

Estado de aprovisionamiento actual.

Valor	Description
Creating
Deleting
Failed
Succeeded

PrivateEndpointServiceConnectionStatus

Enumeración

Estado de conexión del punto de conexión privado.

Valor	Description
Approved
Pending
Rejected

PrivateLinkServiceConnectionState

Object

Colección de información sobre el estado de la conexión entre el consumidor del servicio y el proveedor.

Nombre	Tipo	Description
actionsRequired	string	Mensaje que indica si los cambios en el proveedor de servicios requieren actualizaciones en el consumidor.
description	string	Motivo de aprobación o rechazo de la conexión.
status	PrivateEndpointServiceConnectionStatus	Indica si el propietario del servicio ha aprobado o rechazado o eliminado la conexión.

ProvisioningState

Enumeración

Estado de aprovisionamiento actual

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

RedundancyMode

Enumeración

Explica la estrategia de redundancia actual del clúster, que afecta al Acuerdo de Nivel de Servicio esperado.

Valor	Description
LR	Redundancia local con alta disponibilidad.
None	Sin redundancia. Se producirá una pérdida de disponibilidad.
ZR	Con redundancia de zona. Mayor disponibilidad.

ResourceState

Enumeración

Estado actual de los recursos

Valor	Description
CreateFailed
Creating
DeleteFailed
Deleting
DisableFailed
Disabled
Disabling
EnableFailed
Enabling
Moving
Running
Scaling
ScalingFailed
UpdateFailed
Updating

Sku

Object

Parámetros de SKU proporcionados para la operación de creación de clústeres de Redis Enterprise.

Nombre	Tipo	Description
capacity	integer (int32)	Esta propiedad solo se usa con las SKU Enterprise y EnterpriseFlash. Determina el tamaño del clúster. Los valores válidos son (2, 4, 6, ...) para las SKU empresariales y (3, 9, 15, ...) para las SKU enterpriseFlash.
name	SkuName	Nivel de clúster de Redis Enterprise que se va a implementar. Valores posibles: ("Balanced_B5", "MemoryOptimized_M10", "ComputeOptimized_X5", etc.). Para más información sobre las SKU, consulte la documentación de precios más reciente. Tenga en cuenta que es posible que se admita más SKU en el futuro.

SkuName

Enumeración

Nivel de clúster de Redis Enterprise que se va a implementar. Valores posibles: ("Balanced_B5", "MemoryOptimized_M10", "ComputeOptimized_X5", etc.). Para más información sobre las SKU, consulte la documentación de precios más reciente. Tenga en cuenta que es posible que se admita más SKU en el futuro.

Valor	Description
Balanced_B0
Balanced_B1
Balanced_B10
Balanced_B100
Balanced_B1000
Balanced_B150
Balanced_B20
Balanced_B250
Balanced_B3
Balanced_B350
Balanced_B5
Balanced_B50
Balanced_B500
Balanced_B700
ComputeOptimized_X10
ComputeOptimized_X100
ComputeOptimized_X150
ComputeOptimized_X20
ComputeOptimized_X250
ComputeOptimized_X3
ComputeOptimized_X350
ComputeOptimized_X5
ComputeOptimized_X50
ComputeOptimized_X500
ComputeOptimized_X700
EnterpriseFlash_F1500
EnterpriseFlash_F300
EnterpriseFlash_F700
Enterprise_E1
Enterprise_E10
Enterprise_E100
Enterprise_E20
Enterprise_E200
Enterprise_E400
Enterprise_E5
Enterprise_E50
FlashOptimized_A1000
FlashOptimized_A1500
FlashOptimized_A2000
FlashOptimized_A250
FlashOptimized_A4500
FlashOptimized_A500
FlashOptimized_A700
MemoryOptimized_M10
MemoryOptimized_M100
MemoryOptimized_M1000
MemoryOptimized_M150
MemoryOptimized_M1500
MemoryOptimized_M20
MemoryOptimized_M2000
MemoryOptimized_M250
MemoryOptimized_M350
MemoryOptimized_M50
MemoryOptimized_M500
MemoryOptimized_M700

TlsVersion

Enumeración

Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". Las versiones más recientes se pueden agregar en el futuro. Tenga en cuenta que TLS 1.0 y TLS 1.1 ahora están completamente obsoletos; no se pueden usar. Solo se mencionan por motivos de coherencia con las versiones anteriores de la API.

Valor	Description
1.0
1.1
1.2

UserAssignedIdentity

Object

Propiedades de identidad asignadas por el usuario

Nombre	Tipo	Description
clientId	string (uuid)	Identificador de cliente de la identidad asignada.
principalId	string (uuid)	Identificador de entidad de seguridad de la identidad asignada.

Compartir a través de

Redis Enterprise - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

RedisEnterpriseUpdate

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Cluster

ClusterUpdate

CmkIdentityType

CustomerManagedKeyEncryption

Encryption

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HighAvailability

KeyEncryptionKeyIdentity

Kind

ManagedServiceIdentity

ManagedServiceIdentityType

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

ProvisioningState

RedundancyMode

ResourceState

Sku

SkuName

TlsVersion

UserAssignedIdentity