Get Secret Versions - Get Secret Versions
지정된 비밀의 모든 버전을 나열합니다.
응답에서는 전체 암호 식별자 및 특성이 제공됩니다. 비밀에 대한 값이 반환되지 않습니다. 이 작업에는 비밀/목록 권한이 필요합니다.
GET {vaultBaseUrl}/secrets/{secret-name}/versions?api-version=7.4
GET {vaultBaseUrl}/secrets/{secret-name}/versions?maxresults={maxresults}&api-version=7.4
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
secret-name
|
path | True |
string |
비밀의 이름입니다. |
vault
|
path | True |
string |
자격 증명 모음 이름(예 https://myvault.vault.azure.net: )입니다. |
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
maxresults
|
query |
integer int32 |
페이지에서 반환할 최대 결과 수입니다. 지정하지 않으면 서비스는 최대 25개 결과를 반환합니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
비밀의 다음 페이지에 대한 링크와 함께 비밀 목록을 포함하는 응답 메시지입니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답을 Key Vault. |
예제
GetSecretVersions
Sample Request
GET https://myvault.vault.azure.net//secrets/listsecretversionstest/versions?maxresults=1&api-version=7.4
Sample Response
{
"value": [
{
"id": "https://myvault.vault.azure.net/secrets/listsecretversionstest/11a536561da34d6b8b452d880df58f3a",
"attributes": {
"enabled": true,
"created": 1481851699,
"updated": 1481851699
}
}
],
"nextLink": "https://myvault.vault.azure.net:443/secrets/listsecretversionstest/versions?api-version=7.2&$skiptoken=eyJOZXh0TWFya2VyIjoiMiExNDQhTURBd01EWXlJWE5sWTNKbGRDOU1TVk5VVTBWRFVrVlVWa1ZTVTBsUFRsTlVSVk5VTHpGRU5EazJNa0l4UlVRM09EUkVRa1k0T1RsR016TXpNa1UwTnpZNFFqY3dJVEF3TURBeU9DRTVPVGs1TFRFeUxUTXhWREl6T2pVNU9qVTVMams1T1RrNU9UbGFJUS0tIiwiVGFyZ2V0TG9jYXRpb24iOjB9&maxresults=1"
}
정의
Name | Description |
---|---|
Deletion |
현재 자격 증명 모음의 비밀에 대해 현재 적용 중인 삭제 복구 수준을 반영합니다. '제거 가능'이 포함된 경우 권한 있는 사용자가 비밀을 영구적으로 삭제할 수 있습니다. 그렇지 않으면 시스템에서만 보존 간격이 끝날 때 비밀을 제거할 수 있습니다. |
Error |
키 자격 증명 모음 서버 오류입니다. |
Key |
키 자격 증명 모음 오류 예외입니다. |
Secret |
비밀 관리 특성입니다. |
Secret |
비밀 메타데이터를 포함하는 비밀 항목입니다. |
Secret |
비밀 목록 결과입니다. |
DeletionRecoveryLevel
현재 자격 증명 모음의 비밀에 대해 현재 적용 중인 삭제 복구 수준을 반영합니다. '제거 가능'이 포함된 경우 권한 있는 사용자가 비밀을 영구적으로 삭제할 수 있습니다. 그렇지 않으면 시스템에서만 보존 간격이 끝날 때 비밀을 제거할 수 있습니다.
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 |
키 자격 증명 모음 서버 오류입니다. |
|
message |
string |
오류 메시지입니다. |
KeyVaultError
키 자격 증명 모음 오류 예외입니다.
Name | 형식 | Description |
---|---|---|
error |
키 자격 증명 모음 서버 오류입니다. |
SecretAttributes
비밀 관리 특성입니다.
Name | 형식 | Description |
---|---|---|
created |
integer |
생성 시간(UTC)입니다. |
enabled |
boolean |
개체를 사용할 수 있는지 여부를 확인합니다. |
exp |
integer |
만료 날짜(UTC)입니다. |
nbf |
integer |
UTC에서 날짜 이전이 아닙니다. |
recoverableDays |
integer |
softDelete 데이터 보존 일수입니다. softDelete를 사용하도록 설정하면 값이 =7이고 <=90이어야 합니다. 그렇지 않으면 0입니다>. |
recoveryLevel |
현재 자격 증명 모음의 비밀에 대해 현재 적용 중인 삭제 복구 수준을 반영합니다. '제거 가능'이 포함된 경우 권한 있는 사용자가 비밀을 영구적으로 삭제할 수 있습니다. 그렇지 않으면 시스템에서만 보존 간격이 끝날 때 비밀을 제거할 수 있습니다. |
|
updated |
integer |
마지막으로 업데이트된 시간(UTC)입니다. |
SecretItem
비밀 메타데이터를 포함하는 비밀 항목입니다.
Name | 형식 | Description |
---|---|---|
attributes |
비밀 관리 특성입니다. |
|
contentType |
string |
암호와 같은 비밀 값의 유형입니다. |
id |
string |
비밀 식별자입니다. |
managed |
boolean |
True이면 비밀의 수명이 키 자격 증명 모음에서 관리됩니다. 인증서를 지원하는 키인 경우 관리되는 것이 true입니다. |
tags |
object |
키/값 쌍 형식의 애플리케이션 특정 메타데이터입니다. |
SecretListResult
비밀 목록 결과입니다.
Name | 형식 | Description |
---|---|---|
nextLink |
string |
다음 비밀 집합을 가져올 URL입니다. |
value |
다음 비밀 페이지에 대한 링크와 함께 키 자격 증명 모음의 비밀 목록을 포함하는 응답 메시지입니다. |