Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Accédez à vos systèmes de fichiers FSx for NetApp ONTAP avec Transfer Family

Présentation de

Transfer Family prend en charge Amazon FSx for NetApp ONTAP via les points d'accès S3. Amazon FSx for NetApp ONTAP est un service entièrement géré qui fournit un stockage de fichiers extrêmement fiable, évolutif, performant et riche en fonctionnalités, basé sur NetApp le célèbre système de fichiers ONTAP. Lorsque vous configurez Transfer Family avec un système de FSx fichiers, vos utilisateurs se connectent aux points de terminaison Transfer Family à l'aide de clients de transfert de fichiers standard. Transfer Family achemine les opérations sur les fichiers via un point d'accès S3 connecté à votre FSx volume, tandis que vos données restent sur le système de FSx fichiers. Pour en savoir plus sur FSx NetApp ONTAP, consultez Qu'est-ce qu'Amazon FSx pour NetApp ONTAP ?

Cette intégration vous permet de :

Conditions préalables

Avant de configurer Transfer Family avec Amazon FSx, vous devez satisfaire aux exigences suivantes.

FSx pour les exigences de NetApp l'ONTAP

FSx Pour utiliser NetApp ONTAP avec Transfer Family, vous devez :

Pour en savoir plus, consultez Getting started with Amazon FSx for NetApp ONTAP.

Autorisations IAM requises

Vous pouvez configurer chaque point d'accès S3 avec des autorisations et des contrôles réseau distincts que S3 applique à toute demande effectuée à l'aide de ce point d'accès. Les points d'accès S3 prennent en charge les politiques de ressources IAM que vous pouvez utiliser pour contrôler l'utilisation du point d'accès par ressource, par utilisateur ou selon d'autres conditions. Pour qu'une application ou un utilisateur puisse accéder à des fichiers via un point d'accès, le point d'accès et le volume sous-jacent doivent autoriser la demande. Pour plus d'informations, consultez la section Politiques des points d'accès IAM.

Les points d'accès Amazon S3 FSx utilisent un modèle d'autorisation à double couche qui combine les autorisations IAM avec les autorisations au niveau du système de fichiers. Cette approche garantit que les demandes d'accès aux données sont correctement autorisées à la fois au niveau du AWS service et au niveau du système de fichiers sous-jacent.

Pour qu'une application ou un utilisateur puisse accéder aux données via un point d'accès, la politique du point d'accès S3 et le FSx volume sous-jacent doivent autoriser la demande.

Pour créer et configurer cette intégration, vous devez disposer des autorisations suivantes :

Comment fonctionne FSx le stockage avec Transfer Family

Lorsque vous configurez Transfer Family avec un système de FSx fichiers, les composants suivants fonctionnent ensemble pour permettre les transferts de fichiers :

Pour qu'une opération sur un fichier réussisse, les deux couches d'autorisation doivent autoriser la demande.

Identité de l'utilisateur du système de fichiers

Chaque point d'accès utilise une identité d'utilisateur du système de fichiers que vous spécifiez lors de la création du point d'accès. Cette identité autorise toutes les demandes d'accès aux fichiers effectuées via ce point d'accès. L'utilisateur du système de fichiers est un compte utilisateur sur le système de FSx fichiers Amazon sous-jacent. Si l'utilisateur du système de fichiers dispose d'un accès en lecture seule, seules les demandes de lecture effectuées via le point d'accès sont autorisées et les demandes d'écriture sont bloquées. Si l'utilisateur du système de fichiers dispose d'un accès en lecture-écriture, les demandes de lecture et d'écriture adressées au volume attaché à l'aide du point d'accès sont autorisées.

Création d'un point d'accès S3 pour FSx

Avant de configurer Transfer Family, vous devez créer un point d'accès S3 connecté à votre FSx volume. Les points d'accès S3 sont appelés points de terminaison réseau attachés à une source de données telle qu'un bucket ou un volume Amazon FSx for ONTAP. Vous pouvez créer et associer un point d'accès à un FSx pour NetApp ONTAP à l'aide de la FSx console, de la AWS CLI ou de l'API Amazon. Une fois attaché, vous pouvez utiliser l'objet S3 APIs pour accéder aux données de votre fichier. Vos données continuent de résider dans le système de FSx fichiers Amazon et d'être directement accessibles pour vos charges de travail existantes. Vous continuez à gérer votre stockage en utilisant toutes les fonctionnalités de gestion du stockage FSx d' NetApp ONTAP, notamment les sauvegardes, les instantanés, les quotas d'utilisateurs et de groupes et la compression.

Pour plus d’informations, consultez Création de points d’accès.

Désignation des points d'accès

Lorsque vous nommez votre point d'accès, suivez les instructions suivantes :

Pour une liste complète des règles de dénomination, voir Règles de dénomination, restrictions et limitations des points d'accès.

Création d'un point d'accès FSx pour NetApp ONTAP

Utilisez la procédure suivante pour créer un point d'accès S3 pour un volume FSx for NetApp ONTAP.

Configuration des autorisations du système de fichiers

L'utilisateur du système de fichiers que vous spécifiez détermine les opérations que les utilisateurs de Transfer Family peuvent effectuer. Vous devez configurer les autorisations appropriées sur votre FSx volume.

Exemple UNIX :

# Create a directory for Transfer Family users
mkdir -p /vol1/transfer-users

# Set ownership to match the access point user
chown 1001:1001 /vol1/transfer-users

# Set permissions
chmod 755 /vol1/transfer-users

Exemple Windows :

# Create a directory for Transfer Family users
New-Item -Path "D:\vol1\transfer-users" -ItemType Directory

# Set permissions for the file system user associated with the access point
# Replace DOMAIN\TransferUser with your Windows user identity
icacls "D:\vol1\transfer-users" /grant "DOMAIN\TransferUser:(OI)(CI)M" /T

# Verify permissions
icacls "D:\vol1\transfer-users"

Utilisation d'alias de point d'accès S3 avec FSx

Lorsque vous utilisez des systèmes de FSx fichiers avec Transfer Family, vous devez utiliser des alias de point d'accès S3. Transfer Family ne prend pas en charge l'utilisation de points d'accès ARNs ou d'autres méthodes de référence pour le FSx stockage.

À propos des alias de point d'accès

Lorsque vous créez un point d'accès S3 attaché à un FSx volume, Amazon S3 génère automatiquement un alias de point d'accès. Cet alias est un identifiant unique que vous pouvez utiliser partout où vous utilisez un nom de compartiment S3.

Pour les points d'accès attachés à FSx des volumes, l'alias utilise le format suivant :

access-point-name-metadata-ext-s3alias

Exemple d'alias :

my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias

Trouver l'alias de votre point d'accès

Vous pouvez trouver l'alias du point d'accès après avoir créé le point d'accès.

Pour trouver l'alias du point d'accès (CLI)

Utilisez la commande describe-s3-access-point-attachments.

aws fsx describe-s3-access-point-attachments \
    --filters Name=file-system-id,Values=fs-0123456789abcdef0

La réponse inclut l'alias :

{
    "S3AccessPointAttachments": [
        {
            "S3AccessPoint": {
                "ResourceARN": "arn:aws:s3:us-east-1:111122223333:accesspoint/my-fsx-ap",
                "Alias": "my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias"
            }
        }
    ]
}

Lorsque vous configurez les utilisateurs de Transfer Family, utilisez l'alias du point d'accès dans les mappages du répertoire de base.

Format du répertoire de base :

/access-point-alias/path/to/directory

Exemple :

/my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias/users/jsmith

Configuration de Transfer Family pour le FSx stockage

Après avoir créé le point d'accès S3, configurez un serveur Transfer Family pour l'utiliser.

Création d’un rôle IAM

Vous devez créer un rôle IAM qui accorde à Transfer Family l'accès au point d'accès S3.

Exemple de politique IAM :

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowFileOperations",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                "s3:PutObject",
                "s3:DeleteObject",
                "s3:GetObjectTagging",
                "s3:PutObjectTagging"
            ],
            "Resource": "arn:aws:s3:us-east-2:111122223333:accesspoint/my-fsx-ap/object/*"
        },
        {
            "Sid": "AllowDirectoryOperations",
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Resource": "arn:aws:s3:us-east-2:111122223333:accesspoint/my-fsx-ap"
        }
    ]
}

Gestion des utilisateurs pour le FSx stockage

Créez des utilisateurs Transfer Family avec des mappages de répertoire de base utilisant l'alias du point d'accès S3.

Création d’un utilisateur

Lorsque vous créez un utilisateur pour le FSx stockage, utilisez l'alias du point d'accès dans les mappages du répertoire de base.

Pour créer un utilisateur (CLI)

Utilisez la commande create-user. Remplacez l'alias du point d'accès par votre alias.

aws transfer create-user \
    --server-id s-0123456789abcdef0 \
    --user-name jsmith \
    --role arn:aws:iam::111122223333:role/TransferFamilyFSxRole \
    --home-directory-type LOGICAL \
    --home-directory-mappings '[
        {
            "Entry": "/",
            "Target": "/my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias/users/jsmith"
        }
    ]'

Configuration de mappages de répertoires multiples

Vous pouvez mapper plusieurs répertoires virtuels vers différents chemins du FSx volume.

Exemple : répertoires de chargement et de téléchargement séparés

aws transfer create-user \
    --server-id s-0123456789abcdef0 \
    --user-name jsmith \
    --role arn:aws:iam::111122223333:role/TransferFamilyFSxRole \
    --home-directory-type LOGICAL \
    --home-directory-mappings '[
        {
            "Entry": "/inbox",
            "Target": "/my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias/users/jsmith/inbox"
        },
        {
            "Entry": "/outbox",
            "Target": "/my-fsx-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias/users/jsmith/outbox"
        }
    ]'

Configuration des clients de transfert de fichiers

Lorsque vous utilisez des systèmes de FSx fichiers avec Transfer Family, vous devez configurer vos clients de transfert de fichiers pour désactiver les fonctionnalités non prises en charge.

Configuration de WinSCP

WinSCP utilise par défaut une fonctionnalité de renommage temporaire qui n'est pas prise en charge par les points d'accès S3 pour. FSx

Vous pouvez également désactiver ce paramètre pour une session existante :

Autres clients SFTP

Pour les autres clients SFTP, désactivez les fonctionnalités suivantes si elles sont disponibles :

Consultez la documentation de votre client pour connaître les étapes de configuration spécifiques.

Résolution des problèmes FSx de stockage

Cette section explique comment identifier et résoudre les problèmes courants liés à l'utilisation de Transfer Family avec des systèmes de FSx fichiers.

Problèmes liés au fonctionnement des fichiers

Autorisation refusée

Si vous recevez des messages d'erreur relatifs à l'autorisation refusée :

Le téléchargement échoue avec WinSCP

Si les téléchargements de fichiers échouent avec WinSCP, désactivez le renommage temporaire :

Pour de plus amples informations, veuillez consulter Configuration des clients de transfert de fichiers.

Le téléchargement du fichier échoue

Si le téléchargement de fichiers échoue :