Set Certificate Issuer - Set Certificate Issuer

서비스:

Key Vault

API 버전:

2025-07-01

지정된 인증서 발급자를 설정합니다.
SetCertificateIssuer 작업은 지정된 인증서 발급자를 추가하거나 업데이트합니다. 이 작업에는 certificates/setissuers 권한이 필요합니다.

PUT {vaultBaseUrl}/certificates/issuers/{issuer-name}?api-version=2025-07-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
issuer-name	path	True	string	발급자의 이름입니다. 사용자가 제공하는 값은 서비스를 실행하기 위해 전역적으로 복사될 수 있습니다. 제공되는 값에는 개인 식별 정보나 민감한 정보가 포함되어서는 안 됩니다.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
provider	True	string	발급자 공급자입니다.
attributes		IssuerAttributes	발급자 개체의 속성입니다.
credentials		IssuerCredentials	발급자에 사용할 자격 증명입니다.
org_details		OrganizationDetails	발급자에게 제공된 조직의 세부 정보입니다.

응답

Name	형식	Description
200 OK	IssuerBundle	요청이 성공했습니다.
Other Status Codes	KeyVaultError	예기치 않은 오류 응답입니다.

보안

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
https://vault.azure.net/.default

예제

SetCertificateIssuer

샘플 요청

HTTP

PUT https://myvault.vault.azure.net//certificates/issuers/issuer01?api-version=2025-07-01

{
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser",
    "pwd": "password"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  }
}

샘플 응답

상태 코드:

200

{
  "id": "https://myvault.vault.azure.net/certificates/issuers/issuer01",
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  },
  "attributes": {
    "enabled": true,
    "created": 1482188806,
    "updated": 1482189526
  }
}

정의

Name	Description
AdministratorDetails	인증서 발급자의 조직 관리자에 대한 세부 정보입니다.
CertificateIssuerSetParameters	인증서 발급자가 매개 변수를 설정합니다.
Error
IssuerAttributes	Key Vault 서비스에서 관리하는 발급자의 특성입니다.
IssuerBundle	Key Vault 인증서의 발급자입니다.
IssuerCredentials	인증서 발급자에 사용할 자격 증명입니다.
KeyVaultError	키 자격 증명 모음 오류 예외입니다.
OrganizationDetails	인증서 발급자의 조직에 대한 세부 정보입니다.

AdministratorDetails

Object

인증서 발급자의 조직 관리자에 대한 세부 정보입니다.

Name	형식	Description
email	string	이메일 주소.
first_name	string	이름.
last_name	string	성.
phone	string	전화번호.

CertificateIssuerSetParameters

Object

인증서 발급자가 매개 변수를 설정합니다.

Name	형식	Description
attributes	IssuerAttributes	발급자 개체의 속성입니다.
credentials	IssuerCredentials	발급자에 사용할 자격 증명입니다.
org_details	OrganizationDetails	발급자에게 제공된 조직의 세부 정보입니다.
provider	string	발급자 공급자입니다.

Error

Object

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

IssuerAttributes

Object

Key Vault 서비스에서 관리하는 발급자의 특성입니다.

Name	형식	Description
created	integer (unixtime)	UTC의 생성 시간입니다.
enabled	boolean	발급자가 활성화되었는지 여부를 결정합니다.
updated	integer (unixtime)	UTC로 마지막 업데이트 시간입니다.

IssuerBundle

Object

Key Vault 인증서의 발급자입니다.

Name	형식	Description
attributes	IssuerAttributes	발급자 개체의 속성입니다.
credentials	IssuerCredentials	발급자에 사용할 자격 증명입니다.
id	string	발급자 개체의 식별자입니다.
org_details	OrganizationDetails	발급자에게 제공된 조직의 세부 정보입니다.
provider	string	발급자 공급자입니다.

IssuerCredentials

Object

인증서 발급자에 사용할 자격 증명입니다.

Name	형식	Description
account_id	string	사용자 이름/계정 이름/계정 ID입니다.
pwd	string	암호/비밀/계정 키입니다.

KeyVaultError

Object

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

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

OrganizationDetails

Object

인증서 발급자의 조직에 대한 세부 정보입니다.

Name	형식	Description
admin_details	AdministratorDetails[]	조직 관리자의 세부 정보입니다.
id	string	조직의 ID입니다.