# Ejemplos de Storage Gateway que utilizan la AWS CLI
En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes utilizando AWS Command Line Interface con Storage Gateway.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `describe-gateway-information`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-gateway-information`.
**AWS CLI**
**Para describir una puerta de enlace**
Este comando `describe-gateway-information` devuelve metadatos acerca de la puerta de enlace especificada. Para especificar la puerta de enlace que desea describir, utilice el nombre de recurso de Amazon (ARN) de la puerta de enlace en el comando.
En este ejemplo se especifica una puerta de enlace con el ID `sgw-12A3456B` la cuenta `123456789012`:
```
aws storagegateway describe-gateway-information --gateway-arn "arn:aws:storagegateway:us-west-2:123456789012:gateway/sgw-12A3456B"
```
Este comando devuelve un bloque JSON que contiene los metadatos de una puerta de enlace, por ejemplo, su nombre, las interfaces de red, la zona horaria configurada y el estado (es decir, si se está ejecutando o no la puerta de enlace).
+ Para obtener información sobre la API, consulte [DescribeGatewayInformation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/describe-gateway-information.html) en la *Referencia de comandos de la AWS CLI*.
### `list-file-shares`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-file-shares`.
**AWS CLI**
**Para enumerar los archivos compartidos**
En el siguiente ejemplo de `command-name`, se genera una lista de los widgets disponibles en la cuenta de AWS.
```
aws storagegateway list-file-shares \
--gateway-arn arn:aws:storagegateway:us-east-1:209870788375:gateway/sgw-FB02E292
```
Salida:
```
{
"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 obtener más información, consulte [ListFileShares](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ListFileShares.html) en la *Referencia de la API del servicio AWS Storage Gateway*.
+ Para obtener detalles de la API, consulte [ListFileShares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-file-shares.html) en la *Referencia de comandos de la AWS CLI*.
### `list-gateways`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-gateways`.
**AWS CLI**
**Para enumerar las puertas de enlace de una cuenta**
El siguiente comando `list-gateways` muestra todas las puertas de enlace definidas para una cuenta:
```
aws storagegateway list-gateways
```
Este comando genera un bloque JSON que contiene una lista de ARN (Nombre de recurso de Amazon) de la puerta de enlace.
+ Para obtener información sobre la API, consulte [ListGateways](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-gateways.html) en la *Referencia de comandos de la AWS CLI*.
### `list-volumes`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-volumes`.
**AWS CLI**
**Para enumerar los volúmenes configurados para una puerta de enlace**
El siguiente comando `list-volumes` devuelve una lista de los volúmenes configurados para la puerta de enlace especificada. Para especificar la puerta de enlace que desea describir, utilice el nombre de recurso de Amazon (ARN) de la puerta de enlace en el comando.
En este ejemplo se especifica una puerta de enlace con el ID `sgw-12A3456B` la cuenta `123456789012`:
```
aws storagegateway list-volumes --gateway-arn "arn:aws:storagegateway:us-west-2:123456789012:gateway/sgw-12A3456B"
```
Este comando genera un bloque JSON que contiene una lista de volúmenes que incluye el tipo y el ARN de cada volumen.
+ Para obtener información sobre la API, consulte [ListVolumes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/list-volumes.html) en la *Referencia de comandos de la AWS CLI*.
### `refresh-cache`
En el siguiente ejemplo de código, se muestra cómo utilizar `refresh-cache`.
**AWS CLI**
**Para actualizar la caché de archivos compartidos**
En el siguiente ejemplo de `refresh-cache`, se actualiza la caché del recurso de archivos compartidos especificado.
```
aws storagegateway refresh-cache \
--file-share-arn arn:aws:storagegateway:us-east-1:111122223333:share/share-2FA12345
```
Salida:
```
{
"FileShareARN": "arn:aws:storagegateway:us-east-1:111122223333:share/share-2FA12345",
"NotificationId": "4954d4b1-abcd-ef01-1234-97950a7d3483"
}
```
Para obtener más información, consulte [ListFileShares](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_RefreshCache.html) en la *Referencia de la API del servicio AWS Storage Gateway*.
+ Para obtener información sobre la API, consulte [RefreshCache](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/storagegateway/refresh-cache.html) en la *Referencia de comandos de la AWS CLI*.