Compartir a través de


Get Deleted Sas Definitions - Get Deleted Sas Definitions

Listas definiciones de SAS eliminadas para el almacén y la cuenta de almacenamiento especificados.
La operación Get Deleted Sas Definitions devuelve las definiciones de SAS que se han eliminado para un almacén habilitado para la eliminación temporal. Esta operación requiere el permiso storage/listsas.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
storage-account-name
path True

string

El nombre de la cuenta de almacenamiento.

Regex pattern: ^[0-9a-zA-Z]+$

vaultBaseUrl
path True

string

El nombre del almacén, por ejemplo https://myvault.vault.azure.net, .

api-version
query True

string

Versión de API del cliente.

maxresults
query

integer

int32

Número máximo de resultados que se van a devolver en una página. Si no se especifica, el servicio devolverá hasta 25 resultados.

Respuestas

Nombre Tipo Description
200 OK

DeletedSasDefinitionListResult

Mensaje de respuesta que contiene una lista de definiciones de SAS eliminadas para la cuenta de almacenamiento, junto con un vínculo a la página siguiente de definiciones de SAS eliminadas.

Other Status Codes

KeyVaultError

Key Vault respuesta de error que describe por qué se produjo un error en la operación.

Ejemplos

List Deleted Storage Sas Definitions

Sample Request

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

Sample Response

{
  "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>"
}

Definiciones

Nombre Description
DeletedSasDefinitionItem

Elemento de definición de SAS eliminado que contiene metadatos sobre la definición de SAS eliminada.

DeletedSasDefinitionListResult

Resultado de la lista de definiciones de SAS eliminada

DeletionRecoveryLevel

Refleja el nivel de recuperación de eliminación actualmente en vigor para las cuentas de almacenamiento en el almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente la cuenta de almacenamiento; de lo contrario, solo el sistema puede purgar la cuenta de almacenamiento, al final del intervalo de retención.

Error

Error del servidor del almacén de claves.

KeyVaultError

Excepción de error del almacén de claves.

SasDefinitionAttributes

Atributos de administración de definiciones de SAS.

DeletedSasDefinitionItem

Elemento de definición de SAS eliminado que contiene metadatos sobre la definición de SAS eliminada.

Nombre Tipo Description
attributes

SasDefinitionAttributes

Atributos de administración de definiciones de SAS.

deletedDate

integer

Hora en que se eliminó la definición de SAS, en UTC

id

string

Identificador de SAS de almacenamiento.

recoveryId

string

Dirección URL del objeto de recuperación, que se usa para identificar y recuperar la definición de SAS eliminada.

scheduledPurgeDate

integer

Hora a la que se programa la definición de SAS para purgarse, en UTC

sid

string

Identificador de secreto de definición de SAS de la cuenta de almacenamiento.

tags

object

Metadatos específicos de la aplicación en forma de pares clave-valor.

DeletedSasDefinitionListResult

Resultado de la lista de definiciones de SAS eliminada

Nombre Tipo Description
nextLink

string

Dirección URL para obtener el siguiente conjunto de definiciones de SAS eliminadas.

value

DeletedSasDefinitionItem[]

Un mensaje de respuesta que contiene una lista de las definiciones de SAS eliminadas en el almacén junto con un vínculo a la página siguiente de definiciones sas eliminadas

DeletionRecoveryLevel

Refleja el nivel de recuperación de eliminación actualmente en vigor para las cuentas de almacenamiento en el almacén actual. Si contiene "Purgable", un usuario con privilegios puede eliminar permanentemente la cuenta de almacenamiento; de lo contrario, solo el sistema puede purgar la cuenta de almacenamiento, al final del intervalo de retención.

Nombre Tipo Description
CustomizedRecoverable

string

Indica un estado de almacén en el que la eliminación se puede recuperar sin la posibilidad de eliminación inmediata y permanente (es decir, purgar cuando 7<= SoftDeleteRetentionInDays < 90). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención y mientras la suscripción sigue estando disponible.

CustomizedRecoverable+ProtectedSubscription

string

Indica un almacén y un estado de suscripción en el que la eliminación es recuperable, inmediata y permanente (es decir, la purga) no está permitida y en la que la propia suscripción no se puede cancelar permanentemente cuando 7<= SoftDeleteRetentionInDays < 90. Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención y también refleja el hecho de que no se puede cancelar la propia suscripción.

CustomizedRecoverable+Purgeable

string

Indica un estado de almacén en el que se puede recuperar la eliminación y que también permite la eliminación inmediata y permanente (es decir, purgar cuando 7<= SoftDeleteRetentionInDays < 90). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención, a menos que se solicite una operación de purga o se cancele la suscripción.

Purgeable

string

Indica un estado de almacén en el que la eliminación es una operación irreversible, sin la posibilidad de recuperación. Este nivel no corresponde a ninguna protección disponible en una operación de eliminación; los datos se pierden irrecuperablemente al aceptar una operación de eliminación en el nivel de entidad o superior (almacén, grupo de recursos, suscripción, etc.).

Recoverable

string

Denota un estado de almacén en el que la eliminación se puede recuperar sin la posibilidad de eliminación inmediata y permanente (es decir, purga). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención (90 días) y mientras la suscripción sigue estando disponible. El sistema lo eliminará permanentemente después de 90 días, si no se recupera

Recoverable+ProtectedSubscription

string

Indica un almacén y un estado de suscripción en el que la eliminación se puede recuperar dentro del intervalo de retención (90 días), no se permite la eliminación inmediata y permanente (es decir, purga) y en la que la propia suscripción no se puede cancelar permanentemente. El sistema lo eliminará permanentemente después de 90 días, si no se recupera

Recoverable+Purgeable

string

Indica un estado de almacén en el que se puede recuperar la eliminación y que también permite la eliminación inmediata y permanente (es decir, purga). Este nivel garantiza la capacidad de recuperación de la entidad eliminada durante el intervalo de retención (90 días), a menos que se solicite una operación de purga o se cancele la suscripción. El sistema lo eliminará permanentemente después de 90 días, si no se recupera

Error

Error del servidor del almacén de claves.

Nombre Tipo Description
code

string

Código de error.

innererror

Error

Error del servidor del almacén de claves.

message

string

El mensaje de error.

KeyVaultError

Excepción de error del almacén de claves.

Nombre Tipo Description
error

Error

Error del servidor del almacén de claves.

SasDefinitionAttributes

Atributos de administración de definiciones de SAS.

Nombre Tipo Description
created

integer

Hora de creación en UTC.

enabled

boolean

el estado habilitado del objeto.

recoverableDays

integer

días de retención de datos softDelete. El valor debe ser >=7 y <=90 cuando softDelete está habilitado; en caso contrario, 0.

recoveryLevel

DeletionRecoveryLevel

Refleja el nivel de recuperación de eliminación actualmente en vigor para las definiciones de SAS en el almacén actual. Si contiene "Purgable", la definición de SAS puede eliminarse permanentemente por un usuario con privilegios; de lo contrario, solo el sistema puede purgar la definición de SAS, al final del intervalo de retención.

updated

integer

Hora de la última actualización en UTC.