类:Mongo::Crypt::KMS::AWS::MasterKeyDocument Private

继承:
对象
  • 对象
显示全部
包括:
验证
定义于:
build/Ruby-driver-v2.19/lib/ mongo /crypt/ KMS / Amazon Web Services /master_document.rb

Overview

此类是私有 API 的一部分。 应尽可能避免使用此类,因为它将来可能会被删除或更改。

Amazon Web Services KMS主密钥文档对象包含KMS主密钥参数。

常量摘要折叠

FORMAT_HINT =

此常量是私有 API 的一部分。 应尽可能避免使用此常量,因为它将来可能会被删除或更改。

" Amazon Web Services密钥文档必须采用以下格式: " +
"{ region: 'REGION', key: 'KEY' }"

实例属性摘要折叠

实例方法摘要折叠

验证中包含的方法

#validate_param , validate_tls_options

构造函数详情

#initialize (opts) ⇒ MasterKeyDocument

此方法是私有 API 的一部分。 您应尽可能避免使用此方法,因为它将来可能会被删除或更改。

从参数哈希创建主密钥文档对象。

参数:

  • opts (哈希)

    包含Amazon Web Services KMS提供程序的主密钥选项的哈希值。

选项哈希 ( opts ):

  • :地区 string

    Amazon Web Services地区。

  • :key string

    Amazon Web Services KMS密钥。

  • :endpoint ( string | nil )

    Amazon Web Services KMS端点,可选。

引发:

  • ( ArgumentError )

    如果所需选项缺失或不正确。



49
50
51
52
53
54
55
56
57
58
# File ' 构建/ruby-driver-v2.19/lib/ mongo /crypt/ KMS / Amazon Web Services /master_document.rb', 第49行

def 初始化(opts)
  除非 opts.is_a?(哈希)
    提高 ArgumentError.new(
      '密钥文档选项必须包含名为 :master_key 且具有哈希值的密钥'
    )
  end
  地区 = validate_param(:地区, opts, FORMAT_HINT)
  @key = validate_param(:key, opts, FORMAT_HINT)
  @endpoint = validate_param(:endpoint, opts, FORMAT_HINT, 必需: false)
end

实例属性详细信息

#端点string | nil (只读)

此方法是私有 API 的一部分。 您应尽可能避免使用此方法,因为它将来可能会被删除或更改。

返回Amazon Web Services KMS端点。

返回:

  • ( string | nil )

    Amazon Web Services KMS端点。



35
36
37
# File ' 构建/ruby-driver-v2.19/lib/ mongo /crypt/ KMS / Amazon Web Services /master_document.rb', 第35行

def 端点
  @endpoint
end

# keystring (readonly)

此方法是私有 API 的一部分。 您应尽可能避免使用此方法,因为它将来可能会被删除或更改。

返回Amazon Web Services KMS密钥。

返回:

  • ( string )

    Amazon Web Services KMS密钥。



32
33
34
# File ' 构建/ruby-driver-v2.19/lib/ mongo /crypt/ KMS / Amazon Web Services /master_document.rb', 第32行

def key
  @key
end

# 地区string (readonly)

此方法是私有 API 的一部分。 您应尽可能避免使用此方法,因为它将来可能会被删除或更改。

返回Amazon Web Services区域。

返回:

  • ( string )

    Amazon Web Services地区。



29
30
31
# File ' 构建/ruby-driver-v2.19/lib/ mongo /crypt/ KMS / Amazon Web Services /master_document.rb', 第29行

def 区域
  地区
end

实例方法详细信息

# to_documentBSON::Document

此方法是私有 API 的一部分。 您应尽可能避免使用此方法,因为它将来可能会被删除或更改。

将主密钥文档对象转换为 libmongocrypt 格式的 BSON 文档。

返回:

  • ( BSON::Document )

    libmongocrypt 格式的Amazon Web Services KMS主密钥文档。



63
64
65
66
67
68
69
70
71
72
73
# File ' 构建/ruby-driver-v2.19/lib/ mongo /crypt/ KMS / Amazon Web Services /master_document.rb', 第63行

def to_document
  BSON::文档.new({
    提供商: 'aws',
    区域: 区域,
    键: key,
  }).点击 do |bson|
    除非 端点.nil?
      bson.update({ 端点: 端点 })
    end
  end
end