CreateFileSystem - - Centre de documentation Alibaba Cloud

Avant d'appeler cette opération, vous devez comprendre les modalités de facturation et la grille tarifaire d'Apsara File Storage NAS. Pour plus d'informations, consultez les pages Facturation et Tarifs.
Avant de créer un système de fichiers, effectuez la vérification d'identité réelle.
Lorsque vous appelez cette opération, un rôle lié au service NAS est automatiquement créé. Pour plus d'informations, consultez la rubrique Gestion des rôles liés au service NAS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateFileSystem	L'opération que vous souhaitez exécuter. Définissez la valeur sur CreateFileSystem.
FileSystemType	String	Non	standard	Le type de système de fichiers. Valeurs possibles : standard (valeur par défaut) : système de fichiers NAS généraliste extreme : système de fichiers Extreme NAS cpfs : système de fichiers Cloud Parallel File Storage (CPFS) Remarque Les systèmes de fichiers CPFS sont disponibles uniquement sur le site Alibaba Cloud Chine (aliyun.com).
ChargeType	String	Non	PayAsYouGo	La méthode de facturation. Valeurs possibles : PayAsYouGo (valeur par défaut) : paiement à l'utilisation Subscription : abonnement
Duration	Integer	Non	1	La durée de l'abonnement. Ce paramètre n'est valide et obligatoire que si le paramètre ChargeType est défini sur Subscription. Unité : mois. Si vous ne renouvelez pas un système de fichiers par abonnement à son expiration, celui-ci est automatiquement libéré.
Capacity	Long	Non	100	La capacité du système de fichiers. Unité : GiB. Ce paramètre est valide et obligatoire si le paramètre FileSystemType est défini sur extreme ou cpfs. Spécifiez une valeur conforme aux spécifications indiquées sur la page d'achat suivante : Système de fichiers Extreme NAS (paiement à l'utilisation)
Bandwidth	Long	Non	150	Le débit maximal du système de fichiers. Unité : Mo/s. Spécifiez une valeur conforme aux spécifications indiquées sur la page d'achat suivante.
StorageType	String	Oui	Performance	Le type de stockage. Si le paramètre FileSystemType est défini sur standard, vous pouvez définir le paramètre StorageType sur Performance ou Capacity. Si le paramètre FileSystemType est défini sur extreme, vous pouvez définir le paramètre StorageType sur standard ou advance. Si le paramètre FileSystemType est défini sur cpfs, vous pouvez définir le paramètre StorageType sur advance_100 (ligne de base de 100 Mo/s/TiB) ou advance_200 (ligne de base de 200 Mo/s/TiB). Cette valeur est disponible uniquement sur le site Alibaba Cloud Chine (aliyun.com).
ZoneId	String	Non	cn-hangzhou-b	L'ID de la zone. Chaque région comprend plusieurs emplacements isolés appelés zones. Chaque zone dispose de sa propre alimentation électrique et de ses propres réseaux. Ce paramètre n'est pas obligatoire si le paramètre FileSystemType est défini sur standard. Par défaut, une zone est sélectionnée aléatoirement en fonction du type de protocole et du type de stockage. Ce paramètre est obligatoire si le paramètre FileSystemType est défini sur extreme ou cpfs. Remarque La valeur cpfs est disponible uniquement sur le site Alibaba Cloud Chine (aliyun.com). Une instance Elastic Compute Service (ECS) et un système de fichiers NAS situés dans différentes zones d'une même région peuvent communiquer entre eux. Nous vous recommandons de sélectionner la zone où réside l'instance ECS. Cela permet d'éviter la latence interzones entre le système de fichiers et l'instance ECS.
ProtocolType	String	Oui	NFS	Le type de protocole. Si le paramètre FileSystemType est défini sur standard, vous pouvez définir le paramètre ProtocolType sur NFS ou SMB. Si le paramètre FileSystemType est défini sur extreme, vous pouvez définir le paramètre ProtocolType sur NFS. Si le paramètre FileSystemType est défini sur cpfs, vous pouvez définir le paramètre ProtocolType sur cpfs. Cette valeur est disponible uniquement sur le site Alibaba Cloud Chine (aliyun.com).
EncryptType	Integer	Non	1	Indique si les données du système de fichiers doivent être chiffrées. Vous pouvez utiliser des clés gérées par Key Management Service (KMS) pour chiffrer les données stockées dans un système de fichiers. Lors de la lecture et de l'écriture des données chiffrées, celles-ci sont automatiquement déchiffrées. Valeurs possibles : 0 : Les données du système de fichiers ne sont pas chiffrées. 1 : Des clés gérées par NAS sont utilisées pour chiffrer les données du système de fichiers. Cette valeur n'est valide que si le paramètre FileSystemType est défini sur standard ou extreme. 2 : Des clés gérées par KMS sont utilisées pour chiffrer les données du système de fichiers. Cette valeur n'est valide que si le paramètre FileSystemType est défini sur extreme. Remarque Vous pouvez utiliser des clés gérées par KMS uniquement dans les régions suivantes : États-Unis (Silicon Valley), États-Unis (Virginie), Royaume-Uni (Londres), Australie (Sydney), Allemagne (Francfort) et Singapour.
SnapshotId	String	Non	s-xxx	L'ID du snapshot. Ce paramètre est disponible uniquement pour les systèmes de fichiers Extreme NAS. Remarque Vous pouvez créer un système de fichiers à partir d'un snapshot. Dans ce cas, la version du système de fichiers correspond à celle du système de fichiers source. Par exemple, si le système de fichiers source du snapshot utilise la version 1, pour créer un système de fichiers de version 2, vous pouvez créer le système de fichiers A à partir du snapshot, puis créer le système de fichiers B de version 2. Vous pourrez ensuite copier les données et migrer votre activité du système de fichiers A vers le système de fichiers B.
VpcId	String	Non	Aucun.	L'ID du réseau privé virtuel (VPC). Ce paramètre est obligatoire uniquement si vous définissez le paramètre FileSystemType sur cpfs. Il est disponible uniquement sur le site Alibaba Cloud Chine (aliyun.com). Ce paramètre est réservé et non obligatoire si vous définissez le paramètre FileSystemType sur standard ou extreme.
VSwitchId	String	Non	Aucun.	L'ID du vSwitch. Ce paramètre est obligatoire uniquement si vous définissez le paramètre FileSystemType sur cpfs. Il est disponible uniquement sur le site Alibaba Cloud Chine (aliyun.com). Ce paramètre est réservé et non obligatoire si vous définissez le paramètre FileSystemType sur standard ou extreme.
Description	String	Non	Ceci est un système de fichiers.	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, mais ne peut pas commencer par `http://` ni par `https://`. La description peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des tirets (-).
ClientToken	String	Non	123e4567-e89b-12d3-a456-42665544****	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez générer le jeton côté client, mais vous devez vous assurer qu'il est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez la rubrique Comment garantir l'idempotence ? Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement l'ID de requête comme jeton client. La valeur de RequestId peut varier selon les appels d'API.
KmsKeyId	String	Non	Aucun.	L'ID de la clé gérée par KMS. Ce paramètre est obligatoire uniquement si le paramètre EncryptType est défini sur 2.
DryRun	Boolean	Non	true	Indique s'il faut effectuer une simulation (dry run). Lors de la simulation, le système vérifie la validité des paramètres de requête et la disponibilité des ressources demandées. Aucun système de fichiers n'est créé et aucun frais n'est engagé pendant cette phase. Valeurs possibles : true : effectue une simulation. Le système vérifie les paramètres obligatoires, la syntaxe de la requête, les limites et les ressources NAS disponibles. Si la requête échoue à la simulation, un message d'erreur est renvoyé. Si elle réussit, le code d'état HTTP 200 est renvoyé. Aucune valeur n'est retournée pour le paramètre FileSystemId. false (valeur par défaut) : effectue une simulation et envoie la requête. Si la simulation réussit, un système de fichiers est créé.

Prenez note des informations suivantes concernant l'idempotence des API :

L'opération CreateFileSystem crée un système de fichiers et engendre des frais. Par conséquent, en cas d'expiration du délai de la requête ou d'erreur interne, le client peut tenter de renvoyer la requête. Dans ce cas, spécifiez le paramètre ClientToken dans la requête afin d'éviter les envois répétés par le client.

Remarque

Cette opération prend en charge l'idempotence uniquement si le paramètre FileSystemType est défini sur extreme ou cpfs. Elle ne prend pas en charge l'idempotence lorsque le paramètre FileSystemType est défini sur standard.

La liste suivante fournit plus de détails sur le paramètre ClientToken.

Un jeton client est une chaîne unique sensible à la casse, générée par le client. Il ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Exemple :
```
ClientToken=123e4567-e89b-12d3-a456-42665544****
```
Si vous spécifiez un jeton client déjà utilisé et modifiez d'autres paramètres de requête, NAS renvoie le code d'erreur IdempotentParameterMismatch.

Remarque
Si vous rappelez l'opération, vous devez modifier les valeurs des paramètres SignatureNonce, Timestamp et Signature. En effet, NAS utilise le paramètre SignatureNonce pour prévenir les attaques par rejeu et le paramètre Timestamp pour identifier l'horodatage de chaque requête. Par conséquent, une tentative de nouvel envoi nécessite des valeurs différentes pour les paramètres SignatureNonce et Timestamp, ce qui entraîne également un changement de la valeur du paramètre Signature.
Si vous spécifiez le paramètre ClientToken et que la requête échoue, la requête est renvoyée en fonction des codes d'état HTTP et des messages d'erreur suivants :
- Si le code d'état HTTP 200 est renvoyé, le client reçoit le même résultat que lors de la dernière requête après le renvoi. Toutefois, l'état de votre serveur n'est pas affecté.
- Si un code d'état HTTP 4xx est renvoyé et que le message d'erreur n'indique pas « try it later », les paramètres de requête sont invalides. Dans ce cas, modifiez les paramètres de requête selon le message d'erreur renvoyé, puis renvoyez la requête.
- Si un code d'état HTTP 5xx est renvoyé, un délai d'attente réseau ou une erreur interne s'est produit. Dans ce cas, vous pouvez renvoyer la même requête, qui doit contenir le même jeton client et les mêmes paramètres de requête.
Un jeton client est valide pendant 30 jours.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

98696EF0-1607-4E9D-B01D-F20930B6****

L'ID de la requête.

FileSystemId

String

1ca404****

L'ID du système de fichiers créé.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=CreateFileSystem
&EncryptType=1
&ProtocolType=NFS
&StorageType=Performance
&ZoneId=cn-hangzhou-b
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateFileSystemResponse>
    <FileSystemId>1ca404****</FileSystemId>
    <RequestId>98696EF0-1607-4E9D-B01D-F20930B6****</RequestId>
</CreateFileSystemResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Codes d'erreur

Code d'état HTTP

Code d'erreur

Message d'erreur

Description

202

RequestAccepted

La requête a été acceptée par le serveur.

Message renvoyé car la requête a été acceptée par le backend.

400

IdempotentParameterMismatch

Le même jeton client a été transmis avec des paramètres différents.

Message d'erreur indiquant que le même jeton client est spécifié dans différentes requêtes.

400

InvalidParameter.KmsServiceNotEnabled

Key Management Service n'est pas activé.

Message d'erreur indiquant que KMS est désactivé.

400

DryRunOperation

La requête est validée avec l'indicateur DryRun défini.

Message renvoyé car la requête est validée.

400

SubAccount.NoExtremeSLRPermission

L'utilisateur RAM ne dispose pas de l'autorisation nécessaire pour créer le rôle lié au service AliyunServiceRoleForNasExtreme. Veuillez accorder à l'utilisateur RAM l'autorisation ram:CreateServiceLinkedRole.

Message d'erreur indiquant que l'utilisateur RAM actuel n'est pas autorisé à créer le rôle lié au service AliyunServiceRoleForNasExtreme. Accordez l'autorisation ram:CreateServiceLinkedRole à l'utilisateur RAM.

400

SubAccount.NoStandardSLRPermission

L'utilisateur RAM ne dispose pas de l'autorisation nécessaire pour créer le rôle lié au service AliyunServiceRoleForNasStandard. Veuillez accorder à l'utilisateur RAM l'autorisation ram:CreateServiceLinkedRole.

Message d'erreur indiquant que l'utilisateur RAM actuel n'est pas autorisé à créer le rôle lié au service AliyunServiceRoleForNasStandard. Accordez l'autorisation ram:CreateServiceLinkedRole à l'utilisateur RAM.

400

SubAccount.NoEncryptionSLRPermission

L'utilisateur RAM ne dispose pas de l'autorisation nécessaire pour créer le rôle lié au service AliyunServiceRoleForNasEncryption. Veuillez accorder à l'utilisateur RAM l'autorisation ram:CreateServiceLinkedRole.

Message d'erreur indiquant que l'utilisateur RAM actuel n'est pas autorisé à créer le rôle lié au service AliyunServiceRoleForNasEncryption. Accordez l'autorisation ram:CreateServiceLinkedRole à l'utilisateur RAM.

400

InvalidParam.NotSupportBYOK

Le type de système de fichiers spécifié ne prend pas en charge la fonction de chiffrement BYOK.

Message d'erreur indiquant que le type de système de fichiers spécifié ne prend pas en charge le chiffrement KMS.

400

MissingParameter.KmsKeyId

Lorsque le paramètre EncryptType est égal à 2, le paramètre KmsKeyId est obligatoire pour votre requête.

Message d'erreur indiquant que le paramètre KmsKeyId n'est pas spécifié. Si le chiffrement KMS est utilisé, vous devez spécifier le paramètre KmsKeyId.

403

OperationDenied.InvalidState

L'opération n'est pas autorisée lorsque l'état est en cours de traitement.

Message d'erreur indiquant que le système de fichiers se trouve dans un état invalide.

403

InvalidFileSystem.AlreadyExisted

Le système de fichiers spécifié existe déjà.

Message d'erreur indiquant que le système de fichiers spécifié existe déjà.

403

Resource.OutOfStock

L'inventaire de la zone spécifiée est insuffisant.

Message d'erreur indiquant que les ressources disponibles dans la zone spécifiée sont insuffisantes.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs d'API.