Selective Key Restore Operation - Selective Key Restore Operation

Dienst:: Key Vault

API-Version:: 7.4

Stellt alle Schlüsselversionen eines bestimmten Schlüssels mithilfe des vom Benutzer bereitgestellten SAS-Tokens wieder her, das auf einen zuvor gespeicherten Azure Blob Storage-Sicherungsordner verweist.

PUT {vaultBaseUrl}/keys/{keyName}/restore?api-version=7.4

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
keyName	path	True	string	Der Name des Schlüssels, der aus der vom Benutzer bereitgestellten Sicherung wiederhergestellt werden soll
vaultBaseUrl	path	True	string	Der Tresorname, z. B. `https://myvault.vault.azure.net`.
api-version	query	True	string	Client-API-Version.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
folder	True	string	Der Ordnername des Blobs, in dem die vorherige erfolgreiche vollständige Sicherung gespeichert wurde
sasTokenParameters	True	SASTokenParameter

Antworten

Name	Typ	Beschreibung
202 Accepted	SelectiveKeyRestoreOperation	Der Selektive Schlüsselwiederherstellungsvorgang wurde aus der zuvor gespeicherten Sicherung gestartet. Header Retry-After: integer Azure-AsyncOperation: string
Other Status Codes	KeyVaultError	Key Vault-Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Name

Typ

Beschreibung

202 Accepted

SelectiveKeyRestoreOperation

Der Selektive Schlüsselwiederherstellungsvorgang wurde aus der zuvor gespeicherten Sicherung gestartet.

Header

Retry-After: integer
Azure-AsyncOperation: string

Other Status Codes

KeyVaultError

Key Vault-Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

Selectively restore key from a backup

Beispielanforderung

HTTP

PUT https://myvault.vault.azure.net/keys/hsm-mail-key/restore?api-version=7.4

{
  "sasTokenParameters": {
    "storageResourceUri": "https://myaccount.blob.core.windows.net/sascontainer/sasContainer",
    "token": "se=2018-02-01T00%3A00Z&spr=https&sv=2017-04-17&sr=b&sig=XXFNfuMCH112BxhemJ7PWn0xGfImMXT6LfbXWvtRUk%3D"
  },
  "folder": "mhsm-mypool-20200303062926785"
}

Beispiel für eine Antwort

Statuscode:: 202

Retry-After: 5
Azure-AsyncOperation: https://myvault.vault.azure.net/restore/45aacd568a23b0s49a2803861e8dd3ase21f/pending

{
  "status": "InProgress",
  "statusDetails": "Selective Key restore is in progress",
  "jobId": "45aacd568a23b0s49a2803861e8dd3ase21f",
  "startTime": 1490790000,
  "endTime": 0
}

Definitionen

Name	Beschreibung
Error	Der Schlüsseltresorserverfehler.
KeyVaultError	Ausnahme des Schlüsseltresorfehlers.
SASTokenParameter
SelectiveKeyRestoreOperation	Selektiver Schlüsselwiederherstellungsvorgang
SelectiveKeyRestoreOperationParameters

Error

Objekt

Der Schlüsseltresorserverfehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
innererror	Error	Der Schlüsseltresorserverfehler.
message	string	Die Fehlermeldung.

KeyVaultError

Objekt

Ausnahme des Schlüsseltresorfehlers.

Name	Typ	Beschreibung
error	Error	Der Schlüsseltresorserverfehler.

SASTokenParameter

Objekt

Name	Typ	Beschreibung
storageResourceUri	string	Azure Blob Storage-Container-URI
token	string	Das SAS-Token, das auf einen Azure Blob Storage-Container zeigt