> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Aprende a excluir recursos de la gestión al usar Auth0 Deploy CLI.

# Excluir recursos de la gestión

En algunos casos, puede ser útil excluir ciertos recursos de la gestión. Esto puede deberse a que su inquilino contiene una gran cantidad de un tipo de recurso concreto y gestionarlos supone una carga operativa, o a que su flujo de trabajo de desarrollo solo se aplica a un subconjunto específico de recursos y prefiere omitir el resto para mejorar el rendimiento. En cualquier caso, al usar Deploy CLI dispone de varias opciones para excluir recursos.

<div id="exclude-entire-resources-by-type">
  ## Excluir recursos completos por tipo
</div>

En inquilinos más complejos, es posible que quiera omitir tipos de recursos completos. Por ejemplo:

* Inquilino empresarial con miles de organizaciones, donde gestionarlas todas supondría una carga operativa.
* El proceso de CI/CD solo se centra en gestionar roles y quiere excluir todos los demás.
* El desarrollo de funcionalidades se refiere a un hook y quiere excluir temporalmente todos los demás para optimizar el rendimiento.

Este tipo de exclusión se expresa pasando un array de nombres de recursos a cualquiera de las propiedades de configuración `AUTH0_EXCLUDED` o `AUTH0_INCLUDED_ONLY`. La propiedad de configuración `AUTH0_EXCLUDED` excluye únicamente los tipos de recursos que se le proporcionan. A la inversa, la propiedad `AUTH0_INCLUDED_ONLY` excluye todos los tipos de recursos excepto los definidos. La exclusión funciona en ambos sentidos; es decir, tanto al exportar desde Auth0 como al importar a Auth0, independientemente de si existen o no archivos de configuración de recursos.

Todos los valores de recursos compatibles con la exclusión: `actions`, `attackProtection`, `branding`, `clientGrants`, `clients`, `connections`, `customDomains`, `databases`, `emailProvider`, `emailTemplates`, `guardianFactorProviders`, `guardianFactorTemplates`, `guardianFactors`, `guardianPhoneFactorMessageTypes`, `guardianPhoneFactorSelectedProvider`, `guardianPolicies`, `logStreams`, `migrations`, `organizations`, `pages`, `prompts`, `resourceServers`, `roles`, `tenant`, `triggers`.

<div id="exclusion-example">
  ### Ejemplo de exclusión
</div>

El siguiente ejemplo muestra cómo excluir `clients`, `connections`, `databases` y `organizations` para que no los gestione Deploy CLI.

```json lines theme={null}
{
  "AUTH0_DOMAIN": "example-site.us.auth0.com",
  "AUTH0_CLIENT_ID": "<YOUR_AUTH0_CLIENT_ID>",
  "AUTH0_EXCLUDED": ["clients", "connections", "databases", "organizations"]
}
```

<div id="inclusion-example">
  ### Ejemplo de inclusión
</div>

En el siguiente ejemplo se muestra cómo especificar que solo se administren `actions`, `clients` y `connections` con Deploy CLI.

```json lines theme={null}
{
  "AUTH0_DOMAIN": "example-site.us.auth0.com",
  "AUTH0_CLIENT_ID": "<YOUR_AUTH0_CLIENT_ID>",
  "AUTH0_INCLUDED_ONLY": ["actions", "clients", "connections"]
}
```

<div id="exclude-single-resources-by-id">
  ## Excluir recursos individuales por ID
</div>

Algunos tipos de recursos permiten excluir recursos individuales por ID. Esto resulta útil si trabaja en un contexto con varios entornos y desea omitir de los entornos de nivel inferior un recurso específico de producción.

Este método es compatible con Rules, clientes, bases de datos, conexiones y <Tooltip tip="Servidor de recursos: servidor que aloja recursos protegidos. Los servidores de recursos aceptan y responden a solicitudes de recursos protegidos." cta="Ver glosario" href="/es/docs/glossary?term=resource+servers">servidores de recursos</Tooltip> mediante los valores de configuración `AUTH0_EXCLUDED_RULES`, `AUTH0_EXCLUDED_CLIENTS`, `AUTH0_EXCLUDED_DATABASES`, `AUTH0_EXCLUDED_CONNECTIONS` y `AUTH0_EXCLUDED_RESOURCE_SERVERS`, respectivamente.

### Ejemplo

```json lines theme={null}
{
  "AUTH0_DOMAIN": "example-site.us.auth0.com",
  "AUTH0_CLIENT_ID": "<YOUR_AUTH0_CLIENT_ID>",
  "AUTH0_EXCLUDED_CLIENTS": ["Your Application Name"],
  "AUTH0_EXCLUDED_CONNECTIONS": ["con_O1H3KyRMFP1IWRq3", "con_9avEYuj19ihqKBOs"]
}
```

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Se está considerando retirar la compatibilidad con la exclusión de recursos por ID en futuras versiones principales. Consulta la [propuesta de exclusión de recursos](https://github.com/auth0/auth0-deploy-cli/blob/6381ce6efa8cd59e7a5c8d37e8915b0989d677b9/docs/excluding-from-management.md?plain=1#L51) para obtener más información.
</Callout>

<div id="omission-and-empty-states">
  ## Omisión y estados vacíos
</div>

Además de excluir recursos, que hacen que las configuraciones se ignoren de forma forzada en ambos sentidos, Auth0 Deploy  CLI admite dos conceptos similares: omisión y estados vacíos.

<div id="omission">
  ### Omisión
</div>

La configuración de recursos que no esté presente, ya sea de forma intencional o involuntaria, se omitirá durante la importación. Por ejemplo, si se eliminara la configuración de un recurso, se omitiría durante la importación y no alteraría el estado del inquilino remoto.

No existe el concepto de omisión en la exportación. A menos que se excluyan explícitamente, todas las configuraciones de su inquilino se escribirán en archivos de configuración de recursos.

<div id="example">
  #### Ejemplo
</div>

```yaml lines theme={null}
roles: # la configuración de roles no se omite
  - name: Admin
    description: Can read and write things
    permissions: []
  - name: Reader
    description: Can only read things
    permissions: []
# La omisión del resto de configuraciones implica que serán ignoradas
```

<div id="empty">
  ### Vacío
</div>

Configuración de recursos definida explícitamente como vacía. En configuraciones basadas en conjuntos, como Hooks, organizaciones y Actions, establecer estas configuraciones como un conjunto vacío expresa la intención de vaciar esos recursos. Esto indicaría una eliminación, siempre que la propiedad de configuración de eliminación AUTH0\_ALLOW\_DELETE esté habilitada. Para obtener más información sobre esta propiedad, consulta [Configurar Deploy CLI](/es/docs/deploy-monitor/deploy-cli-tool/configure-the-deploy-cli).

En las configuraciones de recursos no basadas en conjuntos, como inquilino y marca, el concepto de vacío no se aplica y no activará ninguna eliminación ni retirada.

<div id="example-of-emptiness">
  #### Ejemplo de estado vacío
</div>

```yaml lines theme={null}
hooks: [] # Hooks vacíos
connections: [] # Conexiones vacías
tenant: {} # Efectivamente un no-op, el estado vacío no aplica a la configuración de recursos no definidos
```
