你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.KeyVault 保管库/密钥 2023-02-01

项目
04/20/2024

Bicep 资源定义

保管库/密钥资源类型可以通过针对以下操作进行部署：

资源组 - 请参阅资源组部署命令

有关每个 API 版本中更改的属性的列表，请参阅更改日志。

注解

有关使用密钥保管库获取安全值的指南，请参阅使用 Bicep 管理机密。

有关创建机密的快速入门，请参阅快速入门：使用 ARM 模板从 Azure 密钥保管库设置和检索机密。

有关创建密钥的快速入门，请参阅快速入门：使用 ARM 模板创建 Azure 密钥保管库和密钥。

资源格式

若要创建 Microsoft.KeyVault/vaults/keys 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.KeyVault/vaults/keys@2023-02-01' = {
  name: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    attributes: {
      enabled: bool
      exp: int
      exportable: bool
      nbf: int
    }
    curveName: 'string'
    keyOps: [
      'string'
    ]
    keySize: int
    kty: 'string'
    release_policy: {
      contentType: 'string'
      data: 'string'
    }
    rotationPolicy: {
      attributes: {
        expiryTime: 'string'
      }
      lifetimeActions: [
        {
          action: {
            type: 'string'
          }
          trigger: {
            timeAfterCreate: 'string'
            timeBeforeExpiry: 'string'
          }
        }
      ]
    }
  }
}

属性值

vaults/keys

名称	说明	值
name	资源名称了解如何在 Bicep 中为子资源设置名称和类型。	字符串 (必需)
标记	将分配给密钥的标记。	标记名称和值的字典。请参阅模板中的标记
父级 (parent)	在 Bicep 中，可以为子资源指定父资源。仅当子资源在父资源外部声明时，才需要添加此属性。有关详细信息，请参阅父资源之外的子资源。	类型为资源的符号名称：保管库
properties	要创建的密钥的属性。	需要 KeyProperties ()

KeyProperties

名称	说明	值
attributes	键的属性。	KeyAttributes
curveName	椭圆曲线名称。有关有效值，请参阅 JsonWebKeyCurveName。	“P-256” “P-256K” “P-384” “P-521”
keyOps		包含任意项的字符串数组： “decrypt” “encrypt” “import” “release” “sign” “unwrapKey” “verify” “wrapKey”
keySize	密钥的大小（以位为单位）。例如：RSA 的 2048、3072 或 4096。	int
kty	键的类型。有关有效值，请参阅 JsonWebKeyType。	“EC” “EC-HSM” “RSA” “RSA-HSM”
release_policy	响应中的密钥发布策略。它将用于输出和输入。如果为空，则省略	KeyReleasePolicy
rotationPolicy	响应中的密钥轮换策略。它将用于输出和输入。如果为空，则省略	RotationPolicy

KeyAttributes

名称	说明	值
enabled	确定是否启用对象。	bool
exp	自 1970-01-01T00：00：00Z 起的到期日期（以秒为单位）。	int
出口	指示是否可以导出私钥。	bool
nbf	不早于自 1970-01-01T00：00：00Z 以来的日期（以秒为单位）。	int

KeyReleasePolicy

名称	说明	值
contentType	密钥发布策略的内容类型和版本	string
数据	Blob 编码策略规则，可在其中释放密钥。	字符串

RotationPolicy

名称	说明	值
attributes	密钥轮换策略的属性。	KeyRotationPolicyAttributes
lifetimeActions	密钥轮换操作的 lifetimeActions。	LifetimeAction[]

KeyRotationPolicyAttributes

名称	说明	值
expiryTime	新密钥版本的过期时间。它应采用ISO8601格式。例如：“P90D”、“P1Y”。	字符串

LifetimeAction

名称	说明	值
action	密钥轮换策略 lifetimeAction 的操作。	操作
触发器	密钥轮换策略 lifetimeAction 的触发器。	触发器

操作

名称	说明	Value
type	操作的类型。应不区分大小写地比较该值。	'Notify' 'Rotate'

触发器

名称	说明	值
timeAfterCreate	密钥创建后轮换密钥的持续时间。它仅适用于旋转。它将采用 ISO 8601 持续时间格式。例如：“P90D”、“P1Y”。	字符串
timeBeforeExpiry	密钥过期之前要轮换或通知的持续时间。它将采用 ISO 8601 持续时间格式。例如：“P90D”、“P1Y”。	字符串

快速入门模板

以下快速入门模板部署此资源类型。

模板	说明
在 Azure KeyVault 中创建密钥	此模块允许你在现有 KeyVault 中创建密钥。
使用客户管理的密钥进行 Azure 存储帐户加密	此模板部署一个存储帐户，其中包含客户管理的密钥，用于生成并放置在密钥保管库内的加密。

ARM 模板资源定义

可以使用面向以下操作部署保管库/密钥资源类型：

资源组 - 请参阅资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅更改日志。

注解

有关使用密钥保管库获取安全值的指南，请参阅使用 Bicep 管理机密。

有关创建机密的快速入门，请参阅快速入门：使用 ARM 模板从 Azure 密钥保管库设置和检索机密。

有关创建密钥的快速入门，请参阅快速入门：使用 ARM 模板创建 Azure 密钥保管库和密钥。

资源格式

若要创建 Microsoft.KeyVault/vaults/keys 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.KeyVault/vaults/keys",
  "apiVersion": "2023-02-01",
  "name": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "attributes": {
      "enabled": "bool",
      "exp": "int",
      "exportable": "bool",
      "nbf": "int"
    },
    "curveName": "string",
    "keyOps": [ "string" ],
    "keySize": "int",
    "kty": "string",
    "release_policy": {
      "contentType": "string",
      "data": "string"
    },
    "rotationPolicy": {
      "attributes": {
        "expiryTime": "string"
      },
      "lifetimeActions": [
        {
          "action": {
            "type": "string"
          },
          "trigger": {
            "timeAfterCreate": "string",
            "timeBeforeExpiry": "string"
          }
        }
      ]
    }
  }
}

属性值

vaults/keys

名称	说明	Value
type	资源类型	'Microsoft.KeyVault/vaults/keys'
apiVersion	资源 API 版本	'2023-02-01'
name	资源名称了解如何在 JSON ARM 模板中为子资源设置名称和类型。	字符串 (必需)
标记	将分配给密钥的标记。	标记名称和值的字典。请参阅模板中的标记
properties	要创建的密钥的属性。	需要 KeyProperties ()

KeyProperties

名称	说明	值
attributes	键的属性。	KeyAttributes
curveName	椭圆曲线名称。有关有效值，请参阅 JsonWebKeyCurveName。	“P-256” “P-256K” “P-384” “P-521”
keyOps		包含任意项的字符串数组： “decrypt” “encrypt” “import” “release” “sign” “unwrapKey” “verify” “wrapKey”
keySize	密钥的大小（以位为单位）。例如：RSA 的 2048、3072 或 4096。	int
kty	键的类型。有关有效值，请参阅 JsonWebKeyType。	“EC” “EC-HSM” “RSA” “RSA-HSM”
release_policy	响应中的密钥发布策略。它将用于输出和输入。如果为空，则省略	KeyReleasePolicy
rotationPolicy	响应中的密钥轮换策略。它将用于输出和输入。如果为空，则省略	RotationPolicy

KeyAttributes

名称	说明	值
enabled	确定是否启用对象。	bool
exp	自 1970-01-01T00：00：00Z 以来的到期日期（以秒为单位）。	int
出口	指示是否可以导出私钥。	bool
nbf	自 1970-01-01T00：00：00Z 以来，不早于日期（以秒为单位）。	int

KeyReleasePolicy

名称	说明	值
contentType	密钥发布策略的内容类型和版本	string
数据	Blob 编码可释放密钥所依据的策略规则。	字符串

RotationPolicy

名称	说明	值
attributes	密钥轮换策略的属性。	KeyRotationPolicyAttributes
lifetimeActions	生存期密钥轮换操作。	LifetimeAction[]

KeyRotationPolicyAttributes

名称	说明	值
expiryTime	新密钥版本的过期时间。它应采用ISO8601格式。例如：“P90D”、“P1Y”。	字符串

LifetimeAction

名称	说明	值
action	密钥轮换策略生存期的操作操作。	操作
触发器	密钥轮换策略生存期操作的触发器。	触发器

操作

名称	说明	Value
type	操作的类型。值应不区分大小写地进行比较。	“Notify” “旋转”

触发器

名称	说明	值
timeAfterCreate	密钥创建后轮换密钥的持续时间。它仅适用于旋转。它将采用 ISO 8601 持续时间格式。例如：“P90D”、“P1Y”。	字符串
timeBeforeExpiry	密钥轮换或通知前的持续时间。它将采用 ISO 8601 持续时间格式。例如：“P90D”、“P1Y”。	字符串

快速入门模板

以下快速入门模板部署此资源类型。

模板	说明
在 Azure KeyVault 中创建密钥	此模块允许你在现有 KeyVault 中创建密钥。
使用客户管理的密钥进行 Azure 存储帐户加密	此模板部署一个存储帐户，其中包含客户管理的密钥，用于生成并放置在密钥保管库内的加密。

Terraform (AzAPI 提供程序) 资源定义

保管库/密钥资源类型可以通过针对以下操作进行部署：

资源组

有关每个 API 版本中更改的属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.KeyVault/vaults/keys 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.KeyVault/vaults/keys@2023-02-01"
  name = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      attributes = {
        enabled = bool
        exp = int
        exportable = bool
        nbf = int
      }
      curveName = "string"
      keyOps = [
        "string"
      ]
      keySize = int
      kty = "string"
      release_policy = {
        contentType = "string"
        data = "string"
      }
      rotationPolicy = {
        attributes = {
          expiryTime = "string"
        }
        lifetimeActions = [
          {
            action = {
              type = "string"
            }
            trigger = {
              timeAfterCreate = "string"
              timeBeforeExpiry = "string"
            }
          }
        ]
      }
    }
  })
}

属性值

vaults/keys

名称	说明	Value
type	资源类型	“Microsoft.KeyVault/vaults/keys@2023-02-01”
name	资源名称	字符串 (必需)
parent_id	此资源的父资源 ID。	类型为“保管库”的资源的 ID
标记	将分配给密钥的标记。	标记名称和值的字典。
properties	要创建的密钥的属性。	需要 KeyProperties ()

KeyProperties

名称	说明	值
attributes	键的属性。	KeyAttributes
curveName	椭圆曲线名称。有关有效值，请参阅 JsonWebKeyCurveName。	“P-256” “P-256K” “P-384” “P-521”
keyOps		包含任意项的字符串数组： “decrypt” “encrypt” “import” “release” “sign” “unwrapKey” “verify” “wrapKey”
keySize	密钥的大小（以位为单位）。例如：RSA 的 2048、3072 或 4096。	int
kty	键的类型。有关有效值，请参阅 JsonWebKeyType。	“EC” “EC-HSM” “RSA” “RSA-HSM”
release_policy	响应中的密钥发布策略。它将用于输出和输入。如果为空，则省略	KeyReleasePolicy
rotationPolicy	响应中的密钥轮换策略。它将用于输出和输入。如果为空，则省略	RotationPolicy

KeyAttributes

名称	说明	值
enabled	确定是否启用对象。	bool
exp	自 1970-01-01T00：00：00Z 以来的到期日期（以秒为单位）。	int
出口	指示是否可以导出私钥。	bool
nbf	自 1970-01-01T00：00：00Z 以来，不早于日期（以秒为单位）。	int

KeyReleasePolicy

名称	说明	值
contentType	密钥发布策略的内容类型和版本	string
数据	Blob 编码可释放密钥所依据的策略规则。	字符串

RotationPolicy

名称	说明	值
attributes	密钥轮换策略的属性。	KeyRotationPolicyAttributes
lifetimeActions	生存期密钥轮换操作。	LifetimeAction[]

KeyRotationPolicyAttributes

名称	说明	值
expiryTime	新密钥版本的过期时间。它应采用ISO8601格式。例如：“P90D”、“P1Y”。	字符串

LifetimeAction

名称	说明	值
action	密钥轮换策略生存期的操作操作。	操作
触发器	密钥轮换策略生存期操作的触发器。	触发器

操作

名称	说明	Value
type	操作的类型。值应不区分大小写地进行比较。	“通知” “旋转”

触发器

名称	说明	值
timeAfterCreate	密钥创建后轮换密钥的持续时间。它仅适用于旋转。它将采用 ISO 8601 持续时间格式。例如：“P90D”、“P1Y”。	字符串
timeBeforeExpiry	密钥轮换或通知前的持续时间。它将采用 ISO 8601 持续时间格式。例如：“P90D”、“P1Y”。	字符串

通过

Microsoft.KeyVault 保管库/密钥 2023-02-01

Bicep 资源定义

注解

资源格式

属性值

vaults/keys

KeyProperties

KeyAttributes

KeyReleasePolicy

RotationPolicy

KeyRotationPolicyAttributes

LifetimeAction

操作

触发器

快速入门模板

ARM 模板资源定义

注解

资源格式

属性值

vaults/keys

KeyProperties

KeyAttributes

KeyReleasePolicy

RotationPolicy

KeyRotationPolicyAttributes

LifetimeAction

操作

触发器

快速入门模板

Terraform (AzAPI 提供程序) 资源定义

资源格式

属性值

vaults/keys

KeyProperties

KeyAttributes

KeyReleasePolicy

RotationPolicy

KeyRotationPolicyAttributes

LifetimeAction

操作

触发器

反馈

其他资源