创建副本文件共享

使用控制台、命令行界面 (CLI)、API 或 Terraform，在同一大都市区域内的另一个区域中，或在同一地理区域内的另一个大都市区域中，创建副本文件共享。

下表显示了哪些大城市区域可以在每个地理区域内相互复制。

下表显示了在每个地理区域中可以相互复制的都会区。 每个地理位置都是一个单独的列。
美洲 欧洲 亚洲
  • 德克萨斯州达拉斯 / us-south
  • 蒙特利尔 / ca-mon
  • 圣保罗 / br-sao
  • 多伦多 / ca-tor
  • 华盛顿特区 / us-east
 -法兰克福/ eu-de
-伦敦/ eu-gb
-马德里/ eu-es
  • 钦奈 / in-che
  • 孟买 / in-mum
  • 大阪 / jp-osa
  • 悉尼 / au-syd
  • 东京 / jp-tok

指定的源文件共享不得已具有另一个副本，并且不得是另一个共享的副本。

如果要在另一个区域中创建副本，那么需要首先建立服务到服务授权。 两个文件服务实例必须属于同一帐户。 不支持跨帐户复制。 更多信息，请参阅 为 File Storage for VPC 建立服务对服务授权。

当您创建具有区域可用性的文件共享时，数据会自动在整个区域内进行复制，因此您无需在区域内设置复制对。

在控制台中为文件共享添加复制功能

您可以从所有文件共享的列表或文件共享详细信息页面创建文件共享的副本。 如果还没有源文件共享，请按照在 控制台中创建文件共享和挂载目标 中的说明提供一个。 当文件共享在 VPC 的文件存储共享页面上显示为“稳定”时，单击操作图标操作图标，然后单击创建副本。

在“文件共享副本创建”页面上，查看源文件共享详细信息，并完成副本详细信息。

  1. 名称-为副本共享提供唯一名称。

  2. 副本位置-地理位置已预先选择，无法更改。 使用 “区域”菜单选择副本所属的区域。 菜单按地理区域分类。 在每个地区下，大都市区按字母顺序排列。 点击地铁站名旁边的箭头以展开其分区，然后点击某个分区进行选择。

  3. 资源组-从列表中选择资源组。

  4. 标记-(可选) 指定 用户标记。 应用于副本的标记可以与源共享的标记相同或不同。

  5. 概要文件-已预先选择 dp2 概要文件，即使源文件共享基于先前发行版中的概要文件也是如此。 指定 IOPS 的最大值。 它确定您在 执行故障转移 后在副本上获得的性能。

  6. 安装目标-(可选) 为副本共享创建安装目标。 如果您现在不想创建安装目标，那么可以跳过此步骤。 否则，请点击 “创建”。 您可以为每个文件共享创建一个安装目标。 根据共享的 安装目标访问方式，创建安装目标 表单看起来不同。

    • 如果您选择安全组作为访问模式，请按照表2中的说明输入信息。 此操作将创建 虚拟网络接口 并将其连接到安装目标，以标识具有保留 IP 地址的文件共享并应用所选安全组的规则。 此安装目标支持传输中加密和跨区域安装。
    用于创建挂载目标的值。
    字段 值
    详细信息
    安装目标名称 指定安装目标名称。 该名称最多可以是 63 个小写字母数字字符，并且包含连字符 (-)，并且必须以小写字母开头。 如果需要，您日后可以编辑该名称。
    区域 区域继承自文件共享 (例如，达拉斯 2)。
    VPC 选择可用的 VPC。 该列表仅包含在所选区域内拥有子网的 VPC。
    Subnet 从列表中选择一个子网。
    预留 IP 地址 对于安装目标是必需的。 之后无法更改 IP 地址。 但是，您可以删除安装目标并创建另一个具有不同 IP 地址的目标。
    预留方法 您可以让文件服务为您选择 IP 地址。 创建安装目标后，保留的 IP 将变为可视。 或者，指定您自己的 IP。
    自动释放 删除安装目标时释放 IP 地址。 缺省情况下，会启用此设置。
    安全组 已选择 VPC 的 缺省安全组。 您可以使用该安全组，也可以从列表中选择其他安全组。
    • 已废弃 如果选择 VPC 作为访问模式，请提供挂载目标的名称，并从列表中选择一个 VPC。 此安装目标可用于在与文件共享相同的区域中所选 VPC 的任何虚拟服务器实例上安装文件共享。 不支持跨区域安装。

    VPC 访问模式已弃用，并将于 2027 年 5 月 6 日停止支持。 按照 迁移指南 将源共享的访问控制模式更新为 security-group。

  7. 同步频率-指定要将更改从主文件共享同步到副本共享的频率。 在 “频率”中，请选择以下选项之一并配置开始时间：

    • 每15分钟：输入开始时间的分钟值。
    • 按小时：输入开始时间的分钟值。
    • 每日：请以协调世界时（UTC）格式（HH:MM）输入开始时间，时间范围为00:00至23:59。
    • 每周：选择复制任务运行的具体星期几（可选一天或多天），并以 HH:MM 格式输入 UTC 时间，时间范围为 00:00 至 23:59。
    • 每月：输入复制任务运行的日期（1 - 31），并以 HH:MM 格式输入 UTC 时间，时间范围为 00:00 至 23:59。
    • Cron表达式：请以 minute hour day month weekday 的格式输入 cron-spec 表达式。 复制操作的计划间隔不得少于15分钟。 例如，若要每天 UTC 时间下午 5:30 进行复制，请输入 30 17 * * *。

  8. 加密 - 副本始终继承源共享的加密设置。 无法更改加密类型。 如果源共享使用的是提供商管理的加密，则会显示“提供商管理”选项卡，但无法选中该选项卡。 如果源共享使用的是客户管理的加密，则密钥详细信息将显示为只读，包括加密类型、密钥名称、密钥管理服务实例和密钥 ID。

  9. 在侧面板中，查看估算成本，并应用折扣代码 (如果有)。

  10. 单击“创建文件共享”。

如果您尚未准备好订购或仅查找定价信息，那么可以将在侧面板中看到的信息添加到估算中。 有关该功能如何工作的更多信息，请参阅 估算成本。

从 CLI 将复制添加到文件共享

您可以使用 CLI 在其他区域或地区创建一个包含副本共享的文件共享，也可以为现有的文件共享创建一个副本共享。

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

从 CLI 创建与副本的文件共享

您可以同时创建一个区域性文件共享及其位于同一区域的副本。 此方法仅支持其副本位于同一区域内的分区共享。 跨区域副本必须在单独的步骤中创建，因为在初始化副本时，源共享必须处于稳定状态。

使用 "ibmcloud is share-create 命令创建共享时，可通过指定选项 "--replica-share-name、"--replica-share-profile、"--replica-share-cron-spec"、--replica-share-zone 的值，同时创建副本共享。cron-spec 指定复制频率，您可以安排每 15 分钟复制一次数据。 有关命令选项的更多信息，请参阅 "ibmcloud is share-create。

在以下示例中，将在 us-south-2 中使用 us-south-1 中的副本文件共享 my-replica-file-share 创建共享 my-source-file-share。 在此示例中，只为源文件共享创建了一个挂载目标。 您还可以使用相同的 JSON 语法和 --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

从 CLI 为现有文件共享创建副本

您可以为现有文件共享在同一区域或同一地理区域内的另一个区域中创建一个副本。

  1. 通过使用 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-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. 通过 ibmcloud is share 命令查看要用作源的文件共享的详细信息。 在同一区域中创建副本时，可以使用共享的名称或标识。 如果在另一个区域中创建副本，请记下源文件共享的 CRN。

    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. 在目标区域运行 ibmcloud is share-replica-create 命令，创建副本共享。 如果目标区域不正确，请使用 ibmcloud target -r REGION 命令切换目标区域。 使用 --source-share-id 选项，按 ID 或 CRN 指定源共享。 提供值以定义将要创建副本文件共享的区域以及副本共享的配置文件。 使用 --replication-cron-spec 选项，用 cron 表达式指定复制时间表。 如果源文件共享有 user_managed 加密，则必须提供 --encryption-key-crn。 --encryption-key-crn 属性不得另行指定。

    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

使用 API 将复制添加到文件共享

您可以通过在 VPC API 中调用 /shares 方法来以编程方式设置复制，如以下样本请求中所示。

开始之前，请先设置 API 环境。 有关文件共享 VPC API 的更多信息，请参阅 VPC API 参考。

使用 API 创建与副本的文件共享

您可以同时创建一个区域性文件共享及其位于同一区域的副本。 此方法仅支持其副本位于同一区域内的分区共享。 跨区域副本必须在单独的步骤中创建，因为在初始化副本时，源共享必须处于稳定状态。

创建文件共享时，可以指定还在其他区域中创建副本文件共享。 发出 POST /shares 请求并指定 replica_share 属性以定义副本文件共享。

以下示例为源共享 source-share-001 创建副本 test-replica-001。 为副本文件共享和源文件共享指定了安装目标 (在创建文件共享时是可选的)。

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"]
   }'

使用 API 为现有文件共享创建副本

若要为现有的文件共享添加复制功能，您需要在另一个区域中创建一个复制共享。 在 POST /shares 请求中，指定副本共享的名称和概要文件，并按其名称，标识或 CRN 指定 source_share。 其他必需属性包括提供复制调度的 zone 和 replication_cron_spec。 您可以安排每 15 分钟复制一次数据。

使用 Terraform 将复制添加到文件共享

您可以使用 Terraform 中的 ibm_is_share 资源来创建具有复制的文件共享，或者更新文件共享以包含复制。

以下示例在 us-south-3 区域中创建一个副本共享，并将其关联到由 ID 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 * * *"
}

以下示例在 us-south-1 中使用 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"
  }
}

后续步骤