Regenerate Storage Account Key - Regenerate Storage Account Key
Hiermee wordt de opgegeven sleutelwaarde voor het opgegeven opslagaccount opnieuw gegenereerd. Voor deze bewerking is de machtiging storage/regeneratekey vereist.
POST {vaultBaseUrl}/storage/{storage-account-name}/regeneratekey?api-version=7.4
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
storage-account-name
|
path | True |
string |
De naam van het opslagaccount. Regex pattern: |
vault
|
path | True |
string |
De kluisnaam, bijvoorbeeld https://myvault.vault.azure.net. |
api-version
|
query | True |
string |
Client-API-versie. |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
keyName | True |
string |
De naam van de opslagaccountsleutel. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Het bijgewerkte opslagaccount. |
|
Other Status Codes |
Key Vault foutbericht waarin wordt beschreven waarom de bewerking is mislukt. |
Voorbeelden
Regenerate Storage account key
Sample Request
POST https://myvault.vault.azure.net//storage/regenerateKey01/regeneratekey?api-version=7.4
{
"keyName": "key2"
}
Sample Response
{
"id": "https://myvault.vault.azure.net/storage/regenerateKey01",
"resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
"activeKeyName": "key2",
"autoRegenerateKey": true,
"regenerationPeriod": "P10D",
"attributes": {
"enabled": true,
"created": 1490738386,
"updated": 1490738386,
"recoveryLevel": "Recoverable+Purgeable"
},
"tags": {
"tag1": "val1",
"tag2": "val2"
}
}
Definities
Name | Description |
---|---|
Deletion |
Geeft het herstelniveau voor verwijdering weer dat momenteel van kracht is voor opslagaccounts in de huidige kluis. Als het 'Opschonen' bevat, kan het opslagaccount permanent worden verwijderd door een bevoegde gebruiker; anders kan alleen het systeem het opslagaccount opschonen, aan het einde van het retentie-interval. |
Error |
De sleutelkluisserverfout. |
Key |
De fout-uitzondering voor de sleutelkluis. |
Storage |
De opslagaccountbeheerkenmerken. |
Storage |
De parameters voor het opnieuw genereren van de sleutel van het opslagaccount. |
Storage |
Een opslagaccountbundel bestaat uit de details van het opslagaccount van de sleutelkluis plus de bijbehorende kenmerken. |
DeletionRecoveryLevel
Geeft het herstelniveau voor verwijdering weer dat momenteel van kracht is voor opslagaccounts in de huidige kluis. Als het 'Opschonen' bevat, kan het opslagaccount permanent worden verwijderd door een bevoegde gebruiker; anders kan alleen het systeem het opslagaccount opschonen, aan het einde van het retentie-interval.
Name | Type | Description |
---|---|---|
CustomizedRecoverable |
string |
Geeft een kluisstatus aan waarin verwijdering kan worden hersteld zonder de mogelijkheid voor onmiddellijke en permanente verwijdering (d.w.w. opschonen wanneer 7<= SoftDeleteRetentionInDays < 90). Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het retentie-interval en zolang het abonnement nog beschikbaar is. |
CustomizedRecoverable+ProtectedSubscription |
string |
Geeft een kluis- en abonnementstatus aan waarin verwijdering kan worden hersteld, directe en permanente verwijdering (dat wil zeggen opschonen) niet is toegestaan en waarin het abonnement zelf niet permanent kan worden geannuleerd wanneer 7<= SoftDeleteRetentionInDays < 90. Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het retentie-interval en weerspiegelt ook het feit dat het abonnement zelf niet kan worden geannuleerd. |
CustomizedRecoverable+Purgeable |
string |
Geeft een kluisstatus aan waarin verwijdering kan worden hersteld en die ook onmiddellijke en permanente verwijdering toestaat (d.w.w. opschonen wanneer 7<= SoftDeleteRetentionInDays < 90). Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het retentie-interval, tenzij een opschoonbewerking wordt aangevraagd of het abonnement wordt geannuleerd. |
Purgeable |
string |
Geeft een kluisstatus aan waarin het verwijderen een onomkeerbare bewerking is, zonder de mogelijkheid tot herstel. Dit niveau komt overeen met het feit dat er geen bescherming beschikbaar is tegen een Delete-bewerking; de gegevens gaan onherroepelijk verloren bij het accepteren van een Verwijderbewerking op entiteitsniveau of hoger (kluis, resourcegroep, abonnement, enzovoort) |
Recoverable |
string |
Geeft een kluisstatus aan waarin verwijdering kan worden hersteld zonder de mogelijkheid tot onmiddellijke en permanente verwijdering (d.w.w. opschonen). Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het bewaarinterval (90 dagen) en zolang het abonnement nog beschikbaar is. Het systeem zal het na 90 dagen permanent verwijderen, indien niet hersteld |
Recoverable+ProtectedSubscription |
string |
Geeft een kluis- en abonnementsstatus aan waarin verwijdering kan worden hersteld binnen een bewaarperiode (90 dagen), directe en permanente verwijdering (dat wil zeggen opschonen) niet is toegestaan en waarin het abonnement zelf niet permanent kan worden geannuleerd. Het systeem zal het na 90 dagen permanent verwijderen, indien niet hersteld |
Recoverable+Purgeable |
string |
Geeft een kluisstatus aan waarin verwijdering kan worden hersteld en die ook onmiddellijke en permanente verwijdering toestaat (d.w.w. opschonen). Dit niveau garandeert de herstelbaarheid van de verwijderde entiteit tijdens het retentie-interval (90 dagen), tenzij een opschoonbewerking wordt aangevraagd of het abonnement wordt geannuleerd. Het systeem zal het na 90 dagen permanent verwijderen, indien niet hersteld |
Error
De sleutelkluisserverfout.
Name | Type | Description |
---|---|---|
code |
string |
De foutcode. |
innererror |
De sleutelkluisserverfout. |
|
message |
string |
Het foutbericht. |
KeyVaultError
De fout-uitzondering voor de sleutelkluis.
Name | Type | Description |
---|---|---|
error |
De sleutelkluisserverfout. |
StorageAccountAttributes
De opslagaccountbeheerkenmerken.
Name | Type | Description |
---|---|---|
created |
integer |
Aanmaaktijd in UTC. |
enabled |
boolean |
de ingeschakelde status van het object. |
recoverableDays |
integer |
softDelete dagen voor gegevensretentie. De waarde moet =7 en <=90 zijn wanneer softDelete is >ingeschakeld, anders 0. |
recoveryLevel |
Geeft het herstelniveau voor verwijdering weer dat momenteel van kracht is voor opslagaccounts in de huidige kluis. Als het 'Opschonen' bevat, kan het opslagaccount permanent worden verwijderd door een bevoegde gebruiker; anders kan alleen het systeem het opslagaccount opschonen, aan het einde van het retentie-interval. |
|
updated |
integer |
Tijdstip laatst bijgewerkt in UTC. |
StorageAccountRegenerteKeyParameters
De parameters voor het opnieuw genereren van de sleutel van het opslagaccount.
Name | Type | Description |
---|---|---|
keyName |
string |
De naam van de opslagaccountsleutel. |
StorageBundle
Een opslagaccountbundel bestaat uit de details van het opslagaccount van de sleutelkluis plus de bijbehorende kenmerken.
Name | Type | Description |
---|---|---|
activeKeyName |
string |
De huidige naam van de sleutel van het actieve opslagaccount. |
attributes |
De kenmerken van het opslagaccount. |
|
autoRegenerateKey |
boolean |
of keyvault het opslagaccount voor de gebruiker moet beheren. |
id |
string |
De opslagaccount-id. |
regenerationPeriod |
string |
De duur van de sleutelregeneratie die is opgegeven in ISO-8601-indeling. |
resourceId |
string |
De resource-id van het opslagaccount. |
tags |
object |
Toepassingsspecifieke metagegevens in de vorm van sleutel-waardeparen |