Exemplos do Storage Gateway usando a AWS CLI - AWS Command Line Interface
Ações

Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.

Exemplos do Storage Gateway usando a AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a 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.

Tópicos

Ações

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).

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

AWS CLI

Para listar compartilhamentos de arquivos

O exemplo command-name a seguir lista os widgets disponíveis na sua conta da AWS.

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 na Referência da API do serviço do AWS Storage Gateway.

  • Para ver detalhes da API, consulte ListFileShares na Referência de comandos da AWS CLI.

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 seguinte comando retornará um bloco JSON que contém uma lista dos nomes de recursos da Amazon (ARNs) do gateway.

  • Para ver detalhes da API, consulte ListGateways na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte ListVolumes na Referência de comandos da AWS CLI.

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 na Referência da API do serviço do AWS Storage Gateway.

  • Para ver detalhes da API, consulte RefreshCache na Referência de comandos da AWS CLI.