創(chuàng)建一個Fileset。
接口說明
-
CPFS 使用說明
- 僅支持 CPFS 2.2.0 及以上版本創(chuàng)建 Fileset。您可以在控制臺文件系統(tǒng)詳情頁面查看版本信息。
- 單個 CPFS 文件系統(tǒng)最多支持創(chuàng)建 10 個 Fileset。
- 父目錄必須是已存在的目錄。
- Fileset 路徑支持的最大深度為 8 層，根目錄/為 0 層。例如，F(xiàn)ileset 路徑為/test/aaa/ccc/，則表示路徑深度為 3 層。
- 不支持 Fileset 中嵌套 Fileset。即當(dāng)父目錄已指定為 Fileset，其子目錄不支持指定為 Fileset。
- Fileset 最多支持 100 萬個文件，如果文件數(shù)量超過此上限，添加新文件會返回
no space錯誤信息。
-
CPFS 智算版使用說明
- 僅支持 CPFS 智算版 2.7.0 及以上版本創(chuàng)建 Fileset。您可以在控制臺文件系統(tǒng)詳情頁面查看版本信息。
- 單個 CPFS 文件系統(tǒng)最多支持創(chuàng)建 500 個 Fileset。
- Fileset 路徑必須為新路徑，不能為已存在路徑，F(xiàn)ileset 路徑不支持重命名，不支持路徑為軟鏈接。
- Fileset 路徑支持的最大深度為 8 層，根目錄/為 0 層。例如，F(xiàn)ileset 路徑為/test/aaa/ccc/，則表示路徑深度為 3 層。
- Fileset 路徑為多層目錄時，父目錄必須是已存在的目錄。
- 不支持在 Fileset 中嵌套 Fileset，即當(dāng)父目錄已指定為 Fileset，其子目錄不支持指定為 Fileset。一個 Fileset 路徑只支持一個配額。
- Fileset 容量配額，最小起步 10 GiB，擴容單位為 1 GiB，上限為 1000 TiB，容量配額不能超過文件系統(tǒng)的總?cè)萘俊?/li>
- Fileset 最多支持 100 億個文件或目錄，最小起步 10000，擴容單位為 1。
- 修改目錄配額時，設(shè)置的配額容量或文件數(shù)必須高于已使用容量或文件數(shù)。
- 配額的統(tǒng)計有 5 分鐘的延遲，當(dāng)前的實際使用量 5 分鐘之后才會生效。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| nas:CreateFileset | create | *Fileset acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| FileSystemId | string | 是 | 文件系統(tǒng) ID。
說明
國際站不支持 CPFS。
| bmcpfs-290w65p03ok64ya**** |
| FileSystemPath | string | 是 | 待創(chuàng)建的 Fileset 的絕對路徑。
| /test/ |
| DryRun | boolean | 否 | 是否對此次創(chuàng)建請求執(zhí)行預(yù)檢。 預(yù)檢操作會幫助您檢查參數(shù)有效性、校驗庫存等，并不會實際創(chuàng)建實例，也不會產(chǎn)生費用。 取值：
| false |
| DeletionProtection | boolean | 否 | 實例釋放保護屬性，指定是否支持通過控制臺或 API（ DeleteFileset ）釋放實例。
說明
該屬性只能限制手動釋放操作，對系統(tǒng)釋放操作不生效。
| false |
| Description | string | 否 | Fileset 的描述信息。
| 內(nèi)部事務(wù)目錄 |
| ClientToken | string | 否 | 保證請求冪等性，從您的客戶端生成一個參數(shù)值，確保不同的請求間該參數(shù)值唯一。 ClientToken 只支持 ASCII 字符，且不能超過 64 個字符。更多信息，請參見如何保證冪等性。 說明
若用戶未指定，則系統(tǒng)自動使用 API 請求的 RequestId 作為 ClientToken 標(biāo)識。每次 API 請求的 RequestId 可能不一樣。
| 123e4567-e89b-12d3-a456-42665544**** |
| Quota | object | 否 | 配額信息。 說明
僅 CPFS 智算版 2.7.0 及以上版本支持此參數(shù)。
| |
| FileCountLimit | long | 否 | 配額文件數(shù)量限制。取值范圍：
| 10000 |
| SizeLimit | long | 否 | 配額總?cè)萘肯拗?。單位：Byte。 取值范圍：
| 10737418240 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"FsetId": "fset-1902718ea0ae****"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | IllegalCharacters | The parameter contains illegal characters. | 參數(shù)非法。 |
| 400 | MissingFileSystemId | FileSystemId is mandatory for this action. | 未指定FileSystemId參數(shù)。 |
| 400 | MissingFileSystemPath | FileSystemPath is mandatory for this action. | 缺少FileSystemPath參數(shù)。 |
| 400 | InvalidFilesystemType.NotSupport | This Api does not support this fileSystem type. | 當(dāng)前接口不支持該類型文件系統(tǒng)。 |
| 400 | InvalidFilesystemVersion.NotSupport | This Api does not support this fileSystem version. | 當(dāng)前接口不支持該版本文件系統(tǒng)。 |
| 400 | InvalidRequest | The request is invalid. | 請求無效。 |
| 400 | Quota.Invalid.Limit | Quota limit is invalid. | 無效的配額。 |
| 400 | Resource.Exceed.Limit | Resource exceed limit. | 資源數(shù)量超過限制。 |
| 400 | Resource.Check.Fail | Resource check failed. | 資源檢查失敗。 |
| 400 | Fileset.Path.Duplicate | Fileset path is duplicate. | Fileset路徑已存在。 |
| 400 | Fileset.Path.Nested | Fileset path is nested. | Fileset路徑存在嵌套。 |
| 400 | Fileset.Path.NotExist | Fileset.Path.Not.Exist. | Fileset父目錄路徑不存在。 |
| 400 | Fileset.Path.Exist | Fileset already exist. | Fileset路徑已經(jīng)存在。 |
| 403 | OperationDenied.AlreadyExists | The operation is denied due to IdirName already exists in parent path. | 創(chuàng)建的目錄名在父目錄中已存在。 |
| 403 | OperationDenied.TooManyFilesets | The operation is denied due to too many fileset in filesystem. | 文件系統(tǒng)的Fileset目錄數(shù)量超過閾值。 |
| 403 | OperationDenied.TooManyDepths | The operation is denied due to Fileset path too deep. | Fileset目錄路徑深度超過閾值。 |
| 403 | OperationDenied.NestedDir | The operation is denied due to nested directory. | 目錄存在嵌套導(dǎo)致無法創(chuàng)建自動更新配置。 |
| 403 | OperationDenied.DependencyViolation | The operation is denied due to dependancy violation. | 進行該操作的條件不滿足。 |
| 403 | OperationDenied.FilesetNotSupported | The operation is not supported. | 該文件系統(tǒng)不支持Fileset。 |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定的文件系統(tǒng)不存在。 |
| 404 | InvalidFileSystemPath.ParentNotFound | The specified parent path does not exist. | 指定的父目錄不存在。 |
| 404 | InvalidFileSystemPath.NotDirectory | The specified idir parent path is not directory. | 指定的父目錄不是目錄。 |
| 404 | InvalidFileSystemPath.InvalidCharacters | The specified fileset path contains invalid characters. | 指定的Fileset路徑包含非法字符。 |
| 404 | InvalidFilesetPath.InvalidParameter | Fileset path is invalid. | 指定的Fileset路徑無效。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-10-24 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2024-05-31 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-04-24 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |