# Ejemplos de DataSync que utilizan la AWS CLI
<a name="cli_datasync_code_examples"></a>

En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con DataSync.

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
<a name="actions"></a>

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-location-azure-blob`.

**AWS CLI**  
**Actualización de su ubicación de transferencia con un agente nuevo**  
En el siguiente ejemplo de `update-location-object-storage`, se actualiza la ubicación de DataSync para Microsoft Azure Blob Storage con un agente nuevo.  

```
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 no genera ninguna salida.  
Para obtener más información, consulte [Replacing your agent](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) en la *Guía del usuario de AWS DataSync*.  
+  Para obtener detalles sobre la API, consulte [UpdateLocationAzureBlob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html) en la *Referencia de comandos de la AWS CLI*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-location-hdfs`.

**AWS CLI**  
**Actualización de su ubicación de transferencia con un agente nuevo**  
En el siguiente ejemplo de `update-location-hdfs`, se actualiza la ubicación de HDFS de DataSync con un agente nuevo. Solo necesitará las opciones `--kerberos-keytab` y `--kerberos-krb5-conf` si su clúster de HDFS utiliza la autenticación 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
```
Contenido de `hdfs.keytab`:  

```
N/A. The content of this file is encrypted and not human readable.
```
Contenido 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 no genera ninguna salida.  
Para obtener más información, consulte [Replacing your agent](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) en la *Guía del usuario de AWS DataSync*.  
+  Para obtener detalles sobre la API, consulte [UpdateLocationHdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html) en la *Referencia de comandos de la AWS CLI*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-location-nfs`.

**AWS CLI**  
**Actualización de su ubicación de transferencia con un agente nuevo**  
En el siguiente ejemplo de `update-location-nfs`, se actualiza la ubicación NFS de DataSync con un agente nuevo.  

```
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 no genera ninguna salida.  
Para obtener más información, consulte [Replacing your agent](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) en la *Guía del usuario de AWS DataSync*.  
+  Para obtener detalles sobre la API, consulte [UpdateLocationNfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html) en la *Referencia de comandos de la AWS CLI*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-location-object-storage`.

**AWS CLI**  
**Actualización de su ubicación de transferencia con un agente nuevo**  
En el siguiente ejemplo de `update-location-object-storage`, se actualiza la ubicación de almacenamiento de objetos de DataSync con un agente nuevo.  

```
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 no genera ninguna salida.  
Para obtener más información, consulte [Replacing your agent](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) en la *Guía del usuario de AWS DataSync*.  
+  Para obtener detalles sobre la API, consulte [UpdateLocationObjectStorage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html) en la *Referencia de comandos de la AWS CLI*. 

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

En el siguiente ejemplo de código, se muestra cómo utilizar `update-location-smb`.

**AWS CLI**  
**Actualización de su ubicación de transferencia con un agente nuevo**  
En el siguiente ejemplo de `update-location-smb`, se actualiza la ubicación de SMB de DataSync con un agente nuevo.  

```
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 no genera ninguna salida.  
Para obtener más información, consulte [Replacing your agent](https://docs.aws.amazon.com/datasync/latest/userguide/replacing-agent.html) en la *Guía del usuario de AWS DataSync*.  
+  Para obtener detalles sobre la API, consulte [UpdateLocationSmb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html) en la *Referencia de comandos de la AWS CLI*.