Obtém um de documento chave com um nome alternativo

# MongoDB\Driver\ClientEncryption::getKeyByAltName

(mongodb >=1.15.0)

MongoDB\Driver\ClientEncryption::getKeyByAltName — Obtém um de documento chave com um nome alternativo

### Descrição

final public function MongoDB\Driver\ClientEncryption::getKeyByAltName(string `$keyAltName`): ?object

Encontra um único documento de chave na coleção do cofre de chaves com o nome alternativo fornecido em `keyAltName`.

### Parâmetros

`keyAltName`
  Nome alternativo para o documento de chave.

### Valor Retornado

Retorna o documento de chave ou `null` se nenhum documento corresponder.

### Erros/Exceções

- Lança uma exceção MongoDB\Driver\Exception\InvalidArgumentException em caso de erro ao analisar argumentos.
- Lança uma exceção MongoDB\Driver\Exception\ConnectionException se a conexão com o servidor falhar (por outros motivos além da autenticação).
- Lança uma exceção MongoDB\Driver\Exception\AuthenticationException se a autenticação for necessária e falhar.
- Lança MongoDB\Driver\Exception\RuntimeException em outros erros.

### Veja Também

- MongoDB\Driver\ClientEncryption::addKeyAltName() - Adiciona um nome alternativo a um documento de chave
- MongoDB\Driver\ClientEncryption::removeKeyAltName() - Remove um nome alternativo de um documento de chave

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