Get Deleted Sas Definitions - Get Deleted Sas Definitions

Référence

Service:: Key Vault

API Version:: 7.4

Listes définitions SAP supprimées pour le coffre et le compte de stockage spécifiés.
L’opération Obtenir les définitions sas supprimées retourne les définitions SAS qui ont été supprimées pour un coffre activé pour la suppression réversible. Cette opération nécessite l’autorisation stockage/listesas.

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

With optional parameters:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
storage-account-name	path	True	string	Nom du compte de stockage. Regex pattern: `^[0-9a-zA-Z]+$`
vaultBaseUrl	path	True	string	Nom du coffre, par exemple https://myvault.vault.azure.net.
api-version	query	True	string	Version d’API client.
maxresults	query		integer int32	Nombre maximal de résultats à retourner dans une page. S’il n’est pas spécifié, le service retourne jusqu’à 25 résultats.

Réponses

Nom	Type	Description
200 OK	DeletedSasDefinitionListResult	Message de réponse contenant une liste de définitions SAP supprimées pour le compte de stockage, ainsi qu’un lien vers la page suivante des définitions SAP supprimées.
Other Status Codes	KeyVaultError	Key Vault réponse d’erreur décrivant la raison de l’échec de l’opération.

Exemples

List Deleted Storage Sas Definitions

Sample Request

HTTP

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

Sample Response

Status code:: 200

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

Définitions

Nom	Description
DeletedSasDefinitionItem	Élément de définition SAS supprimé contenant les métadonnées relatives à la définition SAS supprimée.
DeletedSasDefinitionListResult	Résultat de la liste de définitions SAS supprimées
DeletionRecoveryLevel	Reflète le niveau de récupération de suppression actuellement en vigueur pour les comptes de stockage dans le coffre actuel. S’il contient « Purgeable », le compte de stockage peut être supprimé définitivement par un utilisateur privilégié ; sinon, seul le système peut vider le compte de stockage, à la fin de l’intervalle de rétention.
Error	Erreur du serveur du coffre de clés.
KeyVaultError	Exception d’erreur du coffre de clés.
SasDefinitionAttributes	Attributs de gestion des définitions SAP.

DeletedSasDefinitionItem

Élément de définition SAS supprimé contenant les métadonnées relatives à la définition SAS supprimée.

Nom	Type	Description
attributes	SasDefinitionAttributes	Attributs de gestion des définitions SAP.
deletedDate	integer	Heure à laquelle la définition SAS a été supprimée, en UTC
id	string	Identificateur SAP de stockage.
recoveryId	string	URL de l’objet de récupération, utilisée pour identifier et récupérer la définition SAS supprimée.
scheduledPurgeDate	integer	Heure à laquelle la définition SAS est planifiée pour être purgée, en UTC
sid	string	ID de secret de définition SAP du compte de stockage.
tags	object	Métadonnées spécifiques d’application sous la forme de paires clé/valeur.

DeletedSasDefinitionListResult

Résultat de la liste de définitions SAS supprimées

Nom	Type	Description
nextLink	string	URL permettant d’obtenir l’ensemble suivant de définitions SAP supprimées.
value	DeletedSasDefinitionItem[]	Message de réponse contenant une liste des définitions SAS supprimées dans le coffre, ainsi qu’un lien vers la page suivante des définitions sas supprimées

DeletionRecoveryLevel

Reflète le niveau de récupération de suppression actuellement en vigueur pour les comptes de stockage dans le coffre actuel. S’il contient « Purgeable », le compte de stockage peut être supprimé définitivement par un utilisateur privilégié ; sinon, seul le système peut vider le compte de stockage, à la fin de l’intervalle de rétention.

Nom	Type	Description
CustomizedRecoverable	string	Désigne un état de coffre dans lequel la suppression est récupérable sans possibilité de suppression immédiate et définitive (par exemple, purger quand 7<= SoftDeleteRetentionInDays < 90). Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention et tant que l’abonnement est toujours disponible.
CustomizedRecoverable+ProtectedSubscription	string	Indique un état de coffre et d’abonnement dans lequel la suppression est récupérable, la suppression immédiate et permanente (c’est-à-dire la purge) n’est pas autorisée et dans laquelle l’abonnement lui-même ne peut pas être annulé définitivement lorsque 7<= SoftDeleteRetentionInDays < 90. Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention et reflète également le fait que l’abonnement lui-même ne peut pas être annulé.
CustomizedRecoverable+Purgeable	string	Désigne un état de coffre dans lequel la suppression est récupérable, et qui permet également une suppression immédiate et définitive (par exemple, purge lorsque 7<= SoftDeleteRetentionInDays < 90). Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention, sauf si une opération de purge est demandée ou si l’abonnement est annulé.
Purgeable	string	Désigne un état de coffre dans lequel la suppression est une opération irréversible, sans possibilité de récupération. Ce niveau correspond à l’absence de protection disponible contre une opération de suppression ; les données sont irrémédiablement perdues lors de l’acceptation d’une opération de suppression au niveau de l’entité ou au niveau supérieur (coffre, groupe de ressources, abonnement, etc.)
Recoverable	string	Désigne un état de coffre dans lequel la suppression est récupérable sans possibilité de suppression immédiate et définitive (c’est-à-dire une purge). Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention (90 jours) et tant que l’abonnement est toujours disponible. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré
Recoverable+ProtectedSubscription	string	Désigne un état de coffre et d’abonnement dans lequel la suppression est récupérable dans l’intervalle de rétention (90 jours), la suppression immédiate et définitive (c’est-à-dire la purge) n’est pas autorisée et dans lequel l’abonnement lui-même ne peut pas être annulé définitivement. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré
Recoverable+Purgeable	string	Désigne un état de coffre dans lequel la suppression est récupérable et qui permet également une suppression immédiate et définitive (c’est-à-dire une purge). Ce niveau garantit la récupération de l’entité supprimée pendant l’intervalle de rétention (90 jours), sauf si une opération de purge est demandée ou si l’abonnement est annulé. Le système le supprimera définitivement après 90 jours, s’il n’est pas récupéré

Error

Erreur du serveur du coffre de clés.

Nom	Type	Description
code	string	Code d'erreur.
innererror	Error	Erreur du serveur du coffre de clés.
message	string	Message d’erreur.

KeyVaultError

Exception d’erreur du coffre de clés.

Nom	Type	Description
error	Error	Erreur du serveur du coffre de clés.

SasDefinitionAttributes

Attributs de gestion des définitions SAP.

Nom	Type	Description
created	integer	Heure de création en UTC.
enabled	boolean	état activé de l’objet.
recoverableDays	integer	softDelete data retention days. La valeur doit être >=7 et <=90 lorsque softDelete est activé, sinon 0.
recoveryLevel	DeletionRecoveryLevel	Reflète le niveau de récupération de suppression actuellement en vigueur pour les définitions SAP dans le coffre actuel. S’il contient « Purgeable », la définition SAP peut être supprimée définitivement par un utilisateur privilégié ; sinon, seul le système peut vider la définition SAP, à la fin de l’intervalle de rétention.
updated	integer	Heure de la dernière mise à jour en UTC.

Partager via