管理副本文件共享

通过删除复制关系来管理副本文件共享，从而创建可独立进行读写操作的共享，这些共享可以分别进行更新和删除。

您需要管理员或编辑者 IAM 用户角色来创建和管理文件共享副本和复制关系。有关这些角色和操作的列表，请参阅用于创建和管理文件共享的 IAM 角色。

复制同步信息

复制是一个异步操作，它不是瞬时的。每次同步操作后，系统都会提供有关上次复制过程的有用信息，例如开始和结束日期以及传输的数据卷。通过查看复制信息，您可以查看上次复制所花费的时间长度并计算传输速率。查看传输的数据值可帮助您估算计费周期结束时的全局传输费用。

您可以使用复制同步信息来微调复制调度。它可以帮助您平衡需要在副本上刷新数据以满足恢复点目标在灾难恢复计划中，数据恢复的时间以秒、分、小时为单位，从恢复的实例开始，到灾难发生点结束。的成本和频率。它还可以帮助确定复制过程是否有降级的危险。

当要传输的数据量超过复制窗口期间可传输的数据量 (具有正常传输速率) 时，复制过程无法完成，并且复制状态变为 degraded。如果发生此情况，请尝试调整文件共享的更改速率和复制频率。

系统每 15 分钟查询一次上次同步状态。结果显示上次完成的复制的数据。如果在运行查询时正在进行复制，那么它不会显示在响应中。复制完成后，下一个查询将更新上次同步信息。从复制完成到接口中最后一次同步信息更新之间可能会有短暂的延迟。

查看源或副本共享的详细信息时，可以查看有关上次复制操作的信息。有关更多信息，请参阅在控制台中查看文件共享的详细信息。

在列出源共享或副本共享的详细信息时，可以查看有关上次复制操作的信息。有关更多信息，请参阅从 CLI 查看文件共享的详细信息。

您可以通过调用 VPC API中的 /shares 方法，以编程方式检索最后一个同步详细信息。在 API 响应中查找 latest_sync 部分，以查看复制何时启动 (started_at)，何时结束 (completed_at) 以及传输的数据量 (data_transferred)。有关更多信息，请参阅查看与 API 的单个文件共享。

此外，使用 IBM Cloud Logs 时，还可以查看最近复制同步的历史信息。发生复制时，文件服务会生成 regional-file.00002I 日志消息，其中包含有关发生复制的时间以及传输的数据量的信息。有关更多信息，请参阅 VPC 日志记录。

使用 API 验证复制

您可以使用 API 来验证复制是否成功，暂挂或失败。您可以发出 GET /shares/{share_id} 请求，以查看源或副本共享的共享标识的状态。

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"

在响应中，查看 latest_job 属性。此示例显示复制故障转移成功:

  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "$vpc_api_endpoint/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "share-name1",
  .
  .
  .
  "latest_job": {
      "status": "succeeded",
      "status_reason": {
          "code": "",
          "message": "",
          "more_info": ""
      },
      "type": "replication_failover"
  }

对于复制分割，当从源共享分割副本共享时，您可以在响应中看到 latest_job 的 running 状态。

"latest_job": {
    "status": "running",
     "status_reason": {
          "code": "",
          "message": "",
         "more_info": ""
    },
    "type": "replication_split"
},

如果正在对文件共享执行任何其他操作 (例如，扩展大小)，那么无法执行复制 failover 或 split 操作。您可以在指示问题的响应中看到 409 错误。请参阅以下示例。

"errors": [
    {
        "code": "share_operation_pending",
          "message": "An operation 'replication_failover' is pending on file share, request to 'replication_split' cannot be accepted.",
          "more_info": "Before sending another request wait for the current operation to complete and try again."
     }
],
"trace": "4634eee2-0a9b-43b7-b35e-8885cc258500"

除去复制关系

您可以通过除去源文件共享与副本文件共享之间的复制关系来结束复制。该操作称为分割文件共享。除去复制关系将创建两个独立的读/写文件共享。它们之间不再同步数据。您可以单独管理每个文件共享，扩展容量和调整 IOPS，并创建更多副本。

您还可以指定如果 failover 操作未成功，那么将拆分源文件共享和副本文件共享。

当对源或副本文件共享执行另一操作 (例如，正在扩展文件共享大小) 时，无法除去复制关系。拆分操作一直处于待处理状态，直到其他操作完成。

除去复制关系时，无法撤销该操作。此外，在删除复制关系之前，副本上的数据不会与源文件自动同步。

在控制台中删除复制关系

要在控制台中删除复制关系：

转至所有文件共享的列表。从 IBM Cloud 控制台，单击导航菜单图标 > 基础架构 > 存储 > 文件存储共享。
单击文件共享或副本文件共享的名称以转至其详细信息页面。
在 文件共享复制关系 部分中，单击 除去复制关系。除去复制关系将创建两个独立文件共享。
在新窗口中，单击 取消链接。在除去复制关系之前，副本上的数据不会自动与源文件共享同步。

文件共享详细信息页面指示没有复制关系。

从 CLI 中除去复制关系

在使用 CLI 之前，您必须先安装 IBM Cloud CLI 以及 VPC CLI 插件。有关更多信息，请参阅 CLI 先决条件。

通过使用 ibmcloud is shares 命令列出区域中的文件共享，从 CLI 中找到您的共享。

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-2a10af45-de9e-4894-8e9e-fd01a25ec529   my-replica-file-share   stable            us-south-1   dp2       101        Default         replica            none                    0                0
r006-74634ace-43bd-4983-a22b-47b1c9662794   my-source-file-share    stable            us-south-2   dp2       101        Default         source             none                    1                1
r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default         none               none                    0                0
r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default         none               none                    0                0

查看要使用 ibmcloud is share 命令修改的文件共享的详细信息。

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)                     1500
IOPS                         2000
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
Latest job                   Job status   Job status reasons
                             succeeded    -

Replication share            ID                                          Name               Resource type
                             r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share   share

Replication role             source
Replication status           active
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

运行 ibmcloud is share-replica-split 命令并按其名称或标识指定副本文件共享。

ibmcloud is share-replica-split r006-6d1719da-f790-45cc-9f68-896fd5673a1a

This will disassociate a replica file share r006-6d1719da-f790-45cc-9f68-896fd5673a1a from its source file share and cannot be undone. Continue [y/N] ?> y
The request to disassociate a replica file share r006-6d1719da-f790-45cc-9f68-896fd5673a1a from its source file share was accepted, under account Test Accouont as user test.user@ibm.com...
OK
Replica File share r006-6d1719da-f790-45cc-9f68-896fd5673a1a is disassociated.

此操作的结果是两个独立的读/写文件共享。在列出区域中的文件共享时，可以在两个文件共享的复制列中看到 none。

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
r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   stable            us-south-1   dp2       1500       Default          replica
r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    stable            us-south-2   dp2       1500       Default          source
r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share        stable            us-south-3   dp2       1500       Default          none
r006-925214bc-ded5-4626-9d8e-bc4e2e579232   my-new-file-share       stable            us-south-2   dp2       500        Default          none
r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default          none
r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default          none

有关命令选项的更多信息，请参阅 ibmcloud is share-replica-split。

除去与 API 的复制关系

发出 DELETE /shares/{replica_id}/source 请求以除去复制关系。拆分文件共享将除去复制关系并创建两个独立的文件共享。除去关系后，无法重新建立关系。如果文件共享的 lifecycle_state 为 updating 或者正在进行副本操作，那么无法拆分文件共享。

curl -X DELETE \
"$vpc_api_endpoint/v1/shares/{replica_share_id}/source?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\

成功的响应指示已接受将副本文件共享与其源文件共享解除关联的请求。

除去与 Terraform 的复制关系

使用 ibm_is_share_replica_operations 资源来分割源共享和副本共享。拆分文件共享将除去复制关系并创建两个独立的文件共享。除去关系后，无法重新建立关系。

resource "ibm_is_share_replica_operations" "test" {
  share_replica = ibm_is_share.replica.id
  split_share = true
}

有关自变量和属性的更多信息，请参阅 ibm_is_share_replica_operations。

删除副本和源文件共享

出于各种原因，您可能想要删除复制的文件共享。其中一个可能的原因是解除对源文件共享删除的限制。由于副本文件共享与源共享处于活动复制中，因此必须先将副本文件共享与源共享拆分，然后才能删除源文件共享。您可以通过以下两种方式拆分股份：

执行手动拆分，这将除去复制关系并创建两个独立的读/写文件共享。然后，您就可以像使用或删除普通文件共享一样使用或删除复制文件共享。
删除副本文件共享的挂载目标后，直接删除副本文件共享。 split 进程在后台自动启动。分割操作完成后，副本文件共享会被删除，源共享也会被删除。

你可以通过控制台、CLI、API 或 Terraform 删除文件共享（源或副本）。