오류는 HTTP 상태 코드 및 오류 메시지를 모두 반환합니다. 클라이언트에 의해 발생한 오류는 4xx 클라이언트 오류 상태 코드를 반환합니다. API 서비스에 의해 발생한 오류는 5xx 서버 오류 상태 코드를 반환합니다.
{
"errors": [
{
"code": "<error_code>",
"message": "<error_message>"
}
]
}| 이름 | 유형 | 설명 |
|---|---|---|
| errors | array | 요청에서 오류의 목록입니다. |
| .. code | string | 지정된 오류를 식별하는 오류 코드입니다. |
| .. message | string | 오류의 설명입니다. |
| 상태 | 코드 | 설명 |
|---|---|---|
| 429 | request_limit_exceeded |
서비스를 사용할 수 없습니다. 요청 수를 제한하십시오 속도 제한을 참조하십시오. |
| 404 | not_found | 일반적 404 메시지입니다. 엔드포인트 URL이 적절하게 구성되었는지 확인하십시오. |
| 404 | not_found|order |
지정한 주문을 찾을 수 없습니다. 다음을 확인합니다.
|
| 404 | not_found|product |
지정한 제품을 찾을 수 없습니다. 정확한 제품 식별자를 사용하는지 확인하십시오. 용어집 — 제품 식별자를 참조하십시오. |
| 404 | not_found|route | 엔드포인트가 없습니다. 사용하는 엔드포인트 URL이 정확한지 확인하십시오. |
| 403 | access_denied|missing_permission |
사용하는 API 키에 요청을 수행할 권한이 없습니다. 키의 권한 부여 수준을 식별하려면 /user/me 엔드포인트에 GET 요청을 보내어 access_roles.name 값을 찾습니다.
|
| 400 | ambiguous_product |
제품을 결정하기 위해 product.type_hint 값을 사용할 수 없습니다.주문 제출 — 요청 매개 변수 표를 참조하십시오. |
| 400 | auth_key_exists_for_account | 계정에 대한 AuthKey를 이미 만들었습니다. |
| 400 | bad_request_format | 요청 본문의 형식이 틀립니다. 요청 본문이 유효한 JSON 또는 XML을 사용하는지 확인하십시오. |
| 400 | cert_transparency_turned_off_for_account | CertCentral 계정에 대해 CT 로그를 사용 중지했습니다. 관리자가 이 기능을 사용해야 합니다. |
| 400 | csr_invalid_cannot_parse |
CSR이 정확한 형식이 아니거나 필요한 필드가 없거나 잘못된 글자가 있는 필드를 포함합니다. CSR 만들기를 참조하십시오. |
| 400 | csr_not_allowed |
지정된 제품이 CSR을 사용하지 않습니다. 용어집 — CSR 요구 사항을 참조하십시오. |
| 400 | ct_logging_disabled | CertCentral 계정에 대해 CT 로그를 사용 중지했습니다. 관리자가 이 기능을 사용해야 합니다. |
| 400 | custom_expiration_not_allowed | 허용된 유효 기간이 제품 유형에 대해 구성되어 있습니다. 제한 사항을 제거하여 사용자 지정 만료 날짜를 허용하십시오. |
| 400 | disabled_domain |
제출한 도메인이 비활성화되어 있습니다. 제출하기 전에 도메인을 활성화해야 합니다. 도메인 활성화를 참조하십시오. |
| 400 | domain_not_allowed | 지정된 컨테이너에 대해 도메인 제한이 구성되어 있습니다. |
| 400 | email_domain_not_validated | 이메일에 검사한 도메인이 있어야 합니다. |
| 400 | email_not_valid_email_format | 제출한 이메일 주소가 유효하지 않습니다. 제출한 이메일 주소가 표준 이메일 주소 규칙을 따르는지 확인하십시오. |
| 400 | file_random_value_not_found |
도메인에 대해 예상하는 파일 위치에 무작위 값을 찾을 수 없습니다. 다음을 확인합니다.
|
| 400 | inactive_organization |
제출한 조직이 비활성화되어 있습니다. 조직을 활성화하거나 다른 조직을 지정하십시오. 조직 활성화를 참조하십시오. |
| 400 | internal_names_not_allowed | |
| 400 | invalid_ca_cert_id | 지정된 인증 기관이 유효하지 않습니다. |
| 400 | invalid_chars:<param.name> | 지정된 매개 변수가 잘못된 글자를 포함합니다. 엔드포인트의 응답 매개 변수 표에서 유효한 입력 글자를 참조하십시오. |
| 400 | invalid_common_name_on_duplicate | 복제 요청의 일반 이름이 원래 주문과 일치해야 합니다. 원래 주문에서 정확한 일반 이름을 참조하십시오. |
| 400 | invalid_dns_cname |
도메인에 대한 유효한 DNS CNAME 레코드를 찾을 수 없습니다. 다음을 확인합니다.
|
| 400 | invalid_dns_method | 주문에 대한 DCV 방법이 이메일로 지정되어 있습니다. |
| 400 | invalid_dns_name_on_duplicate | 복제 요청의 DNS 이름이 원래 주문과 일치해야 합니다. 원래 주문에서 정확한 DNS 이름을 참조하십시오. |
| 400 | invalid_dns_txt |
도메인에 대한 유효한 DNS TXT 레코드를 찾을 수 없습니다. 다음을 확인합니다.
|
| 400 | invalid_payment_method | 지정한 결제 방법이 사용되지 않고 있습니다. 지정한 결제 방법을 사용하려면 계정에서 사용해야 합니다. |
| 400 | invalid_value:<param.name> | 지정된 매개 변수가 잘못된 값을 포함합니다. 엔드포인트의 응답 매개 변수 표에서 유효한 입력 값을 참조하십시오. |
| 400 | missing_ca_cert_id | 이 요청에 대한 인증 기관 ID가 필요합니다. 인증서를 발급할 인증 기관을 지정하고 요청을 다시 보내십시오. |
| 400 | missing_dns_name_on_duplicate | 요청에 DNS 이름이 없습니다. 중복 주문에서 DNS 이름을 제거할 수 없습니다. DNS 이름을 포함하여 요청을 다시 보내십시오. |
| 400 | missing_request_data | 요청에서 본문을 보내지 않았습니다. 엔드포인트 설명서에서 요청 요구 사항을 참조하십시오. |
| 400 | missing_required_custom_field |
요청 본문에 필요한 사용자 지정 필드가 없습니다. 계정에 대한 사용자 지정 주문 필드 메타데이터의 목록을 받으려면 사용자 지정 필드 목록을 참조하십시오. |
| 400 | no_private_ca_enabled | 이 계정에 사용하는 사설 인증 기관이 없습니다. |
| 400 | not_allowed_to_change_ct_setting_per_order | CertCentral 계정에 인증서 주문 당 기능을 활성화하지 않았습니다. 관리자가 이 기능을 사용해야 합니다. |
| 400 | order_not_eligible_for_duplicate | 지정한 주문에 대한 복제를 허용하지 않습니다. |
| 400 | other_domain_on_wildcard | 와일드카드 인증서의 모든 SAN은 같은 일반 이름이 있어야 합니다. SAN을 변경하여 동일한 일반 이름을 사용하거나 멀티도메인 인증서를 주문하십시오. |
| 400 | pending_reissue | 이 주문에 대한 이전 다시 발급 요청이 아직 보류 중입니다. 새로운 다시 발급을 요청하기 전에 보류 중인 요청을 거부하거나 승인하고 발급해야 합니다. |
| 400 | product_name_limit_exceeded | 이 제품에 허용된 사용자 수를 초과했습니다. |
| 400 | product_not_allowed | 이 제품은 허용되지 않습니다. |
| 400 | protected_domain | 이 인증서 요청에 나열한 한 개 이상의 도메인은 도메인 소유자의 보호를 받습니다. 도메인을 수정하고 요청을 다시 제출하십시오. |
| 400 |
required_param: |
지정한 매개 변수가 필요합니다. 엔드포인트의 응답 매개 변수 표를 참조하여 필수 및 옵션 매개 변수를 식별하십시오. |
| 400 | rfc5280_common_name_invalid | 제출한 일반 이름이 업계 표준을 준수하지 않습니다. |
| 400 | rfc5280_common_name_too_long | 일반 이름은 업계 표준을 준수하려면 64자 이하여야 합니다. |
| 400 | rfc5280_org_unit_too_long | 조직 부서는 업계 표준을 준수하려면 64자 이하여야 합니다. |
| 400 | rfc5280_org_name_too_long | 조직 이름 총 길이(EV 인증서의 가명을 포함)는 업계 표준을 준수하려면 64자 이하여야 합니다. |
| 400 | rfc5280_address_field_too_long | 주소 필드는 업계 표준을 준수하려면 64자 이하여야 합니다. |
| 400 | rfc5280_org_unit_invalid | 조직 부서 필드가 업계 표준에 비하여 잘못된 값을 포함합니다. |
| 400 | rfc5280_org_invalid | 조직의 한 개 이상 필드에 업계 표준에 비하여 잘못된 값을 포함하고 있습니다. |
| 400 | username_unavailable | 지정한 사용자 이름을 사용할 수 없습니다. |