Renombrar un archivo compartido en la consola

1. En la página detalles de comparticiones de archivos, pulse el icono Editar junto al nombre de compartición de archivos.

2. Proporcione un nuevo nombre para la unidad compartida de archivos.

Los nombres de compartición válidos pueden incluir una combinación de caracteres alfanuméricos en minúsculas (a-z, 0-9) y el guion (-), con un máximo de 63 caracteres. Los nombres de unidades compartidas de archivos deben empezar por una letra minúscula.

Cambiar el nombre de un destino de montaje de un recurso compartido de archivos en la consola

1. Vaya a la página detalles de comparticiones de archivos.
2. Pulse el icono Acciones .
3. Seleccione Cambiar nombre.
4. Especifique un nuevo nombre y pulse Cambiar nombre.

Los nombres de destino de montaje válidos pueden incluir una combinación de caracteres alfanuméricos en minúsculas (a-z, 0-9) y el guion (-), con un máximo de 63 caracteres. Los nombres de destino de montaje deben empezar por una letra minúscula.

Actualización de un perfil de recurso compartido en la consola

Estas instrucciones son para la generación anterior de perfiles de recursos compartidos de archivos (de uso general, 5-iops, 10-iops o personalizados) que se utilizaron en la versión beta de los recursos compartidos de archivos zonales. A partir del 06 de mayo de 2026, estos perfiles de acciones son Deprecated. Para acceder a las funciones actuales, debe cambiar el perfil de IOPS de su recurso compartido a dp2. Los perfiles de los archivos compartidos que se crearon con el perfil dp2 o rfs no se pueden modificar.

Puede cambiar el perfil de una compartición de archivos del perfil actual a otro perfil de nivel IOPS, a un perfil personalizado o a un perfil dp2 de alto rendimiento. Su facturación se ajusta en función del perfil que elija.

1. Vaya a la página detalles de comparticiones de archivos.
2. Pulse el icono Editar situado junto al perfil actual o utilice el menú Acciones y seleccione Editar perfil de IOPS. Un panel lateral muestra el perfil actual, el tamaño de compartición de archivos y el máximo de IOPS.
3. Para un Perfil nuevo, pulse la flecha abajo. Puede seleccionar un nuevo nivel de IOPS, un perfil personalizado o dp2. Para IOPS personalizadas o dp2, especifique un nuevo IOPS máximo basado en el tamaño de compartición de archivo. El precio de la acción de archivo se calcula automáticamente en función de su selección.
4. Haz clic en « Guardar y continuar ».

Actualización de los modos de cifrado de tránsito permitidos en la consola

El propietario de una acción puede cambiar los modos de cifrado de tránsito permitidos. Sin embargo, antes de que se pueda cambiar esta propiedad, se deben suprimir todos los enlaces. La supresión de los enlaces interrumpe la vía de acceso de red entre la compartición de archivo de origen y la compartición de descriptor de acceso, y coloca el destino de montaje que está conectado a la compartición de descriptor de acceso en un estado anómalo. Para obtener más información, consulte Eliminación del acceso a una compartición de archivos de otras cuentas.

1. Seleccione una compartición de archivos de la lista de comparticiones de archivos.
2. En la página Detalles de compartición de archivos, localice las modalidades de cifrado de tránsito permitidas.
3. Pulse el icono Editar para cambiar el valor actual.

Cambiar el nombre de un recurso compartido de archivos desde la CLI

1. Localice la compartición de archivos que desea renombrar listando las comparticiones de archivos en la región con el mandato ibmcloud is shares. Anota el nombre y el ID del archivo compartido.

   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
   r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   tier-3iops 40         defaults         none               -                       -                -
   

2. Ejecute el mandato ibmcloud is share-update y especifique un nuevo nombre de compartición de archivos con las opciones --name.

   ibmcloud is share-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 --name my-renamed-share
   

   Updating file share r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 under account Test Account as user test.user@ibm.com...
   ID                           r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   Name                         my-renamed-share
   CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   Lifecycle state              stable
   Access control mode          vpc
   Zone                         us-south-2
   Profile                      dp2
   Size(GB)                     100
   IOPS                         100
   Encryption                   ipsec
   Mount Targets                ID                          Name
                                No mounted targets found.
   Resource group               ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
   Created                      2023-08-01T17:02:01+00:00
   Encryption key               crn:v1:bluemix:public:kms:eu-de:a/a1234567:key:f602ae93-b915-49bc-a0e1-af29c73e7788
   Latest job                   Job status   Job status reasons
                                -            -
   Replication cron spec        00 11 * * 0
   Replication role             replica
   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
   

Los nombres de compartición válidos pueden incluir una combinación de caracteres alfanuméricos en minúsculas (a-z, 0-9) y el guion (-), con un máximo de 63 caracteres. Los nombres de unidades compartidas de archivos deben empezar por una letra minúscula.

Para obtener más información sobre las opciones de mandato, consulte ibmcloud is share-update.

Cambiar el nombre de un destino de montaje de un recurso compartido de archivos desde la línea de comandos

1. Liste las comparticiones de archivos en la región con el mandato ibmcloud is shares. Anote el nombre y el ID de la compartición de archivos que tiene el destino de montaje que desea renombrar.

2. Utilice el nombre o ID de la compartición para buscar sus destinos de montaje con el mandato ibmcloud is share-mount-targets.

   ibmcloud is share-mount-targets r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   

   Listing share mount target of r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
   ID                                          Name                     VPC      Lifecycle state   Transit Encryption
   r006-fdbffc45-618c-49f1-bb08-ec530d7be378   my-source-mount-target   my-vpc   stable            none
   

3. Para renombrar el destino de montaje, ejecute el mandato share-mount-target-update con el nombre o ID de compartición de archivos y el nombre de destino de montaje. Especifique un nuevo nombre de destino de montaje con la opción --name.

   ibmcloud is share-mount-target-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 r006-fdbffc45-618c-49f1-bb08-ec530d7be378 --name my-renamed-mount-target
   

Los nombres de destino de montaje válidos pueden incluir una combinación de caracteres alfanuméricos en minúsculas (a-z, 0-9) y el guion (-), con un máximo de 63 caracteres. Los nombres de destino de montaje deben empezar por una letra minúscula.

Para obtener más información sobre las opciones de mandato, consulte ibmcloud is share-mount-target-update.

Actualización de un perfil de recurso compartido de archivos en la CLI

Estas instrucciones son para la generación anterior de perfiles de recursos compartidos de archivos (de uso general, 5-iops, 10-iops o personalizados) que se utilizaron en la versión beta de los recursos compartidos de archivos zonales. A partir del 06 de mayo de 2026, estos perfiles de acciones son Deprecated. Para acceder a las funciones actuales, debe cambiar el perfil de IOPS de su recurso compartido a dp2. Los perfiles de los archivos compartidos que se crearon con el perfil dp2 o rfs no se pueden modificar.

1. Localice la compartición de archivos que desea actualizar listando las comparticiones 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
   r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f   my-old-file-share       stable            us-south-1   tier-3iops 40         defaults         none               -                       -                -
   

2. Utilice el mandato share-update con el parámetro --profile para indicar el nuevo perfil de compartición de archivos por nombre.

   ibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000
   

   Updating file share my-file-share-8 under account Test Account as user test.user@ibm.com...
   ID                           r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f
   Name                         my-old-file-share
   CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f
   Lifecycle state              updating
   Access control mode          vpc
   Zone                         us-south-1
   Profile                      dp2
   Size(GB)                     1000
   IOPS                         3000
   User Tags                    env:dev,env:prod
   Encryption                   provider_managed
   Mount Targets                ID                                          Name
                                r006-c9d82a15-7ead-4388-abc8-88e81c12ed28   my-target121
   Resource group               ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
   Created                      2023-03-27T20:43:36+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
   

Para obtener más información sobre las opciones de mandato, consulte ibmcloud is share-update.

Actualización de los modos de cifrado de tránsito permitidos desde la CLI

El propietario del recurso compartido puede actualizar los modos de cifrado de tránsito permitidos con los siguientes valores.

• Para los archivos compartidos zonales, los valores permitidos son ipsec,none,ipsec, o none.
• Para los archivos compartidos regionales, los valores permitidos son stunnel,none, stunnel, o none.

Sin embargo, antes de poder cambiar esta propiedad, se deben eliminar todos los enlaces y objetivos de montaje. La supresión de los enlaces interrumpe la vía de acceso de red entre la compartición de archivo de origen y la compartición de descriptor de acceso, y coloca el destino de montaje que está conectado a la compartición de descriptor de acceso en un estado anómalo. Para obtener más información, consulte Eliminación del acceso a un recurso compartido de archivos desde otras cuentas.

ibmcloud is share-update my-origin-share --allowed-transit-encryption-modes ipsec

Updating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                               r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name                             my-origin-share
CRN                              crn:v1:bluemix:public:is:us-south-2:a/1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state                  stable
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes ipsec
Origin share CRN                                                                                             Name            Remote account  Remote region
                                 crn:v1:bluemix:public:is:us-south-2:a/7654321::share:r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed  my-origin-share a7654321        -
Zone                             us-south-2
Profile                          dp2
Size(GB)                         1000
IOPS                             1000
Encryption                       provider_managed
Mount Targets                    ID                          Name
                                 No mounted targets found.
Resource group                   ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
Created                          2024-06-25T22:15:15+00:00
Replication role                 none
Replication status               none
Replication status reasons       Status code   Status message
                                 -             -
 Allowed Access Protocols        nfs4
 Availability Mode               zonal
 Bandwidth(Mbps)                 1
 Storage Generation              1

Cambiar el nombre de un recurso compartido mediante la API

Realice una llamada PATCH /shares/$share_id para renombrar una unidad compartida de archivos específica. Vea el ejemplo siguiente.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"\
  -d '{"name": "share-renamed1"}'

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-17T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "id": "0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "share-renamed1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-10iops",
    "name": "tier-10iops",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "id": "bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 100,
  "mount_targets": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Los nombres de compartición válidos pueden incluir una combinación de caracteres alfanuméricos en minúsculas (a-z, 0-9) y el guion (-), con un máximo de 63 caracteres. Los nombres de unidades compartidas de archivos deben empezar por una letra minúscula.

Cambiar el nombre de un destino de montaje de un recurso compartido de archivos mediante la API

Realiza una llamada « PATCH /shares/$share_id/mount_targets/$target_id » para cambiar el nombre de un destino de montaje de un recurso compartido de archivos. Vea el ejemplo siguiente.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{"name": "target-renamed1"}

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-18T23:31:59Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "lifecycle_state": "stable",
  "mount_path": "domain.com:/vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
  "name": "target-renamed1",
  "resource_type": "share_target",
  "transit_encryption": "none",
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs8c95b3c1-fe3c-45c-97a6-e43d14088287",
    "id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
    "name": "vpc-name1",
    "resource_type": "vpc"
  }
}

Los nombres de destino de montaje válidos pueden incluir una combinación de caracteres alfanuméricos en minúsculas (a-z, 0-9) y el guion (-), con un máximo de 63 caracteres. Los nombres de destino de montaje deben empezar por una letra minúscula.

Actualización de un perfil de recurso compartido de archivos mediante la API

Estas instrucciones son para la generación anterior de perfiles de recursos compartidos de archivos (de uso general, 5-iops, 10-iops o personalizados) que se utilizaron en la versión beta de los recursos compartidos de archivos zonales. A partir del 06 de mayo de 2026, estos perfiles de acciones son Deprecated. Para acceder a las funciones actuales, debe cambiar el perfil de IOPS de su recurso compartido a dp2. Los perfiles de los archivos compartidos que se crearon con el perfil dp2 o rfs no se pueden modificar.

Realice una llamada PATCH /shares/{share_ID} y especifique el nombre de perfil en la propiedad profile. El ejemplo siguiente cambia el perfil a un perfil dp2.

curl -X PATCH "$vpc_api_endpoint/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{"profile": {"name": "dp2"}}'

Actualización de las modalidades de cifrado de tránsito permitidas con la API

El propietario del recurso compartido puede actualizar los modos de cifrado de tránsito permitidos con los siguientes valores.

• Para los archivos compartidos zonales, los valores permitidos son ipsec,none,ipsec, o none.
• Para los archivos compartidos regionales, los valores permitidos son stunnel,none, stunnel, o none.

Sin embargo, antes de poder cambiar esta propiedad, deben eliminarse todos los enlaces y objetivos de montaje. La supresión de los enlaces interrumpe la vía de acceso de red entre la compartición de archivo de origen y la compartición de descriptor de acceso, y coloca el destino de montaje que está conectado a la compartición de descriptor de acceso en un estado anómalo. Para obtener más información, consulte Eliminación del acceso a una compartición de archivos de otras cuentas.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"
  -d '{"allowed_transit_encryption_modes": "ipsec"}'

Actualización de atributos de una compartición de archivos con Terraform

Actualice el recurso ibm_is_share para cambiar los atributos de la compartición de archivos como, por ejemplo, el nombre, el tamaño, el perfil, las etiquetas. Cuando se aplica, el ejemplo siguiente actualiza el nombre de la compartición a new_name.

resource "ibm_is_share" "example" {
  name    = "new_name"
  size    = 300
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
}

El nombre válido para el recurso compartido de archivos y el destino de montaje puede incluir una combinación de caracteres alfanuméricos en minúscula (a-z, 0-9) y el guión (-), con una longitud máxima de 63 caracteres. Los nombres de unidades compartidas de archivos deben empezar por una letra minúscula.

Algunos atributos, como el perfil, los modos de cifrado en tránsito permitidos y el cifrado en reposo, no son editables para los recursos compartidos de acceso.

El propietario del recurso compartido puede actualizar los modos de cifrado de tránsito permitidos con los siguientes valores.

• Para los archivos compartidos zonales, los valores permitidos son ipsec,none,ipsec, o none.
• Para los archivos compartidos regionales, los valores permitidos son stunnel,none, stunnel, o none.

Sin embargo, antes de poder cambiar esta propiedad, se deben eliminar todos los enlaces y objetivos de montaje. La supresión de los enlaces interrumpe la vía de acceso de red entre la compartición de archivo de origen y la compartición de descriptor de acceso, y coloca el destino de montaje que está conectado a la compartición de descriptor de acceso en un estado anómalo. Para obtener más información, consulte Eliminación del acceso a un recurso compartido de archivos desde otras cuentas.

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_share.

Actualización de atributos de un destino de montaje con Terraform

Actualice el recurso ibm_is_share_mount_target para cambiar el nombre del destino de montaje. Cuando se aplica, el recurso siguiente cambia el nombre del destino de montaje a my-new-share-target.

resource "ibm_is_share_mount_target" "is_share_target" {
  access_protocol    = "nfs4"
  name               = "my-new-share-target"
  share              = is_share.is_share.id
  subnet             = ibm_is_subnet.example.id
}`

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_share_target.