Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

CreateFileSystem

创建新的空文件系统。该操作在 Amazon EFS 用于确保幂等创建的请求中需要一个创建令牌（使用相同的创建令牌调用该操作没有效果）。如果当前不存在由 Amazon Web Services 账户 具有指定创建令牌的调用者拥有的文件系统，则此操作将执行以下操作：

否则，此操作将返回 FileSystemAlreadyExists 错误，其中包含现有文件系统的 ID。

幂等操作允许您重试 CreateFileSystem 调用，而不会有创建额外文件系统的风险。当初始调用以某种方式失败时，可能会发生这种情况，使其无法确定是否已实际创建文件系统。例如，可能发生了传输级别超时或重置了连接。只要使用相同的创建令牌，如果初始调用已成功创建文件系统，则客户端可以从 FileSystemAlreadyExists 错误中了解文件系统的存在。

有关更多信息，请参阅《Amazon EFS 用户指南》中的创建文件系统。

此操作接受为文件系统选择的可选 PerformanceMode 参数。我们建议对所有文件系统使用 generalPurpose PerformanceMode。maxIO 模式是上一代性能类型，专为高度并行化的工作负载而设计，可以比 generalPurpose 模式容忍更高的延迟。单区文件系统或使用弹性吞吐量的文件系统不支持 MaxIO 模式。

创建文件系统后，将无法更改 PerformanceMode。有关更多信息，请参阅 Amazon EFS 性能模式。

可以使用 ThroughputMode 参数设置文件系统的吞吐量模式。

在完全创建文件系统之后，Amazon EFS 将其生命周期状态设置为 available，此时您可以在 VPC 中为文件系统创建一个或多个挂载目标。有关更多信息，请参阅 CreateMountTarget。您可以使用挂载目标将 Amazon EFS 文件系统挂载到您的 VPC 中的 EC2 实例上。有关更多信息，请参阅 Amazon EFS：工作原理。

此操作需要 elasticfilesystem:CreateFileSystem 操作的权限。

可以在创建时对文件系统进行标记。如果在创建操作中指定了标签，则 IAM 会对 elasticfilesystem:TagResource 操作执行额外的授权，以验证用户是否具备创建标签的权限。因此，您必须授予使用 elasticfilesystem:TagResource 操作的显式权限。有关更多信息，请参阅在创建过程中授予标记资源的权限。

请求语法

POST /2015-02-01/file-systems HTTP/1.1
Content-type: application/json

{
   "AvailabilityZoneName": "string",
   "Backup": boolean,
   "CreationToken": "string",
   "Encrypted": boolean,
   "KmsKeyId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}

URI 请求参数

该请求不使用任何 URI 参数。

请求正文

请求接受采用 JSON 格式的以下数据。

响应语法

HTTP/1.1 201
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "CreationTime": number,
   "CreationToken": "string",
   "Encrypted": boolean,
   "FileSystemArn": "string",
   "FileSystemId": "string",
   "FileSystemProtection": { 
      "ReplicationOverwriteProtection": "string"
   },
   "KmsKeyId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "NumberOfMountTargets": number,
   "OwnerId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "SizeInBytes": { 
      "Timestamp": number,
      "Value": number,
      "ValueInArchive": number,
      "ValueInIA": number,
      "ValueInStandard": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 201 响应。

服务以 JSON 格式返回的以下数据。

错误

示例

创建加密 EFS 文件系统

以下示例发送 POST 请求，要求在启用自动备份的 us-west-2 区域中创建文件系统。该请求指定 myFileSystem1 为幂等性的创建令牌。

示例请求

POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42

{
  "CreationToken" : "myFileSystem1",
  "PerformanceMode" : "generalPurpose",
  "Backup": true,
  "Encrypted": true,
  "Tags":[
      {
         "Key": "Name",
         "Value": "Test Group1"
      }
   ]
}

示例响应

HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319

{
   "ownerId":"251839141158",
   "CreationToken":"myFileSystem1",
   "Encrypted": true,
   "PerformanceMode" : "generalPurpose",
   "fileSystemId":"fs-01234567",
   "CreationTime":"1403301078",
   "LifeCycleState":"creating",
   "numberOfMountTargets":0,
   "SizeInBytes":{
       "Timestamp": 1403301078,
       "Value": 29313618372,
       "ValueInArchive": 201156,
       "ValueInIA": 675432,
       "ValueInStandard": 29312741784
   },
   "Tags":[
      {
        "Key": "Name",
        "Value": "Test Group1"
      }
   ],
   "ThroughputMode": "elastic"
}

创建具有单区可用性的加密 EFS 文件系统

以下示例发送 POST 请求，要求在启用自动备份的 us-west-2 区域中创建文件系统。该文件系统在 us-west-2b 可用区中将具有单区存储。

示例请求

POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42

{
  "CreationToken" : "myFileSystem2",
  "PerformanceMode" : "generalPurpose",
  "Backup": true,
  "AvailabilityZoneName": "us-west-2b",
  "Encrypted": true,
  "ThroughputMode": "elastic",
  "Tags":[
      {
         "Key": "Name",
         "Value": "Test Group1"
      }
   ]
}

示例响应

HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319

{
   "ownerId":"251839141158",
   "CreationToken":"myFileSystem1",
   "Encrypted": true,
   "AvailabilityZoneId": "usew2-az2", 
   "AvailabilityZoneName": "us-west-2b",
   "PerformanceMode" : "generalPurpose",
   "fileSystemId":"fs-01234567",
   "CreationTime":"1403301078",
   "LifeCycleState":"creating",
   "numberOfMountTargets":0,
   "SizeInBytes":{
       "Timestamp": 1403301078,
       "Value": 29313618372,
       "ValueInArchive": 201156,
       "ValueInIA": 675432,
       "ValueInStandard": 29312741784
   },
   "Tags":[
      {
        "Key": "Name",
        "Value": "Test Group1"
      }
   ],
   "ThroughputMode": "elastic"
}

另请参阅

有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：