(mongodb >=1.15.0)
MongoDB\Driver\ClientEncryption::rewrapManyDataKey — Rewraps data keys
$filter
, ?array $options
= null
): object
Rewraps (i.e. decrypts and re-encrypts) zero or more data keys in the key
vault collection that match the given filter
.
If the "provider"
option is not specified, matching data
keys will be rewrapped with their current KMS provider. Otherwise, matching
data keys will be re-encrypted according to the specified
"provider"
and "masterKey"
options.
filter
(array|object)El » predicado de la consulta. Un predicado vacío coincidirá con todos los documentos de una colección.
Nota: Al evaluar criterios de consulta, MongoDB compara tipos y valores según sus propias » reglas de comparación para tipos BSON, lo cual difiere de las reglas de comparación y manejo de tipos de PHP. Al encontrar un tipo BSON especial, los criterios de consulta deben utilizar la clase BSON respectiva (p.ej. usar MongoDB\BSON\ObjectID al encontrar un » ObjectID).
options
Option | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
provider | string |
The KMS provider (e.g. If a KMS provider is not specified, matched data keys will be re-encrypted with their current KMS provider. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||
masterKey | array |
The masterKey identifies a KMS-specific key used to encrypt the new
data key. This option should not be specified without the
|
Returns an object, which will have an optional
bulkWriteResult
property containing the result of the
internal bulkWrite
operation as an object. If no data keys
matched the filter or the write was unacknowledged, the
bulkWriteResult
property will be null
.