다음을 통해 공유


CertificateClient 클래스

자격 증명 모음의 인증서를 관리하기 위한 개략적인 인터페이스입니다.

상속
azure.keyvault.certificates._shared.client_base.KeyVaultClientBase
CertificateClient

생성자

CertificateClient(vault_url: str, credential: TokenCredential, **kwargs)

매개 변수

vault_url
str
필수

클라이언트가 액세스할 자격 증명 모음의 URL입니다. 이를 자격 증명 모음의 "DNS 이름"이라고도 합니다. 이 URL이 유효한 Key Vault 리소스를 참조하는지 확인해야 합니다. 자세한 내용은 https://aka.ms/azsdk/blog/vault-uri를 참조하세요.

credential
TokenCredential
필수

자격 증명 모음에 대한 액세스 토큰을 제공할 수 있는 개체(예: 의 자격 증명) identity

api_version
ApiVersion

사용할 서비스 API의 버전입니다. 기본값은 가장 최근으로 설정됩니다.

verify_challenge_resource
bool

인증 챌린지 리소스가 Key Vault 도메인과 일치하는지 확인합니다. 기본값은 True입니다.

메서드

backup_certificate

Azure Key Vault 사용할 수 있는 보호된 형식으로 인증서를 백업합니다.

인증서/백업 권한이 필요합니다. 이는 인증서를 한 자격 증명 모음에서 다른 자격 증명 모음으로 복사할 수 있도록 하기 위한 것입니다. 두 자격 증명 모음 모두 동일한 Azure 구독에서 소유해야 합니다. 또한 지정학적 경계를 넘어 백업/복원을 수행할 수 없습니다. 예를 들어 미국 지역의 자격 증명 모음에서 백업을 EU 지역의 자격 증명 모음으로 복원할 수 없습니다.

begin_create_certificate

새 인증서를 만듭니다.

첫 번째 버전인 경우 인증서 리소스가 만들어집니다. 이 작업에는 인증서/만들기 권한이 필요합니다. 반환된 폴러를 대기하려면 인증서/가져오기 권한이 필요하며 만들기에 성공하면 인증서를 제공하거나 그렇지 않은 경우 CertificateOperation을 제공합니다. 그렇지 않으면 을 HttpResponseError발생합니다.

begin_delete_certificate

인증서의 모든 버전을 삭제합니다. 인증서/삭제 권한이 필요합니다.

이 메서드가 반환될 때 Key Vault 인증서를 삭제하기 시작했습니다. 일시 삭제를 사용하도록 설정된 자격 증명 모음에서 삭제하는 데 몇 초 정도 걸릴 수 있습니다. 따라서 이 메서드는 삭제가 완료되기를 기다릴 수 있는 폴러를 반환합니다.

begin_recover_deleted_certificate

삭제된 인증서를 최신 버전으로 복구합니다. 일시 삭제가 사용하도록 설정된 자격 증명 모음에서만 가능합니다.

인증서/복구 권한이 필요합니다. 이 메서드가 반환될 때 Key Vault 인증서를 복구하기 시작했습니다. 복구에는 몇 초 정도 걸릴 수 있습니다. 따라서 이 메서드는 복구가 완료되기를 기다릴 수 있는 폴러를 반환합니다. 다른 작업에서 복구된 인증서를 즉시 사용하려는 경우에만 대기가 필요합니다.

cancel_certificate_operation

진행 중인 인증서 작업을 취소합니다. 인증서/업데이트 권한이 필요합니다.

close

클라이언트가 연 소켓을 닫습니다.

클라이언트를 컨텍스트 관리자로 사용할 때는 이 메서드를 호출할 필요가 없습니다.

create_issuer

지정된 인증서 발급자를 설정합니다. 인증서/setissuers 권한이 필요합니다.

delete_certificate_operation

특정 인증서에 대한 만들기 작업을 삭제하고 중지합니다.

인증서/업데이트 권한이 필요합니다.

delete_contacts

키 자격 증명 모음에 대한 인증서 연락처를 삭제합니다. 인증서/managecontacts 권한이 필요합니다.

delete_issuer

지정된 인증서 발급자를 삭제합니다.

인증서/manageissuers/deleteissuers 권한이 필요합니다.

get_certificate

관리 정책이 연결된 인증서를 가져옵니다. 인증서/가져오기 권한이 필요합니다.

인증서 버전을 매개 변수로 허용하지 않습니다. 특정 버전의 인증서를 얻으려면 를 호출합니다 get_certificate_version.

get_certificate_operation

인증서 만들기 작업을 가져옵니다. 인증서/가져오기 권한이 필요합니다.

get_certificate_policy

인증서에 대한 정책을 가져옵니다. 인증서/가져오기 권한이 필요합니다.

키 자격 증명 모음에 지정된 인증서 정책 리소스를 반환합니다.

get_certificate_version

관리 정책을 반환하지 않고 특정 버전의 인증서를 가져옵니다.

인증서/가져오기 권한이 필요합니다. 최신 버전의 인증서를 얻거나 인증서의 정책도 얻으려면 를 호출합니다 get_certificate.

get_contacts

키 자격 증명 모음에 대한 인증서 연락처를 가져옵니다. 인증서/managecontacts 권한이 필요합니다.

get_deleted_certificate

삭제된 인증서를 가져옵니다. 일시 삭제가 사용하도록 설정된 자격 증명 모음에서만 가능합니다.

인증서/가져오기 권한이 필요합니다. 삭제된 인증서 정보와 해당 특성(예: 보존 간격, 예약된 영구 삭제 및 현재 삭제 복구 수준)을 검색합니다.

get_issuer

지정된 인증서 발급자를 가져옵니다. 인증서/manageissuers/getissuers 권한이 필요합니다.

import_certificate

외부에서 만든 인증서를 가져옵니다. 인증서/가져오기 권한이 필요합니다.

프라이빗 키가 포함된 기존 유효한 인증서를 Azure Key Vault 가져옵니다. 가져올 인증서는 PFX 또는 PEM 형식일 수 있습니다. 인증서가 PEM 형식인 경우 PEM 파일에는 키와 x509 인증서가 포함되어야 하며 의 를 policycontent_typepem제공해야 합니다.

list_deleted_certificates

현재 복구 가능한 삭제된 인증서를 나열합니다. 자격 증명 모음이 일시 삭제를 사용하도록 설정된 경우에만 가능합니다.

인증서/가져오기/목록 권한이 필요합니다. 현재 자격 증명 모음에서 삭제된 상태이며 복구 또는 제거 준비가 된 인증서를 검색합니다. 이 작업에는 삭제 관련 정보가 포함됩니다.

list_properties_of_certificate_versions

인증서 버전의 식별자 및 속성을 나열합니다.

인증서/목록 권한이 필요합니다.

list_properties_of_certificates

자격 증명 모음에 있는 모든 인증서의 식별자 및 속성을 나열합니다.

인증서/목록 권한이 필요합니다.

list_properties_of_issuers

키 자격 증명 모음에 대한 인증서 발급자의 속성을 나열합니다.

인증서/manageissuers/getissuers 권한이 필요합니다.

merge_certificate

인증서 또는 인증서 체인을 서버에 존재하는 키 쌍과 병합합니다.

인증서/만들기 권한이 필요합니다. 현재 서비스에서 사용할 수 있는 키 쌍과 인증서 또는 인증서 체인의 병합을 수행합니다. 를 사용하여 begin_create_certificate 병합할 인증서를 만들 때 발급자를 '알 수 없음'으로 설정했는지 확인합니다. 이렇게 하면 Key Vault 알려진 발급자에서 인증서에 서명되지 않습니다.

purge_deleted_certificate

삭제된 인증서를 영구적으로 삭제합니다. 일시 삭제가 사용하도록 설정된 자격 증명 모음에서만 가능합니다.

인증서/제거 권한이 필요합니다. 복구할 가능성 없이 지정된 인증서를 되돌릴 수 없는 삭제를 수행합니다. 이 'Purgeable'을 recovery_level 지정하지 않으면 작업을 사용할 수 없습니다. 이 메서드는 인증서 앞에 scheduled_purge_date인증서를 제거하는 데만 필요합니다.

restore_certificate_backup

자격 증명 모음에 인증서 백업을 복원합니다. 인증서/복원 권한이 필요합니다.

그러면 이름, 특성 및 액세스 제어 정책을 사용하여 인증서의 모든 버전이 복원됩니다. 인증서 이름이 이미 사용 중인 경우 복원에 실패합니다. 또한 대상 자격 증명 모음은 원본 자격 증명 모음과 동일한 Microsoft Azure 구독에서 소유해야 합니다.

send_request

클라이언트의 기존 파이프라인을 사용하여 네트워크 요청을 실행합니다.

요청 URL은 자격 증명 모음 URL을 기준으로 할 수 있습니다. 요청에 사용되는 서비스 API 버전은 달리 지정하지 않는 한 클라이언트의 버전과 동일합니다. 응답이 오류인 경우 이 메서드는 발생하지 않습니다. 예외를 발생하려면 반환된 응답 개체에서 raise_for_status() 를 호출합니다. 이 메서드를 사용하여 사용자 지정 요청을 보내는 방법에 대한 자세한 내용은 를 참조하세요 https://aka.ms/azsdk/dpcodegen/python/send_request.

set_contacts

키 자격 증명 모음에 대한 인증서 연락처를 설정합니다. 인증서/managecontacts 권한이 필요합니다.

update_certificate_policy

인증서에 대한 정책을 업데이트. 인증서/업데이트 권한이 필요합니다.

인증서 정책에서 지정된 멤버를 설정합니다. 다른 사용자를 null로 둡니다.

update_certificate_properties

인증서의 속성을 변경합니다. 인증서/업데이트 권한이 필요합니다.

update_issuer

지정된 인증서 발급자를 업데이트. 인증서/setissuers 권한이 필요합니다.

backup_certificate

Azure Key Vault 사용할 수 있는 보호된 형식으로 인증서를 백업합니다.

인증서/백업 권한이 필요합니다. 이는 인증서를 한 자격 증명 모음에서 다른 자격 증명 모음으로 복사할 수 있도록 하기 위한 것입니다. 두 자격 증명 모음 모두 동일한 Azure 구독에서 소유해야 합니다. 또한 지정학적 경계를 넘어 백업/복원을 수행할 수 없습니다. 예를 들어 미국 지역의 자격 증명 모음에서 백업을 EU 지역의 자격 증명 모음으로 복원할 수 없습니다.

backup_certificate(certificate_name: str, **kwargs) -> bytes

매개 변수

certificate_name
str
필수

인증서 이름입니다.

반환

백업된 인증서가 포함된 백업 Blob입니다.

반환 형식

예외

인증서가 없으면

기타 오류의 경우

begin_create_certificate

새 인증서를 만듭니다.

첫 번째 버전인 경우 인증서 리소스가 만들어집니다. 이 작업에는 인증서/만들기 권한이 필요합니다. 반환된 폴러를 대기하려면 인증서/가져오기 권한이 필요하며 만들기에 성공하면 인증서를 제공하거나 그렇지 않은 경우 CertificateOperation을 제공합니다. 그렇지 않으면 을 HttpResponseError발생합니다.

begin_create_certificate(certificate_name: str, policy: CertificatePolicy, **kwargs) -> LROPoller[KeyVaultCertificate | CertificateOperation]

매개 변수

certificate_name
str
필수

인증서 이름입니다.

policy
CertificatePolicy
필수

인증서에 대한 관리 정책입니다. 주체 또는 주체 대체 이름 속성 중 하나가 필요합니다.

enabled
bool

인증서를 사용할 수 있는지 여부입니다.

tags
dict[str, str]

키/값 쌍 형식의 애플리케이션 특정 메타데이터입니다.

반환

인증서 만들기 작업에 대한 LROPoller입니다. 폴러를 기다리면 만들기에 성공하면 인증서가 제공되고, 그렇지 않으면 CertificateOperation이 표시됩니다.

반환 형식

예외

인증서 정책이 잘못된 경우

다른 오류에 대한 것입니다.

begin_delete_certificate

인증서의 모든 버전을 삭제합니다. 인증서/삭제 권한이 필요합니다.

이 메서드가 반환될 때 Key Vault 인증서를 삭제하기 시작했습니다. 일시 삭제를 사용하도록 설정된 자격 증명 모음에서 삭제하는 데 몇 초 정도 걸릴 수 있습니다. 따라서 이 메서드는 삭제가 완료되기를 기다릴 수 있는 폴러를 반환합니다.

begin_delete_certificate(certificate_name: str, **kwargs) -> LROPoller[DeletedCertificate]

매개 변수

certificate_name
str
필수

삭제할 인증서의 이름입니다.

반환

인증서 삭제 작업에 대한 폴러입니다. 폴러의 결과 메서드는 삭제가 DeletedCertificate 완료 될 때까지 기다리지 않고 를 반환합니다. 자격 증명 모음에 일시 삭제가 사용하도록 설정되어 있고 즉시 인증서를 영구적으로 삭제 purge_deleted_certificate하려면 먼저 폴러의 대기 메서드를 호출합니다. 삭제가 완료될 때까지 차단됩니다. 대기 메서드에는 인증서/가져오기 권한이 필요합니다.

반환 형식

예외

인증서가 없으면

기타 오류의 경우

begin_recover_deleted_certificate

삭제된 인증서를 최신 버전으로 복구합니다. 일시 삭제가 사용하도록 설정된 자격 증명 모음에서만 가능합니다.

인증서/복구 권한이 필요합니다. 이 메서드가 반환될 때 Key Vault 인증서를 복구하기 시작했습니다. 복구에는 몇 초 정도 걸릴 수 있습니다. 따라서 이 메서드는 복구가 완료되기를 기다릴 수 있는 폴러를 반환합니다. 다른 작업에서 복구된 인증서를 즉시 사용하려는 경우에만 대기가 필요합니다.

begin_recover_deleted_certificate(certificate_name: str, **kwargs) -> LROPoller[KeyVaultCertificate]

매개 변수

certificate_name
str
필수

복구할 삭제된 인증서의 이름

반환

복구 작업에 대한 폴러입니다. 폴러의 결과 메서드는 복구가 완료될 때까지 기다리지 않고 복구된 KeyVaultCertificate 를 반환합니다. 복구된 인증서를 즉시 사용하려면 인증서를 사용할 준비가 될 때까지 차단하는 폴러의 대기 메서드를 호출합니다. 대기 메서드에는 인증서/가져오기 권한이 필요합니다.

반환 형식

예외

cancel_certificate_operation

진행 중인 인증서 작업을 취소합니다. 인증서/업데이트 권한이 필요합니다.

cancel_certificate_operation(certificate_name: str, **kwargs) -> CertificateOperation

매개 변수

certificate_name
str
필수

인증서 이름입니다.

반환

취소된 인증서 작업

반환 형식

예외

close

클라이언트가 연 소켓을 닫습니다.

클라이언트를 컨텍스트 관리자로 사용할 때는 이 메서드를 호출할 필요가 없습니다.

close() -> None

예외

인증서가 없으면

기타 오류의 경우

create_issuer

지정된 인증서 발급자를 설정합니다. 인증서/setissuers 권한이 필요합니다.

create_issuer(issuer_name: str, provider: str, **kwargs) -> CertificateIssuer

매개 변수

issuer_name
str
필수

발급자의 이름입니다.

provider
str
필수

발급자 공급자입니다.

enabled
bool

발급자를 사용할 수 있는지 여부입니다.

account_id
str

사용자 이름/계정 이름/계정 ID입니다.

password
str

암호/비밀/계정 키입니다.

organization_id
str

organization ID

admin_contacts
list[AdministratorContact]

인증서 발급자의 organization 관리자에 대한 연락처 세부 정보입니다.

반환

만든 CertificateIssuer

반환 형식

예외

delete_certificate_operation

특정 인증서에 대한 만들기 작업을 삭제하고 중지합니다.

인증서/업데이트 권한이 필요합니다.

delete_certificate_operation(certificate_name: str, **kwargs) -> CertificateOperation

매개 변수

certificate_name
str
필수

인증서 이름입니다.

반환

삭제된 CertificateOperation

반환 형식

예외

delete_contacts

키 자격 증명 모음에 대한 인증서 연락처를 삭제합니다. 인증서/managecontacts 권한이 필요합니다.

delete_contacts(**kwargs) -> List[CertificateContact]

반환

키 자격 증명 모음에 대해 삭제된 연락처입니다.

반환 형식

예외

delete_issuer

지정된 인증서 발급자를 삭제합니다.

인증서/manageissuers/deleteissuers 권한이 필요합니다.

delete_issuer(issuer_name: str, **kwargs) -> CertificateIssuer

매개 변수

issuer_name
str
필수

발급자의 이름입니다.

반환

CertificateIssuer

반환 형식

예외

get_certificate

관리 정책이 연결된 인증서를 가져옵니다. 인증서/가져오기 권한이 필요합니다.

인증서 버전을 매개 변수로 허용하지 않습니다. 특정 버전의 인증서를 얻으려면 를 호출합니다 get_certificate_version.

get_certificate(certificate_name: str, **kwargs) -> KeyVaultCertificate

매개 변수

certificate_name
str
필수

지정된 자격 증명 모음에 있는 인증서의 이름입니다.

반환

KeyVaultCertificate의 instance

반환 형식

예외

인증서가 없으면

기타 오류의 경우

get_certificate_operation

인증서 만들기 작업을 가져옵니다. 인증서/가져오기 권한이 필요합니다.

get_certificate_operation(certificate_name: str, **kwargs) -> CertificateOperation

매개 변수

certificate_name
str
필수

인증서 이름입니다.

반환

만든 CertificateOperation

반환 형식

예외

인증서가 없으면

기타 오류의 경우

get_certificate_policy

인증서에 대한 정책을 가져옵니다. 인증서/가져오기 권한이 필요합니다.

키 자격 증명 모음에 지정된 인증서 정책 리소스를 반환합니다.

get_certificate_policy(certificate_name: str, **kwargs) -> CertificatePolicy

매개 변수

certificate_name
str
필수

지정된 키 자격 증명 모음에 있는 인증서의 이름입니다.

반환

인증서 정책

반환 형식

예외

get_certificate_version

관리 정책을 반환하지 않고 특정 버전의 인증서를 가져옵니다.

인증서/가져오기 권한이 필요합니다. 최신 버전의 인증서를 얻거나 인증서의 정책도 얻으려면 를 호출합니다 get_certificate.

get_certificate_version(certificate_name: str, version: str, **kwargs) -> KeyVaultCertificate

매개 변수

certificate_name
str
필수

지정된 자격 증명 모음에 있는 인증서의 이름입니다.

version
str
필수

인증서의 버전입니다.

반환

KeyVaultCertificate의 instance

반환 형식

예외

인증서가 없으면

기타 오류의 경우

get_contacts

키 자격 증명 모음에 대한 인증서 연락처를 가져옵니다. 인증서/managecontacts 권한이 필요합니다.

get_contacts(**kwargs) -> List[CertificateContact]

반환

키 자격 증명 모음에 대한 인증서 연락처입니다.

반환 형식

예외

get_deleted_certificate

삭제된 인증서를 가져옵니다. 일시 삭제가 사용하도록 설정된 자격 증명 모음에서만 가능합니다.

인증서/가져오기 권한이 필요합니다. 삭제된 인증서 정보와 해당 특성(예: 보존 간격, 예약된 영구 삭제 및 현재 삭제 복구 수준)을 검색합니다.

get_deleted_certificate(certificate_name: str, **kwargs) -> DeletedCertificate

매개 변수

certificate_name
str
필수

인증서 이름입니다.

반환

삭제된 인증서

반환 형식

예외

인증서가 없으면

기타 오류의 경우

get_issuer

지정된 인증서 발급자를 가져옵니다. 인증서/manageissuers/getissuers 권한이 필요합니다.

get_issuer(issuer_name: str, **kwargs) -> CertificateIssuer

매개 변수

issuer_name
str
필수

발급자의 이름입니다.

반환

지정된 인증서 발급자입니다.

반환 형식

예외

발급자의 존재하지 않는 경우

기타 오류의 경우

import_certificate

외부에서 만든 인증서를 가져옵니다. 인증서/가져오기 권한이 필요합니다.

프라이빗 키가 포함된 기존 유효한 인증서를 Azure Key Vault 가져옵니다. 가져올 인증서는 PFX 또는 PEM 형식일 수 있습니다. 인증서가 PEM 형식인 경우 PEM 파일에는 키와 x509 인증서가 포함되어야 하며 의 를 policycontent_typepem제공해야 합니다.

import_certificate(certificate_name: str, certificate_bytes: bytes, **kwargs) -> KeyVaultCertificate

매개 변수

certificate_name
str
필수

인증서 이름입니다.

certificate_bytes
bytes
필수

가져올 인증서 개체의 바이트입니다. 이 인증서에는 프라이빗 키가 포함되어야 합니다.

enabled
bool

인증서를 사용할 수 있는지 여부입니다.

tags
dict[str, str]

키/값 쌍 형식의 애플리케이션 특정 메타데이터입니다.

password
str

전달된 인증서의 프라이빗 키가 암호화된 경우 암호화에 사용되는 암호입니다.

policy
CertificatePolicy

인증서에 대한 관리 정책입니다. 를 로 설정pem하여 PEM 형식 인증서를 content_type 가져오는 경우 필요합니다.

반환

가져온 KeyVaultCertificate

반환 형식

예외

list_deleted_certificates

현재 복구 가능한 삭제된 인증서를 나열합니다. 자격 증명 모음이 일시 삭제를 사용하도록 설정된 경우에만 가능합니다.

인증서/가져오기/목록 권한이 필요합니다. 현재 자격 증명 모음에서 삭제된 상태이며 복구 또는 제거 준비가 된 인증서를 검색합니다. 이 작업에는 삭제 관련 정보가 포함됩니다.

list_deleted_certificates(**kwargs) -> ItemPaged[DeletedCertificate]

매개 변수

include_pending
bool

완전히 삭제되지 않은 인증서를 포함할지 여부를 지정합니다. API 버전 v7.0 이상에서만 사용할 수 있습니다.

반환

DeletedCertificate의 반복기와 유사한 instance

반환 형식

예외

list_properties_of_certificate_versions

인증서 버전의 식별자 및 속성을 나열합니다.

인증서/목록 권한이 필요합니다.

list_properties_of_certificate_versions(certificate_name: str, **kwargs) -> ItemPaged[CertificateProperties]

매개 변수

certificate_name
str
필수

인증서 이름입니다.

반환

CertificateProperties의 반복기와 유사한 instance

반환 형식

예외

list_properties_of_certificates

자격 증명 모음에 있는 모든 인증서의 식별자 및 속성을 나열합니다.

인증서/목록 권한이 필요합니다.

list_properties_of_certificates(**kwargs) -> ItemPaged[CertificateProperties]

매개 변수

include_pending
bool

완전히 프로비전되지 않은 인증서를 포함할지 여부를 지정합니다. API 버전 v7.0 이상에서만 사용할 수 있습니다.

반환

CertificateProperties의 반복기와 유사한 instance

반환 형식

예외

list_properties_of_issuers

키 자격 증명 모음에 대한 인증서 발급자의 속성을 나열합니다.

인증서/manageissuers/getissuers 권한이 필요합니다.

list_properties_of_issuers(**kwargs) -> ItemPaged[IssuerProperties]

반환

발급자의 반복기와 유사한 instance

반환 형식

예외

merge_certificate

인증서 또는 인증서 체인을 서버에 존재하는 키 쌍과 병합합니다.

인증서/만들기 권한이 필요합니다. 현재 서비스에서 사용할 수 있는 키 쌍과 인증서 또는 인증서 체인의 병합을 수행합니다. 를 사용하여 begin_create_certificate 병합할 인증서를 만들 때 발급자를 '알 수 없음'으로 설정했는지 확인합니다. 이렇게 하면 Key Vault 알려진 발급자에서 인증서에 서명되지 않습니다.

merge_certificate(certificate_name: str, x509_certificates: List[bytes], **kwargs) -> KeyVaultCertificate

매개 변수

certificate_name
str
필수

인증서의 이름

x509_certificates
list[bytes]
필수

병합할 인증서 또는 인증서 체인입니다.

enabled
bool 또는 None

인증서를 사용할 수 있는지 여부입니다.

tags
dict[str, str] 또는 None

키/값 쌍 형식의 애플리케이션 특정 메타데이터입니다.

반환

병합된 인증서

반환 형식

예외

purge_deleted_certificate

삭제된 인증서를 영구적으로 삭제합니다. 일시 삭제가 사용하도록 설정된 자격 증명 모음에서만 가능합니다.

인증서/제거 권한이 필요합니다. 복구할 가능성 없이 지정된 인증서를 되돌릴 수 없는 삭제를 수행합니다. 이 'Purgeable'을 recovery_level 지정하지 않으면 작업을 사용할 수 없습니다. 이 메서드는 인증서 앞에 scheduled_purge_date인증서를 제거하는 데만 필요합니다.

purge_deleted_certificate(certificate_name: str, **kwargs) -> None

매개 변수

certificate_name
str
필수

인증서의 이름

반환

없음

반환 형식

예외

restore_certificate_backup

자격 증명 모음에 인증서 백업을 복원합니다. 인증서/복원 권한이 필요합니다.

그러면 이름, 특성 및 액세스 제어 정책을 사용하여 인증서의 모든 버전이 복원됩니다. 인증서 이름이 이미 사용 중인 경우 복원에 실패합니다. 또한 대상 자격 증명 모음은 원본 자격 증명 모음과 동일한 Microsoft Azure 구독에서 소유해야 합니다.

restore_certificate_backup(backup: bytes, **kwargs) -> KeyVaultCertificate

매개 변수

backup
bytes
필수

인증서 번들과 연결된 백업 Blob입니다.

반환

복원된 KeyVaultCertificate

반환 형식

예외

send_request

클라이언트의 기존 파이프라인을 사용하여 네트워크 요청을 실행합니다.

요청 URL은 자격 증명 모음 URL을 기준으로 할 수 있습니다. 요청에 사용되는 서비스 API 버전은 달리 지정하지 않는 한 클라이언트의 버전과 동일합니다. 응답이 오류인 경우 이 메서드는 발생하지 않습니다. 예외를 발생하려면 반환된 응답 개체에서 raise_for_status() 를 호출합니다. 이 메서드를 사용하여 사용자 지정 요청을 보내는 방법에 대한 자세한 내용은 를 참조하세요 https://aka.ms/azsdk/dpcodegen/python/send_request.

send_request(request: HttpRequest, *, stream: bool = False, **kwargs) -> HttpResponse

매개 변수

request
HttpRequest
필수

만들려는 네트워크 요청입니다.

stream
bool

응답 페이로드가 스트리밍될지 여부입니다. 기본값은 False입니다.

반환

네트워크 호출의 응답입니다. 응답에 대한 오류 처리는 수행하지 않습니다.

반환 형식

예외

인증서가 없으면

기타 오류의 경우

set_contacts

키 자격 증명 모음에 대한 인증서 연락처를 설정합니다. 인증서/managecontacts 권한이 필요합니다.

set_contacts(contacts: List[CertificateContact], **kwargs) -> List[CertificateContact]

매개 변수

contacts
list[CertificateContact]
필수

자격 증명 모음 인증서의 연락처 목록입니다.

반환

만든 연락처 목록

반환 형식

예외

update_certificate_policy

인증서에 대한 정책을 업데이트. 인증서/업데이트 권한이 필요합니다.

인증서 정책에서 지정된 멤버를 설정합니다. 다른 사용자를 null로 둡니다.

update_certificate_policy(certificate_name: str, policy: CertificatePolicy, **kwargs) -> CertificatePolicy

매개 변수

certificate_name
str
필수

지정된 자격 증명 모음에 있는 인증서의 이름입니다.

policy
CertificatePolicy
필수

인증서에 대한 정책입니다.

반환

인증서 정책

반환 형식

예외

update_certificate_properties

인증서의 속성을 변경합니다. 인증서/업데이트 권한이 필요합니다.

update_certificate_properties(certificate_name: str, version: str | None = None, **kwargs) -> KeyVaultCertificate

매개 변수

certificate_name
str
필수

지정된 키 자격 증명 모음의 인증서 이름입니다.

version
str
필수

인증서의 버전입니다.

enabled
bool

인증서를 사용할 수 있는지 여부입니다.

tags
dict[str, str]

키/값 쌍 형식의 애플리케이션 특정 메타데이터입니다.

반환

업데이트된 KeyVaultCertificate

반환 형식

예외

update_issuer

지정된 인증서 발급자를 업데이트. 인증서/setissuers 권한이 필요합니다.

update_issuer(issuer_name: str, **kwargs) -> CertificateIssuer

매개 변수

issuer_name
str
필수

발급자의 이름입니다.

enabled
bool

발급자를 사용할 수 있는지 여부입니다.

provider
str

발급자 공급자

account_id
str

사용자 이름/계정 이름/계정 ID입니다.

password
str

암호/비밀/계정 키입니다.

organization_id
str

organization ID

admin_contacts
list[AdministratorContact]

인증서 발급자의 organization 관리자에 대한 연락처 세부 정보

반환

업데이트된 발급자

반환 형식

예외

특성

vault_url