REST Resource: projects.locations.cmekConfigs

资源：CmekConfig

用于通过 Cloud KMS 密钥启用 CMEK 数据加密的配置。

JSON 表示法 
{
  "name": string,
  "kmsKey": string,
  "kmsKeyVersion": string,
  "state": enum (State),
  "isDefault": boolean,
  "lastRotationTimestampMicros": string,
  "singleRegionKeys": [
    {
      object (SingleRegionKey)
    }
  ],
  "notebooklmState": enum (NotebookLMState)
}
字段
name

string

必需。CmekConfig 的名称，格式为 projects/{project}/locations/{location}/cmekConfig 或 projects/{project}/locations/{location}/cmekConfigs/{cmekConfig}。
kmsKey

string

必需。将用于加密资源 projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId} 的 KMS 密钥资源名称。
kmsKeyVersion

string

仅限输出。将用于加密资源 <kmsKey>/cryptoKeyVersions/{keyVersion} 的 KMS 密钥版本资源名称。
state

enum (State)

仅限输出。CmekConfig 的状态。
isDefault

boolean

仅限输出。客户的默认 CmekConfig。
lastRotationTimestampMicros

string (int64 format)

仅限输出。上次密钥轮替的时间戳。
singleRegionKeys[]

object (SingleRegionKey)

可选。某些 VAIS 功能所需的单区域 CMEK。
notebooklmState

enum (NotebookLMState)

仅限输出。NotebookLM 语料库是否已准备就绪，可供使用。

州

CmekConfig 的状态。

枚举
STATE_UNSPECIFIED CmekConfig 状态未知。
CREATING 正在创建 CmekConfig。
ACTIVE CmekConfig 可与 DataStore 搭配使用。
KEY_ISSUE CmekConfig 不可用，很可能是因为 KMS 密钥已被撤消。
DELETING CmekConfig 正在删除。
DELETE_FAILED CmekConfig 删除流程失败。
UNUSABLE CmekConfig 不可用，很可能是由于某些内部问题。
ACTIVE_ROTATING KMS 密钥版本正在轮替。
DELETED KMS 密钥已被软删除。系统最终会应用某种清理政策。
EXPIRED KMS 密钥已过期，这意味着该密钥已停用 30 天以上。客户可以调用 cmekConfigs.delete 将状态更改为 DELETED。

SingleRegionKey

单区域 CMEK 的元数据。

JSON 表示法 
{
  "kmsKey": string
}
字段
kmsKey

string

必需。将用于加密资源 projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId} 的单区域 KMS 密钥资源名称。

NotebookLMState

NotebookLM 的状态。

枚举
NOTEBOOK_LM_STATE_UNSPECIFIED NotebookLM 状态未知。
NOTEBOOK_LM_NOT_READY NotebookLM 尚未准备就绪。
NOTEBOOK_LM_READY NotebookLM 已准备就绪，可以开始使用了。
NOTEBOOK_LM_NOT_ENABLED NotebookLM 未启用。

方法

delete

 取消配置 CmekConfig。

get

 获取 CmekConfig。

list

 列出项目中的所有 CmekConfig。

patch

 为客户项目的某个位置预配 CMEK 密钥。