Get Deleted Certificates - Get Deleted Certificates

참조

Service:: Key Vault

API Version:: 7.4

현재 복구에 사용할 수 있는 지정된 자격 증명 모음에서 삭제된 인증서를 Lists.
GetDeletedCertificates 작업은 삭제된 상태이고 복구 또는 제거 준비가 된 현재 자격 증명 모음의 인증서를 검색합니다. 이 작업에는 삭제 관련 정보가 포함됩니다. 이 작업을 수행하려면 인증서/가져오기/목록 권한이 필요합니다. 이 작업은 일시 삭제 사용 자격 증명 모음에서만 사용하도록 설정할 수 있습니다.

GET {vaultBaseUrl}/deletedcertificates?api-version=7.4

With optional parameters:

GET {vaultBaseUrl}/deletedcertificates?maxresults={maxresults}&includePending={includePending}&api-version=7.4

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
vaultBaseUrl	path	True	string	자격 증명 모음 이름(예: https://myvault.vault.azure.net)입니다.
api-version	query	True	string	클라이언트 API 버전입니다.
includePending	query		boolean	완전히 프로비전되지 않은 인증서를 포함할지 여부를 지정합니다.
maxresults	query		integer int32	페이지에서 반환할 최대 결과 수입니다. 지정하지 않으면 서비스는 최대 25개 결과를 반환합니다.

응답

Name	형식	Description
200 OK	DeletedCertificateListResult	자격 증명 모음의 삭제된 인증서 목록과 삭제된 인증서의 다음 페이지에 대한 링크가 포함된 응답 메시지
Other Status Codes	KeyVaultError	작업이 실패한 이유를 설명하는 오류 응답을 Key Vault.

예제

GetDeletedCertificates

Sample Request

HTTP

GET https://myvault.vault.azure.net//deletedcertificates?maxresults=1&api-version=7.4

Sample Response

Status code:: 200

{
  "value": [
    {
      "recoveryId": "https://myvault.vault.azure.net/deletedcertificates/listdeletedcerttest0",
      "deletedDate": 1493937659,
      "scheduledPurgeDate": 1501713659,
      "id": "https://myvault.vault.azure.net/certificates/listdeletedcerttest0",
      "x5t": "fLi3U52HunIVNXubkEnf8tP6Wbo",
      "attributes": {
        "enabled": true,
        "nbf": 1430344421,
        "exp": 2208988799,
        "created": 1493937658,
        "updated": 1493937658,
        "recoveryLevel": "Recoverable+Purgeable"
      }
    }
  ],
  "nextLink": "https://myvault.vault.azure.net:443/deletedcertificates?api-version=7.2&$skiptoken=eyJOZXh0TWFya2VyIjoiMiExMTIhTURBd01ETTVJV05sY25ScFptbGpZWFJsTDB4SlUxUkVSVXhGVkVWRVEwVlNWRlJGVTFRd0wxQlBURWxEV1NFd01EQXdNamdoT1RrNU9TMHhNaTB6TVZReU16bzFPVG8xT1M0NU9UazVPVGs1V2lFLSIsIlRhcmdldExvY2F0aW9uIjowfQ&maxresults=1"
}

정의

Name	Description
CertificateAttributes	인증서 관리 특성입니다.
DeletedCertificateItem	삭제된 인증서에 대한 메타데이터가 포함된 삭제된 인증서 항목입니다.
DeletedCertificateListResult	이 자격 증명 모음에서 삭제된 인증서 목록입니다.
DeletionRecoveryLevel	현재 자격 증명 모음의 인증서에 대해 현재 적용되는 삭제 복구 수준을 반영합니다. 'Purgeable'이 포함된 경우 권한 있는 사용자가 인증서를 영구적으로 삭제할 수 있습니다. 그렇지 않으면 시스템에서만 보존 간격이 끝날 때 인증서를 제거할 수 있습니다.
Error	키 자격 증명 모음 서버 오류입니다.
KeyVaultError	키 자격 증명 모음 오류 예외입니다.

CertificateAttributes

인증서 관리 특성입니다.

Name	형식	Description
created	integer	UTC의 생성 시간입니다.
enabled	boolean	개체를 사용할 수 있는지 여부를 결정합니다.
exp	integer	UTC의 만료 날짜입니다.
nbf	integer	UTC에서 날짜 이전이 아닙니다.
recoverableDays	integer	softDelete 데이터 보존 일 수입니다. softDelete를 >사용하도록 설정한 경우 값은 =7 및 <=90이어야 합니다. 그렇지 않으면 0입니다.
recoveryLevel	DeletionRecoveryLevel	현재 자격 증명 모음의 인증서에 대해 현재 적용되는 삭제 복구 수준을 반영합니다. 'Purgeable'이 포함된 경우 권한 있는 사용자가 인증서를 영구적으로 삭제할 수 있습니다. 그렇지 않으면 시스템에서만 보존 간격이 끝날 때 인증서를 제거할 수 있습니다.
updated	integer	UTC에서 마지막으로 업데이트된 시간입니다.

DeletedCertificateItem

삭제된 인증서에 대한 메타데이터가 포함된 삭제된 인증서 항목입니다.

Name	형식	Description
attributes	CertificateAttributes	인증서 관리 특성입니다.
deletedDate	integer	인증서가 삭제된 시간(UTC)
id	string	인증서 ID입니다.
recoveryId	string	삭제된 인증서를 식별하고 복구하는 데 사용되는 복구 개체의 URL입니다.
scheduledPurgeDate	integer	인증서를 제거하도록 예약된 시간(UTC)입니다.
tags	object	키/값 쌍 형식의 애플리케이션 특정 메타데이터입니다.
x5t	string	인증서의 지문입니다.

DeletedCertificateListResult

이 자격 증명 모음에서 삭제된 인증서 목록입니다.

Name	형식	Description
nextLink	string	삭제된 다음 인증서 집합을 가져올 URL입니다.
value	DeletedCertificateItem[]	자격 증명 모음의 삭제된 인증서 목록과 삭제된 인증서의 다음 페이지에 대한 링크가 포함된 응답 메시지

DeletionRecoveryLevel

현재 자격 증명 모음의 인증서에 대해 현재 적용되는 삭제 복구 수준을 반영합니다. 'Purgeable'이 포함된 경우 권한 있는 사용자가 인증서를 영구적으로 삭제할 수 있습니다. 그렇지 않으면 시스템에서만 보존 간격이 끝날 때 인증서를 제거할 수 있습니다.

Name	형식	Description
CustomizedRecoverable	string	즉시 영구 삭제할 가능성 없이 삭제를 복구할 수 있는 자격 증명 모음 상태를 나타냅니다(즉, 7<= SoftDeleteRetentionInDays < 90인 경우 제거). 이 수준은 보존 간격 동안 및 구독을 계속 사용할 수 있는 동안 삭제된 엔터티의 복구 가능성을 보장합니다.
CustomizedRecoverable+ProtectedSubscription	string	삭제가 복구 가능하고, 즉각적이고 영구적인 삭제(즉, 제거)가 허용되지 않으며, 7<= SoftDeleteRetentionInDays < 90일 때 구독 자체를 영구적으로 취소할 수 없는 자격 증명 모음 및 구독 상태를 나타냅니다. 이 수준은 보존 간격 동안 삭제된 엔터티의 복구 가능성을 보장하며 구독 자체를 취소할 수 없다는 사실도 반영합니다.
CustomizedRecoverable+Purgeable	string	삭제를 복구할 수 있는 자격 증명 모음 상태와 즉시 영구 삭제를 허용하는 자격 증명 모음 상태를 나타냅니다(즉, 7<= SoftDeleteRetentionInDays < 90인 경우 제거). 이 수준은 제거 작업이 요청되거나 구독이 취소되지 않는 한 보존 간격 동안 삭제된 엔터티의 복구 가능성을 보장합니다.
Purgeable	string	삭제가 복구되지 않고 되돌릴 수 없는 작업인 자격 증명 모음 상태를 표시합니다. 이 수준은 삭제 작업에 대해 사용할 수 있는 보호가 없음에 해당합니다. 엔터티 수준 이상(자격 증명 모음, 리소스 그룹, 구독 등)에서 삭제 작업을 수락하면 데이터가 돌이킬 수 없을 정도로 손실됩니다.
Recoverable	string	즉시 영구 삭제(즉, 제거)할 가능성 없이 삭제를 복구할 수 있는 자격 증명 모음 상태를 나타냅니다. 이 수준은 보존 간격(90일)과 구독을 계속 사용할 수 있는 동안 삭제된 엔터티의 복구 가능성을 보장합니다. 시스템이 복구되지 않은 경우 90일 후에 영구적으로 삭제합니다.
Recoverable+ProtectedSubscription	string	보존 간격(90일) 내에 삭제를 복구할 수 있고, 즉시 및 영구 삭제(즉, 제거)가 허용되지 않으며 구독 자체를 영구적으로 취소할 수 없는 자격 증명 모음 및 구독 상태를 나타냅니다. 시스템이 복구되지 않은 경우 90일 후에 영구적으로 삭제합니다.
Recoverable+Purgeable	string	삭제를 복구할 수 있고 즉시 영구 삭제(즉, 제거)도 허용하는 자격 증명 모음 상태를 나타냅니다. 이 수준은 제거 작업이 요청되거나 구독이 취소되지 않는 한 보존 간격(90일) 동안 삭제된 엔터티의 복구 가능성을 보장합니다. 시스템이 복구되지 않은 경우 90일 후에 영구적으로 삭제합니다.

Error

키 자격 증명 모음 서버 오류입니다.

Name	형식	Description
code	string	오류 코드입니다.
innererror	Error	키 자격 증명 모음 서버 오류입니다.
message	string	오류 메시지입니다.

KeyVaultError

키 자격 증명 모음 오류 예외입니다.

Name	형식	Description
error	Error	키 자격 증명 모음 서버 오류입니다.