SecretClient class

SecretClient のインスタンスを作成します。

使用例:

import { SecretClient } from "@azure/keyvault-secrets";
import { DefaultAzureCredential } from "@azure/identity";

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

let client = new SecretClient(vaultUrl, credentials);

new SecretClient(vaultUrl: string, credential: TokenCredential, pipelineOptions?: SecretClientOptions)

パラメーター

コンテナーのベース URL

vaultUrl: string

プロパティ値

指定したシークレットのバックアップをクライアントにダウンロードするように要求します。 シークレットのすべてのバージョンがダウンロードされます。 この操作には、シークレット/バックアップのアクセス許可が必要です。

使用例:

let client = new SecretClient(url, credentials);
let backupResult = await client.backupSecret("MySecretName");

指定したシークレットをバックアップします。

function backupSecret(secretName: string, options?: BackupSecretOptions): Promise<undefined | Uint8Array>

パラメーター

戻り値

Azure Key Vaultに格納されているシークレットを削除します。 この関数は、シークレットが削除されるまで無期限に待機できる実行時間の長い操作ポーリング ャーを返します。

この操作には、シークレット/削除アクセス許可が必要です。

使用例:

const client = new SecretClient(url, credentials);
await client.setSecret("MySecretName", "ABC123");

const deletePoller = await client.beginDeleteSecret("MySecretName");

// Serializing the poller
const serialized = deletePoller.toString();

// A new poller can be created with:
// const newPoller = await client.beginDeleteSecret("MySecretName", { resumeFrom: serialized });

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

指定したキー コンテナーからシークレットを削除します。

function beginDeleteSecret(name: string, options?: BeginDeleteSecretOptions): Promise<PollerLike<PollOperationState<DeletedSecret>, DeletedSecret>>

パラメーター

戻り値

指定したコンテナー内の削除されたシークレットを回復します。 この関数は、シークレットが回復されるまで無期限に待機できる実行時間の長い操作ポーリング ャーを返します。

この操作には、シークレット/回復アクセス許可が必要です。

使用例:

const client = new SecretClient(url, credentials);
await client.setSecret("MySecretName", "ABC123");

const deletePoller = await client.beginDeleteSecret("MySecretName");
await deletePoller.pollUntilDone();

const recoverPoller = await client.beginRecoverDeletedSecret("MySecretName");

// Serializing the poller
const serialized = recoverPoller.toString();

// A new poller can be created with:
// const newPoller = await client.beginRecoverDeletedSecret("MySecretName", { resumeFrom: serialized });

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

削除されたシークレットを最新バージョンに回復します。

function beginRecoverDeletedSecret(name: string, options?: BeginRecoverDeletedSecretOptions): Promise<PollerLike<PollOperationState<SecretProperties>, SecretProperties>>

パラメーター

戻り値

getDeletedSecret メソッドは、指定された削除されたシークレットとその属性を返します。 この操作には、シークレット/取得アクセス許可が必要です。

使用例:

let client = new SecretClient(url, credentials);
await client.getDeletedSecret("MyDeletedSecret");

指定した削除されたシークレットを取得します。

function getDeletedSecret(secretName: string, options?: GetDeletedSecretOptions): Promise<DeletedSecret>

パラメーター

戻り値

getSecret メソッドは、Azure Key Vaultに格納されているすべてのシークレットに適用されます。 この操作には、シークレット/取得アクセス許可が必要です。

使用例:

let client = new SecretClient(url, credentials);
let secret = await client.getSecret("MySecretName");

指定したキー コンテナーから指定されたシークレットを取得します。

function getSecret(secretName: string, options?: GetSecretOptions): Promise<KeyVaultSecret>

パラメーター

戻り値

コンテナー内の削除されたシークレットを反復処理します。 完全なシークレット識別子および属性は応答で提供されます。 シークレットの値は返されません。 この操作には、secrets/list アクセス許可が必要です。

使用例:

let client = new SecretClient(url, credentials);
for await (const deletedSecret of client.listDeletedSecrets()) {
  console.log("deleted secret: ", deletedSecret);
}

コンテナー内のすべてのシークレットを一覧表示します。

function listDeletedSecrets(options?: ListDeletedSecretsOptions): PagedAsyncIterableIterator<DeletedSecret, DeletedSecret[], PageSettings>

パラメーター

戻り値

コンテナー内のすべてのシークレットの最新バージョンを反復処理します。 完全なシークレット識別子および属性は応答で提供されます。 シークレットの値は返されません。 この操作には、secrets/list アクセス許可が必要です。

使用例:

let client = new SecretClient(url, credentials);
for await (const secretProperties of client.listPropertiesOfSecrets()) {
  const secret = await client.getSecret(secretProperties.name);
  console.log("secret: ", secret);
}

コンテナー内のすべてのシークレットを一覧表示します。

function listPropertiesOfSecrets(options?: ListPropertiesOfSecretsOptions): PagedAsyncIterableIterator<SecretProperties, SecretProperties[], PageSettings>

パラメーター

戻り値

コンテナー内の指定されたシークレットのすべてのバージョンを反復処理します。 完全なシークレット識別子および属性は応答で提供されます。 シークレットの値は返されません。 この操作には、secrets/list アクセス許可が必要です。

使用例:

let client = new SecretClient(url, credentials);
for await (const secretProperties of client.listPropertiesOfSecretVersions("MySecretName")) {
  const secret = await client.getSecret(secretProperties.name);
  console.log("secret version: ", secret);
}

function listPropertiesOfSecretVersions(secretName: string, options?: ListPropertiesOfSecretVersionsOptions): PagedAsyncIterableIterator<SecretProperties, SecretProperties[], PageSettings>

パラメーター

戻り値

削除されたシークレットの消去操作は、回復の可能性なしにシークレットを完全に削除します。 この操作は、論理的な削除が有効なコンテナーでのみ有効にすることができます。 この操作には、シークレット/消去アクセス許可が必要です。

使用例:

const client = new SecretClient(url, credentials);
const deletePoller = await client.beginDeleteSecret("MySecretName");
await deletePoller.pollUntilDone();
await client.purgeDeletedSecret("MySecretName");

指定したシークレットを完全に削除します。

function purgeDeletedSecret(secretName: string, options?: PurgeDeletedSecretOptions): Promise<void>

パラメーター

戻り値

バックアップされたシークレットとそのすべてのバージョンを資格情報コンテナーに復元します。 この操作には、シークレット/復元アクセス許可が必要です。

使用例:

let client = new SecretClient(url, credentials);
let mySecretBundle = await client.backupSecret("MySecretName");
// ...
await client.restoreSecretBackup(mySecretBundle);

バックアップされたシークレットをコンテナーに復元します。

function restoreSecretBackup(secretBundleBackup: Uint8Array, options?: RestoreSecretBackupOptions): Promise<SecretProperties>

パラメーター

戻り値

setSecret メソッドは、シークレットまたはシークレット バージョンを Azure Key Vaultに追加します。 名前付きのシークレット キーが既に存在する場合は、Azure Key Vault により、そのシークレットの新しいバージョンが作成されます。 この操作には、secrets/set アクセス許可が必要です。

使用例:

let client = new SecretClient(url, credentials);
await client.setSecret("MySecretName", "ABC123");

指定したキー コンテナーにシークレットを追加します。

function setSecret(secretName: string, value: string, options?: SetSecretOptions): Promise<KeyVaultSecret>

パラメーター

戻り値

updateSecret メソッドは、既存の格納されているシークレットの指定された属性を変更します。 要求で指定されていないプロパティは変更されません。 シークレット自体の値は変更できません。 この操作には、secrets/set アクセス許可が必要です。

使用例:

let secretName = "MySecretName";
let client = new SecretClient(url, credentials);
let secret = await client.getSecret(secretName);
await client.updateSecretProperties(secretName, secret.properties.version, { enabled: false });

特定のキー コンテナー内の指定したシークレットに関連付けられている属性を更新します。

function updateSecretProperties(secretName: string, secretVersion: string, options?: UpdateSecretPropertiesOptions): Promise<SecretProperties>

パラメーター

戻り値