Get Sas Definitions - Get Sas Definitions

Referentie

Service:: Key Vault

API Version:: 7.4

Sas-opslagdefinities voor het opgegeven opslagaccount weergeven. Voor deze bewerking is de machtiging opslag/lijsten als vereist.

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

With optional parameters:

GET {vaultBaseUrl}/storage/{storage-account-name}/sas?maxresults={maxresults}&api-version=7.4

URI-parameters

Name	In	Vereist	Type	Description
storage-account-name	path	True	string	De naam van het opslagaccount. Regex pattern: `^[0-9a-zA-Z]+$`
vaultBaseUrl	path	True	string	De kluisnaam, bijvoorbeeld https://myvault.vault.azure.net.
api-version	query	True	string	Client-API-versie.
maxresults	query		integer int32	Maximum aantal resultaten dat op een pagina moet worden geretourneerd. Als u niet opgeeft, retourneert de service maximaal 25 resultaten.

Antwoorden

Name	Type	Description
200 OK	SasDefinitionListResult	Een antwoordbericht met een lijst met SAS-definities, samen met een koppeling naar de volgende pagina met SAS-definities.
Other Status Codes	KeyVaultError	Key Vault foutbericht waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

List Storage Sas Definition

Sample Request

HTTP

GET https://myvault.vault.azure.net//storage/listsas01/sas?api-version=7.4

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "https://myvault.vault.azure.net/storage/listsas01/sas/listStrgSasDef01",
      "sid": "https://myvault.vault.azure.net/secrets/listsas01-listStrgSasDef01",
      "attributes": {
        "enabled": true,
        "created": 1490738438,
        "updated": 1490738438,
        "recoveryLevel": "Recoverable"
      }
    },
    {
      "id": "https://myvault.vault.azure.net/storage/listsas01/sas/listStrgSasDef02",
      "sid": "https://myvault.vault.azure.net/secrets/listsas01-listStrgSasDef02",
      "attributes": {
        "enabled": true,
        "created": 1490738438,
        "updated": 1490738438,
        "recoveryLevel": "Recoverable"
      }
    }
  ],
  "nextLink": "https://{BaseUri}/storage/listsas01/sas?api-version=7.2&%24skiptoken=<token>"
}

Definities

Name	Description
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.
Error	De sleutelkluisserverfout.
KeyVaultError	De fout-uitzondering voor de sleutelkluis.
SasDefinitionAttributes	De sas-definitiebeheerkenmerken.
SasDefinitionItem	Het SAS-definitie-item met metagegevens van sas-definities voor opslag.
SasDefinitionListResult	Het resultaat van de sas-definitielijst van het opslagaccount.

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	Error	De sleutelkluisserverfout.
message	string	Het foutbericht.

KeyVaultError

De fout-uitzondering voor de sleutelkluis.

Name	Type	Description
error	Error	De sleutelkluisserverfout.

SasDefinitionAttributes

De sas-definitiebeheerkenmerken.

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	DeletionRecoveryLevel	Geeft het herstelniveau voor verwijdering weer dat momenteel van kracht is voor SAS-definities in de huidige kluis. Als deze 'Opschoonbaar' bevat, kan de SAS-definitie permanent worden verwijderd door een bevoegde gebruiker; anders kan alleen het systeem de SAS-definitie opschonen, aan het einde van het retentie-interval.
updated	integer	Tijdstip laatst bijgewerkt in UTC.

SasDefinitionItem

Het SAS-definitie-item met metagegevens van sas-definities voor opslag.

Name	Type	Description
attributes	SasDefinitionAttributes	De sas-definitiebeheerkenmerken.
id	string	De SAS-id voor opslag.
sid	string	De geheime id van de SAS-definitie van het opslagaccount.
tags	object	Toepassingsspecifieke metagegevens in de vorm van sleutel-waardeparen.

SasDefinitionListResult

Het resultaat van de sas-definitielijst van het opslagaccount.

Name	Type	Description
nextLink	string	De URL voor het ophalen van de volgende set SAS-definities.
value	SasDefinitionItem[]	Een antwoordbericht met een lijst met SAS-definities, samen met een koppeling naar de volgende pagina met SAS-definities.

Share via