Tous les produits
Search
Centre de documentation

File Storage NAS:AttachVscToFilesystems

Dernière mise à jour :Aug 18, 2026

Associe un périphérique de canal de stockage virtuel (VSC) à un système de fichiers.

Description de l'opération

  • Seul CPFS for Lingjun prend en charge cette fonctionnalité.

  • Les opérations par lot sont prises en charge. En mode lot, un seul VscId peut être associé à plusieurs identifiants de système de fichiers (FileSystemId). Cela signifie que les valeurs ResourceIds.VscId doivent être identiques.

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:AttachVscToFilesystems

update

*FileSystem

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

*Vsc

acs:eflo:{#regionId}:{#accountId}:vsc/{#VscId}

Aucune Aucune

Syntaxe de la requête

POST  HTTP/1.1

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

ResourceIds

array<object>

Oui

Les identifiants des systèmes de fichiers et des canaux de stockage virtuels. Vous pouvez spécifier jusqu'à 10 entrées par lot.

object

Non

Les identifiants des systèmes de fichiers et des canaux de stockage virtuels. Vous pouvez spécifier jusqu'à 10 entrées par lot.

FileSystemId

string

Non

L'identifiant du système de fichiers.

bmcpfs-290t15yn4uo8lid****

VscId

string

Non

L'identifiant du canal de stockage virtuel.

vsc-8vb864o3ppwfvh****

ClientToken

string

Non

Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais assurez-vous qu'il est unique pour chaque requête.

Le jeton ne peut contenir que des caractères ASCII et sa longueur ne peut excéder 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 automatiquement le RequestId de la requête API comme ClientToken. Le RequestId peut différer pour chaque requête API.

123e4567-e89b-12d3-a456-42665544****

RoleChain

array<object>

Non

La chaîne de rôles.

Remarque

Ce paramètre est requis uniquement pour les scénarios inter-comptes.

object

Non

RoleType

string

Non

Le type de rôle. Valeurs valides : service et user.

service

RoleArn

string

Non

Le descripteur de ressource du rôle spécifié. Format : acs:ram::$accountID:role/$roleName.

acs:ram::123472233814****:role/aliyunnasclientvsc****

AssumeRoleFor

string

Non

L'UID du compte Alibaba Cloud au nom duquel le service assume le rôle.

176498472570****

Éléments de réponse

Élément

Type

Description

Exemple

object

Schéma de la réponse.

RequestId

string

L'identifiant de la requête.

BC7C825C-5F65-4B56-BEF6-98C56C7C****

Exemples

JSON format

{
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidParameter The parameter is invalid. Illegal parameter.
400 InvalidParameter.ResourceIds Invalid ResourceIds, can not be empty or batch size large than 10.
400 InvalidParameter.FileSystem Invalid FileSystem in ResourceIds.
400 InvalidFilesystemType.NotSupport This Api does not support this fileSystem type. The current interface does not support this type of file system.
400 InvalidParameter.VscId Invalid VscId in ResourceIds.
400 InvalidParameter.VscIds Invalid VscId in ResourceIds.VscIds must be the same.
400 Ram.AddRamParamFailed Ram check has failed due to param invalid, please check param.
400 FeatureOrAPI.NotSupported The Feature/API is not supported in this region now.
403 Forbbiden.Ram User not authorized to operate on the specified resource, or this API doesn't support RAM. The user is not authorized to operate the specified resource, or the API does not support RAM.

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

Notes de version

Consultez Notes de version pour la liste complète.