Redis Enterprise - Update

Referencia

Servicio:: Redis Cache

Versión de la API:: 2024-10-01

Actualiza un clúster de RedisEnterprise existente.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
clusterName	path	True	string	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 Patrón de Regex: `^(?=.{1,60}$)[A-Za-z0-9]+(-[A-Za-z0-9]+)*$`
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
subscriptionId	path	True	string	Identificador de la suscripción de destino.
api-version	query	True	string	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.minimumTlsVersion	TlsVersion	Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2".
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/subid/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1?api-version=2024-10-01

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

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redisEnterprise/cache1",
  "name": "cache1",
  "type": "Microsoft.Cache/redisEnterprise",
  "location": "West US",
  "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/subid/providers/Microsoft.Cache/...pathToOperationStatus...
Location: https://management.azure.com/subscriptions/subid/providers/Microsoft.Cache/...pathToOperationResult...

Definiciones

Nombre	Description
Cluster	Describe el clúster de RedisEnterprise.
ClusterUpdate	Una actualización parcial del clúster de RedisEnterprise
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
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.
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
ResourceState	Estado actual de los recursos
Sku	Parámetros de SKU proporcionados para la operación create RedisEnterprise.
SkuName	Tipo de clúster de RedisEnterprise que se va a implementar. Valores posibles: (Enterprise_E10, EnterpriseFlash_F300 etc.)
TlsVersion	Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2".
UserAssignedIdentity	Propiedades de identidad asignadas por el usuario

Cluster

Describe el clúster de RedisEnterprise.

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.
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.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".
properties.privateEndpointConnections	PrivateEndpointConnection[]	Lista de conexiones de punto de conexión privado asociadas al clúster de RedisEnterprise 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.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 del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
zones	string[]	Availability Zones donde se implementará este clúster.

ClusterUpdate

Una actualización parcial del clúster de RedisEnterprise

Nombre	Tipo	Description
identity	ManagedServiceIdentity	Identidad del recurso.
properties.encryption	Encryption	Configuración de cifrado en reposo para el clúster.
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".
properties.privateEndpointConnections	PrivateEndpointConnection[]	Lista de conexiones de punto de conexión privado asociadas al clúster de RedisEnterprise 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.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

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

Nombre	Tipo	Description
systemAssignedIdentity	string
userAssignedIdentity	string

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.

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. Por ejemplo: https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78

Encryption

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

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

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	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

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.

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

ManagedServiceIdentity

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

Nombre	Tipo	Description
principalId	string	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	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

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

Nombre	Tipo	Description
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

PrivateEndpoint

El recurso Punto de conexión privado.

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

PrivateEndpointConnection

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 del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Estado de aprovisionamiento actual.

Nombre	Tipo	Description
Creating	string
Deleting	string
Failed	string
Succeeded	string

PrivateEndpointServiceConnectionStatus

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

Nombre	Tipo	Description
Approved	string
Pending	string
Rejected	string

PrivateLinkServiceConnectionState

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

Estado de aprovisionamiento actual

Nombre	Tipo	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

ResourceState

Estado actual de los recursos

Nombre	Tipo	Description
CreateFailed	string
Creating	string
DeleteFailed	string
Deleting	string
DisableFailed	string
Disabled	string
Disabling	string
EnableFailed	string
Enabling	string
Running	string
Scaling	string
ScalingFailed	string
UpdateFailed	string
Updating	string

Sku

Parámetros de SKU proporcionados para la operación create RedisEnterprise.

Nombre	Tipo	Description
capacity	integer	Tamaño del clúster de RedisEnterprise. El valor predeterminado es 2 o 3 en función de la SKU. Los valores válidos son (2, 4, 6, ...) para las SKU empresariales y (3, 9, 15, ...) para las SKU flash.
name	SkuName	Tipo de clúster de RedisEnterprise que se va a implementar. Valores posibles: (Enterprise_E10, EnterpriseFlash_F300 etc.)

SkuName

Tipo de clúster de RedisEnterprise que se va a implementar. Valores posibles: (Enterprise_E10, EnterpriseFlash_F300 etc.)

Nombre	Tipo	Description
EnterpriseFlash_F1500	string
EnterpriseFlash_F300	string
EnterpriseFlash_F700	string
Enterprise_E1	string
Enterprise_E10	string
Enterprise_E100	string
Enterprise_E20	string
Enterprise_E200	string
Enterprise_E400	string
Enterprise_E5	string
Enterprise_E50	string

TlsVersion

Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2".

Nombre	Tipo	Description
1.0	string
1.1	string
1.2	string

UserAssignedIdentity

Propiedades de identidad asignadas por el usuario

Nombre	Tipo	Description
clientId	string	Identificador de cliente de la identidad asignada.
principalId	string	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

KeyEncryptionKeyIdentity

ManagedServiceIdentity

ManagedServiceIdentityType

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProvisioningState

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

ProvisioningState

ResourceState

Sku

SkuName

TlsVersion

UserAssignedIdentity

Recursos adicionales