Configuración a través de la consola de IBM Cloud

Realiza la implementación desde la consola especificando los siguientes parámetros.

1. En « Detalles del servicio », configura lo siguiente:

   • Ubicación: Selecciona una ubicación compatible con Gen 2.
   • Nombre del servicio: El nombre puede ser cualquier cadena de caracteres y es el nombre que se utiliza en la web y en la CLI para identificar la nueva instancia.
   • Grupo de recursos: si estás organizando tus servicios en grupos de recursos. Para obtener más información, consulte Gestión de grupos de recursos.

2. Modelo de alojamiento: «Isolated» es una oferta segura de inquilino único destinada a cargas de trabajo empresariales complejas y de alto rendimiento. Para obtener más información, consulta « Modelos de alojamiento ».

3. Asignación de recursos: ajusta la asignación de recursos seleccionando el tamaño de host necesario para tu implementación y especificando el tamaño de disco requerido. El tamaño del host y la asignación de disco son por miembro.

   El tamaño del disco se puede aumentar tras el aprovisionamiento, pero no se puede reducir para evitar la pérdida de datos.

4. En « Configuración del servicio », configura lo siguiente:

   • Versión de la base de datos: la versión de implementación de tu base de datos. Para garantizar un rendimiento óptimo, utiliza la versión recomendada. La última versión menor se utiliza automáticamente. Para obtener más información, consulta la política de versiones de bases de datos.
   • Cifrado: si utilizas Key Protect, puedes seleccionar una instancia y una clave para cifrar el disco de dicha instancia. Si no utilizas tu propia clave, la instancia crea y gestiona automáticamente su propia clave de cifrado de disco.
   • Puntos finales: configura los puntos finales del servicio en tu implementación. La configuración predeterminada es «privada ».

5. Pulse Crear. Se abre la página de la lista de recursos de « Cloud Databases ».

6. Cuando se haya aprovisionado tu instancia, haz clic en el nombre de la misma para ver más información.

Configuración a través de la interfaz de línea de comandos (CLI)

Antes de realizar el aprovisionamiento, sigue las instrucciones que figuran en la documentación para instalar la herramienta CLI de IBM Cloud.

1. Inicie sesión en IBM Cloud. Si utiliza un ID de usuario federado, es importante que cambie a un código de acceso de una sola vez (ibmcloud login --sso) o utilice una clave de API (ibmcloud --apikey key or @key_file) para la autenticación. Para obtener más información sobre cómo iniciar sesión mediante la CLI, consulta Comandos generales de la CLI(ibmcloud) en ibmcloud login.

   ibmcloud login
   

2. Seleccionar un grupo de recursos:

   ibmcloud target -g Default
   

3. Crea una instancia del servicio « Databases for Redis » en IBM Cloud ejecutando un comando como este:

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -p '{"dataservices": {"redis": {"host_flavor":"bx3d.4x20"}}}' --user-tags test-redis,do-not-delete
   

   Por ejemplo, para aprovisionar una instancia de Databases for Redis, utiliza un comando como este:

   ibmcloud resource service-instance-create redis-test-database databases-for-redis databases-for-redis-gen2-standard ca-mon -p '{"dataservices": {"redis": {"host_flavor":"bx3d.4x20"}}}' --user-tags test-redis,do-not-delete
   

   El parámetro « host_flavor » define el tamaño de tu recurso de Compute. Introduce el valor adecuado para la configuración de CPU y RAM que desees. Para conocer los valores disponibles de «host flavor», consulta la sección « Selección del tamaño de host flavor ».

   Los campos del comando se describen en la siguiente tabla:

   Tabla 1. Campos del formato básico de comando

   Campo	Descripción	Distintivo
   INSTANCE_NAME Obligatorio	El nombre de la instancia puede ser cualquier cadena de caracteres y es el nombre que se utiliza en la web y en la CLI para identificar la nueva implementación.
   SERVICE_NAME Obligatorio	Nombre o ID del servicio. Para acceder a « Databases for Redis », utiliza databases-for-redis.
   SERVICE_PLAN_NAME Obligatorio	Plan estándar « gen2 » (standard-gen2)
   LOCATION Obligatorio	La ubicación en la que deseas realizar la implementación. Para obtener una lista de regiones, utiliza el comando « ibmcloud regions ». En el caso de una llamada a la API, «Location» se denomina «target»
   RESOURCE_GROUP	El nombre del grupo de recursos. El valor predeterminado es Default. Indica el ID del grupo de recursos en caso de llamada a la API.	-g
   --parameters	Archivo JSON o cadena JSON con los parámetros para crear la instancia del servicio	-p
   host_flavor	En «Computación aislada», selecciona la configuración de CPU y RAM que desees. Para obtener más información, consulta la siguiente tabla o la sección « Modelos de alojamiento ».
   --user-tags	Lista de nombres de etiquetas de usuario separados por comas

   Verás una respuesta similar a la siguiente:

   Creating service instance redis-test-database in resource group Default of account ICD as user@ibm.com...
   OK
   Service instance redis-test-database was created.
   Name:                   redis-test-database
   ID:                     crn:v1:bluemix:public:databases-for-redis:ca-mon:a/23b09aee04da4545b6e32805fa93249d:4b6b8771-b44e-4687-9393-db8a2dec1942::
   GUID:                   4b6b8771-b44e-4687-9393-db8a2dec1942
   Location:               ca-mon
   State:                  provisioning
   Type:                   service_instance
   Sub Type:
   Allow Cleanup:          false
   Locked:                 false
   One-time credentials:   false
   Created at:             2026-06-25T12:48:00Z
   Updated at:             2026-06-25T12:48:01Z
   Last Operation:
                           Status    create in progress
                           Message   Started create instance operation
   

   Para comprobar el estado del aprovisionamiento, utiliza el siguiente comando :

   ibmcloud resource service-instance <INSTANCE_NAME>
   

   Una vez finalizado el proceso, verás una respuesta similar a la siguiente:

   Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
   OK
   Name:                  INSTANCE_NAME
   ID:                    crn:v1:bluemix:public:databases-for-redis:ca-mon:a/23b09aee04da4545b6e32805fa93249d:4b6b8771-b44e-4687-9393-db8a2dec1942::
   GUID:                  4b6b8771-b44e-4687-9393-db8a2dec1942
   Location:              <LOCATION>
   Service Name:          databases-for-redis
   Service Plan Name:     standard-gen2
   Resource Group Name:   default
   State:                 active
   Type:                  service_instance
   Sub Type:              Public
   Locked:                false
   Service Endpoints:     private
   Created at:            2026-06-25T19:42:07Z
   Created by:            USER
   Updated at:            2026-06-25T19:53:25Z
   Last Operation:
                          Status    create succeeded
                          Message   Provisioning redis with version 8.2 (100%)
   

ibmcloud resource service-instance-update service-instance-current-name --service-plan-id databases-for-redis-gen2-standard -p '{"dataservices": {"redis": {"storage_gb":20}}}' -g Default --name NEW_NAME

ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>

ibmcloud resource service-instance-create restore-instance-name databases-for-redis standard-gen2 ca-mon -g Default  -p '{
      "dataservices":{
            "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
}'

Suministro mediante la API del controlador de recursos

Sigue estos pasos para realizar el aprovisionamiento mediante la API de Resource Controller.

1. Obtén un token de IAM con el siguiente comando :

   IAM_TOKEN=$(ibmcloud iam oauth-tokens -o json | jq .iam_token -r)
   

2. Debes conocer el ID del grupo de recursos en el que deseas realizar la implementación. Esta información está disponible a través de la CLI de IBM Cloud.

   Utiliza un comando como este:

   ibmcloud resource groups
   

   Anota el ID del grupo de recursos que desees. En la mayoría de los casos utilizamos el valor predeterminado del grupo de recursos.

3. Debes conocer la región en la que quieres realizar la implementación.

   Para obtener una lista de todas las regiones en las que se pueden aprovisionar implementaciones desde la región actual, utiliza el complemento de la CLI « Cloud Databases ».

   El comando tiene el siguiente aspecto:

   ibmcloud cdb regions --json
   

4. El parámetro « host_flavor » define el tamaño de tu recurso de Compute. Elige el valor adecuado para tu implementación. Para conocer los valores disponibles de «host flavor», consulta « Computación aislada de 2.ª generación ».

5. Cuando dispongas de toda la información, crea una nueva instancia de recurso mediante el controlador de recursos de IBM Cloud.

   curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: ${IAM_TOKEN}"   -H 'Content-Type: application/json' -d '{
       "name": "redis-test",
       "target": "ca-mon",
       "resource_group": "c21a4e8564c14d1aab2a9a8b441904eb",
       "resource_plan_id": "databases-for-redis-gen2-standard",
       "parameters": {
         "dataservices": {
           "redis": {
             "host_flavor": "bx3d.4x20"
           }
         },
         "service_endpoints": "private",
         "version": "8.2"
       },
       "tags": [
         "redis-test",
         "do-not-delete"
       ]
     }'
   

   Los campos del mandato se describen en la tabla siguiente.

   Tabla 3. Campos del formato básico de comando

   Campo	Descripción	Distintivo
   name Obligatorio	El nombre de la instancia puede ser cualquier cadena de caracteres y es el nombre que se utiliza en la web y en la CLI para identificar la nueva implementación.
   target Obligatorio	La ubicación en la que deseas realizar la implementación. Para obtener una lista de regiones, utiliza el comando « ibmcloud regions ».
   resource_group Obligatorio	El identificador del grupo de recursos. El valor predeterminado es Default.
   resource_plan_id Obligatorio	Plan estándar « gen2 » (databases-for-redis)
   parameters	Objeto JSON con los parámetros para crear una instancia del servicio
   host_flavor	En «Computación aislada», selecciona la configuración de CPU y RAM que desees. Para obtener más información, consulta « Modelos de alojamiento ».
   service_endpoints Obligatorio	Configura los puntos de acceso del servicio de tu implementación, ya sea public, private o public-and-private.
   version	La versión de la base de datos que se va a poner en servicio. Si se omite, la base de datos se crea con la versión principal y menor más reciente.
   tags	Conjunto de nombres de etiquetas de usuario

curl -X GET https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}" | jq

curl -X PATCH https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}" -H 'Content-Type: application/json' -d '{
"name": "redis-test-testing-patch",
"parameters":{"dataservices":{"redis":{"host_flavor":"bx3d.8x40"}}}
}' | jq

curl -X DELETE https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}"

curl -X POST   https://resource-controller.cloud.ibm.com/v2/resource_instances   -H "Authorization: ${IAM_TOKEN}"   -H 'Content-Type: application/json' -d '{
    "name": "redis-test-restore",
    "target": "ca-mon",
    "resource_group": "c21a4e8564c14d1aab2a9a8b441904eb",
    "resource_plan_id": "databases-for-redis-gen2-standard",
    "parameters": {
      "dataservices": {
        "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
    },
    "tags": [
      "redis-test"
    ]
  }'

Suministro con Terraform

Utiliza Terraform para gestionar tu infraestructura a través del recurso « ibm_database » para Terraform, que permite el aprovisionamiento de implementaciones de « Cloud Databases ».

Selecciona el modelo de alojamiento en el que deseas que se configure tu base de datos. Puede cambiarlo más adelante.

Configure una instancia de « Databases for Redis » con el parámetro « "host_flavor" » establecido en el tipo de host deseado. Por ejemplo:

data "ibm_resource_group" "group" {
  name = "<your_resource_group>"
}
resource "ibm_resource_instance" "<your_instance_name>" {
  name = "your_instance_name"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags              = ["terraform", "redis"]
  resource_group_id = data.ibm_resource_group.group.id
  timeouts {
    create = "120m"
    update = "120m"
    delete = "15m"
  }
}

Antes de ejecutar un script de Terraform en una instancia existente, utiliza el comando « terraform plan » para comparar el estado actual de la infraestructura con el estado deseado definido en tus archivos de Terraform. Cualquier modificación de los atributos resource_group_id, service plan, version, key_protect_instance, key_protect_key o backup_encryption_key_crn provocará la recreación de tu instancia. Para consultar una lista de las referencias de argumentos actuales de la especificación « Forces new resource », consulta el Registro de Terraform de ibm_database.

data "ibm_resource_group" "group" {
  name = "<your_resource_group>"
}
data "ibm_resource_instance" "<your_instance_name>" {
  name              = "<your_instance_name>"
  location          = "us-east"
  resource_group_id = data.ibm_resource_group.group.id
  service = "databases-for-redis"
}
output "<your_instance_name>_output" {
  value ={
    id = data.ibm_resource_instance.<your_instance_name>.id
    name = data.ibm_resource_instance.<your_instance_name>.name
    extensions = data.ibm_resource_instance.<your_instance_name>.extensions
    group_id = data.ibm_resource_instance.<your_instance_name>.resource_group_id
  }
}

data "ibm_resource_group" "group" {
  name = "your_resource_group"
}
resource "ibm_resource_instance" "<your_instance_name>" {
  name = "<your_instance_name>"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags              = ["scaling","tf"]
  resource_group_id = data.ibm_resource_group.group.id
  parameters_json = jsonencode({
  "dataservices": {
      "redis": {
        "host_flavor": "bx2.8x32"
      }
  }
})
  timeouts {
    create = "120m"
    update = "120m"
    delete = "15m"
  }
}

resource "ibm_resource_instance" "<your_instance_name>" {
  name = "<your_instance_name>"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags      = ["terraform", "redis"]
    parameters_json = jsonencode({
      "dataservices": {
        "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
    })
}