API de ingestão de conteúdo externo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 19 min. de leitura

    • . Ingestão de conteúdo externo A API fornece endpoints que permitem a ingestão de conteúdo de fontes fora do ServiceNow® instância no ServiceNow® Pesquisa com IAíndice da aplicação.

    API de ingestão de conteúdo externo - EXCLUA /ais/external_content/deleteByQuery/

    Exclui todos os documentos externos que correspondem à consulta especificada do Pesquisa com IAíndice.

    Formato de URL

    URL com controle de versão: /api/now/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 1. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    schema_table_name

    O nome da tabela de esquema de conteúdo externo que define o esquema para os documentos indexados serem excluídos. Por exemplo, u_ext_content .

    Tipo de dados: Cadeia de caracteres
    Tabela 2. Parâmetros de consulta
    Nome Descrição
    consulta

    Uma consulta de escape de URL válida para a tabela de esquema especificada por schema_table_name. Por exemplo, Título: Introdução para consultar documentos cujo título seja Introdução .

    Tipo de dados: Cadeia de caracteres
    Tabela 3. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 4. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Oferece suporte somente a application/json.
    Tabela 5. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 6. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    erro

    Objeto que descreve o erro encontrado durante o processamento da solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail

    Detalhes do erro encontrado durante o processamento da solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro

    Mensagem do erro encontrado durante o processamento da solicitação.

    Tipo de dados: Cadeia de caracteres
    resultado

    Resultado de uma solicitação processada com sucesso.

    Tipo de dados: Cadeia de caracteres
    status

    Status de uma solicitação malsucedida.

    Valores válidos:
    • failure

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Exclua documentos com valores de campo de título Introdução e. Relatório referente a 31 de Outubro de 2020 na tabela de esquema u_ext_content.

    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 de ingestão de conteúdo externo - EXCLUA /ais/external_content/deleteDocument/

    Exclui o documento externo com um identificador exclusivo especificado do Pesquisa com IAíndice.

    Formato de URL

    URL com controle de versão: /api/now/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 7. Parâmetros de caminho
    Parâmetro Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    document_id

    O identificador exclusivo do documento externo a ser excluído. Por exemplo, ADMIN-2027858531-16 .

    Tipo de dados: Cadeia de caracteres
    schema_table_name

    O nome da tabela de esquema de conteúdo externo que define o esquema para o documento indexado excluir. Por exemplo, u_ext_content .

    Tipo de dados: Cadeia de caracteres
    Tabela 8. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 9. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 10. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Oferece suporte somente a application/json.
    Tabela 11. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 12. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Elemento Descrição
    erro

    Objeto que descreve o erro encontrado durante o processamento da solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail

    Detalhes do erro encontrado durante o processamento da solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro

    Mensagem do erro encontrado durante o processamento da solicitação.

    Tipo de dados: Cadeia de caracteres
    resultado

    Resultado de uma solicitação processada com sucesso.

    Tipo de dados: Cadeia de caracteres
    status

    Status de uma solicitação malsucedida.

    Valores válidos:
    • failure

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Exclua o documento com identificador ADMIN-2587918521-27 na tabela de esquema u_ext_content.

    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 de ingestão de conteúdo externo - POST /ais/external_content/ingestDocument/

    Envia uma lista de documentos externos para Pesquisa com IA lote de ingestão para indexação. Após a conclusão da indexação, o conteúdo dos documentos ingeridos se torna pesquisável.

    Você pode usar este endpoint para alimentar documentos externos com conteúdo de texto e metadados.

    Se você precisar associar conteúdo binário pesquisável e metadados a um documento externo, siga estas etapas:
    1. Armazene o conteúdo binário em Pesquisa com IA usando o. PUBLICAR /ais/external_content/storeContent endpoint. Registre o valor de resultparâmetro do corpo da resposta.
    2. Envie o documento externo para Pesquisa com IA usando este endpoint. Defina os documentos content_pointerparâmetro do corpo da solicitação para corresponder ao registrado resultvalor do parâmetro do corpo da resposta.
    Durante a ingestão, Pesquisa com IA analisa o conteúdo binário e adiciona seu conteúdo pesquisável ao registro indexado que representa o documento externo. A análise remove o objeto de conteúdo armazenado.

    Formato de URL

    URL com controle de versão: /api/now/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 13. Parâmetros de caminho
    Parâmetro Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    schema_table_name

    O nome da tabela de esquema de conteúdo externo que define o esquema para documentos externos na solicitação. Por exemplo, u_ext_content .

    Tipo de dados: Cadeia de caracteres
    Tabela 14. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 15. Solicitar parâmetros do corpo (XML ou JSON)
    Elemento Descrição
    [matriz]

    Obrigatório. Matriz sem nome de objetos em que cada objeto representa um documento externo para ingestão para indexação.

    Tipo de dados: Matriz

    [
  {
    "content_pointer": "String",
    "document_id": "String",
    "principals": {Object},
    "properties": {Object}
  }
]
    .content_pointer
    Identificador de uma instância de conteúdo binário armazenado usando PUBLICAR /ais/external_content/storeContent endpoint. Durante a ingestão, Pesquisa com IA analisa o conteúdo binário e adiciona seu conteúdo pesquisável ao registro indexado que representa o documento externo. A análise remove o objeto de conteúdo armazenado.
    Nota:
    Este identificador deve corresponder a. resultelemento do corpo da resposta retornado pelo StoreContent endpoint.

    Tipo de dados: Cadeia de caracteres
    .document_id

    Obrigatório. Identificador exclusivo do documento externo na tabela de esquema de conteúdo externo especificada pelo schema_table_nameparâmetro de caminho.

    Nota:
    Ao ingerir um documento, ele substitui qualquer documento existente na mesma tabela de esquema de conteúdo externo que tem o mesmo document_id. Se dois ou mais documentos na mesma solicitação de ingestão tiverem o mesmo document_ida solicitação falha.

    Tipo de dados: Cadeia de caracteres
    .principais
    Objeto que contém pares de chave-valor que descrevem as permissões de acesso do documento externo para entidades de segurança definidas externamente (usuários e grupos).
    Nota:

    Se você omitir este parâmetro para um documento, a solicitação será bem-sucedida, mas Pesquisa com IA rejeita o documento com a mensagem de feedback de ingestão O principal do documento está ausente .

    Se este objeto de parâmetro não incluir pares de chave-valor que concedam acesso a um documento, a solicitação será bem-sucedida, mas Pesquisa com IA rejeita o documento com a mensagem de feedback de ingestão O principal do documento é inválido .

    Tipo de dados: Objeto

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

    Versões compatíveis: Disponível a partir da v2 da API.
    .principals.everyone
    Sinalizador que indica se o acesso ao documento externo é permitido para todos os usuários. Quando este parâmetro é definido como true. todos ServiceNow AI Platform os usuários podem exibir o registro indexado criado a partir do documento.
    Nota:
    Se você definir este parâmetro e [array].principals.none. truepara um documento, a solicitação é bem-sucedida, mas Pesquisa com IA rejeita o documento com a mensagem de feedback de ingestão O principal do documento é inválido . Você só pode definir um desses dois parâmetros como trueem uma solicitação.
    Valores válidos:
    • true: Permitir acesso ao documento para todos os usuários. Pesquisa com IA ignora tudo [array].principals.groups.*e. [array].principals.users.*configurações de parâmetro para o documento.
    • false: Não permitir que todos os usuários acessem o documento externo. Os usuários só poderão acessar o documento se [array].principals.noneé definido como falso e se permitido pela interação de seus mapeamentos de usuário e por [array].principals.groups.*e. [array].principals.users.*parâmetros.

    Tipo de dados: Booliano

    Padrão: true

    Versões compatíveis: Disponível a partir da v2 da API.
    .principals.groups.deny

    Matriz de cadeias de caracteres em que cada cadeia de caracteres é o nome de um grupo definido externamente que tem acesso negado ao documento externo. ServiceNow AI Platform os usuários mapeados para qualquer um desses grupos externos não podem exibir o registro do resultado da pesquisa indexada criado a partir do documento.

    Se ambos forem [array].principals.everyoneou [array].principals.noneestá definido como trueeste parâmetro não tem efeito.

    Este parâmetro tem precedência sobre [array].principals.groups.read. Se o mesmo usuário for mapeado para grupos externos com permissões de acesso de leitura e negação para um documento, Pesquisa com IA nega esse acesso do usuário ao registro indexado.

    Por padrão, [array].principals.users.readtem precedência sobre este parâmetro. Para reverter essa ordem de precedência para uma origem indexada, consulte Altere a precedência das permissões de leitura do usuário e negação de grupo para uma origem indexada de conteúdo externa. .

    Tipo de dados: Matriz

    Os valores podem estar em qualquer formato, dependendo dos nomes dos grupos definidos externamente especificados. Os exemplos incluem:

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

    Versões compatíveis: Disponível a partir da v2 da API.
    [array].principals.groups.read

    Matriz de cadeias de caracteres em que cada cadeia de caracteres é o nome de um grupo definido externamente que tem permissão para acessar o documento externo. ServiceNow AI Platform os usuários mapeados para qualquer um desses grupos externos podem exibir o registro do resultado da pesquisa indexada criado a partir do documento.

    Se ambos forem [array].principals.everyoneou [array].principals.noneestá definido como trueeste parâmetro não tem efeito.

    [array].principals.groups.deny tem precedência sobre este parâmetro. Se o mesmo usuário for mapeado para grupos externos com permissões de acesso de leitura e negação para um documento, Pesquisa com IA nega esse acesso do usuário ao registro indexado.

    Tipo de dados: Matriz

    Os valores podem estar em qualquer formato, dependendo dos nomes dos grupos definidos externamente especificados. Os exemplos incluem:

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

    Versões compatíveis: Disponível a partir da v2 da API.
    .principals.none
    Opção booliana que indica se o acesso ao documento externo é negado para todos os usuários. Quando este parâmetro é definido como true, somente ServiceNow AI Platform usuários com a função de privilégio elevado ais_high_security_admin podem exibir o registro indexado criado a partir do documento.
    Nota:
    Se você definir este parâmetro e [array].principals.everyone. truepara um documento, Pesquisa com IA rejeita o documento durante a ingestão com mensagem de erro O principal do documento é inválido . Você só pode definir um desses dois parâmetros como trueem uma solicitação.
    Valores válidos:
    • trueNegar acesso ao documento para todos os usuários, exceto aqueles com a função de privilégio elevado ais_high_security_admin. Pesquisa com IA ignora tudo [array].principals.groups.*e. [array].principals.users.*configurações de parâmetro para o documento.
    • false: Não negue o acesso ao documento para todos os usuários. Os usuários podem acessar o documento se [array].principals.everyoneestá definido como true, ou se permitido pela interação de seus mapeamentos de usuário e do [array].principals.groups.reade. [array].principals.users.readparâmetros.

    Tipo de dados: Booliano

    Padrão: false

    Versões compatíveis: Disponível a partir da v2 da API.
    .principals.users.deny

    Matriz de cadeias de caracteres em que cada cadeia de caracteres é o nome de um usuário definido externamente que tem acesso negado ao documento externo. ServiceNow AI Platform os usuários mapeados para qualquer um desses usuários externos não podem exibir o registro do resultado da pesquisa indexada criado a partir do documento.

    Se ambos forem [array].principals.everyoneou [array].principals.noneestá definido como trueeste parâmetro não tem efeito.

    Este parâmetro tem precedência sobre [array].principals.users.read. Se o mesmo usuário for mapeado para usuários externos com permissões de acesso de leitura e negação para um documento, Pesquisa com IA nega esse acesso do usuário ao registro indexado.

    Tipo de dados: Matriz

    Os valores podem estar em qualquer formato, dependendo dos nomes dos usuários definidos externamente especificados. Os exemplos incluem:

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

    Versões compatíveis: Disponível a partir da v2 da API.
    [array].principals.users.read

    Matriz de cadeias de caracteres em que cada cadeia de caracteres é o nome de um usuário definido externamente que tem permissão para acessar o documento externo. ServiceNow AI Platform os usuários mapeados para qualquer um desses usuários externos podem exibir o registro do resultado da pesquisa indexada criado a partir do documento.

    Se ambos forem [array].principals.everyoneou [array].principals.noneestá definido como trueeste parâmetro não tem efeito.

    [array].principals.users.deny tem precedência sobre este parâmetro. Se o mesmo usuário for mapeado para usuários externos com permissões de acesso de leitura e negação para um documento, Pesquisa com IA nega esse acesso do usuário ao registro indexado.

    Por padrão, este parâmetro tem precedência sobre [array].principals.groups.deny. Para reverter essa ordem de precedência para uma origem indexada, consulte Altere a precedência das permissões de leitura do usuário e negação de grupo para uma origem indexada de conteúdo externa. .

    Tipo de dados: Matriz

    Os valores podem estar em qualquer formato, dependendo dos nomes dos usuários definidos externamente especificados. Os exemplos incluem:

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

    Versões compatíveis: Disponível a partir da v2 da API.
    .propriedades

    Objeto que contém pares de nome-valor em que cada par representa um nome de campo e um valor a ser ingerido para o documento. Todos os nomes e valores de campos devem ser especificados como cadeias de caracteres.

    Esses valores de campo de documento podem ser acessados por meio da origem indexada definida para a tabela de esquema de conteúdo externo especificada pelo schema_table_nameparâmetro de caminho. Os usuários podem pesquisar esses valores de campo em fontes de pesquisa derivadas desta origem indexada.

    Tipo de dados: Objeto

    Nomes de campos só podem conter letras minúsculas e sublinhados. Os valores podem incluir qualquer caractere. O tamanho do valor é limitado por max_lengthatributo definido para o campo na tabela de esquema de conteúdo externo. Exemplos de pares nome-valor de campo incluem:

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

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 16. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Oferece suporte somente a application/json.
    Tipo de conteúdo Formato de dados do corpo da solicitação. Oferece suporte somente a application/json.
    Tabela 17. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 18. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    202 Sucesso parcial. A solicitação foi processada. Alguns documentos têm aviso de feedback de ingestão ou mensagens de erro.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Nome Descrição
    erro

    Objeto que descreve o erro encontrado durante o processamento da solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail

    Detalhes do erro encontrado durante o processamento da solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro

    Mensagem do erro encontrado durante o processamento da solicitação.

    Tipo de dados: Cadeia de caracteres
    resultado

    Cadeia de caracteres formatada em JSON que representa o objeto de resultado da solicitação de ingestão.

    Tipo de dados: Cadeia de caracteres

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

    Tempo gasto na ingestão de documentos externos.

    Tipo de dados: Número

    Unidade: Milissegundos
    resultado.feedback

    Matriz de objetos em que cada objeto representa feedback para um documento ingerido do corpo da solicitação.

    Tipo de dados: Matriz

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

    Identificador exclusivo do documento externo conforme especificado no corpo da solicitação.

    Tipo de dados: Cadeia de caracteres
    feedback.resultado.mensagens

    Matriz de objetos sem nome em que cada objeto representa uma mensagem de feedback de ingestão registrada durante a indexação do documento externo.

    Tipo de dados: Matriz

    "messages": [
  {
    "code": "String",
    "component": "String",
    "level": "String",
    "message": "String"
  }
]
    resultado.feedback.mensagens.código

    Código para uma exceção lançada pelo componente de fluxo de trabalho de indexação que registrou a mensagem de feedback de ingestão.

    Tipo de dados: Cadeia de caracteres
    result.feedback.messages.component

    Identificador do componente de fluxo de trabalho de indexação que registrou a mensagem de feedback de ingestão.

    Tipo de dados: Cadeia de caracteres
    resultado.feedback.mensagens.nível

    Nível de registro em log para a mensagem de feedback de ingestão.

    Valores válidos:
    • ERROR
    • INFO
    • MINOR_ERROR
    • WARN

    Tipo de dados: Cadeia de caracteres
    resultado.feedback.mensagens.mensagem

    Texto registrado para a mensagem de feedback de ingestão.

    Tipo de dados: Cadeia de caracteres
    status

    Status de uma solicitação malsucedida.

    Valores válidos:
    • failure

    Tipo de dados: Cadeia de caracteres

    Ordem de precedência para permissões principais

    A ordem de precedência para [array].principalsas permissões dependem do valor do user_read_takes_precedence_over_group_denyatributo da origem indexada usado para ingerir um documento externo.
    Valor de atributo Ordem de precedência para permissões principais
    verdadeiro
    Da precedência mais alta para a mais baixa:
    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
    Nota:
    Este é o valor de atributo padrão para fontes indexadas de conteúdo externo.
    falso
    Da precedência mais alta para a mais baixa:
    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
    Nota:
    Para obter instruções sobre como definir este valor de atributo, consulte Altere a precedência das permissões de leitura do usuário e negação de grupo para uma origem indexada de conteúdo externa .

    Solicitação de curl

    Alimente dois documentos externos (com ponteiros de conteúdo para objetos de conteúdo binário armazenados anteriormente usando o. PUBLICAR /ais/external_content/storeContent endpoint) para indexação na tabela de esquema u_ext_content.

    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 de ingestão de conteúdo externo - POST ais/external_content/storeContent

    Armazena conteúdo binário como um objeto de conteúdo no Pesquisa com IA.

    Você pode associar conteúdo binário armazenado a um documento externo seguindo estas etapas:
    1. Armazene o conteúdo binário usando este endpoint. Registre o valor de resultparâmetro do corpo da resposta.
    2. Envie o documento externo para Pesquisa com IA usando o. PUBLIQUE /ais/external_content/ingestDocument/ endpoint. Defina os documentos content_pointerparâmetro do corpo da solicitação para corresponder ao registrado resultvalor do parâmetro do corpo da resposta.
    Durante a ingestão, Pesquisa com IA analisa o conteúdo binário e adiciona seu conteúdo pesquisável ao registro indexado que representa o documento externo. A análise remove o objeto de conteúdo armazenado.

    Formato de URL

    URL com controle de versão: /api/now//api/ais/external_content/storeContent

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 19. Parâmetros de caminho
    Parâmetro Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    Tabela 20. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 21. Parâmetros do corpo da solicitação
    Elemento Descrição
    [dados binários] Obrigatório. Conteúdo binário a ser armazenado como um objeto de conteúdo no Pesquisa com IA.

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 22. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Oferece suporte somente a application/json.
    Tipo de conteúdo

    Formato de dados do corpo da solicitação.

    Valores válidos:
    • 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
    Tabela 23. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 24. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta (JSON ou XML)

    Elemento Descrição
    erro

    Objeto que descreve o erro encontrado durante o processamento da solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail

    Detalhes do erro encontrado durante o processamento da solicitação.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro

    Mensagem do erro encontrado durante o processamento da solicitação.

    Tipo de dados: Cadeia de caracteres
    resultado

    Identificador do objeto de conteúdo binário armazenado por solicitação bem-sucedida.

    Tipo de dados: Cadeia de caracteres

    "result" : "91841766-2a5f-4c64-a20a-27ca485eca21"
    Nota:
    Para anexar o conteúdo armazenado a um documento externo ingerido, especifique este identificador como content_pointerelemento do corpo da solicitação para uma solicitação para IngestDocument endpoint.
    status

    Status de uma solicitação malsucedida.

    Valores válidos:
    • failure

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Armazene conteúdo binário de um arquivo PDF como um objeto de conteúdo.

    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'

    O corpo da resposta inclui o identificador exclusivo do novo objeto de conteúdo.

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