KeyVaultBackupClient class
KeyVaultBackupClient biedt methoden voor het genereren van back-ups en het herstellen van back-ups van een bepaald Azure Key Vault-exemplaar. Deze client ondersteunt het genereren van volledige back-ups, selectieve herstelbewerkingen van specifieke sleutels en volledige herstelbewerkingen van Key Vault-exemplaren.
Constructors
| Key |
Hiermee maakt u een exemplaar van de KeyVaultBackupClient. Voorbeeldgebruik:
|
Eigenschappen
| vault |
De basis-URL naar de kluis |
Methoden
| begin |
Begint met het genereren van een back-up van een Azure Key Vault op het opgegeven Storage Blob-account met behulp van een door de gebruiker toegewezen beheerde identiteit voor toegang tot het Opslagaccount. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de Key Vault-back-up wordt gegenereerd. Voorbeeldgebruik:
Hiermee start u een volledige back-upbewerking. |
| begin |
Begint met het genereren van een back-up van een Azure Key Vault op het opgegeven Storage Blob-account. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de Key Vault-back-up wordt gegenereerd. Voorbeeldgebruik:
Hiermee start u een volledige back-upbewerking. |
| begin |
Start een bewerking vóór de back-up die kan worden gebruikt om te controleren of de klant een beginBackup--bewerking kan uitvoeren met behulp van de geconfigureerde door de gebruiker toegewezen beheerde identiteit van de beheerde HSM om te verifiëren met Azure Storage. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de bewerking is voltooid. Voorbeeldgebruik:
|
| begin |
Hiermee start u een bewerking vóór de back-up die kan worden gebruikt om te controleren of de klant een beginBackup--bewerking kan uitvoeren met behulp van het opgegeven SAS-token. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de bewerking is voltooid. Voorbeeldgebruik:
|
| begin |
Start een bewerking vooraf herstellen die kan worden gebruikt om te controleren of de klant een beginRestore bewerking kan uitvoeren met behulp van het opgegeven SAS-token. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de bewerking is voltooid. Voorbeeldgebruik:
|
| begin |
Start een bewerking vooraf herstellen die kan worden gebruikt om te controleren of de klant een beginRestore bewerking kan uitvoeren met behulp van het opgegeven SAS-token. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de bewerking is voltooid. Voorbeeldgebruik:
|
| begin |
Begint met het herstellen van alle sleutelmaterialen met behulp van het SAS-token dat verwijst naar een eerder opgeslagen back-upmap van Azure Blob Storage, met behulp van een door de gebruiker toegewezen beheerde identiteit voor toegang tot het opslagaccount. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de herstelbewerking van Key Vault is voltooid. Voorbeeldgebruik:
Hiermee start u een volledige herstelbewerking. |
| begin |
Begint met het herstellen van alle sleutelmaterialen met behulp van het SAS-token dat verwijst naar een eerder opgeslagen back-upmap van Azure Blob Storage. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de herstelbewerking van Key Vault is voltooid. Voorbeeldgebruik:
Hiermee start u een volledige herstelbewerking. |
| begin |
Begint met het herstellen van alle sleutelversies van een bepaalde sleutel met behulp van een eerder opgeslagen back-upmap van Azure Blob Storage. De back-upmap van Blob Storage wordt geopend met behulp van door de gebruiker toegewezen beheerde identiteit. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat selectief herstel van Key Vault is voltooid. Voorbeeldgebruik:
Hiermee maakt u een nieuwe roltoewijzing. |
| begin |
Begint met het herstellen van alle sleutelversies van een bepaalde sleutel met behulp van het door de gebruiker opgegeven SAS-token dat verwijst naar een eerder opgeslagen back-upmap van Azure Blob Storage. Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat selectief herstel van Key Vault is voltooid. Voorbeeldgebruik:
Hiermee maakt u een nieuwe roltoewijzing. |
Constructordetails
KeyVaultBackupClient(string, TokenCredential, KeyVaultBackupClientOptions)
Hiermee maakt u een exemplaar van de KeyVaultBackupClient.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
new KeyVaultBackupClient(vaultUrl: string, credential: TokenCredential, options?: KeyVaultBackupClientOptions)
Parameters
- vaultUrl
-
string
de URL van de Sleutelkluis. Deze moet deze vorm hebben: https://${your-key-vault-name}.vault.azure.net. Controleer of deze URL verwijst naar een geldige Key Vault- of beheerde HSM-resource. Zie https://aka.ms/azsdk/blog/vault-uri voor meer informatie.
- credential
- TokenCredential
Een object dat de TokenCredential-interface implementeert die wordt gebruikt voor het verifiëren van aanvragen voor de service. Gebruik het @azure/identity-pakket om een referentie te maken die aan uw behoeften voldoet.
- options
- KeyVaultBackupClientOptions
opties die worden gebruikt voor het configureren van Key Vault API-aanvragen.
Eigenschapdetails
vaultUrl
De basis-URL naar de kluis
vaultUrl: string
Waarde van eigenschap
string
Methodedetails
beginBackup(string, KeyVaultBeginBackupOptions)
Begint met het genereren van een back-up van een Azure Key Vault op het opgegeven Storage Blob-account met behulp van een door de gebruiker toegewezen beheerde identiteit voor toegang tot het Opslagaccount.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de Key Vault-back-up wordt gegenereerd.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>"; // <Blob storage URL>/<folder name>
const poller = await client.beginBackup(blobStorageUri);
// Serializing the poller
const serialized = poller.toString();
// A new poller can be created with:
await client.beginBackup(blobStorageUri, { resumeFrom: serialized });
// Waiting until it's done
const backupUri = await poller.pollUntilDone();
console.log(backupUri);
Hiermee start u een volledige back-upbewerking.
function beginBackup(blobStorageUri: string, options?: KeyVaultBeginBackupOptions): Promise<PollerLike<KeyVaultBackupOperationState, KeyVaultBackupResult>>
Parameters
- blobStorageUri
-
string
De URL van de blobopslagresource, inclusief het pad naar de container waar de back-up uiteindelijk wordt opgeslagen.
- options
- KeyVaultBeginBackupOptions
De optionele parameters.
Retouren
beginBackup(string, string, KeyVaultBeginBackupOptions)
Begint met het genereren van een back-up van een Azure Key Vault op het opgegeven Storage Blob-account.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de Key Vault-back-up wordt gegenereerd.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>"; // <Blob storage URL>/<folder name>
const sasToken = "<sas-token>";
const poller = await client.beginBackup(blobStorageUri, sasToken);
// Serializing the poller
const serialized = poller.toString();
// A new poller can be created with:
await client.beginBackup(blobStorageUri, sasToken, { resumeFrom: serialized });
// Waiting until it's done
const backupUri = await poller.pollUntilDone();
console.log(backupUri);
Hiermee start u een volledige back-upbewerking.
function beginBackup(blobStorageUri: string, sasToken: string, options?: KeyVaultBeginBackupOptions): Promise<PollerLike<KeyVaultBackupOperationState, KeyVaultBackupResult>>
Parameters
- blobStorageUri
-
string
De URL van de blobopslagresource, inclusief het pad naar de container waar de back-up uiteindelijk wordt opgeslagen.
- sasToken
-
string
Het SAS-token dat wordt gebruikt voor toegang tot de blobopslagresource.
- options
- KeyVaultBeginBackupOptions
De optionele parameters.
Retouren
beginPreBackup(string, KeyVaultBeginPreBackupOptions)
Start een bewerking vóór de back-up die kan worden gebruikt om te controleren of de klant een beginBackup--bewerking kan uitvoeren met behulp van de geconfigureerde door de gebruiker toegewezen beheerde identiteit van de beheerde HSM om te verifiëren met Azure Storage.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de bewerking is voltooid.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>"; // <Blob storage URL>/<folder name>
const poller = await client.beginPreBackup(blobStorageUri);
// Serializing the poller
const serialized = poller.toString();
// A new poller can be created with:
await client.beginPreBackup(blobStorageUri, { resumeFrom: serialized });
// Waiting until it's done
const result = await poller.pollUntilDone();
console.log(result);
function beginPreBackup(blobStorageUri: string, options?: KeyVaultBeginPreBackupOptions): Promise<PollerLike<KeyVaultBackupOperationState, KeyVaultBackupResult>>
Parameters
- blobStorageUri
-
string
De URL van de blobopslagresource, inclusief het pad naar de container waar de back-up uiteindelijk wordt opgeslagen.
- options
- KeyVaultBeginPreBackupOptions
De optionele parameters.
Retouren
beginPreBackup(string, string, KeyVaultBeginPreBackupOptions)
Hiermee start u een bewerking vóór de back-up die kan worden gebruikt om te controleren of de klant een beginBackup--bewerking kan uitvoeren met behulp van het opgegeven SAS-token.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de bewerking is voltooid.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>"; // <Blob storage URL>/<folder name>
const sasToken = "<sas-token>";
const poller = await client.beginPreBackup(blobStorageUri, sasToken);
// Serializing the poller
const serialized = poller.toString();
// A new poller can be created with:
await client.beginPreBackup(blobStorageUri, sasToken, { resumeFrom: serialized });
// Waiting until it's done
const result = await poller.pollUntilDone();
console.log(result);
function beginPreBackup(blobStorageUri: string, sasToken: string, options?: KeyVaultBeginPreBackupOptions): Promise<PollerLike<KeyVaultBackupOperationState, KeyVaultBackupResult>>
Parameters
- blobStorageUri
-
string
De URL van de blobopslagresource, inclusief het pad naar de container waar de back-up uiteindelijk wordt opgeslagen.
- sasToken
-
string
Het SAS-token dat wordt gebruikt voor toegang tot de blobopslagresource.
- options
- KeyVaultBeginPreBackupOptions
De optionele parameters.
Retouren
beginPreRestore(string, KeyVaultBeginPreRestoreOptions)
Start een bewerking vooraf herstellen die kan worden gebruikt om te controleren of de klant een beginRestore bewerking kan uitvoeren met behulp van het opgegeven SAS-token.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de bewerking is voltooid.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>"; // <Blob storage URL>/<folder name>
const sasToken = "<sas-token>";
const poller = await client.beginPreRestore(blobStorageUri, sasToken);
// The poller can be serialized with:
const serialized = poller.toString();
// A new poller can be created with:
await client.beginPreRestore(blobStorageUri, sasToken, { resumeFrom: serialized });
// Waiting until it's done
await poller.pollUntilDone();
function beginPreRestore(folderUri: string, options?: KeyVaultBeginPreRestoreOptions): Promise<PollerLike<KeyVaultRestoreOperationState, KeyVaultRestoreResult>>
Parameters
- folderUri
-
string
De URL van de blobopslagresource waarin de vorige geslaagde volledige back-up is opgeslagen.
- options
- KeyVaultBeginPreRestoreOptions
De optionele parameters.
Retouren
beginPreRestore(string, string, KeyVaultBeginPreRestoreOptions)
Start een bewerking vooraf herstellen die kan worden gebruikt om te controleren of de klant een beginRestore bewerking kan uitvoeren met behulp van het opgegeven SAS-token.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de bewerking is voltooid.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>"; // <Blob storage URL>/<folder name>
const sasToken = "<sas-token>";
const poller = await client.beginPreRestore(blobStorageUri, sasToken);
// The poller can be serialized with:
const serialized = poller.toString();
// A new poller can be created with:
await client.beginPreRestore(blobStorageUri, sasToken, { resumeFrom: serialized });
// Waiting until it's done
await poller.pollUntilDone();
function beginPreRestore(folderUri: string, sasToken: string, options?: KeyVaultBeginPreRestoreOptions): Promise<PollerLike<KeyVaultRestoreOperationState, KeyVaultRestoreResult>>
Parameters
- folderUri
-
string
De URL van de blobopslagresource waarin de vorige geslaagde volledige back-up is opgeslagen.
- sasToken
-
string
Het SAS-token. Als er geen SAS-token is opgegeven, wordt door de gebruiker toegewezen beheerde identiteit gebruikt voor toegang tot de blobopslagresource.
- options
- KeyVaultBeginPreRestoreOptions
De optionele parameters.
Retouren
beginRestore(string, KeyVaultBeginRestoreOptions)
Begint met het herstellen van alle sleutelmaterialen met behulp van het SAS-token dat verwijst naar een eerder opgeslagen back-upmap van Azure Blob Storage, met behulp van een door de gebruiker toegewezen beheerde identiteit voor toegang tot het opslagaccount.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de herstelbewerking van Key Vault is voltooid.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>"; // <Blob storage URL>/<folder name>
const poller = await client.beginRestore(blobStorageUri);
// The poller can be serialized with:
const serialized = poller.toString();
// A new poller can be created with:
await client.beginRestore(blobStorageUri, { resumeFrom: serialized });
// Waiting until it's done
await poller.pollUntilDone();
Hiermee start u een volledige herstelbewerking.
function beginRestore(folderUri: string, options?: KeyVaultBeginRestoreOptions): Promise<PollerLike<KeyVaultRestoreOperationState, KeyVaultRestoreResult>>
Parameters
- folderUri
-
string
De URL van de blobopslagresource waarin de vorige geslaagde volledige back-up is opgeslagen.
- options
- KeyVaultBeginRestoreOptions
De optionele parameters.
Retouren
beginRestore(string, string, KeyVaultBeginRestoreOptions)
Begint met het herstellen van alle sleutelmaterialen met behulp van het SAS-token dat verwijst naar een eerder opgeslagen back-upmap van Azure Blob Storage.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat de herstelbewerking van Key Vault is voltooid.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>"; // <Blob storage URL>/<folder name>
const sasToken = "<sas-token>";
const poller = await client.beginRestore(blobStorageUri, sasToken);
// The poller can be serialized with:
const serialized = poller.toString();
// A new poller can be created with:
await client.beginRestore(blobStorageUri, sasToken, { resumeFrom: serialized });
// Waiting until it's done
const backupUri = await poller.pollUntilDone();
console.log(backupUri);
Hiermee start u een volledige herstelbewerking.
function beginRestore(folderUri: string, sasToken: string, options?: KeyVaultBeginRestoreOptions): Promise<PollerLike<KeyVaultRestoreOperationState, KeyVaultRestoreResult>>
Parameters
- folderUri
-
string
De URL van de blobopslagresource waarin de vorige geslaagde volledige back-up is opgeslagen.
- sasToken
-
string
Het SAS-token. Als er geen SAS-token is opgegeven, wordt door de gebruiker toegewezen beheerde identiteit gebruikt voor toegang tot de blobopslagresource.
- options
- KeyVaultBeginRestoreOptions
De optionele parameters.
Retouren
beginSelectiveKeyRestore(string, string, KeyVaultBeginSelectiveKeyRestoreOptions)
Begint met het herstellen van alle sleutelversies van een bepaalde sleutel met behulp van een eerder opgeslagen back-upmap van Azure Blob Storage. De back-upmap van Blob Storage wordt geopend met behulp van door de gebruiker toegewezen beheerde identiteit.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat selectief herstel van Key Vault is voltooid.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>";
const keyName = "<key-name>";
const poller = await client.beginSelectiveKeyRestore(keyName, blobStorageUri);
// Serializing the poller
const serialized = poller.toString();
// A new poller can be created with:
await client.beginSelectiveKeyRestore(keyName, blobStorageUri, { resumeFrom: serialized });
// Waiting until it's done
await poller.pollUntilDone();
Hiermee maakt u een nieuwe roltoewijzing.
function beginSelectiveKeyRestore(keyName: string, folderUri: string, options?: KeyVaultBeginSelectiveKeyRestoreOptions): Promise<PollerLike<KeyVaultSelectiveKeyRestoreOperationState, KeyVaultSelectiveKeyRestoreResult>>
Parameters
- keyName
-
string
De naam van de sleutel die moet worden hersteld.
- folderUri
-
string
De URL van de blobopslagresource, met de mapnaam van de blob waar de vorige geslaagde volledige back-up is opgeslagen.
De optionele parameters.
Retouren
beginSelectiveKeyRestore(string, string, string, KeyVaultBeginSelectiveKeyRestoreOptions)
Begint met het herstellen van alle sleutelversies van een bepaalde sleutel met behulp van het door de gebruiker opgegeven SAS-token dat verwijst naar een eerder opgeslagen back-upmap van Azure Blob Storage.
Deze functie retourneert een poller voor langdurige bewerkingen waarmee u voor onbepaalde tijd kunt wachten totdat selectief herstel van Key Vault is voltooid.
Voorbeeldgebruik:
import { DefaultAzureCredential } from "@azure/identity";
import { KeyVaultBackupClient } from "@azure/keyvault-admin";
const vaultUrl = `https://<MY KEY VAULT HERE>.vault.azure.net`;
const credentials = new DefaultAzureCredential();
const client = new KeyVaultBackupClient(vaultUrl, credentials);
const blobStorageUri = "<blob-storage-uri>";
const sasToken = "<sas-token>";
const keyName = "<key-name>";
const poller = await client.beginSelectiveKeyRestore(keyName, blobStorageUri, sasToken);
// Serializing the poller
const serialized = poller.toString();
// A new poller can be created with:
await client.beginSelectiveKeyRestore(keyName, blobStorageUri, sasToken, {
resumeFrom: serialized,
});
// Waiting until it's done
await poller.pollUntilDone();
Hiermee maakt u een nieuwe roltoewijzing.
function beginSelectiveKeyRestore(keyName: string, folderUri: string, sasToken: string, options?: KeyVaultBeginSelectiveKeyRestoreOptions): Promise<PollerLike<KeyVaultSelectiveKeyRestoreOperationState, KeyVaultSelectiveKeyRestoreResult>>
Parameters
- keyName
-
string
De naam van de sleutel die moet worden hersteld.
- folderUri
-
string
De URL van de blobopslagresource, met de mapnaam van de blob waar de vorige geslaagde volledige back-up is opgeslagen.
- sasToken
-
string
Het SAS-token. Als er geen SAS-token is opgegeven, wordt door de gebruiker toegewezen beheerde identiteit gebruikt voor toegang tot de blobopslagresource.
De optionele parameters.