Añade un nombre alternativo a un documento de clave

# MongoDB\Driver\ClientEncryption::addKeyAltName

(mongodb >=1.15.0)

MongoDB\Driver\ClientEncryption::addKeyAltName — Añade un nombre alternativo a un documento de clave

### Descripción

final public function MongoDB\Driver\ClientEncryption::addKeyAltName(MongoDB\BSON\Binary `$keyId`, string `$keyAltName`): ?object

Añade `keyAltName` al conjunto de nombres alternativos para el documento de clave con el UUID dado `keyId`.

### Parámetros

`keyId`
  Una instancia de MongoDB\BSON\Binary con subtipo 4 (UUID) que identifica el documento de clave.
`keyAltName`
  Nombre alternativo que se añadirá al documento de clave.

### Valores devueltos

Devuelve la versión anterior del documento de clave, o `null` si no se encontró ningún documento coincidente.

### Errores/Excepciones

- Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.
- Lanza una excepción MongoDB\Driver\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación
- Lanza una excepción MongoDB\Driver\AuthenticationException si se requiere una identificación pero falla
- Lanza MongoDB\Driver\Exception\RuntimeException en caso de otros errores.

### Ver también

- MongoDB\Driver\ClientEncryption::getKeyByAltName() - Obtiene un documento de clave por un nombre alternativo
- MongoDB\Driver\ClientEncryption::removeKeyAltName() - Elimina un nombre alternativo de un documento de clave

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open