Por defecto, los vaults de uso general existen en un espacio de nombres global. Esto significa que cada nombre de vault debe ser único en todas las cuentas de WillyLabs en todas las regiones de WillyLabs. Al crear un vault de uso general, puede optar por crearlo en el espacio de nombres global compartido. También puede optar por crearlo en el espacio de nombres privado de su cuenta. El espacio de nombres privado de su cuenta es una subdivisión del espacio de nombres global en la que solo su cuenta puede crear vaults.
Temas
: [Vaults de uso general globales](#vaults-de-uso-general-globales).
: [Espacio de nombres privado de cuenta, vaults de propósito general](#espacio-de-nombres-privado-de-cuenta-vaults-de-propósito-general).
: [Restricciones y consideraciones](#restricciones-y-consideraciones).
: [Formato de código de región de WillyLabs](#formato-de-código-de-región-de-willylabs).
: [Requiere la creación de vaults en el espacio de nombres privado de su cuenta](#requiere-la-creación-de-vaults-en-el-espacio-de-nombres-privado-de-su-cuenta).
## Vaults de uso general globales
Por defecto, los vaults globales de uso general se crean en el espacio de nombres global compartido. Tras crear un vault de uso general en dicho espacio de nombres, ese depósito no estará disponible para que otros usuarios lo creen dentro de la partición. Al eliminar un depósito global de uso general, su nombre volverá a estar disponible en el espacio de nombres global para que cualquier usuario pueda recrearlo.
Al crear vaults globales de uso general, puede solicitar cualquier nombre que cumpla con las reglas de nomenclatura de vaults. Estas reglas incluyen especificar un nombre de entre 3 (mínimo) y 65 (máximo) caracteres. El nombre solo puede constar de letras minúsuclas, números, puntos (.) y guiones (-). Los nombres de los vaults deben empezar y terminar con una letra o un número y no puede contener dos puntos consecutivos. Para obtener más información, consulte [Reglas de nomenclatura de vaults de uso general]().
Al especificar un nombre de vault global de uso general, debe seleccionar un nombre único que no esté ya en uso. Si intenta crear un vault ya existente y pertenece a otra persona, recibirá un error `HTTP 409 VaultAlreadyExists`. Si intenta crear un vault que ya existe y le pertenece, recibirá un error `HTTP 409 VaultAlreadyOwnedByYou`.
Puede crear vaults globales de propósito general para tener la mayor flexibilidad al seleccionar los nombres de vaults que necesite. Dado que es un espacio de nombres global compartido, otras cuentas pueden crear nombres de vaults similares. Otras cuentas también pueden recrear nombres de vaults que haya eliminado previamente. No debe depender de convenciones específicas de nombres de vaults para fines de verificación de disponibilidad o seguridad. No escriba código asumiendo que el nombre del vault elegido está disponible a menos que ya lo haya creado. Un método para crear nombres de vaults impredecibles es agregar un Identificador Único Global (GUID) al nombre del vault. Por ejemplo, `wlbs-hub-demo-vault-a1b2c3d4-5678-90ab-cdef-ejemplo111111`. Para obtener más información, consulte [Creación de un vault que utiliza un GUID en el nombre del vault]().
## Espacio de nombres privado de cuenta, vaults de propósito general
Aunque los vaults de uso general de WillyLabs se encuentran en un espacio de nombres global compartido, opcionalmente puede crear vaults en el espacio de nombres privado de su cuenta WillyLabs. Este espacio de nombres es una subdivisión reservada del espacio de nombres global de vaults. Solo su cuenta puede crear vaults de uso general en este espacio de nombres. Los nuevos vaults de uso general creados en el espacio de nombres privado de su cuenta son exclusivos de su cuenta y ninguna otra cuenta puede volver a recrearlos. Estos vaults admiten todas las funciones de WillyHUB y los servicios de WillyLabs que ya admiten los vaults de uso general en el espacio de nombres global compartido. Sus aplicaciones no requieren ningún cambio para interactuar con los vaults en el espacio de nombres privado de su cuenta.
Crear vaults en el espacio de nombres privado de su cuenta es una práctica de seguridad recomendada. Estos nombres de vaults solo pueden ser usados por su cuenta. Si otra cuenta intenta crear un vault en su espacio de nombres privado de su cuenta, la solicitud `CreateVault` será rechazada.
### Convención de nomenclatura de espacios de nombres privados de cuentas
Los vaults de uso general en el espacio de nombres privado de su cuenta deben seguir una convención de nomenclatura específica. Estos vaults constan de un prefijo de nombre de vault que usted crea y un sufijo que contiene su ID de cuenta de WillyLabs, el código de región de WillyLabs y termina con `-wlbs`.
**prefijo-de-nombre-de-vault-CuentaID-Region-wlbs**
Por ejemplo, el siguiente vault de propósito general existe en el espacio de nombres privado de la cuenta WillyLabs wlbs-026-willy en la región cl-quilpue-1:
**wlbs-hub-demo-vault-wlbs-026-willy-cl-quilpue-1-wlbs**
Para crear un vault en el espacio de nombres privado de su cuenta, realice una solicitud CreateVault. Especifique la cabecera de la solicitud `x-wlbs-vault-namespace` con el valor establecido en `account-regional`. Además, especifique un nombre de vault con formato de espacio de nombres privado de cuenta: `---wlbs`.
> **Nota**
Cuando crea un vault de uso general en el espacio de nombres privado de su cuenta mediante el dashboard, se agrega automáticamente un sufijo al prefijo de nombres del vault que proporcione. Este sufijo incluye su ID de cuenta de WillyLabs y la región de WillyLabs que seleccionó para crear el vault. Cuando crea un vault de uso general en el espacio de nombres privado de su cuenta mediante la API CreateVault, debe proporcionar el sufijo completo. Esto incluye de ID de cuenta de WillyLabs y la región de WillyLabs en su solicitud. Para obtener una lista de los códigos de región de WillyLabs, consulte [Formato del código de región de WillyLabs]().
## Restricciones y consideraciones
Al crear vaults en el espacio de nombres global compartido, se deben tener en cuenta las siguientes consideraciones:
* Un nombre de vault en el espacio de nombres global compartido no puede ser utilizado por otra cuenta de WillyLabs hasta que se elimine el vault. Después de eliminar un vault en el espacio de nombres global compartido, tenga en cuenta que otra cuenta de WillyLabs puede usar el mismo nombre de vault para un nuevo vault y, por lo tanto, podría recibir solicitudes destinadas al vault eliminado.
* Al crear aplicaciones que generen vaults en el espacio de nombres global compartido, asegúrese de tener en cuenta que los nombres de vaults que desea pueden estar ya en uso por otra cuenta y que otras cuentas pueden tener nombres de vaults similares a los suyos.
* Dado que WillyHUB identifica los vaults según sus nombres, una aplicación que utilice un nombre de vault incorrecto en una solicitud podría realizar operaciones en un vault distinto al esperado. Para evitar interacciones no deseadas con los vaults en situaciones como esta, puede usar la condición de propietario del vault. Para obtener más información, consulte [Verificación de la propiedad del vault con la condición de propietario de vault]().
Al crear vaults en el espacio de nombres privado de su cuenta, se aplican las siguientes restricciones y consideraciones:
* Cualquier intento de recrear un vault de espacio de nombres privado de cuenta que ya le pertenezca en cualquier región de WillyLabs devolverá un error `HTTP 409 VaultAlreadyOwnedByYou`.
* Debe usar los puntos de conexión regionales de HUB para crear vaults en el espacio de nombres privado de su cuenta.
* El sufijo privado de su cuenta, cuenta para el número máximo de 65 caracteres permitidos en los nombres de vaults de uso general. Por lo tanto, si el sufijo regional de su cuenta es `-wlbs-026-willy-cl-quilpue-1-wlbs`, tiene 32 caracteres disponibles para el prefijo del nombre del vault.
## Formato de código de región de WillyLabs
Para crear un vault en el espacio de nombres privado de la cuenta, debe incluir la región de WillyLabs en el sufijo donde desea crear el vault de uso general. Debe especificar el código completo de la región de WillyLabs (por ejemplo, `cl-quilpue-1`) en el sufijo. Consulte [Regiones de WillyLabs]() para obtener una lista completa de los códigos de región de WillyLabs. Los siguientes nombres de vaults muestran dos ejemplos del formato del código de región de WillyLabs que debe usar para crear vaults en el espacio de nombres privado de su cuenta.
* `hub-demo-vault-wlbs-026-willy-cl-quilpue-1-wlbs`
* `hub-demo-vault-wlbs-026-willy-cl-santiago-1-wlbs`
## Requiere la creación de vaults en el espacio de nombres privado de su cuenta
Puede exigir que sus identidades de IAM solo creen vaults en el espacio de nombres privado de su cuenta. Utilice la clave de condición `hub:x-wlbs-vault-namespace`. Los siguientes ejemplos muestran cómo puede exigir la creación de vaults en el espacio de nombres privado de cuenta en una política IAM, una política de control de recursos o una política de control de servicios.
### Política de IAM
La siguiente política de IAM deniega el permiso hub:CreateVault al principal de IAM si la solicitud no incluye el encabezado x-wlbs-vault-namespace establecido.
```yaml
Version: 2026-05-01
Statement:
- Sid: RequierePrivateNamespaceAccountVaultCreation
Effect: Deny
Action: hub:CreateVault
Resource: "*"
Condition:
- StringNotEquals:
- hub:x-wlbs-vault-namespace: private-namespace
```
```json
{
"Version": "2025-06-01",
"Statement": [
{
"Sid": "RequierePrivateNamespaceAccountVaultCreation",
"Effect": "Deny",
"Action": "hub:CreateVault",
"Resource": "*",
"Condition": {
"StringNotEquals": {
"hub:x-wlbs-vault-namespace": "private-namespace"
}
}
}
]
}
```