日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

CreateFileSystem - 創建文件系統

創建一個文件系統。

接口說明

  • 請確保在使用該接口前,已充分了解 NAS 產品的計費說明和價格。更多信息,請參見計費說明價格。

  • 創建文件系統實例需要通過實名認證。具體操作,請參見賬號實名認證

  • 調用此接口將自動創建操作所需的 NAS 服務關聯角色。更多信息,請參見管理 NAS 服務關聯角色

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
nas:CreateFileSystemcreate
  • FileSystem
    acs:nas:{#regionId}:{#accountId}:filesystem/*
  • nas:EncryptedType
  • nas:FileSystemType

請求參數

名稱類型必填描述示例值
FileSystemTypestring

文件系統類型。

取值:

  • standard(默認值):通用型 NAS
  • extreme:極速型 NAS
  • cpfs:文件存儲 CPFS
說明 僅中國站支持 CPFS 文件系統。
standard
ChargeTypestring

計費類型。

取值:

  • PayAsYouGo(默認值):按量付費
  • Subscription:包年包月
PayAsYouGo
Durationinteger

包年包月時長。

單位:月,當 ChargeType=Subscription 時必填且有效。

當包年包月實例到期時未進行續費,實例到期會自動釋放。

1
Capacitylong

文件系統容量。單位:GiB。 當 FileSystemType=extreme 或 cpfs 時必填且有效。

可選值請參考購買頁面的實際規格:

100
Bandwidthlong

文件系統吞吐上限。

單位:MB/s

具體可選規格值請參考購買頁面的實際規格。

150
StorageTypestring

存儲類型。

  • 當 FileSystemType=standard 時,取值:Performance(性能型)、Capacity(容量型)、Premium(高級型)。
  • 當 FileSystemType=extreme 時,取值:standard(標準型)、advance(高級型)。
  • 當 FileSystemType=cpfs 時,取值:advance_100(100 MB/s/TiB 基線)、advance_200(200 MB/s/TiB 基線)。
Performance
ZoneIdstring

可用區 ID。

可用區是指在同一地域內,電力和網絡互相獨立的物理區域。

當 FileSystemType=standard 時,該參數非必選,默認根據 ProtocolType 及 StorageType 配置隨機選擇一個符合條件的可用區。

當 FileSystemType=extreme 或 FileSystemType=cpfs 時,該參數必選。

說明
  • 同一地域不同可用區之間的文件系統與 ECS 云服務器互通。
  • 建議文件系統與云服務器 ECS 屬于同一可用區,避免跨可用區產生的時延。
  • cn-hangzhou-b
    ProtocolTypestring

    文件傳輸協議類型。

    • 當 FileSystemType=standard 時,取值:NFS、SMB。
    • 當 FileSystemType=extreme 時,取值:NFS。
    • 當 FileSystemType=cpfs 時,取值:cpfs。
    NFS
    EncryptTypeinteger

    文件系統是否加密。

    使用 KMS 服務托管密鑰,對文件系統落盤數據進行加密存儲。在讀寫加密數據時,無需解密。

    取值:

    • 0(默認值):不加密。
    • 1:NAS 托管密鑰。當 FileSystemType=standard 或 extreme 時,支持 NAS 托管密鑰。
    • 2:用戶管理密鑰。當 FileSystemType=standard 或 extreme 時,支持用戶管理密鑰。
    說明
  • 極速型 NAS:所有地域支持用戶管理密鑰(KMS)功能。
  • 通用型 NAS:僅西南 1(成都)、華北 1(青島)、華北 5(呼和浩特)、華北 6(烏蘭察布)、華南 2(河源)、華東 1(杭州)、華東 2(上海)、華北 2(北京)、華北 3(張家口)、華南 1(深圳)、華南 3(廣州)、中國香港、日本(東京)、菲律賓(馬尼拉)、泰國(曼谷)、馬來西亞(吉隆坡)、美國(硅谷)、印度尼西亞(雅加達)、英國(倫敦)、新加坡、美國(弗吉尼亞)、德國(法蘭克福)、澳大利亞(悉尼)關停中、華東 1 金融云等地域支持用戶管理密鑰(KMS)功能。
  • 1
    SnapshotIdstring

    快照 ID。

    僅支持極速型 NAS。

    說明 通過快照創建文件系統,創建的文件系統版本和快照源文件系統版本一致。例如:快照的源文件系統版本是 1,需要創建版本 2 的文件系統,可以先通過快照創建一個文件系統 A,然后再創建一個滿足版本 2 配置的文件系統 B,把文件系統 A 中的數據拷貝至文件系統 B,拷貝完成后把業務遷移到文件系統 B 即可。
    s-xxx
    VpcIdstring

    專有網絡 ID。 當 FileSystemType=cpfs 時,必須配置此參數。

    當 FileSystemType=standard 或 extreme 時,此參數為接口預留參數,暫未生效,您無需配置。

    VSwitchIdstring

    交換機 ID。

    當 FileSystemType=cpfs 時,必須配置此參數。

    當 FileSystemType=standard 或 extreme 時,此參數為接口預留參數,暫未生效,您無需配置。

    Descriptionstring

    文件系統描述。

    限制:

    • 長度為 2~128 個英文或中文字符。
    • 必須以大小寫字母或中文開頭,不能以http://https://開頭。
    • 可以包含數字、半角冒號(:)、下劃線(_)或者短劃線(-)。
    此文件系統的描述。
    ClientTokenstring

    保證請求冪等性。從您的客戶端生成一個參數值,確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符,且不能超過 64 個字符。更多信息,請參見如何保證冪等性

    說明 若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。
    123e4567-e89b-12d3-a456-42665544****
    KmsKeyIdstring

    KMS 密鑰 ID。

    僅當 EncryptType=2 時該參數必填。

    DryRunboolean

    是否對此次創建請求執行預檢。

    預檢操作會幫助您檢查參數有效性、校驗庫存等,并不會實際創建實例,也不會產生費用。

    取值:

    • true:發送檢查請求,不會創建實例。檢查項包括是否填寫了必需參數、請求格式、業務限制和 NAS 庫存。如果檢查不通過,則返回對應錯誤。如果檢查通過,則返回 200 HttpCode,但 FileSystemId 為空。
    • false(默認值):發送正常請求,通過檢查后直接創建實例。
    true
    ResourceGroupIdstring

    資源組 ID。

    您可以通過資源管理控制臺查看資源組 ID。

    rg-acfmwavnfdf****

    關于 API 冪等性,您需要注意以下事項:
    由于 CreateFileSystem 接口涉及云資源的創建和費用,您在調用該 API 時,如果發生請求超時或服務端內部錯誤,客戶端可能會嘗試重發請求。建議您在請求中設置 ClientToken 參數以避免因多次重試導致的重復下單的問題。

    說明 當前只有 FileSystemType 參數為 extreme、cpfs 時,該 API 支持冪等;當 FileSystemType 參數為 standard 時,該 API 不支持冪等。

    ClientToken 參數的詳細信息如下所示:

    • ClientToken 是一個由客戶端生成的唯一的、大小寫敏感、不超過 64 個 ASCII 字符的字符串。例如:ClientToken=123e4567-e89b-12d3-a456-42665544****
    • 如果您提供了一個已經使用過的 ClientToken,但其他請求參數有變化,則 NAS 會返回 IdempotentParameterMismatch 的錯誤代碼。
    說明 參數 SignatureNonce、Timestamp 和 Signature 在重試時是需要變化的。具體原因是 NAS 使用 SignatureNonce 防止重放攻擊,使用 Timestamp 標記每次請求時間。所以再次請求必須提供不同的 SignatureNonce 和 Timestamp 參數值,同時也會導致 Signature 值的變化。
    • 添加了 ClientToken 參數后:

      • 返回結果是 200 HTTPCode 時,重試后客戶端可以得到與上次相同的結果,但對您的服務端狀態沒有影響。
      • 返回結果是 4xx HTTPCode 時,如果錯誤信息沒有表明 try it later 類似的信息,重試永遠不會成功,您需要根據錯誤信息排查問題后修改請求參數后再重試請求。
      • 返回結果是 5xx HTTPCode 時,表明請求可能是發生網絡超時或服務端內部錯誤,您可以重新發送同一個請求(必須包含相同 ClientToken 和業務請求參數)以確認請求結果。
    • ClientToken 有效期為 30 天。

    返回參數

    名稱類型描述示例值
    object

    結構,不參與評審,不顯示。

    RequestIdstring

    請求 ID。

    98696EF0-1607-4E9D-B01D-F20930B6****
    FileSystemIdstring

    完成創建的文件系統 ID。

    1ca404****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
      "FileSystemId": "1ca404****"
    }

    錯誤碼

    HTTP status code錯誤碼錯誤信息描述
    202RequestAcceptedThe request has been accepted by the server.請求已被后端接受。
    400IdempotentParameterMismatchThe same client token was passed in to different parameters.相同的ClientToken傳入了不同的參數。
    400InvalidParameter.KmsServiceNotEnabledKey Management Service is not enabled.未啟用KMS服務。
    400InvalidParameter.KmsKeyIdNotFoundThe KMS key ID does not exist.-
    400InvalidParameter.InvalidKmsKeyIdThe KMS key ID is invalid.-
    400DryRunOperationThe request is validated with DryRun flag set.請求校驗通過。
    400SubAccount.NoExtremeSLRPermissionThe RAM user does not have the permission to create service linked role AliyunServiceRoleForNasExtreme. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.當前RAM用戶沒有權限創建AliyunServiceRoleForNasExtreme SLR角色,請授權RAM用戶ram:CreateServiceLinkedRole權限。
    400SubAccount.NoStandardSLRPermissionThe RAM user does not have the permission to create service linked role AliyunServiceRoleForNasStandard. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.當前RAM用戶沒有權限創建AliyunServiceRoleForNasStandard SLR角色,請授權RAM用戶ram:CreateServiceLinkedRole權限。
    400SubAccount.NoEncryptionSLRPermissionThe RAM user does not have the permission to create service linked role AliyunServiceRoleForNasEncryption. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.當前RAM用戶沒有權限創建AliyunServiceRoleForNasEncryption SLR角色,請授權RAM用戶ram:CreateServiceLinkedRole權限。
    400InvalidParam.NotSupportBYOKThe specified file system type does not support the BYOK encryption function.指定文件系統類型不支持用戶管理密鑰(KMS)加密。
    400MissingParameter.KmsKeyIdWhen parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.當加密類型為用戶管理密鑰(KMS)時,KmsKeyId參數必填。
    403OperationDenied.InvalidStateThe operation is not permitted when the status is processing.狀態處理中不允許此操作。
    403InvalidFileSystem.AlreadyExistedThe specified file system already exists.指定的文件系統已存在。
    403Resource.OutOfStockThe inventory of the specified zone is insufficient.指定的可用區庫存不足。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    變更時間變更內容概要操作
    2024-01-25OpenAPI 錯誤碼發生變更查看變更詳情
    2023-12-26OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情