# Exemplos do DataSync usando a AWS CLI
<a name="cli_datasync_code_examples"></a>

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

*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>

### `update-location-azure-blob`
<a name="datasync_UpdateLocationAzureBlob_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-location-azure-blob`.

**AWS CLI**  
**Para atualizar seu local de transferência com um novo agente**  
O exemplo `update-location-object-storage` a seguir atualiza sua localização do DataSync para o Microsoft Azure Blob Storage com um novo agente.  

```
aws datasync update-location-azure-blob \
    --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \
    --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \
    --sas-configuration '{ \
        "Token": "sas-token-for-azure-blob-storage-access" \
    }'
```
Este comando não produz saída.  
Para obter mais informações, consulte [Substituir seu agente](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) no *Guia do usuário do AWS DataSync*.  
+  Para ver detalhes da API, consulte [UpdateLocationAzureBlob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html) na *Referência de comandos da AWS CLI*. 

### `update-location-hdfs`
<a name="datasync_UpdateLocationHdfs_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-location-hdfs`.

**AWS CLI**  
**Para atualizar seu local de transferência com um novo agente**  
O exemplo `update-location-hdfs` a seguir atualiza sua localização do DataSync HDFS com um novo agente. Você só precisará das opções `--kerberos-keytab` e `--kerberos-krb5-conf` se seu cluster do HDFS usar a autenticação do Kerberos.  

```
aws datasync update-location-hdfs \
    --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \
    --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \
    --kerberos-keytab file://hdfs.keytab
    --kerberos-krb5-conf file://krb5.conf
```
Conteúdo de `hdfs.keytab`:  

```
N/A. The content of this file is encrypted and not human readable.
```
Conteúdo de `krb5.conf`:  

```
[libdefaults]
    default_realm = EXAMPLE.COM
    dns_lookup_realm = false
    dns_lookup_kdc = false
    rdns = true
    ticket_lifetime = 24h
    forwardable = true
    udp_preference_limit = 1000000
    default_tkt_enctypes = aes256-cts-hmac-sha1-96 aes128-cts-hmac-sha1-96 des3-cbc-sha1
    default_tgs_enctypes = aes256-cts-hmac-sha1-96 aes128-cts-hmac-sha1-96 des3-cbc-sha1
    permitted_enctypes = aes256-cts-hmac-sha1-96 aes128-cts-hmac-sha1-96 des3-cbc-sha1

[realms]
    EXAMPLE.COM = {
      kdc = kdc1.example.com
      admin_server = krbadmin.example.com
      default_domain = example.com
    }

[domain_realm]
    .example.com = EXAMPLE.COM
    example.com = EXAMPLE.COM

[logging]
    kdc = FILE:/var/log/krb5kdc.log
    admin_server = FILE:/var/log/kerberos/kadmin.log
    default = FILE:/var/log/krb5libs.log
```
Este comando não produz saída.  
Para obter mais informações, consulte [Substituir seu agente](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) no *Guia do usuário do AWS DataSync*.  
+  Para ver detalhes da API, consulte [UpdateLocationHdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html) na *Referência de comandos da AWS CLI*. 

### `update-location-nfs`
<a name="datasync_UpdateLocationNfs_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-location-nfs`.

**AWS CLI**  
**Para atualizar seu local de transferência com um novo agente**  
O exemplo `update-location-nfs` a seguir atualiza sua localização do DataSync NFS com um novo agente.  

```
aws datasync update-location-nfs \
    --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \
    --on-prem-config AgentArns=arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0
```
Este comando não produz saída.  
Para obter mais informações, consulte [Substituir seu agente](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) no *Guia do usuário do AWS DataSync*.  
+  Para ver detalhes da API, consulte [UpdateLocationNfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html) na *Referência de comandos da AWS CLI*. 

### `update-location-object-storage`
<a name="datasync_UpdateLocationObjectStorage_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-location-object-storage`.

**AWS CLI**  
**Para atualizar seu local de transferência com um novo agente**  
O exemplo `update-location-object-storage` a seguir atualiza seu local de armazenamento de objetos DataSync com um novo agente.  

```
aws datasync update-location-object-storage \
    --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \
    --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \
    --secret-key secret-key-for-object-storage
```
Este comando não produz saída.  
Para obter mais informações, consulte [Substituir seu agente](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) no *Guia do usuário do AWS DataSync*.  
+  Para ver detalhes da API, consulte [UpdateLocationObjectStorage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html) na *Referência de comandos da AWS CLI*. 

### `update-location-smb`
<a name="datasync_UpdateLocationSmb_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-location-smb`.

**AWS CLI**  
**Para atualizar seu local de transferência com um novo agente**  
O exemplo `update-location-smb` a seguir atualiza sua localização do DataSync SMB com um novo agente.  

```
aws datasync update-location-smb \
    --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \
    --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \
    --password smb-file-server-password
```
Este comando não produz saída.  
Para obter mais informações, consulte [Substituir seu agente](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) no *Guia do usuário do AWS DataSync*.  
+  Para ver detalhes da API, consulte [UpdateLocationSmb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html) na *Referência de comandos da AWS CLI*.