CreateFileSystem - File Storage NAS - Centre de documentation Alibaba Cloud

Crée un système de fichiers.

Description de l'opération

Assurez-vous de bien comprendre les méthodes de facturation et la tarification de File Storage NAS avant d'appeler cette opération. Pour plus d'informations, consultez Facturation et Tarification.

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

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

nas:CreateFileSystem

create

*FileSystem

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

nas:EncryptedType
nas:FileSystemType

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
FileSystemType	string	Non	Le type de système de fichiers. Valeurs valides : standard : NAS à usage général. cpfs : Cloud Parallel File Storage (redondance locale) cpfsse : Cloud Parallel File Storage SE (redondance de zone) extreme : NAS Extreme.	standard
ChargeType	string	Non	La méthode de facturation. Valeurs valides : PayAsYouGo : Paiement à l'usage. Subscription : Abonnement.	PayAsYouGo
Duration	integer	Non	La durée de l'abonnement.	1
Capacity	integer	Non	La capacité du système de fichiers. Unité : Gio.	100
Bandwidth	integer	Non	Le débit maximal du système de fichiers.	150
StorageType	string	Oui	Le type de stockage. Valeurs valides : standard : NAS Extreme standard. Capacity : NAS Capacity. advance_200 : Cloud Parallel File Storage avec un débit de base de 200 Mo/s/Tio. advance_100 : Cloud Parallel File Storage avec un débit de base de 100 Mo/s/Tio. Premium : NAS Premium. Performance : NAS Performance. economic : Cloud Parallel File Storage économique. advance : NAS Extreme avancé. Agentic : AgenticFS.	Performance
ZoneId	string	Non	L'identifiant de la zone.	cn-hangzhou-b
ProtocolType	string	Oui	Le type de protocole de transfert de fichiers. Valeurs valides : cpfs : Protocole cpfs. SMB : Protocole SMB. NFS : Protocole NFS.	NFS
EncryptType	integer	Non	Indique si le système de fichiers doit être chiffré. Valeurs valides : 0 : Non chiffré. 1 : Clé gérée par NAS. 2 : Chiffrement par clé personnalisée.	1
SnapshotId	string	Non	L'identifiant de l'instantané.	s-extreme-snapsho****
VpcId	string	Non	L'identifiant du VPC.	vpc-bp18cx9a7zoh0h9b4****
VSwitchId	string	Non	L'identifiant du vSwitch.	vsw-bp131dkqilvw5pnlt****
Description	string	Non	La description du système de fichiers.	Description de ce système de fichiers
ClientToken	string	Non	Garantit l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer que la valeur est unique parmi les différentes requêtes. 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.	123e4567-e89b-12d3-a456-42665544****
KmsKeyId	string	Non	L'identifiant de la clé KMS.	fcbd**-62-4a-b605-c58cc1d5**
DryRun	boolean	Non	Indique si un test à blanc doit être effectué pour cette requête.	true
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-acfmwavnfdf****
Tag	array<object>	Non	Les balises.
	object	Non	L'objet de balise.
Key	string	Non	La clé de balise.	nastest
Value	string	Non	La valeur de balise.	testValue
RedundancyType	string	Non	Le type de redondance de stockage. Ce paramètre prend effet uniquement pour CPFS SE. Valeurs valides : ZRS : Redondance de zone.	ZRS
RedundancyVSwitchIds	array	Non	La liste des identifiants de vSwitch à redondance de zone.
	string	Non	La liste des identifiants de vSwitch à redondance de zone.	vsw-123xxx

Remarques sur l'idempotence de l'API :
Puisque l'opération CreateFileSystem implique la création de ressources cloud et la facturation, si une requête expire ou si une erreur interne du serveur se produit, le client peut réessayer la requête. Nous vous recommandons de spécifier le paramètre ClientToken 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.

Détails sur le paramètre ClientToken :

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 d'une nouvelle tentative. 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 requête doit fournir des valeurs SignatureNonce et Timestamp différentes, ce qui entraîne également la modification de la valeur Signature.

Après avoir ajouté le 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 et modifiez les paramètres de la requête avant de réessayer.
- 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. Vous pouvez renvoyer la même requête (qui doit contenir 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
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.

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

Notes de version

Consultez Notes de version pour la liste complète.