CreateFileSystem - Cloud Parallel File Storage - Centre de documentation Alibaba Cloud

Crée un système de fichiers.

Description de l'opération

Avant d'appeler cette opération, assurez-vous de bien comprendre la facturation et la tarification de File Storage NAS. Pour plus d'informations, consultez Facturation et Tarification.
Pour créer une instance de système de fichiers, effectuez la vérification de l'identité réelle. Pour plus d'informations, consultez Vérification de l'identité réelle.
Lorsque vous appelez cette opération, le rôle lié au service NAS associé à l'opération est automatiquement créé. Pour plus d'informations, consultez Gérer le rôle lié au service pour NAS.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
FileSystemType	string	Non	Le type de système de fichiers. Valeurs valides : standard (par défaut) : NAS à usage général. extreme : NAS Extreme. cpfs : Cloud Parallel File Storage (CPFS) (redondance locale). cpfsse : CPFS SE (redondance de zone). Valeurs valides : standard : NAS à usage général. cpfs : Cloud Parallel File System (CPFS) (redondance locale) cpfsse : Cloud Parallel File System (CPFS) SE (redondance de zone) extreme : NAS Extreme.	standard
ChargeType	string	Non	La méthode de facturation. Valeurs valides : PayAsYouGo (par défaut) : Paiement à l'usage. Subscription : Abonnement. Valeurs valides : PayAsYouGo : Paiement à l'usage. Subscription : Abonnement.	PayAsYouGo
Duration	integer	Non	La durée de l'abonnement. Unité : mois. Ce paramètre est requis et ne prend effet que lorsque ChargeType est défini sur Subscription. Si une instance d'abonnement n'est pas renouvelée avant son expiration, l'instance est automatiquement libérée à l'expiration. Pour plus d'informations sur le renouvellement, consultez la documentation relative au renouvellement.	1
Capacity	integer	Non	La capacité du système de fichiers. Unité : GiB. Ce paramètre est requis et ne prend effet que lorsque FileSystemType est défini sur extreme, cpfs ou cpfsse. Pour les valeurs disponibles, reportez-vous aux spécifications réelles sur la page d'achat : Page d'achat de NAS Extreme à paiement à l'usage Page d'achat du système de fichiers parallèle CPFS à paiement à l'usage	100
Bandwidth	integer	Non	Le débit maximum du système de fichiers. Unité : Mo/s. Pour les valeurs de spécification disponibles, reportez-vous aux spécifications réelles sur la page d'achat. Page d'achat du système de fichiers parallèle CPFS à paiement à l'usage	150
StorageType	string	Oui	Le type de stockage. Si FileSystemType est défini sur standard, valeurs valides : Performance, Capacity, Premium et Agentic (AgenticFS). Si FileSystemType est défini sur extreme, valeurs valides : standard et advance. Si FileSystemType est défini sur cpfs, valeurs valides : advance_100 (référence de 100 Mo/s/Tio), advance_200 (référence de 200 Mo/s/Tio) et economic. Si FileSystemType est défini sur cpfsse, valeurs valides : advance_100 (référence de 100 Mo/s/Tio). Valeurs valides : Agentic : Agentic. Capacity : Capacity. Premium : Premium. Performance : Performance. economic : NAS Extreme économique. advance : NAS Extreme avancé.	Performance
ZoneId	string	Non	L'identifiant de la zone. Une zone est une zone physique dotée de réseaux et de réseaux électriques indépendants au sein d'une région. Si FileSystemType est défini sur standard, ce paramètre est facultatif. Par défaut, une zone active qui répond aux configurations conditionnelles ProtocolType et StorageType est sélectionnée de manière aléatoire. Si FileSystemType est défini sur extreme ou cpfs, ce paramètre est requis. Remarque Les systèmes de fichiers et les serveurs Elastic Compute Service (ECS) situés dans différentes zones au sein de la même région peuvent communiquer entre eux. Placez le système de fichiers et le serveur Elastic Compute Service (ECS) dans la même zone pour éviter la latence inter-zone.	cn-hangzhou-b
ProtocolType	string	Oui	Le type de protocole de transfert de fichiers. Si FileSystemType est défini sur standard, valeurs valides : NFS et SMB. Si FileSystemType est défini sur extreme, valeurs valides : NFS. Si FileSystemType est défini sur cpfs, valeurs valides : cpfs. Si FileSystemType est défini sur cpfsse, valeurs valides : cpfs. Valeurs valides : dual : Double protocole NFS+SMB. SMB : Protocole SMB. NFS : Protocole NFS.	NFS
EncryptType	integer	Non	Indique si le système de fichiers doit être chiffré. Utilise des clés gérées par Key Management Service (KMS) pour chiffrer les données stockées sur le système de fichiers. Le déchiffrement n'est pas requis lors de la lecture ou de l'écriture de données chiffrées. Valeurs valides : 0 (par défaut) : Non chiffré. 1 : Clé gérée par NAS. Pris en charge lorsque FileSystemType est défini sur standard ou extreme. 2 : Clé personnalisée (KMS). Pris en charge lorsque FileSystemType est défini sur standard ou extreme. Remarque NAS Extreme : la clé personnalisée (KMS) est prise en charge dans toutes les régions, à l'exception de China East 1 Finance. NAS à usage général : la clé personnalisée (KMS) est prise en charge dans toutes les régions. Valeurs valides : 0 : Non chiffré. 1 : Chiffrement par clé gérée par NAS. 2 : Chiffrement KMS.	1
SnapshotId	string	Non	L'identifiant de l'instantané. Ce paramètre est pris en charge uniquement pour les systèmes de fichiers NAS Extreme avec le type de stockage avancé. Remarque Un système de fichiers créé à partir d'un instantané a la même version que le système de fichiers source de l'instantané. Par exemple, si la version du système de fichiers source est la 1 et que vous souhaitez créer un système de fichiers de version 2, créez d'abord le système de fichiers A à partir de l'instantané, puis créez le système de fichiers B qui répond à la configuration de la version 2, copiez les données du système de fichiers A vers le système de fichiers B, et migrez vos charges de travail vers le système de fichiers B une fois la copie terminée.	s-extreme-snapsho****
VpcId	string	Non	L'identifiant du VPC. Si FileSystemType est défini sur cpfs ou cpfsse, ce paramètre est requis. Si FileSystemType est défini sur standard ou extreme, ce paramètre est réservé et ne prend pas effet. Vous n'avez pas besoin de le configurer.	vpc-bp18cx9a7zoh0h9b4****
VSwitchId	string	Non	L'identifiant du vSwitch. Si FileSystemType est défini sur cpfs, ce paramètre est requis. Si FileSystemType n'est pas défini sur cpfs, ce paramètre est réservé et ne prend pas effet. Vous n'avez pas besoin de le configurer.	vsw-bp131dkqilvw5pnlt****
Description	string	Non	La description du système de fichiers. Limites : La description doit comporter entre 2 et 128 caractères. La description doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`. La description peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).	Description de ce système de fichiers
ClientToken	string	Non	Garantit l'idempotence de la requête. Générez une valeur de paramètre unique à partir de votre client. La valeur de ClientToken ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise le RequestId de la requête API comme ClientToken. Le RequestId peut varier pour chaque requête API.	123e4567-e89b-12d3-a456-42665544****
KmsKeyId	string	Non	L'identifiant de la clé KMS. Ce paramètre est requis uniquement lorsque EncryptType est défini sur 2.	fcbd**-62-4a-b605-c58cc1d5**
DryRun	boolean	Non	Indique si un test à blanc doit être effectué pour cette requête. Un test à blanc vérifie la validité des paramètres et la disponibilité des ressources sans créer réellement l'instance ni engendrer de frais. Valeurs valides : true : envoie une requête de test à blanc sans créer l'instance. Les éléments vérifiés incluent les paramètres requis, le format de la requête, les limites du service et l'inventaire NAS. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, le code d'état HTTP 200 est renvoyé, mais FileSystemId est vide. false (par défaut) : envoie une requête normale. Une fois la vérification réussie, l'instance est créée.	true
ResourceGroupId	string	Non	L'identifiant du groupe de ressources. Vous pouvez consulter les identifiants des groupes de ressources dans la console Resource Management.	rg-acfmwavnfdf****
Tag	array<object>	Non	Les balises. Longueur du tableau : de 1 à 20. Si le tableau contient plusieurs objets de balise, la clé de balise (Key) doit être unique.
	object	Non	L'objet de balise.
Key	string	Non	La clé de balise. Limites : La clé de balise ne peut pas être vide ou être une chaîne vide. La clé de balise peut comporter jusqu'à 128 caractères. La clé de balise ne peut pas commencer par `aliyun` ou `acs:`. La clé de balise ne peut pas contenir `http://` ou `https://`.	nastest
Value	string	Non	La valeur de balise. Limites : La valeur de balise ne peut pas être vide ou être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères. La valeur de balise ne peut pas contenir `http://` ou `https://`.	testValue
RedundancyType	string	Non	Le type de redondance de stockage. Ce paramètre ne prend effet que pour CPFS SE. Valeurs valides : ZRS. Valeurs valides : ZRS : Redondance de zone.	ZRS
RedundancyVSwitchIds	array	Non	La liste des identifiants de vSwitch à redondance de zone. Si RedundancyType est défini sur ZRS, ce paramètre est requis. Vous devez spécifier trois identifiants de vSwitch provenant de trois zones différentes.
	string	Non	La liste des identifiants de vSwitch à redondance de zone.	vsw-123xxx

Remarques sur l'idempotence de l'API :
Étant donné que l'opération CreateFileSystem implique la création et la facturation de ressources cloud, si une requête expire ou si une erreur interne du serveur se produit, le client peut réessayer la requête. Définissez le paramètre ClientToken dans la requête pour éviter les commandes en double causées par plusieurs tentatives.

Remarque

Actuellement, cette opération prend en charge l'idempotence uniquement lorsque FileSystemType est défini sur extreme ou cpfs. Lorsque FileSystemType est défini sur standard, cette opération ne prend pas en charge l'idempotence.

Les détails du paramètre ClientToken sont les suivants :

ClientToken est une chaîne unique et sensible à la casse générée par le client, qui ne contient pas plus de 64 caractères ASCII. Exemple : ClientToken=123e4567-e89b-12d3-a456-42665544****
Si vous fournissez un ClientToken qui a déjà été utilisé mais avec des paramètres de requête différents, NAS renvoie le code d'erreur IdempotentParameterMismatch.

Remarque

Les paramètres SignatureNonce, Timestamp et Signature doivent changer lors des nouvelles tentatives. En effet, NAS utilise SignatureNonce pour empêcher les attaques par rejeu et Timestamp pour marquer l'heure de chaque requête. Par conséquent, une nouvelle tentative doit fournir des valeurs SignatureNonce et Timestamp différentes, ce qui modifie également la valeur de Signature.

Après l'ajout du paramètre ClientToken :
- Si la réponse est HTTP 200, la nouvelle tentative renvoie le même résultat que la requête précédente sans affecter l'état de votre serveur.
- Si la réponse est HTTP 4xx et que le message d'erreur n'indique pas un message de type « réessayez plus tard », la nouvelle tentative ne réussira jamais. Résolvez le problème en fonction du message d'erreur, modifiez les paramètres de la requête et réessayez.
- Si la réponse est HTTP 5xx, la requête a peut-être expiré ou une erreur interne du serveur s'est peut-être produite. Renvoyez la même requête (avec le même ClientToken et les mêmes paramètres de requête métier) pour confirmer le résultat.
Le ClientToken est valide pendant 30 jours.

Éléments de réponse

Élément	Type	Description	Exemple
	object	La structure de la réponse.
RequestId	string	L'identifiant de la requête.	98696EF0-1607-4E9D-B01D-F20930B6****
FileSystemId	string	L'identifiant du système de fichiers créé.	1ca404****

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
202	RequestAccepted	The request has been accepted by the server.	La requête a été acceptée par le backend.
400	IdempotentParameterMismatch	The same client token was passed in to different parameters.	Des paramètres différents ont été spécifiés pour le même ClientToken.
400	InvalidParameter.KmsServiceNotEnabled	Key Management Service is not enabled.	Le service KMS n'est pas activé.
400	DryRunOperation	The request is validated with DryRun flag set.	La requête a passé la validation.
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.	L'utilisateur Resource Access Management (RAM) actuel ne dispose pas de l'autorisation de créer le rôle lié au service AliyunServiceRoleForNasExtreme. Accordez l'autorisation ram:CreateServiceLinkedRole à l'utilisateur RAM.
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.	L'utilisateur Resource Access Management (RAM) actuel ne dispose pas de l'autorisation de créer le rôle lié au service AliyunServiceRoleForNasStandard. Accordez l'autorisation ram:CreateServiceLinkedRole à l'utilisateur RAM.
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.	L'utilisateur Resource Access Management (RAM) actuel ne dispose pas de l'autorisation de créer le rôle lié au service AliyunServiceRoleForNasEncryption. Accordez l'autorisation ram:CreateServiceLinkedRole à l'utilisateur RAM.
400	InvalidParam.NotSupportBYOK	The specified file system type does not support the BYOK encryption function.	Le type de système de fichiers spécifié ne prend pas en charge le chiffrement par clé personnalisée (KMS).
400	MissingParameter.KmsKeyId	When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.	Le paramètre KmsKeyId est requis lorsque le type de chiffrement est Clé personnalisée (KMS).
400	InvalidParameter.InvalidKmsKeyId	The specified KMS key ID is invalid.	La valeur de KeyId KMS n'est pas valide.
400	InvalidParameter.KmsKeyIdNotFound	The specified KMS key ID does not exist.	Le KeyId KMS n'existe pas.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.	Cette opération n'est pas autorisée lorsque l'état est en cours de traitement.
403	InvalidFileSystem.AlreadyExisted	The specified file system already exists.	Le système de fichiers spécifié existe déjà. Vous pouvez appeler DescribeFileSystems et spécifier l'identifiant du système de fichiers pour afficher les informations associées.
403	Resource.OutOfStock	The inventory of the specified zone is insufficient.	L'inventaire dans la zone spécifiée est insuffisant.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.