Creación de comparticiones de archivos de réplica

Crea réplicas de recursos compartidos de archivos en otra zona dentro de la misma región metropolitana o en una región metropolitana diferente dentro de la misma zona geográfica mediante la consola, la CLI, la API o Terraform.

La tabla siguiente muestra qué regiones metropolitanas se pueden replicar entre sí dentro de cada geografía.

Esta tabla muestra las regiones metropolitanas que pueden replicarse entre sí en cada geografía. Cada geografía es una columna separada.
Continente americano Europa Asia
  • Dallas, TX / us-south
  • Montreal / ca-mon
  • São Paulo / br-sao
  • Toronto / ca-tor
  • Washington, D. C. / us-east
 -Frankfurt/ eu-de
-Londres/ eu-gb
-Madrid/ eu-es
  • Chennai / in-che
  • Mumbai / in-mum
  • Osaka / jp-osa
  • Sídney / au-syd
  • Tokio / jp-tok

La compartición de archivo fuente especificada no debe tener otra réplica y no debe ser una réplica de otra compartición.

Si desea crear una réplica en otra región, primero debe establecer las autorizaciones de servicio a servicio. Ambas instancias de servicio de archivos deben pertenecer a la misma cuenta. La réplica entre cuentas no está soportada. Para obtener más información, consulte Establecimiento de autorizaciones de servicio a servicio para File Storage for VPC.

Al crear recursos compartidos de archivos con disponibilidad regional, los datos se replican automáticamente en toda la región, por lo que no es necesario configurar pares de replicación dentro de la región.

Añadir replicación a un recurso compartido de archivos en la consola

Puede crear una réplica de la compartición de archivos a partir de la lista de todas las comparticiones de archivos o de la página de detalles de compartición de archivos. Si aún no tiene un recurso compartido de archivos de origen, aprovisione uno como se describe en Crear un recurso compartido de archivos y montar el destino en la consola. Cuando el recurso compartido de archivos aparezca como "estable" en la página Recursos compartidos de almacenamiento de archivos para VPC, haga clic en el icono Acciones icono Acciones y haga clic en Crear réplica.

En la página de creación de réplica de compartición de archivos, revise los detalles de compartición de archivos de origen y complete los detalles de réplica.

  1. Nombre: asigna un nombre único al recurso compartido de la réplica.

  2. Ubicación de réplica-La geografía está preseleccionada y no se puede cambiar. Utilice el menú Zona para seleccionar la zona de la réplica. El menú está organizado por zonas geográficas. En cada zona geográfica, las ciudades se enumeran por orden alfabético. Haz clic en la flecha situada junto al nombre de una zona metropolitana para desplegar sus zonas y, a continuación, haz clic en una zona para seleccionarla.

  3. Grupo de recursos-Seleccione el grupo de recursos de la lista.

  4. Etiquetas-Opcionalmente, especifique etiquetas de usuario. Las etiquetas que aplique a la réplica pueden ser iguales o diferentes de las etiquetas de la compartición de origen.

  5. Perfil: el perfil dp2 está preseleccionado, incluso si la compartición de archivo de origen se basa en un perfil de un release anterior. Especifique el valor máximo para IOPS. Determina el rendimiento que obtiene en la réplica después de realizar una migración tras error.

  6. Destinos de montaje: si lo desea, cree un destino de montaje para el recurso compartido de la réplica. Puede omitir este paso si no desea crear un destino de montaje ahora. De lo contrario, haz clic en Crear. Puede crear un destino de montaje por cada VPC por cada compartición de archivos. En función de la modalidad de acceso de destino de montaje de la compartición, el formulario Crear destino de montaje tiene un aspecto diferente.

    • Si ha seleccionado el grupo de seguridad como modo de acceso, introduzca la información tal y como se describe en la Tabla 2. Esta acción crea y conecta una interfaz de red virtual al destino de montaje que identifica la compartición de archivos con una dirección IP reservada y aplica las reglas del grupo de seguridad seleccionado. Este destino de montaje da soporte al cifrado en tránsito y al montaje entre zonas.
    Valores para crear un objetivo de montaje.
    Campo Valor
    Detalles
    Nombre de destino de montaje Especifica un nombre de destino de montaje. El nombre puede tener hasta 63 caracteres alfanuméricos en minúsculas, puede incluir el guión (-), y debe comenzar con una letra minúscula. Más adelante puede editar el nombre si lo desea.
    Zona La zona se hereda de la compartición de archivos (por ejemplo, Dallas 2).
    VPC Seleccione una VPC disponible. La lista incluye únicamente aquellas VPC que tienen una subred en la zona seleccionada.
    Subred Seleccione una subred de la lista.
    Dirección IP reservada Necesario para el destino de montaje. La dirección IP no se puede cambiar después. Sin embargo, puede suprimir el destino de montaje y crear otro con una dirección IP diferente.
    Método de reserva Puede hacer que el servicio de archivos seleccione una dirección IP. La IP reservada se vuelve visible después de crear el destino de montaje. O bien, especifique su propia IP.
    Liberación automática Libera la dirección IP cuando suprime el destino de montaje. Está habilitado de forma predeterminada.
    Grupos de seguridad Se selecciona el grupo de seguridad predeterminado para la VPC. Puede utilizarlo o seleccionar otro grupo de seguridad de la lista.
    • Deprecated Si ha seleccionado VPC como modo de acceso, proporcione un nombre para el destino de montaje y seleccione una VPC de la lista. Este destino de montaje se puede utilizar para montar la compartición de archivos en cualquier instancia de servidor virtual de la VPC seleccionada en la misma zona que la compartición de archivos. El montaje entre zonas no está soportado.

    El modo de acceso VPC está en fase de obsolescencia y dejará de recibir soporte el 6 de mayo de 2027. Siga la guía de migración para actualizar el modo de control de acceso del recurso compartido de origen a security-group.

  7. Frecuencia de sincronización-Especifique la frecuencia con la que desea sincronizar los cambios de la compartición de archivos primaria a la compartición de réplica. En Frecuencia, selecciona una de las siguientes opciones y configura la hora de inicio:

    • Cada 15 minutos: Introduce el valor de los minutos para la hora de inicio.
    • Por hora: Introduce el valor en minutos correspondiente a la hora de inicio.
    • Diario: Introduzca la hora de inicio en Tiempo Universal Coordinado (UTC) en formato HH:MM, entre las 00:00 y las 23:59.
    • Semanal: Seleccione el día o los días de la semana en los que se ejecutará la replicación e introduzca la hora de inicio en UTC en formato HH:MM, entre las 00:00 y las 23:59.
    • Mensual: Introduzca el día del mes en el que se ejecuta la replicación (del 1 al 31) e introduzca la hora de inicio en UTC en formato HH:MM, entre las 00:00 y las 23:59.
    • Expresión Cron: Introduce una cron-spec expresión con el formato minute hour day month weekday. La replicación debe programarse con un intervalo mínimo de 15 minutos. Por ejemplo, para realizar la replicación todos los días a las 17:30 UTC, introduce 30 17 * * *.

  8. Cifrado: la réplica siempre hereda la configuración de cifrado del recurso compartido de origen. No se puede cambiar el tipo de cifrado. Si el recurso compartido de origen utiliza cifrado gestionado por el proveedor, se muestra la casilla gestionado por el proveedor, pero no se puede seleccionar. Si el recurso compartido de origen utiliza cifrado gestionado por el cliente, los detalles de la clave se muestran como de solo lectura, incluyendo el tipo de cifrado, el nombre de la clave, la instancia del servicio de gestión de claves y el ID de la clave.

  9. En el panel lateral, revise el coste estimado y aplique un código de descuento, si tiene uno.

  10. Haz clic en Crear recurso compartido de archivos.

Si todavía no está listo para realizar el pedido o simplemente está buscando información de precios, puede añadir la información que ve en el panel lateral a una estimación. Para más información sobre el funcionamiento de esta función, consulte Estimación de costes.

Cómo añadir replicación a un recurso compartido de archivos desde la CLI

Puede utilizar la CLI para crear un recurso compartido de archivos con un recurso compartido de réplica en otra zona o región, o para crear un recurso compartido de réplica para un recurso compartido de archivos existente.

Para poder utilizar la CLI, debe instalar la CLI de IBM Cloud y el plugin de la CLI de VPC. Para obtener más información, consulte los Requisitos previos de la CLI.

Creación de una compartición de archivos con una réplica desde la CLI

Puedes crear un recurso compartido de archivos por zonas con una réplica en la misma región al mismo tiempo. Este enfoque solo es compatible con recursos compartidos zonales cuyas réplicas permanezcan en la misma región. Las réplicas interregionales deben crearse en un paso independiente, ya que requieren que el recurso compartido de origen se encuentre en un estado estable en el momento de la inicialización de la réplica.

Cuando utilice el comando ' ibmcloud is share-create ' para crear su recurso compartido, puede crear un recurso compartido de réplica al mismo tiempo especificando valores para las opciones ' --replica-share-name, ' --replica-share-profile, ' --replica-share-cron-spec,--replica-share-zone. La opción cron especifica la frecuencia de replicación, y puede programar la replicación de sus datos con una frecuencia de hasta 15 minutos. Para más información sobre las opciones del comando, consulte ' ibmcloud is share-create.

En el ejemplo siguiente, se crea una compartición my-source-file-share en us-south-2 con una compartición de archivos de réplica my-replica-file-share en us-south-1. En este ejemplo, sólo se crea un destino de montaje para el recurso compartido de archivos de origen. También puede crear un objetivo de montaje para el recurso compartido de réplica utilizando la misma sintaxis JSON con la opción --replica-share-mount-targets.

ibmcloud is share-create --name my-source-file-share --zone us-south-2 --profile dp2 --size 1500 --iops 2000  --user-tags env:dev --mount-targets '[{"name":"my-source-mount-target","virtual_network_interface": {"name":"my-source-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]' --replica-share-name my-replica-file-share --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone us-south-1

Creating file share my-source-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
Name                               my-source-file-share
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-0a3444bc-df55-4c2e-aef4-f37a9a8d8262
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   user_managed,none
Zone                               us-south-2
Profile                            dp2
Size(GB)                           1500
IOPS                               2000
User Tags                          env:dev
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-67799c85-09cf-4cfe-811d-effa10c99395   my-source-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-08-01T17:25:05+00:00
Replication share                  ID                                          Name                    Resource type
                                   r006-2068a709-8c18-4844-8c1d-42b83889dfb3   my-replica-file-share   share
Replication role                   source
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

Creación de una réplica de un recurso compartido de archivos existente desde la CLI

Puedes crear una réplica de un recurso compartido de archivos ya existente en la misma región o en otra región dentro de la misma zona geográfica.

  1. Localice la compartición de archivos de origen desde la CLI listando las compartición de archivos en la región con el mandato ibmcloud is shares.

    ibmcloud is shares

    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size
r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0
r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0
r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0
r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0
r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0
r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0

  2. Vea los detalles de la compartición de archivos que desea utilizar como origen con el mandato ibmcloud is share. Puede utilizar el nombre o el ID de la compartición al crear una réplica en la misma región. Si crea la réplica en otra región, anote el CRN de la compartición de archivos de origen.

    ibmcloud is share my-file-share

    Getting file share my-file-share under account Test Account as user test.user@ibm.com...
ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name                         my-file-share
CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state              stable
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-2
Profile                      dp2
Size(GB)                     1000
IOPS                         1000
User Tags                    docs:test
Encryption                   provider_managed
Mount Targets                ID                                          Name
                             r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
Resource group               ID                                 Name
                             db8e8d865a83e0aae03f25a492c5b39e   Default
Created                      2023-10-18T22:15:15+00:00
Replication role             none
Replication status           none
Replication status reasons   Status code   Status message
                             -             -
Snapshot count               0
Snapshot size                0
Source snapshot              -
Allowed Access Protocols     nfs4
Availability Mode            zonal
Bandwidth(Mbps)              1
Storage Generation           1

  3. Cree un recurso compartido de réplica ejecutando el comando ibmcloud is share-replica-create en la región de destino. Si no está apuntando a la región correcta, utilice el comando ibmcloud target -r REGION para cambiar la región de destino. Especifique el recurso compartido de origen por ID o CRN utilizando la opción --source-share-id. Proporcione valores para definir la zona en la que se va a crear la réplica del recurso compartido de archivos y el perfil de la réplica del recurso compartido. Especifique la programación de la replicación con una expresión cron utilizando la opción --replication-cron-spec. Si el archivo fuente compartido tiene encriptación user_managed, debe proporcionar la dirección --encryption-key-crn. La propiedad --encryption-key-crn no debe especificarse de otro modo.

    ibmcloud is share-replica-create --name my-replica-share --zone us-south-3 --profile dp2 --replication-cron-spec '10 05 * * *' --source-share my-file-share

    Creating replica file share my-replica-share under account Test Account as user test.user@ibm.com...
ID                               r006-6d1719da-f790-45cc-9f68-896fd5673a1a
Name                             my-replica-share
CRN                              crn:v1:bluemix:public:is:us-south-3:a/a1234567::share:r006-6d1719da-f790-45cc-9f68-896fd5673a1a
Lifecycle state                  pending
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes ipsec,none
Zone                             us-south-3
Profile                          dp2
Size(GB)                         1000
IOPS                             100
User Tags                        docs:test
Encryption                       provider_managed
Mount Targets                    ID                          Name
                                 No mounted targets found.
Resource group                   ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
Created                          2024-06-25T15:13:18+00:00
Latest job                       Job status   Job status reasons
                                 running      -
Replication cron spec            10 05 * * *
Replication role                 replica
Replication status               initializing
Replication status reasons       Status code   Status message
                                 -             -
Source share                     ID                                          Name            Resource type
                                 r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share   share
Snapshot count                   0
Snapshot size                    0
Source snapshot                  -
Allowed Access Protocols         nfs4
Availability Mode                zonal
Bandwidth(Mbps)                  1
Storage Generation               1

Añadir replicación a un recurso compartido de archivos mediante la API

Puede configurar mediante programación la réplica llamando al método /shares en la API de VPC tal como se muestra en las siguientes solicitudes de ejemplo.

Antes de empezar, primero configure el Entorno de API. Para obtener más información sobre el API de VPC de comparticiones de archivos, consulte la referencia del API de VPC.

Creación de una compartición de archivos con una réplica con la API

Puedes crear un recurso compartido de archivos por zonas con una réplica en la misma región al mismo tiempo. Este enfoque solo es compatible con recursos compartidos zonales cuyas réplicas permanezcan en la misma región. Las réplicas interregionales deben crearse en un paso independiente, ya que requieren que el recurso compartido de origen se encuentre en un estado estable en el momento de la inicialización de la réplica.

Al crear un recurso compartido de archivos, puede especificar que también se cree una réplica del mismo en otra zona. Realice una solicitud de POST /shares y especifique la propiedad replica_share para definir la compartición de archivos de réplica.

El ejemplo siguiente crea la réplica test-replica-001 para la compartición de origen source-share-001. Los destinos de montaje, que son opcionales al crear un recurso compartido de archivos, se especifican tanto para el recurso compartido de archivos de réplica como para el de origen.

curl -X POST\
"$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "name": "source-share-001",
    "profile":{"name":"dp2"},
    "size":100,
    "iops": 400,
    "mount-targets":[{"vpc":{"id":"08669c86-4c8a-4bfa-8ddc-37071f955c52"}],
    "zone":{"name":"us-south-1"},
    "replica_share":{
  	   "name": "test-replica-001",
      "profile":{"name":"dp2"},
      "replication_cron_spec":"0 */5 * * *",
      "zone":{"name":"us-south-3"},
      "mount_targets": [
        {"virtual_network_interface": {"subnet": {"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5"}}},
        {"vpc": {"id": "7ec86020-1c6e-4889-b3f0-a15f2e50f87e"}}],
      "resource_group": {},
      "allowed_transit_encryption_modes": "ipsec",
      "user_tags": ["string"]}}]
      }
    "resource_group": {},
    "allowed_transit_encryption_modes": "ipsec",
    "user_tags": ["string"]
   }'

Creación de una réplica para una compartición de archivos existente con la API

Para añadir replicación a un recurso compartido de archivos ya existente, debes crear un recurso compartido de réplica en una zona diferente. En la solicitud POST /shares, especifique el nombre y el perfil de la unidad compartida de réplica y especifique source_share por su nombre, ID o CRN. Otras propiedades obligatorias son zone, y replication_cron_spec, que proporcionan la programación de la replicación. Puede programar la replicación de sus datos con una frecuencia de hasta 15 minutos.

Adición de réplica a compartición de archivos con Terraform

Puede utilizar el recurso ibm_is_share en Terraform para crear una compartición de archivos con réplica, o actualizar una compartición de archivos para incluir la réplica.

En el siguiente ejemplo se crea un recurso compartido réplica en la zona us-south-3 y se asocia al recurso compartido principal, cuyo ID es ibm_is_share.example.id.

resource "ibm_is_share" "my-replica1" {
  zone                  = "us-south-3"
  source_share          = ibm_is_share.example.id
  name                  = "my-replica1"
  profile               = "dp2"
  replication_cron_spec = "0 */5 * * *"
}

El ejemplo siguiente crea una compartición de archivos en us-south-1 con una réplica en us-south-3.

resource "ibm_is_share" "my-replica" {
  zone    = "us-south-1"
  size    = 220
  name    = "my-share"
  profile = "dp2"
  replica_share {
    name                  = "my-replica"
    replication_cron_spec = "0 */5 * * *"
    profile               = "dp2"
    zone                  = "us-south-3"
  }
}

Próximos pasos