CreateFileSystem - - Alibaba Cloud Dokümantasyon Merkezi

Bir dosya sistemi oluşturur.

Operation description

Bu işlemi çağırmadan önce, Dosya Depolama NAS'ın faturalandırma ve fiyatlandırma bilgilerini tam olarak anladığınızdan emin olun. Daha fazla bilgi için Faturalandırma ve Fiyatlandırma konularına bakın.
Bir dosya sistemi örneği oluşturmak için gerçek ad doğrulamasını tamamlayın. Daha fazla bilgi için Gerçek ad doğrulaması konusuna bakın.
Bu işlemin çağrılması, işlem için gereken NAS hizmet bağlantılı rolünü otomatik olarak oluşturur. Daha fazla bilgi için NAS için hizmet bağlantılı rolü yönetme konusuna bakın.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

nas:CreateFileSystem

create

*FileSystem

acs:nas:{#regionId}:{#accountId}:filesystem/*

nas:EncryptedType
nas:FileSystemType

None

Request parameters

Parameter	Type	Required	Description	Example
FileSystemType	string	No	Dosya sistemi türü. Geçerli değerler: standard (varsayılan): Genel amaçlı NAS. extreme: Extreme NAS. cpfs: Cloud Parallel File Storage (CPFS) (yerel olarak yedekli). cpfsse: CPFS SE (bölge yedekli). Valid values: standard : Genel amaçlı NAS. cpfs : Cloud Parallel File System (CPFS) (yerel olarak yedekli) cpfsse : Cloud Parallel File System (CPFS) SE (bölge yedekli) extreme : Extreme NAS.	standard
ChargeType	string	No	Faturalandırma yöntemi. Geçerli değerler: PayAsYouGo (varsayılan): Kullandıkça öde. Subscription: Abonelik. Valid values: PayAsYouGo : Kullandıkça öde. Subscription : Abonelik.	PayAsYouGo
Duration	integer	No	Abonelik süresi. Birim: ay. Bu parametre yalnızca ChargeType değeri Subscription olarak ayarlandığında gereklidir ve geçerli olur. Abonelik örneği, süresi dolmadan önce yenilenmezse, süre dolduğunda örnek otomatik olarak serbest bırakılır.	1
Capacity	integer	No	Dosya sistemi kapasitesi. Birim: GiB. Bu parametre yalnızca FileSystemType değeri extreme, cpfs veya cpfsse olarak ayarlandığında gereklidir ve geçerli olur. Kullanılabilir değerler için satın alma sayfasındaki gerçek teknik özelliklere bakın: Extreme NAS kullandıkça öde satın alma sayfası Paralel dosya sistemi CPFS kullandıkça öde satın alma sayfası	100
Bandwidth	integer	No	Dosya sisteminin maksimum aktarım hızı. Birim: MB/s. Kullanılabilir teknik özellik değerleri için satın alma sayfasındaki gerçek teknik özelliklere bakın. Paralel dosya sistemi CPFS kullandıkça öde satın alma sayfası	150
StorageType	string	Yes	Depolama türü. FileSystemType değeri standard olarak ayarlanırsa geçerli değerler: Performance, Capacity, Premium ve Agentic (AgenticFS). FileSystemType değeri extreme olarak ayarlanırsa geçerli değerler: standard ve advance. FileSystemType değeri cpfs olarak ayarlanırsa geçerli değerler: advance_100 (100 MB/s/TiB temel), advance_200 (200 MB/s/TiB temel) ve economic. FileSystemType değeri cpfsse olarak ayarlanırsa geçerli değerler: advance_100 (100 MB/s/TiB temel). Valid values: standard : Standard Extreme NAS. Agentic : Agentic. Capacity : Capacity. advance_200 : Cloud Paralleled File System 200 MB/s/TiB baseline. advance_100 : Cloud Paralleled File System 100 MB/s/TiB baseline. Premium : Premium. Performance : Performance. economic : Extreme NAS ekonomi. advance : Extreme NAS gelişmiş.	Performance
ZoneId	string	No	Kullanılabilirlik bölgesi kimliği. Kullanılabilirlik bölgesi, bir bölge içinde kendi güç kaynağına ve ağına sahip bağımsız bir fiziksel alandır. FileSystemType değeri standard olarak ayarlanırsa, bu parametre isteğe bağlıdır. Varsayılan olarak, koşullu ProtocolType ve StorageType yapılandırmalarını karşılayan etkin bir kullanılabilirlik bölgesi rastgele seçilir. FileSystemType değeri extreme veya cpfs olarak ayarlanırsa, bu parametre gereklidir. Not Aynı bölgedeki farklı kullanılabilirlik bölgelerinde bulunan dosya sistemleri ve Elastic Compute Service (ECS) örnekleri birbirleriyle iletişim kurabilir. Bölgeler arası gecikmeyi önlemek için dosya sistemini ve Elastic Compute Service (ECS) sunucusunu aynı kullanılabilirlik bölgesine yerleştirin.	cn-hangzhou-b
ProtocolType	string	Yes	Dosya aktarım protokolü türü. FileSystemType değeri standard olarak ayarlanırsa geçerli değerler: NFS ve SMB. FileSystemType değeri extreme olarak ayarlanırsa geçerli değerler: NFS. FileSystemType değeri cpfs olarak ayarlanırsa geçerli değerler: cpfs. FileSystemType değeri cpfsse olarak ayarlanırsa geçerli değerler: cpfs. Valid values: cpfs : cpfs protocol. SMB : SMB protokolü. NFS : NFS protokolü.	NFS
EncryptType	integer	No	Dosya sisteminin şifrelenip şifrelenmeyeceğini belirtir. Dosya sisteminde depolanan verileri şifrelemek için Anahtar Yönetim Hizmeti (KMS) tarafından yönetilen anahtarları kullanır. Şifrelenmiş verileri okurken veya yazarken şifre çözme işlemi gerekmez. Geçerli değerler: 0 (varsayılan): Şifrelenmemiş. 1: NAS tarafından yönetilen anahtar. FileSystemType değeri standard veya extreme olarak ayarlandığında desteklenir. 2: Özel Anahtar (KMS). FileSystemType değeri standard veya extreme olarak ayarlandığında desteklenir. Not Extreme NAS: Özel Anahtar (KMS), China (Hangzhou) Finance Cloud dışındaki tüm bölgelerde desteklenir. Genel amaçlı NAS: Özel Anahtar (KMS) tüm bölgelerde desteklenir. Valid values: 0 : Şifrelenmemiş. 1 : NAS tarafından yönetilen anahtar şifrelemesi. 2 : KMS şifrelemesi.	1
SnapshotId	string	No	Anlık görüntü kimliği. Bu parametre yalnızca gelişmiş depolama türüne sahip Extreme NAS dosya sistemleri için desteklenir. Not Anlık görüntüden oluşturulan bir dosya sistemi, anlık görüntünün kaynak dosya sistemiyle aynı sürüme sahiptir. Örneğin, kaynak dosya sistemi sürümü 1 ise ve sürüm 2 bir dosya sistemi oluşturmak istiyorsanız, önce anlık görüntüden A dosya sistemini oluşturun, ardından sürüm 2 yapılandırmasını karşılayan B dosya sistemini oluşturun, verileri A dosya sisteminden B dosya sistemine kopyalayın ve kopyalama tamamlandıktan sonra iş yüklerinizi B dosya sistemine geçirin.	s-extreme-snapsho****
VpcId	string	No	VPC kimliği. FileSystemType değeri cpfs veya cpfsse olarak ayarlanırsa, bu parametre gereklidir. FileSystemType değeri standard veya extreme olarak ayarlanırsa, bu parametre ayrılmıştır ve geçerli olmaz. Yapılandırmanıza gerek yoktur.	vpc-bp18cx9a7zoh0h9b4****
VSwitchId	string	No	vSwitch kimliği. FileSystemType değeri cpfs olarak ayarlanırsa, bu parametre gereklidir. FileSystemType değeri cpfs olarak ayarlanmazsa, bu parametre ayrılmıştır ve geçerli olmaz. Yapılandırmanıza gerek yoktur.	vsw-bp131dkqilvw5pnlt****
Description	string	No	Dosya sistemi açıklaması. Sınırlamalar: Açıklama 2 ila 128 karakter uzunluğunda olmalıdır. Açıklama bir harfle başlamalıdır ve `http://` veya `https://` ile başlayamaz. Açıklama rakamlar, iki nokta üst üste (:), alt çizgiler (_) ve tireler (-) içerebilir.	The description of this file system
ClientToken	string	No	İsteğin idempotent olmasını sağlar. İstemcinizden benzersiz bir parametre değeri oluşturun. ClientToken değeri yalnızca ASCII karakterler içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için İdempotansın nasıl sağlanacağı konusuna bakın. Not Bu parametreyi belirtmezseniz, sistem API isteğinin RequestId değerini ClientToken olarak kullanır. RequestId her API isteği için farklı olabilir.	123e4567-e89b-12d3-a456-42665544****
KmsKeyId	string	No	KMS anahtar kimliği. Bu parametre yalnızca EncryptType değeri 2 olarak ayarlandığında gereklidir.	fcbd**-62-4a-b605-c58cc1d5**
DryRun	boolean	No	Bu istek için deneme çalıştırması yapılıp yapılmayacağını belirtir. Deneme çalıştırması, örneği gerçekten oluşturmadan veya ücretlendirmeye neden olmadan parametre geçerliliğini ve kaynak kullanılabilirliğini kontrol eder. Geçerli değerler: true: Örneği oluşturmadan bir deneme çalıştırması isteği gönderir. Kontrol öğeleri gerekli parametreleri, istek biçimini, iş sınırlarını ve NAS envanterini içerir. Kontrol başarısız olursa, ilgili hata döndürülür. Kontrol başarılı olursa, HTTP durum kodu 200 döndürülür, ancak FileSystemId boş olur. false (varsayılan): Normal bir istek gönderir. Kontrol başarılı olduktan sonra örnek oluşturulur.	true
ResourceGroupId	string	No	Kaynak grubu kimliği. Kaynak grubu kimliklerini Kaynak Yönetimi konsolunda görüntüleyebilirsiniz.	rg-acfmwavnfdf****
Tag	array<object>	No	Etiketler. Dizi uzunluğu: 1 ila 20. Dizi birden fazla etiket nesnesi içeriyorsa, etiket anahtarı (Key) benzersiz olmalıdır.
	object	No	Etiket nesnesi.
Key	string	No	Etiket anahtarı. Sınırlamalar: Etiket anahtarı boş veya boş bir dize olamaz. Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir. Etiket anahtarı `aliyun` veya `acs:` ile başlayamaz. Etiket anahtarı `http://` veya `https://` içeremez.	nastest
Value	string	No	Etiket değeri. Sınırlamalar: Etiket değeri boş veya boş bir dize olamaz. Etiket değeri en fazla 128 karakter uzunluğunda olabilir. Etiket değeri `http://` veya `https://` içeremez.	testValue
RedundancyType	string	No	Depolama yedekliliği türü. Bu parametre yalnızca CPFS SE için geçerli olur. Geçerli değerler: ZRS. Valid values: ZRS : Bölge yedekli.	ZRS
RedundancyVSwitchIds	array	No	Bölge yedekli vSwitch kimliklerinin listesi. RedundancyType değeri ZRS olarak ayarlandığında, bu parametre gereklidir. Üç farklı kullanılabilirlik bölgesinden üç vSwitch kimliği belirtmeniz gerekir.
	string	No	Bölge yedekli vSwitch kimliği listesi.	vsw-123xxx

API idempotansı ile ilgili notlar:
CreateFileSystem işlemi bulut kaynağı oluşturma ve faturalandırma içerdiğinden, bir istek zaman aşımına uğrarsa veya dahili bir sunucu hatası oluşursa, istemci isteği yeniden deneyebilir. Birden fazla yeniden denemeden kaynaklanan yinelenen siparişleri önlemek için istekte ClientToken parametresini ayarlayın.

Not

Şu anda bu işlem, idempotansı yalnızca FileSystemType değeri extreme veya cpfs olarak ayarlandığında destekler. FileSystemType değeri standard olarak ayarlandığında, bu işlem idempotansı desteklemez.

ClientToken parametresi ayrıntıları aşağıdaki gibidir:

ClientToken, istemci tarafından oluşturulan, büyük/küçük harfe duyarlı, en fazla 64 ASCII karakter içeren benzersiz bir dizedir. Örnek: ClientToken=123e4567-e89b-12d3-a456-42665544****
Daha önce kullanılmış ancak farklı istek parametrelerine sahip bir ClientToken sağlarsanız, NAS IdempotentParameterMismatch hata kodunu döndürür.

Not

SignatureNonce, Timestamp ve Signature parametreleri her yeniden denemede değişmelidir. Bunun nedeni, NAS'ın tekrar saldırılarını önlemek için SignatureNonce ve her isteğin zamanını işaretlemek için Timestamp kullanmasıdır. Bu nedenle, her yeniden deneme farklı SignatureNonce ve Timestamp değerleri sağlamalıdır, bu da Signature değerinin değişmesine neden olur.

ClientToken parametresi eklendikten sonra:
- Yanıt HTTP durum kodu 200 ise, yeniden deneme sunucu tarafındaki durumunuzu etkilemeden önceki istekle aynı sonucu döndürür.
- Yanıt HTTP durum kodu 4xx ise ve hata mesajı "daha sonra deneyin" türünde bir mesaj içermiyorsa, yeniden deneme asla başarılı olmaz. Sorunu hata mesajına göre giderin ve yeniden denemeden önce istek parametrelerini değiştirin.
- Yanıt HTTP durum kodu 5xx ise, istek zaman aşımına uğramış veya dahili bir sunucu hatası oluşmuş olabilir. Sonucu onaylamak için aynı isteği (aynı ClientToken ve iş isteği parametreleriyle) yeniden gönderin.
ClientToken 30 gün boyunca geçerlidir.

Response elements

Element	Type	Description	Example
	object	Yanıt yapısı.
RequestId	string	İstek kimliği.	98696EF0-1607-4E9D-B01D-F20930B6****
FileSystemId	string	Oluşturulan dosya sisteminin kimliği.	1ca404****

Examples

Success response

JSON format

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

Error codes

HTTP status code	Error code	Error message
202	RequestAccepted	The request has been accepted by the server.
400	IdempotentParameterMismatch	The same client token was passed in to different parameters.
400	InvalidParameter.KmsServiceNotEnabled	Key Management Service is not enabled.
400	DryRunOperation	The request is validated with DryRun flag set.
400	SubAccount.NoExtremeSLRPermission	The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasExtreme. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.
400	SubAccount.NoStandardSLRPermission	The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasStandard. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.
400	SubAccount.NoEncryptionSLRPermission	The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasEncryption. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.
400	InvalidParam.NotSupportBYOK	The specified file system type does not support the BYOK encryption function.
400	MissingParameter.KmsKeyId	When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.
400	InvalidParameter.InvalidKmsKeyId	The specified KMS key ID is invalid.
400	InvalidParameter.KmsKeyIdNotFound	The specified KMS key ID does not exist.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.
403	InvalidFileSystem.AlreadyExisted	The specified file system already exists.
403	Resource.OutOfStock	The inventory of the specified zone is insufficient.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.