本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

CreateFileSystem

建立新且空白的文件系統。該操作需要在 Amazon EFS 用於確保冪等創建的請求中使用創建令牌（使用相同的創建令牌調用操作沒有任何效果）。如果呼叫者目前不存在 AWS 帳戶 具有指定建立權杖的呼叫者所擁有的檔案系統，則此作業會執行下列動作：

否則，此操作會傳回 FileSystemAlreadyExists 錯誤，其中包含現有檔案系統的 ID。

等冪操作可讓您重試 CreateFileSystem 呼叫，而無須承擔建立額外檔案系統的風險。在初始呼叫失敗，導致不確定檔案系統實際上是否已建立時，便可能會發生此狀況。其中一個範例便是發生傳輸層逾時，或是您的連線重設時。只要您使用相同的建立字符，若初始呼叫成功建立檔案系統，用戶端便會從 FileSystemAlreadyExists 錯誤中得知該檔案系統已存在。

如需詳細資訊，請參閱 Amazon EFS 使用者指南中的建立檔案系統。

此操作會接受一個為檔案系統選擇的選用 PerformanceMode 參數。我們建議所generalPurposePerformanceMode有檔案系統使用。該maxIO模式是上一代的效能類型，專為高度平行化的工作負載而設計，可以容忍比模式更高的延遲。generalPurpose MaxIO使用彈性輸送量的單一區域檔案系統或檔案系統不支援 mode。

檔案系統建立後無法變更。PerformanceMode如需詳細資訊，請參閱 Amazon EFS 效能模式。

您可以使用 ThroughputMode 參數設定檔案系統的輸送量模式。

檔案系統完全建立之後，Amazon 會將其生命週期狀態EFS設定為available，此時您可以為檔案系統中的檔案系統建立一或多個掛載目標VPC。如需詳細資訊，請參閱 CreateMountTarget。您可以使用掛載目標在您的EC2VPC執行個體上掛載 Amazon EFS 檔案系統。如需詳細資訊，請參閱 AmazonEFS：其運作方式。

這項操作需要 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在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：