

# Ejemplos de WorkSpaces que utilizan la AWS CLI
<a name="cli_workspaces_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 WorkSpaces.

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>

### `create-tags`
<a name="workspaces_CreateTags_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-tags`.

**AWS CLI**  
**Para añadir etiquetas a un WorkSpace**  
En el siguiente ejemplo de `create-tags`, se agregan las etiquetas especificadas al WorkSpace indicado.  

```
aws workspaces create-tags \
    --resource-id ws-dk1xzr417 \
    --tags Key=Department,Value=Finance
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Tag WorkSpaces resources](https://docs.aws.amazon.com/workspaces/latest/adminguide/tag-workspaces-resources.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [CreateTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/create-tags.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-workspaces`
<a name="workspaces_CreateWorkspaces_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-workspaces`.

**AWS CLI**  
**Ejemplo 1: creación de un WorkSpace AlwaysOn**  
En el siguiente ejemplo de `create-workspaces`, se crea un WorkSpace AlwaysOn para el usuario especificado con el directorio y el paquete indicados.  

```
aws workspaces create-workspaces \
    --workspaces DirectoryId=d-926722edaf,UserName=Mateo,BundleId=wsb-0zsvgp8fc
```
Salida:  

```
{
    "FailedRequests": [],
    "PendingRequests": [
        {
            "WorkspaceId": "ws-kcqms853t",
            "DirectoryId": "d-926722edaf",
            "UserName": "Mateo",
            "State": "PENDING",
            "BundleId": "wsb-0zsvgp8fc"
        }
    ]
}
```
**Ejemplo 2: creación de un AutoStop WorkSpace**  
En el siguiente ejemplo de `create-workspaces`, se crea un AutoStop WorkSpace para el usuario especificado con el directorio y el paquete indicados.  

```
aws workspaces create-workspaces \
    --workspaces DirectoryId=d-926722edaf,UserName=Mary,BundleId=wsb-0zsvgp8fc,WorkspaceProperties={RunningMode=AUTO_STOP}
```
Salida:  

```
{
    "FailedRequests": [],
    "PendingRequests": [
        {
            "WorkspaceId": "ws-dk1xzr417",
            "DirectoryId": "d-926722edaf",
            "UserName": "Mary",
            "State": "PENDING",
            "BundleId": "wsb-0zsvgp8fc"
        }
    ]
}
```
**Ejemplo 3: creación de un WorkSpace desacoplado por el usuario**  
En el siguiente ejemplo de `create-workspaces`, se crea un WorkSpace desacoplado por el usuario. Para ello, se establece el nombre de usuario en `[UNDEFINED]` y se especifica un nombre de WorkSpace, un ID de directorio y un ID de paquete.  

```
aws workspaces create-workspaces \
    --workspaces DirectoryId=d-926722edaf,UserName='"[UNDEFINED]"',WorkspaceName=MaryWorkspace1,BundleId=wsb-0zsvgp8fc,WorkspaceProperties={RunningMode=ALWAYS_ON}
```
Salida:  

```
{
    "FailedRequests": [],
    "PendingRequests": [
        {
            "WorkspaceId": "ws-abcd1234",
            "DirectoryId": "d-926722edaf",
            "UserName": "[UNDEFINED]",
            "State": "PENDING",
            "BundleId": "wsb-0zsvgp8fc",
            "WorkspaceName": "MaryWorkspace1"
        }
    ]
}
```
Para obtener más información, consulte [Launch a virtual desktop](https://docs.aws.amazon.com/workspaces/latest/adminguide/launch-workspaces-tutorials.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [CreateWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/create-workspaces.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-tags`
<a name="workspaces_DeleteTags_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-tags`.

**AWS CLI**  
**Para eliminar una etiqueta de un WorkSpace**  
En el siguiente ejemplo de `delete-tags`, se elimina la etiqueta especificada del WorkSpace indicado.  

```
aws workspaces delete-tags \
    --resource-id ws-dk1xzr417 \
    --tag-keys Department
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Tag WorkSpaces resources](https://docs.aws.amazon.com/workspaces/latest/adminguide/tag-workspaces-resources.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [DeleteTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/delete-tags.html) en la *Referencia de comandos de la AWS CLI*. 

### `deregister-workspace-directory`
<a name="workspaces_DeregisterWorkspaceDirectory_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `deregister-workspace-directory`.

**AWS CLI**  
**Para anular el registro de un directorio**  
En el siguiente ejemplo de `deregister-workspace-directory` se anula el registro del directorio indicado.  

```
aws workspaces deregister-workspace-directory \
    --directory-id d-926722edaf
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Register a directory with WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/register-deregister-directory.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener más información sobre la API, consulte [DeregisterWorkspaceDirectory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/deregister-workspace-directory.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-tags`
<a name="workspaces_DescribeTags_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-tags`.

**AWS CLI**  
**Para describir las etiquetas para un WorkSpace**  
En el siguiente ejemplo de `describe-tags` se describen las etiquetas del WorkSpace especificado.  

```
aws workspaces describe-tags \
    --resource-id ws-dk1xzr417
```
Salida:  

```
{
    "TagList": [
        {
            "Key": "Department",
            "Value": "Finance"
        }
    ]
}
```
Para obtener más información, consulte [Tag WorkSpaces resources](https://docs.aws.amazon.com/workspaces/latest/adminguide/tag-workspaces-resources.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener detalles sobre la API, consulte [DescribeTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-tags.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-workspace-bundles`
<a name="workspaces_DescribeWorkspaceBundles_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-workspace-bundles`.

**AWS CLI**  
**Para enumerar los paquetes proporcionados por Amazon**  
En el siguiente ejemplo de `describe-workspace-bundles`, se muestran los nombres e ID de los paquetes proporcionados por Amazon, en formato de tabla y ordenados por nombre.  

```
aws workspaces describe-workspace-bundles \
    --owner AMAZON \
    --query "Bundles[*].[Name, BundleId]"
```
Salida:  

```
[
    [
        "Standard with Amazon Linux 2",
        "wsb-clj85qzj1"
    ],
    [
        "Performance with Windows 10 (Server 2016 based)",
        "wsb-gm4d5tx2v"
    ],
    [
        "PowerPro with Windows 7",
        "wsb-1pzkp0bx4"
    ],
    [
        "Power with Amazon Linux 2",
        "wsb-2bs6k5lgn"
    ],
    [
        "Graphics with Windows 10 (Server 2019 based)",
        "wsb-03gyjnfyy"
    ],
    ...
]
```
Para obtener más información, consulte [WorkSpaces bundles and images](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-bundles.html) en la *Guía de administración e Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [DescribeWorkspaceBundles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-workspace-bundles.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-workspace-directories`
<a name="workspaces_DescribeWorkspaceDirectories_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-workspace-directories`.

**AWS CLI**  
**Para describir un directorio registrado**  
En el siguiente ejemplo de `describe-workspace-directories`, se describe el directorio registrado indicado.  

```
aws workspaces describe-workspace-directories \
    --directory-ids d-926722edaf
```
Salida:  

```
{
    "Directories": [
        {
            "DirectoryId": "d-926722edaf",
            "Alias": "d-926722edaf",
            "DirectoryName": "example.com",
            "RegistrationCode": "WSpdx+9RJ8JT",
            "SubnetIds": [
                "subnet-9d19c4c6",
                "subnet-500d5819"
            ],
            "DnsIpAddresses": [
                "172.16.1.140",
                "172.16.0.30"
            ],
            "CustomerUserName": "Administrator",
            "IamRoleId": "arn:aws:iam::123456789012:role/workspaces_DefaultRole",
            "DirectoryType": "SIMPLE_AD",
            "WorkspaceSecurityGroupId": "sg-0d89e927e5645d7c5",
            "State": "REGISTERED",
            "WorkspaceCreationProperties": {
                "EnableInternetAccess": false,
                "UserEnabledAsLocalAdministrator": true,
                "EnableMaintenanceMode": true
            },
            "WorkspaceAccessProperties": {
                "DeviceTypeWindows": "ALLOW",
                "DeviceTypeOsx": "ALLOW",
                "DeviceTypeWeb": "DENY",
                "DeviceTypeIos": "ALLOW",
                "DeviceTypeAndroid": "ALLOW",
                "DeviceTypeChromeOs": "ALLOW",
                "DeviceTypeZeroClient": "ALLOW",
                "DeviceTypeLinux": "DENY"
            },
            "Tenancy": "SHARED",
            "SelfservicePermissions": {
                "RestartWorkspace": "ENABLED",
                "IncreaseVolumeSize": "DISABLED",
                "ChangeComputeType": "DISABLED",
                "SwitchRunningMode": "DISABLED",
                "RebuildWorkspace": "DISABLED"
            }
        }
    ]
}
```
Para obtener más información, consulte [Administrar directorios para WorkSpaces Personal](https://docs.aws.amazon.com/workspaces/latest/adminguide/manage-workspaces-directory.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [DescribeWorkspaceDirectories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-workspace-directories.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-workspaces-connection-status`
<a name="workspaces_DescribeWorkspacesConnectionStatus_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-workspaces-connection-status`.

**AWS CLI**  
**Para describir el estado de la conexión de un WorkSpace**  
En el siguiente ejemplo de `describe-workspaces-connection-status`, se describe el estado de conexión del WorkSpace especificado.  

```
aws workspaces describe-workspaces-connection-status \
    --workspace-ids ws-dk1xzr417
```
Salida:  

```
{
    "WorkspacesConnectionStatus": [
        {
            "WorkspaceId": "ws-dk1xzr417",
            "ConnectionState": "CONNECTED",
            "ConnectionStateCheckTimestamp": 1662526214.744
        }
    ]
}
```
Para obtener más información, consulte [Administer your WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/administer-workspaces.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [DescribeWorkspacesConnectionStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-workspaces-connection-status.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-workspaces`
<a name="workspaces_DescribeWorkspaces_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-workspaces`.

**AWS CLI**  
**Para describir un WorkSpace**  
En el siguiente ejemplo de `describe-workspaces`, se describe el WorkSpace especificado.  

```
aws workspaces describe-workspaces \
    --workspace-ids ws-dk1xzr417
```
Salida:  

```
{
    "Workspaces": [
        {
            "WorkspaceId": "ws-dk1xzr417",
            "DirectoryId": "d-926722edaf",
            "UserName": "Mary",
            "IpAddress": "172.16.0.175",
            "State": "STOPPED",
            "BundleId": "wsb-0zsvgp8fc",
            "SubnetId": "subnet-500d5819",
            "ComputerName": "WSAMZN-RBSLTTD9",
            "WorkspaceProperties": {
                "RunningMode": "AUTO_STOP",
                "RunningModeAutoStopTimeoutInMinutes": 60,
                "RootVolumeSizeGib": 80,
                "UserVolumeSizeGib": 10,
                "ComputeTypeName": "VALUE"
            },
            "ModificationStates": []
        }
    ]
}
```
Para obtener más información, consulte [Administer your WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/administer-workspaces.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [DescribeWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/describe-workspaces.html) en la *Referencia de comandos de la AWS CLI*. 

### `migrate-workspace`
<a name="workspaces_MigrateWorkspace_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `migrate-workspace`.

**AWS CLI**  
**Para migrar un WorkSpace**  
En el siguiente ejemplo de `migrate-workspace`, se migra el WorkSpace indicado al paquete especificado.  

```
aws workspaces migrate-workspace \
    --source-workspace-id ws-dk1xzr417 \
    --bundle-id wsb-j4dky1gs4
```
Salida:  

```
{
    "SourceWorkspaceId": "ws-dk1xzr417",
    "TargetWorkspaceId": "ws-x5h1lbkp5"
}
```
Para obtener más información, consulte [Migrate a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/migrate-workspaces.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [MigrateWorkspace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/migrate-workspace.html) en la *Referencia de comandos de la AWS CLI*. 

### `modify-workspace-creation-properties`
<a name="workspaces_ModifyWorkspaceCreationProperties_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `modify-workspace-creation-properties`.

**AWS CLI**  
**Para modificar una propiedad de creación de WorkSpace de un directorio**  
En el siguiente ejemplo de `modify-workspace-creation-properties`, se habilita la propiedad `EnableInternetAccess` para el directorio especificado. Esto permite la asignación automática de direcciones IP públicas para los WorkSpaces creados para el directorio.  

```
aws workspaces modify-workspace-creation-properties \
    --resource-id d-926722edaf \
    --workspace-creation-properties EnableInternetAccess=true
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Update directory details for your WorkSpaces](https://docs.aws.amazon.com/workspaces/latest/adminguide/update-directory-details.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [ModifyWorkspaceCreationProperties](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/modify-workspace-creation-properties.html) en la *Referencia de comandos de la AWS CLI*. 

### `modify-workspace-properties`
<a name="workspaces_ModifyWorkspaceProperties_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `modify-workspace-properties`.

**AWS CLI**  
**Para modificar el modo de ejecución de un WorkSpaces**  
En el siguiente ejemplo de `modify-workspace-properties`, se establece el modo de ejecución del WorkSpace especificado en `AUTO_STOP`.  

```
aws workspaces modify-workspace-properties \
    --workspace-id ws-dk1xzr417 \
    --workspace-properties RunningMode=AUTO_STOP
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Modify a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/modify-workspaces.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [ModifyWorkspaceProperties](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/modify-workspace-properties.html) en la *Referencia de comandos de la AWS CLI*. 

### `modify-workspace-state`
<a name="workspaces_ModifyWorkspaceState_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `modify-workspace-state`.

**AWS CLI**  
**Para modificar el estado de un WorkSpace**  
En el siguiente ejemplo de `modify-workspace-state`, se establece el estado del WorkSpace especificado en `ADMIN_MAINTENANCE`.  

```
aws workspaces modify-workspace-state \
    --workspace-id ws-dk1xzr417 \
    --workspace-state ADMIN_MAINTENANCE
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [WorkSpace maintenance](https://docs.aws.amazon.com/workspaces/latest/adminguide/workspace-maintenance.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [ModifyWorkspaceState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/modify-workspace-state.html) en la *Referencia de comandos de la AWS CLI*. 

### `reboot-workspaces`
<a name="workspaces_RebootWorkspaces_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `reboot-workspaces`.

**AWS CLI**  
**Para reiniciar un WorkSpace**  
En el siguiente ejemplo de `reboot-workspaces`, se reinicia el WorkSpace especificado.  

```
aws workspaces reboot-workspaces \
    --reboot-workspace-requests ws-dk1xzr417
```
Salida:  

```
{
    "FailedRequests": []
}
```
Para obtener más información, consulte [Reboot a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/reboot-workspaces.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [RebootWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/reboot-workspaces.html) en la *Referencia de comandos de la AWS CLI*. 

### `rebuild-workspaces`
<a name="workspaces_RebuildWorkspaces_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `rebuild-workspaces`.

**AWS CLI**  
**Para reconstruir un WorkSpace**  
En el siguiente ejemplo de `rebuild-workspaces`, se reconstruye el WorkSpace especificado.  

```
aws workspaces rebuild-workspaces \
    --rebuild-workspace-requests ws-dk1xzr417
```
Salida:  

```
{
    "FailedRequests": []
}
```
Para obtener más información, consulte [Rebuild a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  *Para obtener información sobre la API, consulte [RebuildWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/rebuild-workspaces.html) en la referencia de comandos de la AWS CLI*. 

### `register-workspace-directory`
<a name="workspaces_RegisterWorkspaceDirectory_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `register-workspace-directory`.

**AWS CLI**  
**Para registrar un directorio**  
En el siguiente ejemplo de `register-workspace-directory`, se registra el directorio especificado para usarlo con Amazon WorkSpaces.  

```
aws workspaces register-workspace-directory \
    --directory-id d-926722edaf
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Registrar un directorio de AWS Directory Service existente con WorkSpaces Personal](https://docs.aws.amazon.com/workspaces/latest/adminguide/register-deregister-directory.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [RegisterWorkspaceDirectory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/register-workspace-directory.html) en la *Referencia de comandos de la AWS CLI*. 

### `restore-workspace`
<a name="workspaces_RestoreWorkspace_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `restore-workspace`.

**AWS CLI**  
**Para restaurar un WorkSpace**  
En el siguiente ejemplo de `restore-workspace`, se restablece el WorkSpace especificado.  

```
aws workspaces restore-workspace \
    --workspace-id ws-dk1xzr417
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Restore a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [RestoreWorkspace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/restore-workspace.html) en la *Referencia de comandos de la AWS CLI*. 

### `start-workspaces`
<a name="workspaces_StartWorkspaces_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `start-workspaces`.

**AWS CLI**  
**Para iniciar un AutoStop WorkSpace**  
En el siguiente ejemplo de `start-workspaces`, se reinicia el WorkSpace especificado. El WorkSpace debe tener un modo de ejecución `AutoStop`.  

```
aws workspaces start-workspaces \
    --start-workspace-requests WorkspaceId=ws-dk1xzr417
```
Salida:  

```
{
    "FailedRequests": []
}
```
Para obtener más información, consulte [Stop and start an AutoStop WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/running-mode.html#stop-start-workspace) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [StartWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/start-workspaces.html) en la *Referencia de comandos de la AWS CLI*. 

### `stop-workspaces`
<a name="workspaces_StopWorkspaces_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `stop-workspaces`.

**AWS CLI**  
**Para detener un AutoStop WorkSpace**  
En el siguiente ejemplo de `stop-workspaces`, se detiene el WorkSpace especificado. El WorkSpace debe tener un modo de ejecución `AutoStop`.  

```
aws workspaces stop-workspaces \
    --stop-workspace-requests WorkspaceId=ws-dk1xzr417
```
Salida:  

```
{
    "FailedRequests": []
}
```
Para obtener más información, consulte [Stop and start an AutoStop WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/running-mode.html#stop-start-workspace) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [StopWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/stop-workspaces.html) en la *Referencia de comandos de la AWS CLI*. 

### `terminate-workspaces`
<a name="workspaces_TerminateWorkspaces_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `terminate-workspaces`.

**AWS CLI**  
**Para terminar un WorkSpace**  
En el siguiente ejemplo de `terminate-workspaces`, finaliza el WorkSpace especificado.  

```
aws workspaces terminate-workspaces \
    --terminate-workspace-requests ws-dk1xzr417
```
Salida:  

```
{
    "FailedRequests": []
}
```
Para obtener más información, consulte [Delete a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/delete-workspaces.html) en la *Guía de administración de Amazon WorkSpaces*.  
+  Para obtener información sobre la API, consulte [TerminateWorkspaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workspaces/terminate-workspaces.html) en la *Referencia de comandos de la AWS CLI*. 