在控制台中创建文件共享

1. 在 IBM Cloud 控制台中，单击导航菜单图标 > 基础架构 > 存储 > 文件存储共享。 将显示文件共享的列表。

2. 在 VPC 的文件存储共享页面上，单击创建。 选择“创建文件共享”。

3. 输入以下信息。

1. 创建 挂载目标 是可选的。 如果您现在不想创建安装目标，那么可以跳过此步骤。 不过，要在计算主机上挂载文件共享，还需要一个文件共享。 文件共享可以有多个挂载目标，这样你就可以从多个 VPC 访问它。 您可以为每个文件共享创建一个安装目标。 要创建它，请单击“创建”。

   必须使用 虚拟网络接口 (VNI) 创建挂载目标。 VNI 会为文件共享提供预留 IP 地址，并应用所选 安全组 的规则。 此安装目标支持传输中加密和跨区域安装。 通过提供以下信息来定义挂载目标：

   1. 提供安装目标名称。 该名称最多可以是 63 个小写字母数字字符，并且包含连字符 (-)，并且必须以小写字母开头。 如果需要，您日后可以编辑该名称。
   2. 选择可用的 VPC。 该列表仅包含在所选位置拥有子网的 VPC。 位置选择是从文件共享继承的（例如 us-south-2 ）。
   3. 生成一个默认虚拟网络接口。 点击“编”图标即可对其进行自定义。 如果该位置有多个子网，您可以更改名称或子网。 您也可以选择一个现有的 VNI 来附加到挂载目标。 显示 VPC 中可用 VNI 的列表和位置。 由于所连接的 VNI 二级 IP 地址不能被接受为文件共享挂载目标，因此会被从列表中过滤掉。
   4. 单击下一步。
   5. 对于区域共享，传输中加密默认处于禁用状态；对于区域共享，传输中加密默认处于启用状态。 单击切换按钮更改预设值。 有关此功能的更多信息，请参阅 在传输中加密-保护文件共享与主机之间的安装连接。
   6. 然后，单击下一步。
   7. 复审您的选择，然后单击 上一步 以返回并更新您的选择，或者单击 创建。

2. 在 “静态加密”部分，所有文件共享默认均由 IBM 管理的密钥进行加密。 若要使用 您自己的加密密钥，请点击切换按钮以启用客户管理的加密功能。 如果您已有 KMS 实例和根密钥，系统会自动为您选中它。 要更改密钥或实例，请单击 “编辑”图标 ，以打开 “配置加密”侧边栏。 请从以下选项中选择一项，以查找您的加密密钥：

   • 按实例定位：该面板包含三个步骤：
     1. 选择 KMS 实例：该列表显示了每个可用 Key Protect 实例的名称、ID、类型（标准型或专用型）以及位置。 选择一个实例，然后单击 “选择”。 如果您还没有实例，请点击 “创建”以配置一个。
     2. 关联密钥：该列表显示了每个可用根密钥的名称、ID、最后更新日期、别名和密钥环。 选择一个键，然后单击 “选择”。 如果您还没有密钥，请点击 “创建新密钥”。
     3. 审核：请确认您的选择，包括密钥管理服务、实例类型、实例名称和密钥名称。 “服务授权”部分显示 File Storage for VPC 与KMS实例之间是否已建立所需的授权关系。 如果不是，您可以允许 Key Protect 自动创建授权，或者手动创建一个。 有关详细信息，请参阅 《 为 File Storage for VPC 设置服务间授权 》。 单击 “确认” 以应用您的选择，并返回文件共享配置页面。
   • 按 CRN 查找：输入用于加密共享的客户根密钥的 CRN。 如果您使用的是其他账户的CRK，请选择此选项。 单击 “选择” 以进入 “按实例定位”选项中所述的 “审核”步骤。

3. 如果您选择了单区域可用性，则“加密”卡片之后会显示 “灾难恢复”部分。 此步骤是可选的。 用于在配置时设置同一区域内的异步复制。 跨区域复制必须在共享资源配置完成且处于稳定状态后，单独进行设置。 有关详细信息，请参阅“为文件共享添加复制”。

   要配置同区域复制，请单击 “异步复制”切换按钮。 复制字段会内联展开。 该副本继承了源共享的配置文件和加密设置。 安装目标必须单独添加。

   填写以下字段：

   1. 区域：地理位置和地区是根据源共享的位置预先填入的，无法更改。 从下拉菜单中选择副本所在的区域。 仅显示适用于复制的区域。
   2. 副本名称：为副本共享输入一个名称。
   3. 最大 IOPS：指定副本共享的最大 IOPS 值。
   4. 频率：选择从源共享向副本同步更改的频率，并配置开始时间：
      • 每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 * * *。

4. 输入所有必需信息后，单击 创建文件共享。 返回到 File Storage for VPC 页面，其中有一条消息指示正在供应文件共享。 事务完成时，共享状态将更改为 活动。

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

准备工作

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

以下示例说明了如何创建带或不带挂载目标和不同访问模式的分区和区域共享。 有关命令选项和语法的更多信息，请参阅《 VPC CLI 参考》：ibmcloud is share-create。

收集创建文件共享所需的信息

在运行 ibmcloud is share-create 命令之前，您可以通过查看有关其他文件共享，安装目标和文件存储器概要文件的信息来收集供应共享所需的信息。

• 使用 ibmcloud is shares 命令列出所有文件共享。
• 使用 ibmcloud is share SHARE 命令列出特定文件共享的详细信息。
• 使用 ibmcloud is share-snapshots SHARE 命令列出特定文件共享的快照。
• 使用 ibmcloud is share-profiles 命令列出区域内的所有文件共享配置文件。 只有 dp2 和 rfs 共享配置文件可用于创建文件共享。
• 使用 ibmcloud is share-mount-targets SHARE 命令列出特定文件共享的所有挂载目标。
• 使用 ibmcloud is subnets 命令列出区域内可用的所有子网。
• 使用 ibmcloud is subnet-reserved-ips 命令列出子网中所有保留的 IP 地址。
• 使用 ibmcloud is security-groups 命令列出所有可用的安全组。

使用 CLI 创建无挂载目标的区域文件共享

您可以使用 ibmcloud is share-create 命令，在所选区域内使用 dp2 配置文件，以特定容量和 IOPS 值配置区域文件共享。 下面的示例显示了如何在 us-south-1 区域创建 IOPS 为 100 的 40GB 文件共享。 此文件共享是使用缺省安全组访问方式和提供者管理的加密创建的。

ibmcloud is share-create --name my-file-share --zone us-south-1 --profile dp2 --size 40 --iops 100 --allowed-access-protocols nfs4 --atem ipsec,none

Creating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-a08c2505-b933-4dce-a771-efff2e1a59e1
Name                               my-file-share
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-a08c2505-b933-4dce-a771-efff2e1a59e1
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   ipsec,none
Zone                               us-south-1
Profile                            dp2
Size(GB)                           40
IOPS                               100
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T20:10:35+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

使用 CLI 创建无挂载目标的区域文件共享

下面的示例显示了如何创建带宽为 1000 Mbps 的 40GB 区域文件共享。 该文件共享使用提供商管理的加密创建。 文件共享将在您登录时选择的区域内创建，无需选择位置。

ibmcloud is share-create --name my-regional-file-share --profile rfs --size 40 --bandwidth 1000 --allowed-access-protocols nfs4 --atem stunnel,none

Creating file share my-regional-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-749d05eb-9779-4414-b902-553a4fd1421d
Name                               my-regional-file-share
CRN                                crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-749d05eb-9779-4414-b902-553a4fd1421d
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   stunnel,none
Zone                               -
Profile                            rfs
Size(GB)                           40
IOPS                               35000
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T20:20:09+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     -
Snapshot size                      -
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  regional
Bandwidth(Mbps)                    1000
Storage Generation                 2

收集创建挂载目标所需的信息

创建安装目标时，必须指定其用于的文件共享。 您可以使用文件共享的名称或标识。 您还必须指定 VPC 及其标识或名称。 VPC 对于每个安装目标都必须是唯一的。 您还必须指定将用于管理对共享的访问权的安全访问组。 与挂载目标相关联的安全组必须允许从要挂载共享的所有服务器通过 NFS 端口对 TCP 协议进行入站访问。

最后，必须为为安装目标创建 虚拟网络接口 所需的选项指定值。 使用相应的 CLI 命令来列出可用的 子网，子网中的保留 IP 地址 和 安全组，以获取所需的信息。

以下示例说明了如何创建具有不同访问模式的挂载目标。 有关命令选项和语法的更多信息，请参阅《 VPC CLI 参考》：ibmcloud is share-mount-target-create。

已绑定辅助 IP 地址的虚拟网络接口不能作为文件共享挂载目标。

创建具有安全组访问模式的挂载目标

以下示例为具有安全组访问方式的文件共享创建具有虚拟网络接口的安装目标。

ibmcloud is share-mount-target-create my-regional-file-share --subnet my-subnet --name my-regional-share-mount-target-1 --vni-name my-share-vni-2  --resource-group-id 6edefe513d934fdd872e78ee6a8e73ef  --access-protocol nfs4 --transit-encryption none --vpc my-vpc

Mounting target for share r006-749d05eb-9779-4414-b902-553a4fd1421d under account Test Account as user test.user@ibm.com...
ID                          r006-bc95a3c2-b84b-4186-8c5a-e3dd220abefa
Name                        my-regional-share-mount-target-1
VPC                         ID                                          Name
                            r006-243394d6-b192-4e05-bfab-5d0b4e77cf81   my-vpc
Access control mode         security_group
Resource type               share_mount_target
Virtual network interface   ID                                          Name             Protocol State Filtering Mode
                            0717-24e7dcac-e30f-43cf-9bee-3cab93692690   my-share-vni-2   auto
Lifecycle state             pending
Mount path                  -
Transit Encryption          none
Created                     2025-09-23T20:45:14+00:00
Access Protocol             nfs4

使用 VPC 访问模式创建挂载目标

已弃用

以下示例为采用已弃用的 VPC 访问模式的区域文件共享创建了一个挂载目标。

vpc 访问模式将于 2027 年 5 月 6 日结束支持。 请按照 迁移指南 将共享的访问控制模式更新为 security-group。

ibmcloud is share-mount-target-create my-vpc-file-share --vpc cli-vpc-3 --name my-vpc-mount-target --access-protocol nfs4 --transit-encryption none

Mounting target for share r006-10e82e16-ff7f-4ca4-b543-d24084fc03cf under account Test Account as user test.user@ibm.com...
ID                        r006-71fd953c-8e49-48e8-ab49-5977c324a365
Name                      my-vpc-mount-target
VPC                       ID                                          Name
                          r006-060fbfe6-4d0f-47b0-b9c5-94da8e719e22   cli-vpc-3
Access control mode       vpc
Resource type             share_mount_target
Virtual network interface
Lifecycle state           pending
Created                   2025-09-23T22:15:15+00:00
Mount path                -
Transit Encryption        none

创建带挂载目标的区域文件共享

下面的示例显示了如何在 us-south-1 区域创建容量为 500 GB、IOPS 为 2000 的区域文件共享。 文件共享使用 env:dev 进行标记，并且具有安全组访问控制方式。 可以使用安装目标 my-new-mount-target 在授权虚拟服务器上安装文件共享。

ibmcloud is share-create --name my-new-file-share --zone us-south-1 --profile dp2 --size 500 --iops 2000 --allowed-transit-encryption-modes ipsec,none --user-tags env:dev --mount-targets '[{"name":"my-new-mount-target","virtual_network_interface": {"name":"my-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]'

Creating file share my-new-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-201487a2-cf35-4b2a-a4fe-f480803e1e80
Name                               my-new-file-share
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-201487a2-cf35-4b2a-a4fe-f480803e1e80
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   ipsec,none
Zone                               us-south-1
Profile                            dp2
Size(GB)                           500
IOPS                               2000
User Tags                          env:dev
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-c8952df9-f479-49a8-a66b-85bf112e0831   my-new-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T21:17:25+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

创建带有挂载目标的区域文件共享

下面的示例展示了如何通过 CLI 创建带有挂载目标的区域文件共享。 请注意，如果命令指定的带宽值较低，系统会自动校正配置，以提供至少 800 Mbps 的带宽。

ibmcloud is share-create --name my-regional-file-share --profile rfs --size 5000 --bandwidth 800 --allowed-access-protocols nfs4 --atem stunnel --mount-targets '[{"name":"my-new-mount-target","virtual_network_interface": {"name":"my-regional-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]'

Creating file share my-regional-file-share under account under account Test Account as user test.user@ibm.com...
ID                                 r006-770ff2f9-3211-459d-918b-fbf0b4a4f999
Name                               my-regional-file-share
CRN                                crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-770ff2f9-3211-459d-918b-fbf0b4a4f999
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   stunnel
Zone                               -
Profile                            rfs
Size(GB)                           5000
IOPS                               35000
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-f7c84cb2-0e82-4f9e-b729-6e51ea437df6   my-new-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T21:27:07+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     -
Snapshot size                      -
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  regional
Bandwidth(Mbps)                    800
Storage Generation                 2

准备工作

设置您的 API 环境。 定义 IAM 令牌、API 端点和 API 版本的变量。 有关指示信息，请参阅设置 API 和 CLI 环境。

必须提供 generation 参数并指定 generation=2。 如需了解更多信息，请参阅《 虚拟私有云 API 参考指南 》中的 “生成”部分。

要了解有关 API 的更多信息，一个好办法是在 IBM Cloud 控制台中的供应页面上单击获取样本 API 调用。 您可以查看正确的 API 请求序列，并更好地了解操作及其依赖项。

使用应用程序接口收集所需信息

在发出 POST /shares 请求之前，请使用以下 API 方法收集调配共享所需的信息。

• 列出文件共享GET /shares 在一个地区。
• 通过 GET /shares/{id} 检索文件共享，查看其详细信息。
• 通过 GET /shares/{share_id}/snapshots 列出文件共享快照，以列出特定文件共享的快照。
• 通过 GET /share/profiles 列出文件共享配置文件，查看某一区域的可用文件共享配置文件。 只有 dp2 和 rfs 可用于创建文件共享。
• 通过 GET /shares/{share_id}/mount_targets 列出文件共享的挂载目标，查看文件共享的现有挂载目标、
• 通过 GET /subnets 列出子网，查看区域内可用的子网。
• 使用 GET /subnets/{subnet_id}/reserved_ips列出子网中的保留 IP 地址。
• 通过 GET /security_groups列出安全组.

使用应用程序接口创建分区文件共享

发出 POST /shares 请求以创建文件共享。 指定文件共享，名称，IOPS 概要文件和区域的大小。 如果希望创建具有细粒度访问授权的文件共享，请指定 "security_group 为访问模式。 具有安全组访问模式的共享也可配置为支持传输中加密、跨区挂载、快照和备份。 请参阅以下示例。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
    "access_control_mode": "security-group",
    "allowed_transit_encryption_modes": ["none","ipsec"],
    "size": 4800,
    "iops": 3000,
    "name": "myshare-1",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-1"}
}

确保在创建挂载目标时，还指定了一个虚拟网络接口，该接口是虚拟服务器实例所属安全组的成员。

使用应用程序接口创建区域文件共享

下面的示例显示了如何创建 1000GB 带宽为 8000 Mbps 的区域文件共享。 此文件共享是使用缺省安全组访问方式和提供者管理的加密创建的。 文件共享将在您登录时选择的区域内创建，无需选择位置。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
  "name": "my-regional-share-1",
  "mount_targets": [],
  "profile": {"name": "rfs"},
  "size": 1000,
  "bandwidth": 8000,
  "allowed_transit_encryption_modes": ["none","stunnel"],
  "resource_group": {"id": "db8e8d865a83e0aae03f25a492c5b39e"},
  "access_control_mode": "security_group"
}'

通过指定子网和安全组将安装目标添加到现有文件共享

发出 POST /shares/{share_id}/mount_targets 请求并指定安装目标网络接口的子网和安全组。 与挂载目标相关联的安全组必须允许从要挂载共享的所有服务器通过 NFS 端口对 TCP 协议进行入站访问。

此示例为现有分区文件共享添加了一个挂载目标，该目标由 ID 标识，并提供了一个子网和安全组来定义网络接口。 已启用传输中加密。

 curl -X POST "$vpc_api_endpoint/v1/shares/r006-201487a2-cf35-4b2a-a4fe-f480803e1e80/mount_targets/?version=2023-07-18&generation=2"\
 -d '{
     "virtual_network_interface": {
        "subnet": {"id": "1a0b3d75-8a62-4c78-9263-f9bcd25a8759"},
        "security_groups": [{"id": "b2599112-7027-480e-ad1b-fd917d2fcb84"}]
     },
     "transit_encryption": "ipsec"
}'

下面的示例显示了如何向区域文件共享添加挂载目标。 要为区域文件共享目标启用传输中加密，请指定 "stunnel"。

 curl -X POST "$vpc_api_endpoint/v1/shares/r006-ee1f6fc0-6fa3-4821-ad70-f6589e30c566/mount_targets/?version=2025-09-23&generation=2"\
 -d '{
     "virtual_network_interface": {
        "subnet": {"id": "1a0b3d75-8a62-4c78-9263-f9bcd25a8759"},
        "security_groups": [{"id": "b2599112-7027-480e-ad1b-fd917d2fcb84"}]
     },
     "transit_encryption": "stunnel"
}'

使用 VPC 访问模式将挂载目标添加到现有文件共享中

已弃用

此请求可为现有文件共享添加挂载目标。 在此示例中，指定了 vpc 值，因为文件共享的访问控制模式为 vpc。 无法启用传输中的数据加密。

curl -X POST "$vpc_api_endpoint/v1/shares/$share_id/mount_targets?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-H 'Content-Type: application/json'\
-d '{
    "access_control_mode": "vpc"
    "name": "mount-target-name1",
    "vpc": {"id": "6e01bc24-4a6e-4a0c-a1bd-4caa0c8159e7"},
    "transit_encryption": "none"
  }'

成功的响应如下例所示。

{
  "access_control_mode": "vpc",
  "created_at": "2023-08-08T23:31:59Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/ff859972-8c39-4528-91df-eb9160eae918/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "lifecycle_state": "pending",
  "mount_path": "domain.com:/vol_xyz_2891fd0a_63aa_4deb_9ed5_1159e37cb5aa",
  "name": "mount-target-name1",
  "resource_type": "share_target",
  "transit_encryption": "none",
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/e6ff7b61-feb4-4c87-94aa-277d6f93e164",
    "id": "e6ff7b61-feb4-4c87-94aa-277d6f93e164",
    "name": "vpc-name1",
    "resource_type": "vpc"
  }
}

通过指定子网来创建文件共享和安装目标

文件共享的缺省访问控制方式为 security_group。 要在创建文件共享的同时使用网络接口创建挂载目标，请发出 "POST /shares 请求并指定子网。 如果不指定 虚拟网络接口，则需要指定 "subnet 属性。

下面的示例创建了一个 虚拟网络接口，并将其附加到挂载目标上，同时保留了一个 IP 地址，并应用了所选安全组的规则。 与挂载目标相关联的安全组必须允许从要挂载共享的所有服务器通过 NFS 端口对 TCP 协议进行入站访问。

在此示例中，安装目标部分指定子网标识。 创建安装目标时，系统将从该子网中为 虚拟网络接口 选择保留 IP。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "allowed_transit_encryption_modes": ["ipsec"],
    "size": 10,
    "name": "my-share-1",
    "profile": {"name": "dp2"},
     "zone": {"name": "us-south-1"},
     "mount_targets": [{
         "virtual_network_interface": {"subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"}},
         "transit_encryption": "ipsec"}]
}'

当 transit_encryption 属性设置为 ipsec 时，将使用实例身份证书启用传输中的加密。 transit_encryption 属性的默认值为 "none，即在传输过程中禁用加密。 但是，如果 allowed_transit_encryption_modes 被指定为 ipsec，则必须使用 ipsec 作为 transit_encryption 值创建挂载目标。

成功的响应如下例所示。

 {
    "access_control_mode": "security_group",
    "allowed_transit_encryption_modes": ["ipsec"],
    "created_at": "2023-09-23T12:15:12Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/90c4bb62-1724-47bd-8c45-f7d37d7c3508/mount_targets/7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "id": "7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "lifecycle_state": "pending",
    "mount_path": "",
    "name": "myshare-1",
    "primary_ip": {"address": ""},
    "resource_type": "share_target",
    "size": 10,
    "snapshot_count": 0,
    "snapshot_size": 0,
    "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "name": "subnet-2",
        "resource_type": "subnet"
    },
    "transit_encryption": "ipsec",
    "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interface/710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "id": "710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "name": "enlace-traverse-oat-console",
        "resource_type": "VirtualNetworkInterface"
    },
    "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "id": "82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "name": "my-vpc-2",
        "resource_type": "vpc"
    },
    "user_tags": []
}

下面的示例显示了如何向区域文件共享添加挂载目标。 要为区域文件共享目标启用传输中加密，请指定 "stunnel"。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "allowed_transit_encryption_modes": ["stunnel","none"],
    "size": 5000,
    "name": "my-regional-share-1",
    "profile": {"name": "rfs"},
     "mount_targets": [{
         "virtual_network_interface": {"subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"}},
         "transit_encryption": "stunnel"}]
}'

当 transit_encryption 属性设置为 stunnel 时，将启用传输中加密，您必须在计算主机上完成几个配置步骤，才能安全挂载文件共享。 在示例中，allowed_transit_encryption_modes 被指定为 stunnel,none，那么挂载目标的 transit_encryption 值可以是这两个值中的任意一个。

成功的响应如下例所示。

 {
    "access_control_mode": "security_group",
    "accessor_binding_role": "none",
    "allowed_access_protocols": ["nfs4"],
    "allowed_transit_encryption_modes": ["stunnel"],
    "availability_mode": "regional",
    "access_control_mode": "security_group",
    "bandwidth": 2000,
    "created_at": "2025-09-23T12:15:12Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/90c4bb62-1724-47bd-8c45-f7d37d7c3508/mount_targets/7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "id": "7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "lifecycle_state": "pending",
    "mount_path": "",
    "name": "my-regional-share-1",
    "primary_ip": {"address": ""},
    "resource_type": "share_target",
    "size": 5000,
    "snapshot_count": 0,
    "snapshot_size": 0,
    "storage_generation": 2,
    "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "name": "subnet-2",
        "resource_type": "subnet"
    },
    "transit_encryption": "stunnel",
    "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interface/710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "id": "710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "name": "enlace-traverse-oat-console",
        "resource_type": "VirtualNetworkInterface"
    },
    "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "id": "82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "name": "my-vpc-2",
        "resource_type": "vpc"
    },
    "user_tags": []
}

通过指定子网和安全组来创建文件共享和安装目标

要创建安装目标网络接口，请发出 POST /shares 请求并指定子网和安全组。 与挂载目标相关联的安全组必须允许从要挂载共享的所有服务器通过 NFS 端口对 TCP 协议进行入站访问。

在下面的示例中，mount_targets 属性指定了子网 ID 和安全组 ID。 当 transit_encryption 属性设置为 ipsec 时，它将通过使用实例身份证书来启用传输中的加密。 此选项仅适用于区域文件共享。 区域文件共享使用 stunnel 进行传输中加密。 缺省值为 none，这将禁用传输中的加密。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
    "size": 20,
    "iops": 100,
    "name": "myshare-3",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-1"},
    "allowed_transit_encryption_modes": ["ipsec"],
    "mount_targets": [{
        "virtual_network_interface": {
            "subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"},
            "security_groups": [{"id": "34c09abb-37bf-4ef6-88bb-f63a0ef28915"}]
        },
        "transit_encryption": "ipsec"
      }]
    }'

下面的示例显示了成功的 API 响应。

{
    "access_control_mode": "security_group",
    "allowed_transit_encryption_modes": ["ipsec"],
    "created_at": "2025-09-23T12:55:40Z",
    "crn": "crn:[...]",
    "encryption": "provider_managed",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-56f91d4a-2801-470a-b368-176bde64e954",
    "id": "r006-56f91d4a-2801-470a-b368-176bde64e954",
    "initial_owner": {
        "gid": 0,
        "uid": 0
    },
    "iops": 100,
    "lifecycle_state": "pending",
    "name": "myshare-3",
    "mount_targets": [
        {
            "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-56f91d4a-2801-470a-b368-176bde64e954/mount_targets/r006-b8573e2c-60ee-4ecc-9eae-c52f890a8195",
            "id": "r006-b8573e2c-60ee-4ecc-9eae-c52f890a8195",
            "name": "sticky-idealist-spoiled-sloppily",
            "resource_type": "share_target",
            "transit_encryption": "ipsec"
        }
    ],
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
        "name": "dp2",
        "resource_type": "share_profile"
    },
    "replication_role": "none",
    "replication_status": "none",
    "replication_status_reasons": [],
    "resource_group": {
        "crn": "crn:[...]",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups//678523bcbe2b4eada913d32640909956",
        "id": "678523bcbe2b4eada913d32640909956",
        "name": "Default"
    },
    "resource_type": "share",
    "size": 20,
    "snapshot_count": 10,
    "snapshot_size": 10,
    "user_tags": [],
    "zone": {
        "href": "https://us-south.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
}

通过指定虚拟网络接口来创建文件共享和安装目标

要执行此操作，您必须已经拥有一个 虚拟网络接口，且该虚拟网络接口不得连接到其他资源。 已分配二级 IP 地址的虚拟网络接口不能作为文件共享挂载目标。

发出 POST /shares 请求并使用虚拟网络接口创建安装目标。 在挂载目标的 "virtual_network_interface 属性中指定未连接虚拟网络接口的 ID。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
    "size": 10,
    "name": "my-share-sc-2",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-3"},
    "allowed_transit_encryption_modes": ["none"],
    "mount_targets": [{
        "name": "mount-target-1",
        "transit_encryption": "none",
        "virtual_network_interface": {"id": "0767-fa41aecb-4f21-423d-8082-630bfba1e1d9"}
      }]
    }'

使用 Terraform 创建区域文件共享

要创建文件共享，请使用 ibm_is_share 资源。 下面的示例创建了一个具有分区可用性、200 GB 容量、500 IOPS 和 dp2 性能配置文件的共享。

resource "ibm_is_share" "zonalexample" {
  allowed_transit_encryption_modes = ["ipsec", "none"]
  name                             = "my-new-share"
  size                             = "200"
  iops                             = "500"
  profile                          = "dp2"
  zone                             = "us-south-2"
}

使用 Terraform 创建区域文件共享

下面的示例创建了一个具有区域可用性、200 GB 容量、800 Mbps 带宽和 rfs 性能配置文件的共享。

resource "ibm_is_share" "regionalexample" {
  access_control_mode              = "security_group"
  allowed_transit_encryption_modes = ["stunnel", "none"]
  bandwidth                        = "800"
  name                             = "my-share"
  profile                          = "rfs"
  size                             = "200"
}

使用 Terraform 创建带副本的区域文件共享

要创建文件共享，请使用 ibm_is_share 资源。 要添加副本，请定义与以下示例类似的副本共享。 它将创建具有 220 GB 容量的共享和 dp2 性能概要文件。 replica_share 参数定义副本共享的名称，复制频率 (在 cron 规范中)，性能概要文件以及要在其中创建副本共享的区域。

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

使用安全组访问方式创建与安装目标的文件共享

要与允许在 VPC 中进行基于安全组的认证的安装目标创建文件共享，请使用 ibm_is_share 资源。 将访问控制方式指定为 security_group，并通过为其提供名称，虚拟网络接口的详细信息 (例如，名称，子网或 IP 地址) 来定义安装目标。 此外，指定要用于控制对文件共享的访问权的安全组。 与挂载目标相关联的安全组必须允许从要挂载共享的所有服务器通过 NFS 端口对 TCP 协议进行入站访问。

resource "ibm_is_share" "share4" {
   access_control_mode              = "security_group"
   allowed_transit_encryption_modes = "ipsec"
   iops                             = "3000"
   name                             = "my-share4"
   profile                          = "dp2"
   size                             = "800"
   zone                             = "us-south-2"
   mount_target {
       access_protocol              = "nfs4"
       name                         = "my-mount-target"
       resource_group               = <resource_group_id>
       security_groups.             = [<security_group_ids>]
       transit_encryption           = "ipsec"
       virtual_network_interface {
          primary_ip {
              address               = "10.240.64.5"
              auto_delete           = true
              name                  = "my-example-pip"
          }
       }
   }
}

上例为区域文件共享启用了传输中加密。 如果要使用 Reginal 共享的传输加密来保护数据，请将 transit_encryption 参数指定为 stunnel。

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

使用 VPC 范围的访问方式创建与安装目标的文件共享

[已]废弃{: tag-deprecated} VPC 访问控制模式已废弃。 选择安全组选项。

要创建一个区域文件共享，并使 VPC 中的所有虚拟服务器实例都能访问该文件共享的挂载目标，请使用 ibm_is_share 资源。 将访问控制方式指定为 vpc，并通过为其提供名称以及要在其中使用该方式的 VPC 来定义安装目标。

resource "ibm_is_share" "share3" {
    access_control_mode   = "vpc"
    iops                  = "800"
    name                  = "my-share3"
    profile               = "dp2"
    size                  = "700"
    zone                  = "us-south-2"
    mount_target {
          access_protocol = "nfs4"
          name            = "my-mount-target"
          vpc             = <vpc_id>
    }
}

此类型的文件共享不支持跨区域安装和传输中的加密。