Exemples d’utilisation de l’AWS CLI avec Storage Gateway - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec Storage Gateway

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec Storage Gateway.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser describe-gateway-information.

AWS CLI

Pour décrire une passerelle

La commande describe-gateway-information suivante renvoie les métadonnées de la passerelle spécifiée. Pour spécifier la passerelle à décrire, utilisez l’Amazon Resource Name (ARN) de la passerelle dans la commande.

Cet exemple spécifie une passerelle portant l’ID sgw-12A3456B dans le compte 123456789012 :

aws storagegateway describe-gateway-information --gateway-arn "arn:aws:storagegateway:us-west-2:123456789012:gateway/sgw-12A3456B"

Cette commande génère un bloc JSON qui contient des métadonnées sur la passerelle telles que son nom, ses interfaces réseau, son fuseau horaire et son état (passerelle en cours d’exécution ou non).

L’exemple de code suivant montre comment utiliser list-file-shares.

AWS CLI

Pour répertorier les partages de fichiers

L’exemple command-name suivant répertorie les widgets disponibles dans votre compte AWS.

aws storagegateway list-file-shares \
    --gateway-arn arn:aws:storagegateway:us-east-1:209870788375:gateway/sgw-FB02E292

Sortie :

{
    "FileShareInfoList": [
        {
            "FileShareType": "NFS",
            "FileShareARN": "arn:aws:storagegateway:us-east-1:111122223333:share/share-2FA12345",
            "FileShareId": "share-2FA12345",
            "FileShareStatus": "AVAILABLE",
            "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-FB0AAAAA"
        }
    ],
    "Marker": null
}

Pour plus d’informations, consultez ListFileShares dans la Référence des API AWS Storage Gateway Service.

  • Pour plus de détails sur l’API, consultez ListFileShares dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-gateways.

AWS CLI

Pour répertorier les passerelles d’un compte

La commande list-gateways suivante répertorie toutes les passerelles définies pour un compte :

aws storagegateway list-gateways

Cette commande génère un bloc JSON qui contient la liste des Amazon Resource Name (ARN) de la passerelle.

  • Pour plus de détails sur l’API, consultez ListGateways dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-volumes.

AWS CLI

Pour répertorier les volumes configurés d’une passerelle

La commande list-volumes suivante renvoie la liste des volumes configurés de la passerelle spécifiée. Pour spécifier la passerelle à décrire, utilisez l’Amazon Resource Name (ARN) de la passerelle dans la commande.

Cet exemple spécifie une passerelle portant l’ID sgw-12A3456B dans le compte 123456789012 :

aws storagegateway list-volumes --gateway-arn "arn:aws:storagegateway:us-west-2:123456789012:gateway/sgw-12A3456B"

Cette commande génère un bloc JSON qui contient une liste de volumes incluant le type et l’ARN de chacun d’eux.

  • Pour plus de détails sur l’API, consultez ListVolume dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser refresh-cache.

AWS CLI

Pour actualiser le cache d’un partage de fichiers

L’exemple refresh-cache suivant actualise le cache du partage de fichiers spécifié.

aws storagegateway refresh-cache \
    --file-share-arn arn:aws:storagegateway:us-east-1:111122223333:share/share-2FA12345

Sortie :

{
    "FileShareARN": "arn:aws:storagegateway:us-east-1:111122223333:share/share-2FA12345",
    "NotificationId": "4954d4b1-abcd-ef01-1234-97950a7d3483"
}

Pour plus d’informations, consultez ListFileShares dans la Référence des API AWS Storage Gateway Service.

  • Pour plus de détails sur l’API, consultez RefreshCache dans la Référence des commandes de l’AWS CLI.