

D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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.

# Exemples de Storage Gateway utilisant AWS CLI
<a name="cli_2_storage-gateway_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with 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.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `describe-gateway-information`
<a name="storage-gateway_DescribeGatewayInformation_cli_2_topic"></a>

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).  
+  Pour plus de détails sur l'API, voir [DescribeGatewayInformation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/describe-gateway-information.html)la section *Référence des AWS CLI commandes*. 

### `list-file-shares`
<a name="storage-gateway_ListFileShares_cli_2_topic"></a>

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

**AWS CLI**  
**Pour répertorier les partages de fichiers**  
L'`command-name`exemple suivant répertorie les widgets disponibles dans votre AWS compte.  

```
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](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ListFileShares.html)le manuel *AWS Storage Gateway Service API Reference*.  
+  Pour plus de détails sur l'API, voir [ListFileShares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-file-shares.html)la section *Référence des AWS CLI commandes*. 

### `list-gateways`
<a name="storage-gateway_ListGateways_cli_2_topic"></a>

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 une liste des noms de ressources Amazon (ARNs) de la passerelle.  
+  Pour plus de détails sur l'API, voir [ListGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-gateways.html)la section *Référence des AWS CLI commandes*. 

### `list-volumes`
<a name="storage-gateway_ListVolumes_cli_2_topic"></a>

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, voir [ListVolumes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-volumes.html)la section *Référence des AWS CLI commandes*. 

### `refresh-cache`
<a name="storage-gateway_RefreshCache_cli_2_topic"></a>

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](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_RefreshCache.html)le manuel *AWS Storage Gateway Service API Reference*.  
+  Pour plus de détails sur l'API, voir [RefreshCache](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/refresh-cache.html)la section *Référence des AWS CLI commandes*. 