Get Certificate Policy - Get Certificate Policy

Odwołanie

Service:: Key Vault

API Version:: 7.4

Listy zasad dla certyfikatu.
Operacja GetCertificatePolicy zwraca określone zasoby zasad certyfikatu w określonym magazynie kluczy. Ta operacja wymaga uprawnień do certyfikatów/pobierania.

GET {vaultBaseUrl}/certificates/{certificate-name}/policy?api-version=7.4

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
certificate-name	path	True	string	Nazwa certyfikatu w danym magazynie kluczy.
vaultBaseUrl	path	True	string	Nazwa magazynu, na przykład https://myvault.vault.azure.net.
api-version	query	True	string	Wersja interfejsu API klienta.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CertificatePolicy	Zasady certyfikatu.
Other Status Codes	KeyVaultError	Key Vault odpowiedzi na błąd opisujący, dlaczego operacja nie powiodła się.

Przykłady

GetCertificatePolicy

Sample Request

HTTP

GET https://myvault.vault.azure.net//certificates/updateCert01/policy?api-version=7.4

Sample Response

Status code:: 200

{
  "id": "https://myvault.vault.azure.net/certificates/updateCert01/policy",
  "key_props": {
    "exportable": true,
    "kty": "RSA",
    "key_size": 2048,
    "reuse_key": false
  },
  "secret_props": {
    "contentType": "application/x-pkcs12"
  },
  "x509_props": {
    "subject": "CN=KeyVaultTest",
    "ekus": [],
    "key_usage": [],
    "validity_months": 297
  },
  "lifetime_actions": [
    {
      "trigger": {
        "lifetime_percentage": 80
      },
      "action": {
        "action_type": "EmailContacts"
      }
    }
  ],
  "issuer": {
    "name": "Unknown"
  },
  "attributes": {
    "enabled": true,
    "created": 1482188947,
    "updated": 1482188947
  }
}

Definicje

Nazwa	Opis
Action	Akcja, która zostanie wykonana.
CertificateAttributes	Atrybuty zarządzania certyfikatami.
CertificatePolicy	Zasady zarządzania dla certyfikatu.
CertificatePolicyAction	Typ akcji.
DeletionRecoveryLevel	Odzwierciedla obecnie poziom odzyskiwania usuwania dla certyfikatów w bieżącym magazynie. Jeśli zawiera wartość "Przeczyszczalną", certyfikat może zostać trwale usunięty przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić certyfikat na końcu okresu przechowywania.
Error	Błąd serwera magazynu kluczy.
IssuerParameters	Parametry wystawcy składnika X509 certyfikatu.
JsonWebKeyCurveName	Nazwa krzywej eliptycznej. Prawidłowe wartości można znaleźć w temacie JsonWebKeyCurveName.
JsonWebKeyType	Typ pary kluczy, która ma być używana dla certyfikatu.
KeyProperties	Właściwości pary kluczy kopii zapasowej certyfikatu.
KeyUsageType	Definiuje sposób użycia klucza certyfikatu.
KeyVaultError	Wyjątek błędu magazynu kluczy.
LifetimeAction	Akcja i jego wyzwalacz, który zostanie wykonany przez Key Vault w okresie istnienia certyfikatu.
SecretProperties	Właściwości klucza kopii zapasowej certyfikatu.
SubjectAlternativeNames	Alternatywne nazwy podmiotu obiektu X509.
Trigger	Warunek, który ma zostać spełniony, aby wykonać akcję.
X509CertificateProperties	Właściwości składnika X509 certyfikatu.

Action

Akcja, która zostanie wykonana.

Nazwa	Typ	Opis
action_type	CertificatePolicyAction	Typ akcji.

CertificateAttributes

Atrybuty zarządzania certyfikatami.

Nazwa	Typ	Opis
created	integer	Czas utworzenia w formacie UTC.
enabled	boolean	Określa, czy obiekt jest włączony.
exp	integer	Data wygaśnięcia w formacie UTC.
nbf	integer	Nie wcześniej niż data w formacie UTC.
recoverableDays	integer	softDelete data retention days (dni przechowywania danych softDelete). Wartość powinna mieć >wartość =7 i <=90, gdy funkcja softDelete jest włączona, w przeciwnym razie 0.
recoveryLevel	DeletionRecoveryLevel	Odzwierciedla obecnie poziom odzyskiwania usuwania dla certyfikatów w bieżącym magazynie. Jeśli zawiera wartość "Przeczyszczalną", certyfikat może zostać trwale usunięty przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić certyfikat na końcu okresu przechowywania.
updated	integer	Czas ostatniej aktualizacji w formacie UTC.

CertificatePolicy

Zasady zarządzania dla certyfikatu.

Nazwa	Typ	Opis
attributes	CertificateAttributes	Atrybuty certyfikatu.
id	string	Identyfikator certyfikatu.
issuer	IssuerParameters	Parametry wystawcy składnika X509 certyfikatu.
key_props	KeyProperties	Właściwości klucza kopii zapasowej certyfikatu.
lifetime_actions	LifetimeAction[]	Akcje, które będą wykonywane przez Key Vault przez okres istnienia certyfikatu.
secret_props	SecretProperties	Właściwości wpisu tajnego do tworzenia kopii zapasowej certyfikatu.
x509_props	X509CertificateProperties	Właściwości składnika X509 certyfikatu.

CertificatePolicyAction

Typ akcji.

Nazwa	Typ	Opis
AutoRenew	string
EmailContacts	string

DeletionRecoveryLevel

Odzwierciedla obecnie poziom odzyskiwania usuwania dla certyfikatów w bieżącym magazynie. Jeśli zawiera wartość "Przeczyszczalną", certyfikat może zostać trwale usunięty przez uprzywilejowanego użytkownika; w przeciwnym razie tylko system może przeczyścić certyfikat na końcu okresu przechowywania.

Nazwa	Typ	Opis
CustomizedRecoverable	string	Określa stan magazynu, w którym można odzyskać usunięcie bez możliwości natychmiastowego i trwałego usunięcia (tj. przeczyszczania, gdy 7< = SoftDeleteRetentionInDays < 90). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania i gdy subskrypcja jest nadal dostępna.
CustomizedRecoverable+ProtectedSubscription	string	Oznacza, że magazyn i stan subskrypcji, w którym usunięcie jest możliwe do odzyskania, natychmiastowe i trwałe usunięcie (tj. przeczyszczenie) jest niedozwolone i w którym sama subskrypcja nie może zostać trwale anulowana, gdy 7< = SoftDeleteRetentionInDays < 90. Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania, a także odzwierciedla fakt, że sama subskrypcja nie może zostać anulowana.
CustomizedRecoverable+Purgeable	string	Określa stan magazynu, w którym można odzyskać usunięcie, a także zezwala na natychmiastowe i trwałe usunięcie (tj. przeczyszczanie, gdy 7< = SoftDeleteRetentionInDays < 90). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania, chyba że zażądano operacji przeczyszczania lub subskrypcja zostanie anulowana.
Purgeable	string	Określa stan magazynu, w którym usunięcie jest operacją nieodwracalną, bez możliwości odzyskiwania. Ten poziom nie odpowiada działaniu ochrony przed operacją Usuwania; dane są nieodwracalnie utracone po zaakceptowaniu operacji Usuwania na poziomie jednostki lub wyższym (magazyn, grupa zasobów, subskrypcja itp.)
Recoverable	string	Określa stan magazynu, w którym można odzyskać usunięcie bez możliwości natychmiastowego i trwałego usunięcia (tj. przeczyszczania). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania (90 dni) i gdy subskrypcja jest nadal dostępna. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany
Recoverable+ProtectedSubscription	string	Określa magazyn i stan subskrypcji, w którym usunięcie można odzyskać w okresie przechowywania (90 dni), natychmiastowe i trwałe usunięcie (tj. przeczyszczenie) jest niedozwolone i w którym sama subskrypcja nie może zostać trwale anulowana. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany
Recoverable+Purgeable	string	Określa stan magazynu, w którym można odzyskać usunięcie, a także umożliwia natychmiastowe i trwałe usunięcie (tj. przeczyszczenie). Ten poziom gwarantuje możliwość odzyskania usuniętej jednostki w okresie przechowywania (90 dni), chyba że zażądano operacji przeczyszczania lub subskrypcja zostanie anulowana. System zostanie trwale usunięty po 90 dniach, jeśli nie zostanie odzyskany

Error

Błąd serwera magazynu kluczy.

Nazwa	Typ	Opis
code	string	Kod błędu.
innererror	Error	Błąd serwera magazynu kluczy.
message	string	Komunikat o błędzie.

IssuerParameters

Parametry wystawcy składnika X509 certyfikatu.

Nazwa	Typ	Opis
cert_transparency	boolean	Wskazuje, czy certyfikaty wygenerowane w ramach tych zasad powinny być publikowane w dziennikach przezroczystości certyfikatów.
cty	string	Typ certyfikatu obsługiwany przez dostawcę (opcjonalnie); na przykład "OV-SSL", "EV-SSL"
name	string	Nazwa obiektu wystawcy, do których odwołuje się odwołanie lub nazwy zarezerwowane; na przykład "Self" lub "Unknown".

JsonWebKeyCurveName

Nazwa krzywej eliptycznej. Prawidłowe wartości można znaleźć w temacie JsonWebKeyCurveName.

Nazwa	Typ	Opis
P-256	string
P-256K	string
P-384	string
P-521	string

JsonWebKeyType

Typ pary kluczy, która ma być używana dla certyfikatu.

Nazwa	Typ	Opis
EC	string
EC-HSM	string
RSA	string
RSA-HSM	string
oct	string
oct-HSM	string

KeyProperties

Właściwości pary kluczy kopii zapasowej certyfikatu.

Nazwa	Typ	Opis
crv	JsonWebKeyCurveName	Nazwa krzywej eliptycznej. Prawidłowe wartości można znaleźć w temacie JsonWebKeyCurveName.
exportable	boolean	Wskazuje, czy klucz prywatny można wyeksportować. Zasady wydania należy podać podczas tworzenia pierwszej wersji klucza możliwego do wyeksportowania.
key_size	integer	Rozmiar klucza w bitach. Na przykład: 2048, 3072 lub 4096 dla RSA.
kty	JsonWebKeyType	Typ pary kluczy, która ma być używana dla certyfikatu.
reuse_key	boolean	Wskazuje, czy ta sama para kluczy będzie używana podczas odnawiania certyfikatu.

KeyUsageType

Definiuje sposób użycia klucza certyfikatu.

Nazwa	Typ	Opis
cRLSign	string
dataEncipherment	string
decipherOnly	string
digitalSignature	string
encipherOnly	string
keyAgreement	string
keyCertSign	string
keyEncipherment	string
nonRepudiation	string

KeyVaultError

Wyjątek błędu magazynu kluczy.

Nazwa	Typ	Opis
error	Error	Błąd serwera magazynu kluczy.

LifetimeAction

Akcja i jego wyzwalacz, który zostanie wykonany przez Key Vault w okresie istnienia certyfikatu.

Nazwa	Typ	Opis
action	Action	Akcja, która zostanie wykonana.
trigger	Trigger	Warunek, który wykona akcję.

SecretProperties

Właściwości klucza kopii zapasowej certyfikatu.

Nazwa	Typ	Opis
contentType	string	Typ nośnika (typ MIME).

SubjectAlternativeNames

Alternatywne nazwy podmiotu obiektu X509.

Nazwa	Typ	Opis
dns_names	string[]	Nazwy domen.
emails	string[]	Email adresy.
upns	string[]	Główne nazwy użytkowników.

Trigger

Warunek, który ma zostać spełniony, aby wykonać akcję.

Nazwa	Typ	Opis
days_before_expiry	integer	Dni przed wygaśnięciem, aby spróbować odnowić. Wartość powinna być z zakresu od 1 do validity_in_months pomnożona przez 27. Jeśli validity_in_months wynosi 36, wartość powinna należeć do przedziału od 1 do 972 (36 * 27).
lifetime_percentage	integer	Procent okresu istnienia, w którym ma być wyzwalany. Wartość powinna należeć do przedziału od 1 do 99.

X509CertificateProperties

Właściwości składnika X509 certyfikatu.

Nazwa	Typ	Opis
ekus	string[]	Ulepszone użycie klucza.
key_usage	KeyUsageType[]	Definiuje sposób użycia klucza certyfikatu.
sans	SubjectAlternativeNames	Alternatywne nazwy podmiotu.
subject	string	Nazwa podmiotu. Powinna być prawidłową nazwą wyróżniającą X509.
validity_months	integer	Czas trwania certyfikatu jest ważny w miesiącach.

Share via