Update Storage Account - Update Storage Account

Service:

Key Vault

API Version:

7.4

Aktualizacje określone atrybuty skojarzone z danym kontem magazynu. Ta operacja wymaga uprawnienia magazynu/zestawu/aktualizacji.

PATCH {vaultBaseUrl}/storage/{storage-account-name}?api-version=7.4

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
storage-account-name	path	True	string	Nazwa konta magazynu. Regex pattern: ^[0-9a-zA-Z]+$
vaultBaseUrl	path	True	string	Nazwa magazynu, na przykład https://myvault.vault.azure.net.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Typ	Opis
activeKeyName	string	Bieżąca nazwa aktywnego klucza konta magazynu.
attributes	StorageAccountAttributes	Atrybuty konta magazynu.
autoRegenerateKey	boolean	czy usługa keyvault powinna zarządzać kontem magazynu dla użytkownika.
regenerationPeriod	string	Czas regeneracji klucza określony w formacie ISO-8601.
tags	object	Metadane specyficzne dla aplikacji w postaci par klucz-wartość.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	StorageBundle	Zaktualizowane konto magazynu.
Other Status Codes	KeyVaultError	Key Vault odpowiedzi na błąd opisujący, dlaczego operacja nie powiodła się.

Przykłady

Update Storage account

Sample Request

HTTP

PATCH https://myvault.vault.azure.net//storage/patchStrg01?api-version=7.4

{
  "activeKeyName": "key1",
  "regenerationPeriod": "P10D"
}

Sample Response

Status code:

200

{
  "id": "https://myvault.vault.azure.net/storage/patchStrg01",
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key1",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P10D",
  "attributes": {
    "enabled": true,
    "created": 1490738386,
    "updated": 1490738386,
    "recoveryLevel": "Recoverable+Purgeable"
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

Definicje

Nazwa	Opis
DeletionRecoveryLevel	Odzwierciedla obecnie poziom odzyskiwania usuwania dla kont magazynu w bieżącym magazynie. Jeśli zawiera on element "Przeczyszczalny", konto magazynu może zostać trwale usunięte przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić konto magazynu na końcu okresu przechowywania.
Error	Błąd serwera magazynu kluczy.
KeyVaultError	Wyjątek błędu magazynu kluczy.
StorageAccountAttributes	Atrybuty zarządzania kontami magazynu.
StorageAccountUpdateParameters	Parametry aktualizacji konta magazynu.
StorageBundle	Pakiet konta magazynu składa się ze szczegółów konta magazynu kluczy oraz jego atrybutów.

DeletionRecoveryLevel

Odzwierciedla obecnie poziom odzyskiwania usuwania dla kont magazynu w bieżącym magazynie. Jeśli zawiera on element "Przeczyszczalny", konto magazynu może zostać trwale usunięte przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić konto magazynu na końcu okresu przechowywania.

Nazwa	Typ	Opis
CustomizedRecoverable	string	Określa stan magazynu, w którym można odzyskać usunięcie bez możliwości natychmiastowego i trwałego usunięcia (tj. przeczyszczania, gdy 7< = SoftDeleteRetentionInDays < 90). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania i gdy subskrypcja jest nadal dostępna.
CustomizedRecoverable+ProtectedSubscription	string	Oznacza, że magazyn i stan subskrypcji, w którym usunięcie jest możliwe do odzyskania, natychmiastowe i trwałe usunięcie (tj. przeczyszczenie) jest niedozwolone i w którym sama subskrypcja nie może zostać trwale anulowana, gdy 7< = SoftDeleteRetentionInDays < 90. Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania, a także odzwierciedla fakt, że sama subskrypcja nie może zostać anulowana.
CustomizedRecoverable+Purgeable	string	Określa stan magazynu, w którym można odzyskać usunięcie, a także zezwala na natychmiastowe i trwałe usunięcie (tj. przeczyszczanie, gdy 7< = SoftDeleteRetentionInDays < 90). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania, chyba że zażądano operacji przeczyszczania lub subskrypcja zostanie anulowana.
Purgeable	string	Określa stan magazynu, w którym usunięcie jest operacją nieodwracalną, bez możliwości odzyskiwania. Ten poziom nie odpowiada działaniu ochrony przed operacją Usuwania; dane są nieodwracalnie utracone po zaakceptowaniu operacji Usuwania na poziomie jednostki lub wyższym (magazyn, grupa zasobów, subskrypcja itp.)
Recoverable	string	Określa stan magazynu, w którym można odzyskać usunięcie bez możliwości natychmiastowego i trwałego usunięcia (tj. przeczyszczania). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania (90 dni) i gdy subskrypcja jest nadal dostępna. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany
Recoverable+ProtectedSubscription	string	Określa magazyn i stan subskrypcji, w którym usunięcie można odzyskać w okresie przechowywania (90 dni), natychmiastowe i trwałe usunięcie (tj. przeczyszczenie) jest niedozwolone i w którym sama subskrypcja nie może zostać trwale anulowana. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany
Recoverable+Purgeable	string	Określa stan magazynu, w którym można odzyskać usunięcie, a także umożliwia natychmiastowe i trwałe usunięcie (tj. przeczyszczenie). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania (90 dni), chyba że zażądano operacji przeczyszczania lub subskrypcja zostanie anulowana. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany

Error

Błąd serwera magazynu kluczy.

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	Error	Błąd serwera magazynu kluczy.
message	string	Komunikat o błędzie.

KeyVaultError

Wyjątek błędu magazynu kluczy.

Nazwa	Typ	Opis
error	Error	Błąd serwera magazynu kluczy.

StorageAccountAttributes

Atrybuty zarządzania kontami magazynu.

Nazwa	Typ	Opis
created	integer	Czas utworzenia w formacie UTC.
enabled	boolean	włączony stan obiektu.
recoverableDays	integer	softDelete data retention days (dni przechowywania danych softDelete). Wartość powinna mieć >wartość =7 i <=90, gdy funkcja softDelete jest włączona, w przeciwnym razie 0.
recoveryLevel	DeletionRecoveryLevel	Odzwierciedla obecnie poziom odzyskiwania usuwania dla kont magazynu w bieżącym magazynie. Jeśli zawiera on element "Przeczyszczalny", konto magazynu może zostać trwale usunięte przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić konto magazynu na końcu okresu przechowywania.
updated	integer	Czas ostatniej aktualizacji w formacie UTC.

StorageAccountUpdateParameters

Parametry aktualizacji konta magazynu.

Nazwa	Typ	Opis
activeKeyName	string	Bieżąca nazwa aktywnego klucza konta magazynu.
attributes	StorageAccountAttributes	Atrybuty konta magazynu.
autoRegenerateKey	boolean	czy usługa keyvault powinna zarządzać kontem magazynu dla użytkownika.
regenerationPeriod	string	Czas regeneracji klucza określony w formacie ISO-8601.
tags	object	Metadane specyficzne dla aplikacji w postaci par klucz-wartość.

StorageBundle

Pakiet konta magazynu składa się ze szczegółów konta magazynu kluczy oraz jego atrybutów.

Nazwa	Typ	Opis
activeKeyName	string	Bieżąca nazwa aktywnego klucza konta magazynu.
attributes	StorageAccountAttributes	Atrybuty konta magazynu.
autoRegenerateKey	boolean	czy usługa keyvault powinna zarządzać kontem magazynu dla użytkownika.
id	string	Identyfikator konta magazynu.
regenerationPeriod	string	Czas regeneracji klucza określony w formacie ISO-8601.
resourceId	string	Identyfikator zasobu konta magazynu.
tags	object	Metadane specyficzne dla aplikacji w postaci par klucz-wartość