File Storage for VPC 概要文件

在控制台中查看配置文件

在控制台中创建文件共享 时，可以在预案部分的表中看到可用的预案。

通过 CLI 查看配置文件

要从 CLI 查看可用配置文件列表，请运行 ibmcloud is share-profiles 命令。 选择可用性 拥有预览新区域文件共享产品特殊访问权限的客户，也可以在列出共享配置文件时看到 rfs 配置文件。

ibmcloud is share-profiles

Listing file share profiles in region us-south under account Test Account as user test.user@ibm.com...
Name   Family                Allowed Access Protocols   Allowed transit encryption modes   Availability Modes   Bandwidth(Mbps)
dp2    defined_performance   nfs4                       none,ipsec                         zonal                -
rfs    defined_performance   nfs4                       none,stunnel                       regional             1

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

要查看共享配置文件的详细信息，请使用 ibmcloud is share-profile 命令并指定配置文件的名称。 请参阅以下示例。

ibmcloud is share-profile dp2

Getting file share profile dp2 under account Test Account as user test.user@ibm.com...

Name                               dp2
Family                             defined_performance
IOPS                               Default   Max     Min   Step   Type
                                   100       96000   100   1      range

Capacity                           Default   Max     Min   Step   Type
                                   10        32000   10    1      range

Bandwidth(Mbps)                    Default   Max   Min   Step   Type
                                   -         -     -     -      dependent

Availability Modes                 Default   Type    Value   Values
                                   -         fixed   zonal   -

Allowed Access Protocols           Default   Type     Values
                                   nfs4      subset   nfs4

Allowed transit encryption modes   Default   Type     Values
                                   none      subset   none,ipsec    

ibmcloud is share-profile rfs

Getting file share profile rfs in region us-south under account Test Account as user test.user@ibm.com...
Name                               rfs   
Family                             defined_performance   
IOPS                               Default   Max   Min   Step   Type      
                                   -         -     -     -      fixed      

Capacity                           Default   Max     Min   Step   Type      
                                   1         32000   1     1      range      

Bandwidth(Mbps)                    Default   Max    Min   Step   Type      
                                   1         1024   1     1      range      

Availability Modes                 Default   Type    Value      Values      
                                   -         fixed   regional   -      

Allowed Access Protocols           Default   Type     Values      
                                   nfs4      subset   nfs4      

Allowed transit encryption modes   Default   Type     Values      
                                   stunnel   subset   none,stunnel      

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

使用应用程序接口查看个人资料

使用 GET /share/profiles 请求检索有关一般可用文件共享配置文件的信息。

curl -X GET $vpc_api_endpoint/v1/share/profiles?$api_version&generation=2\
-H "Authorization: $iam_token"

选择可用性 拥有预览新区域文件共享产品特殊访问权限的客户可通过以下 API 请求列出新配置文件：

响应类似于以下示例。

{
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles?limit=50"
  },
  "limit": 50,
  "profiles": [
    {    
    "allowed_access_protocols": {
      "default": [
        "nfs4"
      ],
      "type": "subset",
      "values": [
        "nfs4"
      ]
    },
    "allowed_transit_encryption_modes": {
      "default": [
        "none",
        "stunnel"
      ],
      "type": "subset",
      "values": [
        "none",
        "stunnel"
      ]
    },
    "availability_modes": {
      "type": "fixed",
      "value": "zonal"
    },
    "bandwidth": {
      "type": "fixed",
      "value": 100
    },
    "capacity": {
      "max": 32000,
      "min": 10,
      "step": 1,
      "type": "dependent_range"
    },
    "family": "defined_performance",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
    "iops": {
      "max": 96000,
      "min": 100,
      "step": 1,
      "type": "dependent_range"
    },
    "name": "dp2",
    "resource_type": "share_profile"
},
    {
      "allowed_access_protocols": {
        "default": [
          "nfs4"
        ],
        "type": "subset",
        "values": [
          "nfs4"
        ]
      },
      "allowed_transit_encryption_modes": {
        "default": [
          "none"
        ],
        "type": "subset",
        "values": [
          "none"
        ]
      },
      "availability_modes": {
        "type": "fixed",
        "value": "regional"
      },
      "bandwidth": {
        "max": 8192,
        "min": 1,
        "step": 1,
        "type": "dependent_range"
      },
      "capacity": {
        "max": 32000,
        "min": 10,
        "step": 1,
        "type": "dependent_range"
      },
      "family": "defined_performance",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/rfs",
      "iops": {
        "type": "dependent"
      },
      "name": "rfs",
      "resource_type": "share_profile"
    }
  ],
  "total_count": 2
}

2025-09-16 版本的 API 经过增强，包含以下字段：

• allowed_access_protocols 表示文件共享允许使用哪种访问协议。 当前默认值为 nsf4。
• availability_modes 表示数据可用性。
  • dp2 配置文件支持分区数据可用性。
  • rfs 配置文件支持区域数据的可用性。
• bandwidth 表示文件共享可处理的可用最大带宽值。
  • 对于 dp2 配置文件，带宽是通过 IOPS 数乘以 256 KB 计算得出的。
  • 对于 rfs 配置文件，预设值按每 20 GB 容量 8 Mbps 计算。 不过，您可以将此值提高到 8192 Mbps。
• storage_generation 表示文件共享配置文件在已定义性能配置文件系列中的生成。
  • dp2 配置文件的值为 1。
  • rfs 配置文件的值为 2。

使用 Terraform 查看概要文件

1. 要使用 Terraform，请下载 Terraform CLI 并配置 IBM Cloud® 提供程序插件。 有关更多信息，请参阅 Terraform 入门。

2. VPC 基础架构服务使用特定区域端点，缺省情况下该端点以 us-south 为目标。 如果 VPC 是在另一个区域中创建的，请确保将 provider.tf 文件中的提供程序块中的相应区域作为目标。 请参阅以下以非缺省 us-south 区域为目标的示例。

   provider "ibm" {
      region = "eu-de"
   }
   

3. 将可用卷概要文件的列表作为只读数据源导入。

   data "ibm_is_share_profiles" "example" {
   }
   

   有关更多信息，请参阅 ibm_is_share_profiles。