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 konularını tam olarak anladığınızdan emin olun. Daha fazla bilgi için Faturalandırma ve Fiyatlandırma bölümlerine 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ı bölümüne bakın.
Bu işlemi çağırdığınızda, işlemle ilişkili NAS hizmet bağlantılı rolü otomatik olarak oluşturulur. Daha fazla bilgi için NAS için hizmet bağlantılı rolü yönetme bölümüne 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

*Dosya sistemi.

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

nas:EncryptedType
nas:FileSystemType

None

Request parameters

Parameter	Type	Required	Description	Example
FileSystemType	string	No	Dosya sisteminin 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 Paralleled File System (CPFS) (yerel olarak yedekli) cpfsse : Cloud Paralleled 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. Yenileme hakkında daha fazla bilgi için yenileme belgelerine bakın.	1
Capacity	integer	No	Dosya sisteminin 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: Agentic : Agentic. Capacity : Capacity. 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 bağımsız güç şebekelerine ve ağlara sahip fiziksel bir 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 bölge rastgele seçilir. FileSystemType değeri extreme veya cpfs olarak ayarlanırsa bu parametre gereklidir. Not Aynı bölge içindeki farklı kullanılabilirlik bölgelerinde bulunan dosya sistemleri ve Elastic Computing Service (ECS) sunucuları birbirleriyle iletişim kurabilir. Bölgeler arası gecikmeyi önlemek için dosya sistemini ve Elastic Computing 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: dual : NFS+SMB çift protokolü. 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 East 1 Finance hariç 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 sisteminin 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 karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için İdempotentlik nasıl sağlanır bölümüne 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ılık gösterebilir.	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 ücrete tabi 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, hizmet 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ının (Key) benzersiz olması gerekir.
	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 yedeklilik 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 ayarlanırsa bu parametre gereklidir. Üç farklı bölgeden üç vSwitch kimliği belirtmeniz gerekir.
	string	No	Bölge yedekli vSwitch kimliği listesi.	vsw-123xxx

API idempotentliği 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 sunucu dahili 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, idempotentliği yalnızca FileSystemType değeri extreme veya cpfs olarak ayarlandığında destekler. FileSystemType değeri standard olarak ayarlandığında, bu işlem idempotentliği 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 karakteri 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 yeniden denemelerde 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, bir yeniden deneme farklı SignatureNonce ve Timestamp değerleri sağlamalıdır, bu da Signature değerini değiştirir.

ClientToken parametresi eklendikten sonra:
- Yanıt HTTP 200 ise, yeniden deneme sunucu tarafındaki durumunuzu etkilemeden önceki istekle aynı sonucu döndürür.
- Yanıt HTTP 4xx ise ve hata mesajı "daha sonra deneyin" türünde bir mesaj içermiyorsa, yeniden deneme asla başarılı olmaz. Hata mesajına göre sorunu giderin, istek parametrelerini değiştirin ve yeniden deneyin.
- Yanıt HTTP 5xx ise, istek zaman aşımına uğramış veya sunucu dahili 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	Description
202	RequestAccepted	The request has been accepted by the server.	İstek arka uç tarafından kabul edilmiştir.
400	IdempotentParameterMismatch	The same client token was passed in to different parameters.	Aynı ClientToken için farklı parametreler belirtildi.
400	InvalidParameter.KmsServiceNotEnabled	Key Management Service is not enabled.	KMS etkin değil.
400	DryRunOperation	The request is validated with DryRun flag set.	İstek doğrulamayı geçti.
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.	Mevcut Kaynak Erişim Yönetimi (RAM) kullanıcısı, AliyunServiceRoleForNasExtreme hizmete bağlı rolünü oluşturma iznine sahip değil. RAM kullanıcısına ram:CreateServiceLinkedRole yetkisi verin.
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.	Mevcut Kaynak Erişim Yönetimi (RAM) kullanıcısı, AliyunServiceRoleForNasStandard hizmete bağlı rolünü oluşturma iznine sahip değil. RAM kullanıcısına ram:CreateServiceLinkedRole yetkisi verin.
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.	Mevcut Kaynak Erişim Yönetimi (RAM) kullanıcısı, AliyunServiceRoleForNasEncryption hizmete bağlı rolünü oluşturma iznine sahip değil. RAM kullanıcısına ram:CreateServiceLinkedRole yetkisi verin.
400	InvalidParam.NotSupportBYOK	The specified file system type does not support the BYOK encryption function.	Belirtilen dosya sistemi türü Özel Anahtar (KMS) şifrelemesini desteklemez.
400	MissingParameter.KmsKeyId	When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.	Şifreleme türü Özel Anahtar (KMS) olduğunda KmsKeyId parametresi gereklidir.
400	InvalidParameter.InvalidKmsKeyId	The specified KMS key ID is invalid.	KMS KeyId değeri geçersiz.
400	InvalidParameter.KmsKeyIdNotFound	The specified KMS key ID does not exist.	KMS KeyId mevcut değil.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.	Durum işlenirken bu işleme izin verilmez.
403	InvalidFileSystem.AlreadyExisted	The specified file system already exists.	Belirtilen dosya sistemi zaten mevcut. İlgili bilgileri görüntülemek için DescribeFileSystems çağrısı yapabilir ve dosya sistemi kimliğini belirtebilirsiniz.
403	Resource.OutOfStock	The inventory of the specified zone is insufficient.	Belirtilen bölgedeki envanter yetersiz.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.