Use ALIYUN::NAS::FileSystem in a call to create a file system - Resource Orchestration Service

ALIYUN::NAS::FileSystem is used to create a file system of File Storage NAS (NAS).

Syntax

{
  "Type": "ALIYUN::NAS::FileSystem",
  "Properties": {
    "SnapshotId": String,
    "Description": String,
    "StorageType": String,
    "DeletionForce": Boolean,
    "EncryptType": Integer,
    "VpcId": String,
    "ZoneId": String,
    "Capacity": Integer,
    "Tags": List,
    "ProtocolType": String,
    "FileSystemType": String,
    "Bandwidth": Integer,
    "VSwitchId": String,
    "Duration": Integer,
    "ChargeType": String
  }
}

Properties

Property	Type	Required	Editable	Description	Constraint
ProtocolType	String	Yes	No	The protocol type.	Valid values: NFS: Network File System (NFS) SMB: Server Message Block (SMB) cpfs: Cloud Parallel File Storage (CPFS)
StorageType	String	Yes	No	The storage type.	Valid values when FileSystemType is set to standard: Performance: Performance Capacity: Capacity Valid values when FileSystemType is set to extreme: standard: standard advance: advanced Valid values when FileSystemType is set to cpfs: advance_100: 100 MB/s/TiB baseline advance_200: 200 MB/s/TiB baseline
DeletionForce	Boolean	No	Yes	Specifies whether to forcefully delete the file system.	Valid values: true false (default)
Description	String	No	Yes	The description of the file system.	The description must be 2 to 128 characters in length. It must start with a letter and cannot start with `http://` or `https://`. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).
ZoneId	String	No	No	The zone ID.	None.
Tags	List	No	Yes	The tags of the file system.	You can add up to 20 tags to each file system. For more information, see Tags properties.
SnapshotId	String	No	No	The snapshot ID.	You can use this property to specify a snapshot from which you create a NAS file system. This property is supported only for Extreme NAS file systems. Note If you create a file system from a snapshot, the version of the created file system must be the same as the version of the file system that is contained in the snapshot. If the file system versions are different, you must perform the following operations: Create a file system and copy the data that is stored in the source file of the snapshot to the file system. Migrate your business data to the file system after the data is copied.
EncryptType	Integer	No	No	Specifies whether to encrypt the file system. You can use keys that are managed by Key Management Service (KMS) to encrypt data stored in the file system. When you read and write the encrypted data, you do not need to decrypt the data.	This property takes effect when FileSystemType is set to standard or extreme. Valid values: 0: does not encrypt the file system. 1: encrypts the file system.
Capacity	Integer	No	Yes	The capacity of the file system.	You must specify this property when FileSystemType is set to extreme or cpfs. Valid values when FileSystemType is set to extreme: 100 to 262144. Valid values when FileSystemType is set to cpfs: 2048 to 512000. Unit: GB.
FileSystemType	String	No	No	The type of the file system.	Valid values: standard (default): General-purpose NAS file system extreme: Extreme NAS file system cpfs: CPFS file system
VpcId	String	No	No	The ID of the virtual private cloud (VPC). If you specify VpcId and VSwitchId, a default mount target is preconfigured when the file system is created.	You must specify this property when FileSystemType is set to cpfs.
Bandwidth	Integer	No	No	The maximum throughput of the file system.	You must specify this property when FileSystemType is set to cpfs. The value of Bandwidth varies based on the value of Capacity. For more information, go to the CPFS buy page. Unit: Mbit/s.
VSwitchId	String	No	No	The vSwitch ID. If you specify VpcId and VSwitchId, a default mount target is preconfigured when the file system is created.	You must specify this property when FileSystemType is set to cpfs.
Duration	Integer	No	No	The subscription duration of the file system.	You must specify this property when ChargeType is set to Subscription. If you do not renew a subscription file system when it expires, the file system is automatically released. Valid values: 1 2 3 6 12 36 Unit: month.
ChargeType	String	No	No	The billing method.	Valid values: PayAsYouGo Subscription

Tags syntax

"Tags": [
  {
    "Key": String,
    "Value": String
  }
]

Tags properties

Property	Type	Required	Editable	Description	Constraint
Key	String	Yes	No	The tag key.	The tag key must be 1 to 128 characters in length, and cannot contain `http://` or `https://`. It cannot start with `aliyun` or `acs:`.
Value	String	No	No	The tag value.	The tag value can be up to 128 characters in length, and cannot contain `http://` or `https://`. It cannot start with `aliyun` or `acs:`.

Return values

Fn::GetAtt

FileSystemId: the ID of the file system.

Examples

`YAML` format

ROSTemplateFormatVersion: '2015-09-01'
Description: Test NAS FileSystem
Parameters: {}
Resources:
  FileSystem:
    Type: ALIYUN::NAS::FileSystem
    Properties:
      ProtocolType: NFS
      StorageType: Capacity
Outputs:
  FileSystemId:
    Description: ID of the file system created
    Value:
      Fn::GetAtt:
        - FileSystem
        - FileSystemId

`JSON` format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Test NAS FileSystem",
  "Parameters": {
  },
  "Resources": {
    "FileSystem": {
      "Type": "ALIYUN::NAS::FileSystem",
      "Properties": {
        "ProtocolType": "NFS",
        "StorageType": "Capacity"
      }
    }
  },
  "Outputs": {
    "FileSystemId": {
      "Description": "ID of the file system created",
      "Value": {
        "Fn::GetAtt": [
          "FileSystem",
          "FileSystemId"
        ]
      }
    }
  }
}

For more examples, visit nas.yml. In the examples, the following resource types are used: ALIYUN::NAS::FileSystem, ALIYUN::NAS::AccessGroup, ALIYUN::NAS::AccessRule, and ALIYUN::NAS::MountTarget.