외부 콘텐츠 수집 API

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 29분
  • 외부 콘텐츠 수집 API는 인스턴스 외부 ServiceNow® 의 소스에서 애플리케이션의 인덱스로 ServiceNow® AI 검색 콘텐츠를 수집할 수 있는 엔드포인트를 제공합니다.

    외부 콘텐츠 수집 API – DELETE /ais/external_content/deleteByQuery/{schema_table_name}

    지정된 쿼리와 일치하는 모든 외부 문서를 인덱스에서 삭제합니다 AI 검색 .

    URL 형식

    버전이 지정된 URL: /api/now/{api_version}/ais/external_content/deleteByQuery/{schema_table_name}?query={query}

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    schema_table_name

    삭제할 인덱싱된 문서의 스키마를 정의하는 외부 컨텐츠 스키마 테이블의 이름입니다. 예를 들면 u_ext_content입니다.

    데이터 유형: 문자열

    표 2. 쿼리 매개변수
    이름 설명
    쿼리

    로 지정된 스키마 테이블에 대한 유효한 URL 이스케이프 쿼리입니다.schema_table_name 예를 들어, title= 소개, 제목이 소개인 문서에 대한 쿼리입니다.

    데이터 유형: 문자열

    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

    표 4. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 5. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 6. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(JSON 또는 XML)

    이름 설명
    오류

    요청을 처리하는 동안 발생한 오류를 설명하는 객체입니다.

    데이터 유형: 객체

    "error": {
      "detail": "String",
      "message": "String"
    }
    오류.상세 정보

    요청을 처리하는 동안 발생한 오류에 대한 상세 정보입니다.

    데이터 유형: 문자열

    오류.메시지

    요청을 처리하는 동안 발생한 오류에 대한 메시지입니다.

    데이터 유형: 문자열

    결과

    성공적으로 처리된 요청의 결과입니다.

    데이터 유형: 문자열

    상태

    실패한 요청의 상태입니다.

    유효한 값은 다음과 같습니다.
    • failure

    데이터 유형: 문자열

    cURL 요청

    u_ext_content 스키마 테이블에서 제목 필드 값이 있는 문서 2020년 10월 31일 소개 및 보고서 삭제

    curl "https://instance.service-now.com/api/now/v2/ais/external_content/deleteByQuery/u_ext_content?query=title%3DIntroduction%20OR%20title%3DReport%20for%2031%20October%202020" \
    --request DELETE \
    --user "username":"password" \
    --header "Accept: application/json"
    {
      "result": "Delete By Query Successfully Executed"
    }

    외부 콘텐츠 수집 API – DELETE /ais/external_content/deleteDocument/{schema_table_name}/{document_id}

    지정된 고유 식별자가 있는 외부 문서를 인덱스에서 삭제합니다 AI 검색 .

    URL 형식

    버전이 지정된 URL: /api/now/{api_version}/ais/external_content/deleteDocument/{schema_table_name}/{document_id}

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 7. 경로 매개변수
    매개변수 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    document_id

    삭제할 외부 문서의 고유 식별자입니다. 예: ADMIN-2027858531-16.

    데이터 유형: 문자열

    schema_table_name

    삭제할 인덱싱된 문서의 스키마를 정의하는 외부 컨텐츠 스키마 테이블의 이름입니다. 예를 들면 u_ext_content입니다.

    데이터 유형: 문자열

    표 8. 쿼리 매개변수
    이름 설명
    안 함
    표 9. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    안 함

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

    표 10. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 11. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 12. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(JSON 또는 XML)

    요소 설명
    오류

    요청을 처리하는 동안 발생한 오류를 설명하는 객체입니다.

    데이터 유형: 객체

    "error": {
      "detail": "String",
      "message": "String"
    }
    오류.상세 정보

    요청을 처리하는 동안 발생한 오류에 대한 상세 정보입니다.

    데이터 유형: 문자열

    오류.메시지

    요청을 처리하는 동안 발생한 오류에 대한 메시지입니다.

    데이터 유형: 문자열

    결과

    성공적으로 처리된 요청의 결과입니다.

    데이터 유형: 문자열

    상태

    실패한 요청의 상태입니다.

    유효한 값은 다음과 같습니다.
    • failure

    데이터 유형: 문자열

    cURL 요청

    u_ext_content 스키마 테이블에서 식별자 ADMIN-2587918521-27 이 있는 문서를 삭제합니다.

    curl 'https://instance.service-now.com/api/now/v2/ais/external_content/deleteDocument/u_ext_content/ADMIN-2587918521-27' \
    --request DELETE \
    --user 'username':'password' \
    --header 'Accept: application/json'
    {
      "result":"Document removed"
    }

    외부 콘텐츠 수집 API – POST /ais/external_content/ingestDocument/{schema_table_name}

    인덱싱을 위해 외부 문서 목록을 수집 배치 관리자로 AI 검색 보냅니다. 인덱싱이 완료되면 수집된 문서의 콘텐츠를 검색할 수 있게 됩니다.

    이 엔드포인트를 사용하여 외부 문서에 텍스트 컨텐츠와 메타데이터를 공급할 수 있습니다.

    검색 가능한 이진 컨텐츠와 메타데이터를 외부 문서와 연결해야 하는 경우 다음 단계를 수행합니다.
    1. POST /ais/external_content/storeContent 엔드포인트를 사용하여 이진 콘텐츠를 저장합니다AI 검색. 응답 본문 매개변수의 값을 기록합니다 result .
    2. 이 엔드포인트를 사용하여 외부 문서를 보냅니다.AI 검색 기록 result 된 응답 본문 매개변수 값과 일치하도록 문서의 content_pointer 요청 본문 매개변수를 설정합니다.
    수집하는 AI 검색 동안 이진 콘텐츠를 구문 분석하고 검색 가능한 콘텐츠를 외부 문서를 나타내는 인덱싱된 기록에 추가합니다. 구문 분석은 저장된 컨텐츠 객체를 제거합니다.

    URL 형식

    버전 관리된 URL: /api/now/{api_version}/ais/external_content/ingestDocument/{schema_table_name}

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 13. 경로 매개변수
    매개변수 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    schema_table_name

    요청의 외부 문서에 대한 스키마를 정의하는 외부 컨텐츠 스키마 테이블의 이름입니다. 예를 들면 u_ext_content입니다.

    데이터 유형: 문자열

    표 14. 쿼리 매개변수
    이름 설명
    안 함
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    요소 설명
    [배열]

    필수 각 객체가 인덱싱을 위해 수집할 외부 문서를 나타내는 명명되지 않은 객체 배열입니다.

    데이터 유형: 배열

    [
      {
        "content_pointer": "String",
        "document_id": "String",
        "principals": {Object},
        "properties": {Object}
      }
    ]
    [배열].content_pointer
    POST /ais/external_content/storeContent 엔드포인트를 사용하여 저장된 이진 콘텐츠 인스턴스의 식별자입니다. 수집하는 AI 검색 동안 이진 콘텐츠를 구문 분석하고 검색 가능한 콘텐츠를 외부 문서를 나타내는 인덱싱된 기록에 추가합니다. 구문 분석은 저장된 컨텐츠 객체를 제거합니다.
    주:
    이 식별자는 storeContent 엔드포인트에서 반환한 응답 본문 요소와 result 일치해야 합니다.

    데이터 유형: 문자열

    [배열].document_id

    필수 path 매개변수로 지정된 외부 컨텐츠 스키마 테이블에 있는 외부 문서에 대한 고유 식별자입니다 schema_table_name .

    주:
    문서를 수집하면 동일한 외부 컨텐츠 스키마 테이블 document_id에 있는 기존 문서를 덮어씁니다. 동일한 수집 요청의 두 개 이상의 문서가 동일한 document_id경우 요청이 실패합니다.

    데이터 유형: 문자열

    [배열].principals
    외부에 정의된 보안 주체(사용자 및 그룹)에 대한 외부 문서의 접근 권한을 설명하는 키-값 쌍을 포함하는 객체입니다.
    주:

    문서에 대해 이 매개변수를 생략하면 요청은 성공하지만 AI 검색 수집 피드백 메시지와 함께 문서는 거부됩니다. 문서의 원칙이 누락되었습니다.

    이 매개변수 객체에 문서에 대한 액세스 권한을 부여하는 키-값 쌍이 포함되어 있지 않으면 요청은 성공하지만 AI 검색 수집 피드백 메시지와 함께 문서를 거부합니다. 문서의 원칙이 잘못되었습니다.

    데이터 유형: 객체

    "principals": {
      "everyone": Boolean,
      "groups.deny": [Array],
      "groups.read": [Array],
      "none": Boolean,
      "users.deny": [Array],
      "users.read": [Array]
    }

    지원되는 버전: API v2부터 사용할 수 있습니다.

    [배열].원칙.모든 사람
    모든 사용자에게 외부 문서에 대한 액세스가 허용되는지 여부를 나타내는 플래그입니다. 이 매개변수를 로 설정 true하면 모든 ServiceNow AI Platform 사용자가 문서에서 만든 인덱싱된 기록을 볼 수 있습니다.
    주:
    문서에 대해 이 매개변수와 [array].principals.none 를 모두 설정하면 true 요청은 성공하지만 AI 검색 수집 피드백 메시지와 함께 문서가 거부됩니다. 문서의 주체가 잘못되었습니다. 이 두 매개변수 중 하나만 요청에 설정할 수 있습니다.true
    유효한 값은 다음과 같습니다.
    • true: 모든 사용자가 문서에 접근할 수 있도록 허용합니다. AI 검색 문서에 대한 모든 [array].principals.groups.*[array].principals.users.* 매개변수 설정을 무시합니다.
    • false: 모든 사용자가 외부 문서에 액세스할 수 있도록 허용하지 마십시오. 사용자는 false로 설정되고 사용자 매핑과 [array].principals.groups.* 매개변수 [array].principals.users.* 의 상호 작용에 의해 허용되는 경우에만 문서 [array].principals.none 에 액세스할 수 있습니다.

    데이터 유형: 부울

    기본값: true

    지원되는 버전: API v2부터 사용할 수 있습니다.

    [배열].principals.groups.deny

    각 문자열이 외부 문서에 대한 접근이 거부된 외부적으로 정의된 그룹의 이름인 문자열의 배열입니다. ServiceNow AI Platform 이러한 외부 그룹에 매핑된 사용자는 문서에서 작성된 인덱싱된 검색 결과 기록을 볼 수 없습니다.

    또는 [array].principals.none 중 하나 [array].principals.everyone 가 로 설정된 true경우 이 매개변수는 영향을 주지 않습니다.

    이 매개변수는 보다 우선합니다 [array].principals.groups.read. 동일한 사용자가 문서 AI 검색 에 대한 읽기 및 거부 액세스 권한을 모두 가진 외부 그룹에 매핑된 경우 인덱싱된 기록에 대한 사용자의 액세스를 거부합니다.

    기본적으로 이 [array].principals.users.read 매개변수보다 우선합니다. 인덱싱된 원본에 대해 이 우선 순위를 반대로 하려면 외부 콘텐츠 인덱싱된 원본에 대한 사용자 읽기 및 그룹 거부 권한의 우선 순위 변경을 참조하세요.

    데이터 유형: 배열

    값은 지정된 외부에서 정의된 그룹의 이름에 따라 모든 형식이 될 수 있습니다. 예를 들면 다음과 같습니다.

    "groups.deny": [
      "hr-admin",
      "legal"
    ]

    지원되는 버전: API v2부터 사용할 수 있습니다.

    [array].principals.groups.read

    각 문자열이 외부 문서에 액세스할 수 있는 외부적으로 정의된 그룹의 이름인 문자열의 배열입니다. ServiceNow AI Platform 이러한 외부 그룹에 매핑된 사용자는 문서에서 만든 인덱싱된 검색 결과 기록을 볼 수 있습니다.

    또는 [array].principals.none 중 하나 [array].principals.everyone 가 로 설정된 true경우 이 매개변수는 영향을 주지 않습니다.

    [array].principals.groups.deny 이 매개변수보다 우선합니다. 동일한 사용자가 문서 AI 검색 에 대한 읽기 및 거부 액세스 권한을 모두 가진 외부 그룹에 매핑된 경우 인덱싱된 기록에 대한 사용자의 액세스를 거부합니다.

    데이터 유형: 배열

    값은 지정된 외부에서 정의된 그룹의 이름에 따라 모든 형식이 될 수 있습니다. 예를 들면 다음과 같습니다.

    "groups.read": [
      "devops",
      "it",
      "report-admins"
    ]

    지원되는 버전: API v2부터 사용할 수 있습니다.

    [배열].principals.none
    모든 사용자에 대해 외부 문서에 대한 액세스가 거부되는지 여부를 나타내는 부울 옵션입니다. 이 매개 변수를 로 ServiceNow AI Platform 설정하면 trueais_high_security_admin 상승된 권한 역할을 가진 사용자만 문서에서 작성된 인덱싱된 기록을 볼 수 있습니다.
    주:
    문서에 대해 이 매개 변수와 [array].principals.everyone to true 를 모두 설정하면 수집 중에 문서의 보안 주체가 잘못되었다는 오류 메시지와 함께 문서를 거부합니다. AI 검색 이 두 매개변수 중 하나만 요청에 설정할 수 있습니다.true
    유효한 값은 다음과 같습니다.
    • true: ais_high_security_admin 상승된 권한 역할을 가진 사용자를 제외한 모든 사용자가 문서에 접근하는 것을 거부합니다. AI 검색 문서의 모든 [array].principals.groups.*[array].principals.users.* 매개변수 설정을 무시합니다.
    • false: 모든 사용자의 문서에 대한 액세스를 거부하지 않습니다. 가 로 설정true되거나 사용자 매핑과 [array].principals.groups.read[array].principals.users.read 매개변수의 상호 작용에 의해 허용되는 경우 사용자는 문서 [array].principals.everyone 에 접근할 수 있습니다.

    데이터 유형: 부울

    기본값: false

    지원되는 버전: API v2부터 사용할 수 있습니다.

    [배열].principals.users.deny

    각 문자열이 외부 문서에 대한 접근이 거부된 외부적으로 정의된 사용자의 이름인 문자열의 배열입니다. ServiceNow AI Platform 이러한 외부 사용자에게 매핑된 사용자는 문서에서 작성된 인덱싱된 검색 결과 기록을 볼 수 없습니다.

    또는 [array].principals.none 중 하나 [array].principals.everyone 가 로 설정된 true경우 이 매개변수는 영향을 주지 않습니다.

    이 매개변수는 보다 우선합니다 [array].principals.users.read. 동일한 사용자가 문서 AI 검색 에 대한 읽기 및 거부 액세스 권한을 모두 가진 외부 사용자에게 매핑된 경우 인덱싱된 기록에 대한 해당 사용자의 액세스를 거부합니다.

    데이터 유형: 배열

    값은 지정된 외부에서 정의된 사용자의 이름에 따라 모든 형식이 될 수 있습니다. 예를 들면 다음과 같습니다.

    "users.deny": [
      "ad\bow-ruggeri",
      "abel-tuter@sharepoint"
    ]

    지원되는 버전: API v2부터 사용할 수 있습니다.

    [array].principals.users.read

    각 문자열이 외부 문서에 액세스할 수 있는 외부적으로 정의된 사용자의 이름인 문자열의 배열입니다. ServiceNow AI Platform 이러한 외부 사용자에 매핑된 사용자는 문서에서 만든 인덱싱된 검색 결과 기록을 볼 수 있습니다.

    또는 [array].principals.none 중 하나 [array].principals.everyone 가 로 설정된 true경우 이 매개변수는 영향을 주지 않습니다.

    [array].principals.users.deny 이 매개변수보다 우선합니다. 동일한 사용자가 문서 AI 검색 에 대한 읽기 및 거부 액세스 권한을 모두 가진 외부 사용자에게 매핑된 경우 인덱싱된 기록에 대한 해당 사용자의 액세스를 거부합니다.

    기본적으로 이 매개변수는 보다 우선합니다 [array].principals.groups.deny. 인덱싱된 원본에 대해 이 우선 순위를 반대로 하려면 외부 콘텐츠 인덱싱된 원본에 대한 사용자 읽기 및 그룹 거부 권한의 우선 순위 변경을 참조하세요.

    데이터 유형: 배열

    값은 지정된 외부에서 정의된 사용자의 이름에 따라 모든 형식이 될 수 있습니다. 예를 들면 다음과 같습니다.

    "users.read": [
      "ad\abel-tuter",
      "beth-anglin@sharepoint"
    ]

    지원되는 버전: API v2부터 사용할 수 있습니다.

    [배열].속성

    각 쌍이 문서에 대해 수집할 필드 이름과 값을 나타내는 이름-값 쌍을 포함하는 객체입니다. 모든 필드 이름과 값은 문자열로 지정해야 합니다.

    수집 후 이러한 문서 필드 값은 path 매개 변수로 schema_table_name 지정된 외부 컨텐츠 스키마 테이블에 대해 정의된 인덱싱된 소스를 통해 액세스할 수 있습니다. 사용자는 이 인덱싱된 소스에서 파생된 검색 소스에서 이러한 필드 값을 검색할 수 있습니다.

    데이터 유형: 객체

    필드 이름에는 소문자와 밑줄만 사용할 수 있습니다. 값에는 모든 문자가 포함될 수 있습니다. 값 길이는 외부 컨텐츠 스키마 테이블의 필드에 대해 정의된 속성에 의해 max_length 제한됩니다. 필드 이름-값 쌍의 예는 다음과 같습니다.

    "properties": {
      "creation_date": "2020-11-03 12:27:43",
      "file_size": "10285",
      "title": "Introduction",
      "url": "file:///myhost/reports/Introduction.pdf"
    }

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

    표 16. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    콘텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 17. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 18. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    202 부분 성공. 요청이 처리되었습니다. 일부 문서에 수집 피드백, 경고 또는 오류 메시지가 있습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(JSON 또는 XML)

    이름 설명
    오류

    요청을 처리하는 동안 발생한 오류를 설명하는 객체입니다.

    데이터 유형: 객체

    "error": {
      "detail": "String",
      "message": "String"
    }
    오류.상세 정보

    요청을 처리하는 동안 발생한 오류에 대한 상세 정보입니다.

    데이터 유형: 문자열

    오류.메시지

    요청을 처리하는 동안 발생한 오류에 대한 메시지입니다.

    데이터 유형: 문자열

    결과

    수집 요청의 결과 객체를 나타내는 JSON 형식의 문자열입니다.

    데이터 유형: 문자열

    "result": "{\"duration_in_ms\": Number, \"feedback\": [Array] }"
    result.duration_in_ms

    외부 문서를 수집하는 데 소요된 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초

    결과.피드백

    각 객체가 요청 본문에서 수집된 문서에 대한 피드백을 나타내는 객체의 배열입니다.

    데이터 유형: 배열

    "feedback": [
      {
        "document_id": "String",
        "messages": [Array]
      }
    ]
    result.feedback.document_id

    요청 본문에 지정된 외부 문서의 고유 식별자입니다.

    데이터 유형: 문자열

    결과.피드백.메시지

    각 객체가 외부 문서 인덱싱 중에 기록된 수집 피드백 메시지를 나타내는 명명되지 않은 객체의 배열입니다.

    데이터 유형: 배열

    "messages": [
      {
        "code": "String",
        "component": "String",
        "level": "String",
        "message": "String"
      }
    ]
    결과.피드백.메시지.코드

    수집 피드백 메시지를 기록한 인덱싱 워크플로우 구성요소에서 throw한 예외에 대한 코드입니다.

    데이터 유형: 문자열

    결과.피드백.메시지.구성 요소

    수집 피드백 메시지를 기록한 인덱싱 워크플로우 구성요소의 식별자입니다.

    데이터 유형: 문자열

    결과.피드백.메시지.수준

    수집 피드백 메시지에 대한 로깅 수준입니다.

    유효한 값은 다음과 같습니다.
    • ERROR
    • INFO
    • MINOR_ERROR
    • WARN

    데이터 유형: 문자열

    결과.피드백.메시지.메시지

    수집 피드백 메시지에 대해 기록된 텍스트입니다.

    데이터 유형: 문자열

    상태

    실패한 요청의 상태입니다.

    유효한 값은 다음과 같습니다.
    • failure

    데이터 유형: 문자열

    주체 권한의 선행 순서

    권한의 [array].principals 우선순위는 외부 문서를 수집하는 데 사용되는 인덱싱된 소스의 속성 값 user_read_takes_precedence_over_group_deny 에 따라 달라집니다.
    속성 값 주체 권한의 선행 순서
    우선순위가 가장 높은 것부터 가장 낮은 것으로:
    1. [array].principals.everyone, [array].principals.none
    2. [array].principals.users.deny
    3. [array].principals.users.read
    4. [array].principals.groups.deny
    5. [array].principals.groups.read
    주:
    외부 콘텐츠 인덱싱된 소스의 기본 속성 값입니다.
    아니오
    우선순위가 가장 높은 것부터 가장 낮은 것으로:
    1. [array].principals.everyone, [array].principals.none
    2. [array].principals.users.deny, [array].principals.groups.deny
    3. [array].principals.users.read, [array].principals.groups.read
    주:
    이 특성 값을 설정하는 방법에 대한 지침은 외부 콘텐츠 인덱싱된 원본에 대한 사용자 읽기 및 그룹 거부 권한의 우선 순위 변경을 참조하세요.

    cURL 요청

    u_ext_content 스키마 테이블로 인덱싱하기 위한 두 개의 외부 문서( 이전에 POST /ais/external_content/storeContent 엔드포인트를 사용하여 저장한 이진 컨텐츠 개체에 대한 컨텐츠 포인터 포함)를 피드합니다.

    curl 'https://instance.servicenow.com/api/now/v2/ais/external_content/ingestDocument/u_ext_content' \
      --request POST \
      --user 'username':'password' \
      --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --data '[
      {
        "document_id": "ADMIN-2027858531-16",
        "content_pointer": "749b52a1-baa8-4556-a4f3-00404c95e6a8",
        "properties": {
          "title": "Introduction",
          "url": "file:///myhost/reports/Introduction.pdf",
          "file_name": "Introduction.pdf",
          "file_size": "10285",
          "creation_date": "2020-11-01 12:27:43"
        },
        "principals": {
          "everyone": false,
          "groups.read": [
            "report-users",
            "report-admins"
          ],
          "users.deny": [
            "ad\abel-tuter"
          ]
        }
      },
      {
        "document_id": "ADMIN-2587918521-27",
        "content_pointer": "bd605435-268b-464f-a7c3-0c5ea894a5c2",
        "properties": {
          "title": "Report for 31 August 2020",
          "url": "file:///myhost/reports/Report-2020-08-31.pdf",
          "file_size": "27597",
          "creation_date": "2020-09-01 12:48:13"
        },
        "principals": {
          "everyone": false,
          "groups.read": [
            "report-users",
            "report-admins"
          ],
          "users.read": [
            "ad\beth-anglin"
          ]
        }
      }
    ]'
    {
      "result":"{\"duration_in_ms\":3822,\"feedback\":[{\"messages\":[{\"level\":\"INFO\",\"message\":\"CREATED\",\"component\":\"init\"},{\"level\":\"INFO\",\"message\":\"OK\",\"component\":\"index-886de18e750030108b23bcd69cdc2dd3-indexer.index-886de18e750030108b23bcd69cdc2dd3-content-dispatcher\"},{\"level\":\"INFO\",\"message\":\"COMPLETED\",\"component\":\"sink.sink\"}],\"document_id\":\"ADMIN-2027858531-16\"},{\"messages\":[{\"level\":\"INFO\",\"message\":\"CREATED\",\"component\":\"init\"},{\"level\":\"WARN\",\"message\":\"field \\u0027text\\u0027 tokens exceed index.maxTokens\",\"code\":\"INDEX_ENGINE-32\",\"component\":\"ingestGlideDocument.standardAnalyzer\"},{\"level\":\"INFO\",\"message\":\"OK\",\"component\":\"index-886de18e750030108b23bcd69cdc2dd3-indexer.index-886de18e750030108b23bcd69cdc2dd3-content-dispatcher\"},{\"level\":\"INFO\",\"message\":\"COMPLETED\",\"component\":\"sink.sink\"}],\"document_id\":\"ADMIN-2587918521-27\"}]}"
    }

    외부 콘텐츠 수집 API – POST ais/external_content/storeContent

    이진 컨텐츠를 컨텐츠 객체로 저장합니다 AI 검색.

    다음 단계에 따라 저장된 이진 컨텐츠를 외부 문서와 연결할 수 있습니다.
    1. 이 엔드포인트를 사용하여 이진 콘텐츠를 저장합니다. 응답 본문 매개변수의 값을 기록합니다 result .
    2. POST /ais/external_content/ingestDocument/{schema_table_name} 엔드포인트를 AI 검색 사용하여 외부 문서를 보냅니다. 기록 result 된 응답 본문 매개변수 값과 일치하도록 문서의 content_pointer 요청 본문 매개변수를 설정합니다.
    수집하는 AI 검색 동안 이진 콘텐츠를 구문 분석하고 검색 가능한 콘텐츠를 외부 문서를 나타내는 인덱싱된 기록에 추가합니다. 구문 분석은 저장된 컨텐츠 객체를 제거합니다.

    URL 형식

    버전이 지정된 URL: /api/now/{api_version}/ais/external_content/storeContent

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 19. 경로 매개변수
    매개변수 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    표 20. 쿼리 매개변수
    이름 설명
    없음
    표 21. 요청 본문 매개변수
    요소 설명
    [이진 데이터] 필수 에서 컨텐츠 객체 AI 검색로 저장할 이진 컨텐츠입니다.

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

    표 22. 요청 헤더
    머리글 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    콘텐츠-형식

    요청 본문의 데이터 형식입니다.

    유효한 값은 다음과 같습니다.
    • application/msword
    • application/octet-stream
    • application/pdf
    • application/vnd.ms-excel
    • application/vnd.ms-powerpoint
    • application/vnd.ms-powerpoint.presentation.macroenabled.12
    • application/vnd.openxmlformats-officedocument.presentationml.presentation
    • application/vnd.openxmlformats-officedocument.presentationml.template
    • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
    • application/vnd.openxmlformats-officedocument.wordprocessingml.document
    • application/vnd.openxmlformats-officedocument.wordprocessingml.template
    • text/html
    • text/plain
    표 23. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

    표 24. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(JSON 또는 XML)

    요소 설명
    오류

    요청을 처리하는 동안 발생한 오류를 설명하는 객체입니다.

    데이터 유형: 객체

    "error": {
      "detail": "String",
      "message": "String"
    }
    오류.상세 정보

    요청을 처리하는 동안 발생한 오류에 대한 상세 정보입니다.

    데이터 유형: 문자열

    오류.메시지

    요청을 처리하는 동안 발생한 오류에 대한 메시지입니다.

    데이터 유형: 문자열

    결과

    성공적인 요청으로 저장된 이진 콘텐츠 객체의 식별자입니다.

    데이터 유형: 문자열

    "result" : "91841766-2a5f-4c64-a20a-27ca485eca21"
    주:
    저장된 콘텐츠를 수집된 외부 문서에 첨부하려면 이 식별자를 ingestDocument 엔드포인트에 대한 요청의 요청 본문 요소로 content_pointer 지정합니다.
    상태

    실패한 요청의 상태입니다.

    유효한 값은 다음과 같습니다.
    • failure

    데이터 유형: 문자열

    cURL 요청

    PDF 파일의 이진 컨텐츠를 컨텐츠 객체로 저장합니다.

    curl 'https://instance.servicenow.com/api/now/v2/ais/external_content/storeContent' \
    --request POST \
    --user 'username':'password' \
    --header 'Content-Type: application/pdf' \
    --data-binary '@Report-2020-08-31.pdf'

    응답 본문에는 새 컨텐츠 객체의 고유 식별자가 포함됩니다.

    {
      "result" : "fb439a4f-62ad-4dab-9654-5088d99a6ff9"
    }