이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.
카탈로그 항목 교체
put
/catalogs/{catalog_name}/items
이 엔드포인트를 사용하면 카탈로그의 여러 항목을 교체할 수 있습니다.
카탈로그 항목이 존재하지 않으면 이 엔드포인트가 카탈로그에 해당 항목을 생성합니다. 요청당 최대 50개의 카탈로그 항목을 처리할 수 있습니다. 이 엔드포인트는 비동기식으로 작동합니다.
문제 해결
다음 표에는 반환될 수 있는 오류와 관련 문제 해결 단계가 나와 있습니다.
| 오류 | 문제 해결 |
|---|---|
catalog-not-found |
카탈로그 이름이 유효한지 확인하세요. |
company-size-limit-already-reached |
카탈로그 저장 용량 한도에 도달했습니다. 저장 용량 등급에 대해 알아보려면 데이터 저장 용량 제한을 참조하세요. |
company-size-limit-surge |
요청이 회사의 남은 카탈로그 저장 용량을 초과합니다. 더 작은 단위로 업데이트를 다시 시도하세요. 저장 용량 등급에 대해 알아보려면 데이터 저장 용량 제한을 참조하세요. |
ids-not-strings |
각 항목 ID가 문자열인지 확인하세요. |
ids-not-unique |
각 항목 ID가 고유한지 확인하세요. |
ids-too-large |
각 항목 ID의 글자 수 제한은 250자입니다. |
items-array-is-invalid |
items는 객체 배열이어야 합니다. |
items-missing-ids |
일부 항목에 항목 ID가 없습니다. 각 항목에 ID가 있는지 확인하세요. |
items-too-large |
항목 값은 5,000자를 초과할 수 없습니다. |
invalid-ids |
항목 ID 이름에 사용할 수 있는 문자는 영문자, 숫자, 하이픈, 밑줄입니다. |
invalid-fields |
API 요청에서 전송하는 모든 필드가 카탈로그에 이미 존재하는지 확인하세요. 이는 오류에 언급된 ID 필드와는 관련이 없습니다. |
invalid-keys-in-value-object |
항목 객체 키에는 . 또는 $를 포함할 수 없습니다. |
too-deep-nesting-in-value-object |
항목 객체는 50단계를 초과하여 중첩할 수 없습니다. |
request-includes-too-many-items |
요청에 항목이 너무 많습니다. 요청당 항목 한도는 50개입니다. |
unable-to-coerce-value |
항목 유형을 변환할 수 없습니다. |
OpenAPI 문서를 다운로드하여 스키마 유효성 검사에 사용할 수 있습니다. 방법을 알아보려면 요청 유효성 검사에 OpenAPI 스키마 사용을 참조하세요.
New Stuff!