KeyClient class

创建 KeyClient 的实例。

示例用法：

import { KeyClient } from "@azure/keyvault-keys";
import { DefaultAzureCredential } from "@azure/identity";

let vaultUrl = `https://<MY KEYVAULT HERE>.vault.azure.net`;
let credentials = new DefaultAzureCredential();

let client = new KeyClient(vaultUrl, credentials);

new KeyClient(vaultUrl: string, credential: TokenCredential, pipelineOptions?: KeyClientOptions)

参数

保管库的基 URL

vaultUrl: string

属性值

请求将指定密钥的备份下载到客户端。 将下载密钥的所有版本。 此作需要密钥/备份权限。

示例用法：

let client = new KeyClient(url, credentials);
let backupContents = await client.backupKey("MyKey");

备份指定的键。

function backupKey(name: string, options?: BackupKeyOptions): Promise<undefined | Uint8Array>

参数

返回

删除作适用于 Azure Key Vault 中存储的任何密钥。 无法删除单个版本的密钥，只能同时删除给定密钥的所有版本。

此函数返回一个长时间运行的作轮询程序，该轮询程序允许无限期等待，直到删除密钥。

此作需要密钥/删除权限。

示例用法：

const client = new KeyClient(url, credentials);
await client.createKey("MyKey", "EC");
const poller = await client.beginDeleteKey("MyKey");

// Serializing the poller
const serialized = poller.toString();
// A new poller can be created with:
// await client.beginDeleteKey("MyKey", { resumeFrom: serialized });

// Waiting until it's done
const deletedKey = await poller.pollUntilDone();
console.log(deletedKey);

从指定的密钥保管库中删除密钥。

function beginDeleteKey(name: string, options?: BeginDeleteKeyOptions): Promise<PollerLike<PollOperationState<DeletedKey>, DeletedKey>>

参数

返回

恢复指定保管库中已删除的密钥。 此作只能在启用软删除的保管库上执行。

此函数返回一个长时间运行的作轮询程序，该轮询程序允许无限期等待，直到恢复已删除的密钥。

此作需要密钥/恢复权限。

示例用法：

const client = new KeyClient(url, credentials);
await client.createKey("MyKey", "EC");
const deletePoller = await client.beginDeleteKey("MyKey");
await deletePoller.pollUntilDone();
const poller = await client.beginRecoverDeletedKey("MyKey");

// Serializing the poller
const serialized = poller.toString();
// A new poller can be created with:
// await client.beginRecoverDeletedKey("MyKey", { resumeFrom: serialized });

// Waiting until it's done
const key = await poller.pollUntilDone();
console.log(key);

将已删除的密钥恢复到最新版本。

function beginRecoverDeletedKey(name: string, options?: BeginRecoverDeletedKeyOptions): Promise<PollerLike<PollOperationState<DeletedKey>, DeletedKey>>

参数

返回

createEcKey 方法在 Azure Key Vault 中创建新的椭圆曲线密钥。 如果已存在命名密钥，Azure Key Vault 将创建密钥的新版本。 它需要密钥/创建权限。

示例用法：

let client = new KeyClient(url, credentials);
let result = await client.createEcKey("MyKey", { curve: "P-256" });

创建一个新密钥，将其存储，然后将密钥参数和属性返回到客户端。

function createEcKey(name: string, options?: CreateEcKeyOptions): Promise<KeyVaultKey>

参数

返回

创建密钥作可用于在 Azure Key Vault 中创建任何密钥类型。 如果已存在命名密钥，Azure Key Vault 将创建密钥的新版本。 它需要密钥/创建权限。

示例用法：

let client = new KeyClient(url, credentials);
// Create an elliptic-curve key:
let result = await client.createKey("MyKey", "EC");

创建一个新密钥，将其存储，然后将密钥参数和属性返回到客户端。

function createKey(name: string, keyType: string, options?: CreateKeyOptions): Promise<KeyVaultKey>

参数

返回

createOctKey 方法在 Azure Key Vault 中创建新的 OCT 密钥。 如果已存在命名密钥，Azure Key Vault 将创建密钥的新版本。 它需要密钥/创建权限。

示例用法：

let client = new KeyClient(url, credentials);
let result = await client.createOctKey("MyKey", { hsm: true });

创建一个新密钥，将其存储，然后将密钥参数和属性返回到客户端。

function createOctKey(name: string, options?: CreateOctKeyOptions): Promise<KeyVaultKey>

参数

返回

createRSAKey 方法在 Azure Key Vault 中创建新的 RSA 密钥。 如果已存在命名密钥，Azure Key Vault 将创建密钥的新版本。 它需要密钥/创建权限。

示例用法：

let client = new KeyClient(url, credentials);
let result = await client.createRsaKey("MyKey", { keySize: 2048 });

创建一个新密钥，将其存储，然后将密钥参数和属性返回到客户端。

function createRsaKey(name: string, options?: CreateRsaKeyOptions): Promise<KeyVaultKey>

参数

返回

获取给定密钥的 CryptographyClient。

示例用法：

let client = new KeyClient(url, credentials);
// get a cryptography client for a given key
let cryptographyClient = client.getCryptographyClient("MyKey");

function getCryptographyClient(keyName: string, options?: GetCryptographyClientOptions): CryptographyClient

参数

返回

• CryptographyClient 使用与此 keyClient 相同的选项、凭据和 http 客户端

getDeletedKey 方法返回指定的已删除键及其属性。 此作需要密钥/获取权限。

示例用法：

let client = new KeyClient(url, credentials);
let key = await client.getDeletedKey("MyDeletedKey");

获取指定的已删除密钥。

function getDeletedKey(name: string, options?: GetDeletedKeyOptions): Promise<DeletedKey>

参数

返回

getKey 方法获取指定的密钥，适用于 Azure Key Vault 中存储的任何密钥。 此作需要密钥/获取权限。

示例用法：

let client = new KeyClient(url, credentials);
let key = await client.getKey("MyKey");

从给定的密钥保管库中获取指定的密钥。

function getKey(name: string, options?: GetKeyOptions): Promise<KeyVaultKey>

参数

返回

获取 Key Vault 密钥的轮换策略。 默认情况下，所有密钥都有一个策略，该策略将在到期前 30 天通知。

此作需要密钥/获取权限。 示例用法：

let client = new KeyClient(vaultUrl, credentials);
let result = await client.getKeyRotationPolicy("myKey");

function getKeyRotationPolicy(keyName: string, options?: GetKeyRotationPolicyOptions): Promise<KeyRotationPolicy>

参数

返回

获取从托管 HSM 获取包含随机值的请求字节数。 此作需要 managedHsm/rng 权限。

示例用法：

let client = new KeyClient(vaultUrl, credentials);
let { bytes } = await client.getRandomBytes(10);

function getRandomBytes(count: number, options?: GetRandomBytesOptions): Promise<Uint8Array>

参数

返回

导入密钥作可用于将任何密钥类型导入 Azure Key Vault。 如果已存在命名密钥，Azure Key Vault 将创建密钥的新版本。 此作需要密钥/导入权限。

示例用法：

let client = new KeyClient(url, credentials);
// Key contents in myKeyContents
let result = await client.importKey("MyKey", myKeyContents);

导入外部创建的密钥、存储密钥，并将密钥参数和属性返回到客户端。

function importKey(name: string, key: JsonWebKey, options?: ImportKeyOptions): Promise<KeyVaultKey>

参数

返回

循环访问保管库中已删除的密钥。 响应中提供了完整的密钥标识符和属性。 不会为键返回任何值。 此作需要密钥/列表权限。

示例用法：

let client = new KeyClient(url, credentials);
for await (const deletedKey of client.listDeletedKeys()) {
  console.log("deleted key: ", deletedKey);
}

列出保管库中的所有密钥

function listDeletedKeys(options?: ListDeletedKeysOptions): PagedAsyncIterableIterator<DeletedKey, DeletedKey[], PageSettings>

参数

返回

循环访问保管库中所有密钥的最新版本。 响应中提供了完整的密钥标识符和属性。 不会为键返回任何值。 此作需要密钥/列表权限。

示例用法：

let client = new KeyClient(url, credentials);
for await (const keyProperties of client.listPropertiesOfKeys()) {
  const key = await client.getKey(keyProperties.name);
  console.log("key: ", key);
}

列出保管库中的所有密钥

function listPropertiesOfKeys(options?: ListPropertiesOfKeysOptions): PagedAsyncIterableIterator<KeyProperties, KeyProperties[], PageSettings>

参数

返回

循环访问保管库中给定密钥的所有版本。 响应中提供了完整的密钥标识符、属性和标记。 此作需要密钥/列表权限。

示例用法：

let client = new KeyClient(url, credentials);
for await (const keyProperties of client.listPropertiesOfKeyVersions("MyKey")) {
  const key = await client.getKey(keyProperties.name);
  console.log("key version: ", key);
}

function listPropertiesOfKeyVersions(name: string, options?: ListPropertiesOfKeyVersionsOptions): PagedAsyncIterableIterator<KeyProperties, KeyProperties[], PageSettings>

参数

返回

清除删除的密钥作会永久删除密钥，且无法恢复。 只能在启用软删除的保管库上启用此作。 此作需要密钥/清除权限。

示例用法：

const client = new KeyClient(url, credentials);
const deletePoller = await client.beginDeleteKey("MyKey")
await deletePoller.pollUntilDone();
await client.purgeDeletedKey("MyKey");

永久删除指定的键。

function purgeDeletedKey(name: string, options?: PurgeDeletedKeyOptions): Promise<void>

参数

返回

从托管 HSM 释放密钥。

发布密钥作适用于所有密钥类型。 该作要求将密钥标记为可导出，以及密钥/释放权限。

示例用法：

let client = new KeyClient(vaultUrl, credentials);
let result = await client.releaseKey("myKey", target)

function releaseKey(name: string, targetAttestationToken: string, options?: ReleaseKeyOptions): Promise<ReleaseKeyResult>

参数

返回

将备份的密钥及其所有版本还原到保管库。 此作需要密钥/还原权限。

示例用法：

let client = new KeyClient(url, credentials);
let backupContents = await client.backupKey("MyKey");
// ...
let key = await client.restoreKeyBackup(backupContents);

将备份的密钥还原到保管库。

function restoreKeyBackup(backup: Uint8Array, options?: RestoreKeyBackupOptions): Promise<KeyVaultKey>

参数

返回

通过生成密钥的新版本来根据密钥策略轮换密钥。 此作需要密钥/轮换权限。

示例用法：

let client = new KeyClient(vaultUrl, credentials);
let key = await client.rotateKey("MyKey");

function rotateKey(name: string, options?: RotateKeyOptions): Promise<KeyVaultKey>

参数

返回

updateKeyProperties 方法更改现有存储密钥的指定属性。 未在请求中指定的属性保持不变。 无法更改键本身的值。 此作需要密钥/设置权限。

示例用法：

let keyName = "MyKey";
let client = new KeyClient(vaultUrl, credentials);
let key = await client.getKey(keyName);
let result = await client.updateKeyProperties(keyName, key.properties.version, { enabled: false });

更新与给定密钥保管库中的指定密钥关联的属性。

function updateKeyProperties(name: string, keyVersion: string, options?: UpdateKeyPropertiesOptions): Promise<KeyVaultKey>

参数

返回

updateKeyProperties 方法更改现有存储密钥的最新版本的指定属性。 未在请求中指定的属性保持不变。 无法更改键本身的值。 此作需要密钥/设置权限。

示例用法：

let keyName = "MyKey";
let client = new KeyClient(vaultUrl, credentials);
let key = await client.getKey(keyName);
let result = await client.updateKeyProperties(keyName, { enabled: false });

更新与给定密钥保管库中的指定密钥关联的属性。

function updateKeyProperties(name: string, options?: UpdateKeyPropertiesOptions): Promise<KeyVaultKey>

参数

返回

更新 Key Vault 密钥的轮换策略。 此作需要密钥/更新权限。

示例用法：

let client = new KeyClient(vaultUrl, credentials);
const setPolicy = await client.updateKeyRotationPolicy("MyKey", myPolicy);

function updateKeyRotationPolicy(keyName: string, policy: KeyRotationPolicyProperties, options?: UpdateKeyRotationPolicyOptions): Promise<KeyRotationPolicy>

参数

返回