Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Storage Gateway.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

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

O código de exemplo a seguir mostra como usar `describe-gateway-information`.

**AWS CLI**  
**Para descrever um gateway**  
O comando `describe-gateway-information` a seguir retornará metadados sobre o gateway especificado. Para especificar qual gateway descrever, use nome do recurso da Amazon (ARN) do gateway no comando.  
Este exemplo especifica um gateway com o ID `sgw-12A3456B` na conta `123456789012`:  

```
aws storagegateway describe-gateway-information --gateway-arn "arn:aws:storagegateway:us-west-2:123456789012:gateway/sgw-12A3456B"
```
Este comando produz um bloco JSON que contém metadados sobre o gateway, como seu nome, interfaces de rede, fuso horário configurado e o estado (se o gateway está em execução ou não).  
+  Para obter detalhes da API, consulte [DescribeGatewayInformation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/describe-gateway-information.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `list-file-shares`.

**AWS CLI**  
**Para listar compartilhamentos de arquivos**  
O `command-name` exemplo a seguir lista os widgets disponíveis na sua AWS conta.  

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

```
{
    "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
}
```
Para obter mais informações, consulte [ListFileShares](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ListFileShares.html)a *Referência da API do AWS Storage Gateway Service*.  
+  Para obter detalhes da API, consulte [ListFileShares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-file-shares.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `list-gateways`.

**AWS CLI**  
**Para listar gateways para uma conta**  
O comando `list-gateways` a seguir lista todos os gateways definidos para uma conta:  

```
aws storagegateway list-gateways
```
Esse comando gera um bloco JSON que contém uma lista de nomes de recursos da Amazon () ARNs do gateway.  
+  Para obter detalhes da API, consulte [ListGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-gateways.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `list-volumes`.

**AWS CLI**  
**Para listar os volumes configurados para um gateway**  
O comando `list-volumes` a seguir retorna uma lista de volumes configurados para o gateway especificado. Para especificar qual gateway descrever, use nome do recurso da Amazon (ARN) do gateway no comando.  
Este exemplo especifica um gateway com o ID `sgw-12A3456B` na conta `123456789012`:  

```
aws storagegateway list-volumes --gateway-arn "arn:aws:storagegateway:us-west-2:123456789012:gateway/sgw-12A3456B"
```
Esse comando gera um bloco JSON que contém uma lista de volumes que inclui o tipo e o ARN de cada volume.  
+  Para obter detalhes da API, consulte [ListVolumes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-volumes.html)em *Referência de AWS CLI Comandos*. 

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

O código de exemplo a seguir mostra como usar `refresh-cache`.

**AWS CLI**  
**Para atualizar o cache de compartilhamento de arquivos**  
O seguinte exemplo de `refresh-cache` atualiza o cache do compartilhamento de arquivos especificado.  

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

```
{
    "FileShareARN": "arn:aws:storagegateway:us-east-1:111122223333:share/share-2FA12345",
    "NotificationId": "4954d4b1-abcd-ef01-1234-97950a7d3483"
}
```
Para obter mais informações, consulte [ListFileShares](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_RefreshCache.html)a *Referência da API do AWS Storage Gateway Service*.  
+  Para obter detalhes da API, consulte [RefreshCache](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/refresh-cache.html)em *Referência de AWS CLI Comandos*.