API de instância do CMDB

. Instância do CMDB A API fornece endpoints para criar, ler, atualizar e excluir operações no existente Configuration Management Database (CMDB) tabelas. Você só pode inserir, atualizar ou excluir um registro de cada vez.

Esta API requer que o usuário tenha a função ITIL.

CMDB Instância - EXCLUA /now/cmdb/instance/sys_id/relation/(rel_sys_id)

Exclui a relação do item de configuração (IC) especificado.

Formato de URL

URL com controle de versão: /api/now//cmdb/instance// sys_id/relation/

URL padrão: /api/now/cmdb/instance/

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
nomeClasse	CMDB nome da classe. Este é o nome da tabela que contém os registros de IC desejados, como cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Tipo de dados: Cadeia de caracteres
rel_sys_id	Sys_id da relação a ser removida. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do IC. Tipo de dados: Cadeia de caracteres

Tabela 2. Parâmetros de consulta

Nome	Descrição
Nenhum(a)

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
Nenhum(a)

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.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
405	Método inválido. A funcionalidade está desabilitada.
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
Nenhum(a)

Solicitação de cURL de amostra

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/0f4ac6c4b750230096c3e4f6ee11a9fe/relation/b0dbda5347c12200e0ef563dbb9a718f" \
--request DELETE \
--user 'username':'password'

CMDB Instância - OBTER /now/cmdb/instance/

Retorna os itens de configuração (IC) disponíveis para um especificado Configuration Management Database (CMDB) classe (tabela).

Formato de URL

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

URL padrão: /api/now/cmdb/instance/

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

Nome	Descrição
nomeClasse	CMDB nome da classe. Este é o nome da tabela que contém os registros de IC desejados, como cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Tipo de dados: Cadeia de caracteres

Tabela 8. Parâmetros de consulta

Nome	Descrição
sysparm_limit	Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro. Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro. Nota: Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema. Tipo de dados: Número Padrão: 20 Máximo: 100
sysparm_offset	Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis. Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros. Não passe um número negativo em sysparm_offsetparâmetro. Tipo de dados: Número Padrão: 0
sysparm_query	Consulta codificada usado para filtrar o conjunto de resultados. Você pode usar um filtro de IU para obter uma consulta codificada corretamente. Sintaxe: sysparm_query_query_<col_name> <operator> <value> . <col_name>: Nome da coluna da tabela a ser filtrada. Compatível com os seguintes valores <operator>: Corresponde exatamente ao <value>. Não corresponde ao <value>. Declarações de consulta lógica E múltipla. OU: Declarações de consulta lógica OU múltipla. CURTIR: O <col_name> contém a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. STARTSWITH: O <col_name> começa com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. ENDSWITH: O <col_name> termina com a cadeia de caracteres especificada. Funciona somente para campos do <col_name> cujo tipo de dados é cadeia de caracteres. <value>: Valor a ser correspondido. Para obter mais operadores, consulte Operators available for filters and queries. Todos os parâmetros diferenciam maiúsculas de minúsculas. As consultas podem conter mais de uma entrada, como sysparm_query_<col_name> <operator> <value>[<operator> <col_name> <operator> <value>] . Por exemplo: (Sysparm_query_caller_id_id_javascript:gs.getUserID() "ative_true") As consultas codificadas também são compatíveis com a funcionalidade Ordem por. Para classificar respostas com base em determinados campos, use ORDERBY e. ORDERBYDESC cláusulas em sysparm_query. Sintaxe: ORDERBY<col_name> ORDERBYDESC<col_name> Por exemplo: SYsparm_query Esta consulta filtra todos os registros ativos e ordena os resultados em ordem crescente por número e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, como especificar um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: . glide.invalid_query.returns_no_rowsa propriedade controla o comportamento de todas as consultas na instância, como em listas, scripts ( GlideRecord.query() E APIs de serviço web. Tipo de dados: Cadeia de caracteres

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. Tipos compatíveis: application/jsonou application/xml. Padrão: 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.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
405	Método inválido. A funcionalidade está desabilitada.
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
nome	Nome de um IC na classe especificada. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do IC. Tipo de dados: Cadeia de caracteres

Solicitação de cURL de amostra

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

"result": [
  {
    "sys_id": "3a290cc60a0a0bb400000bdb386af1cf",
    "name": "PS LinuxApp01"
  },
  {
    "sys_id": "3a5dd3dbc0a8ce0100655f1ec66ed42c",
    "name": "PS LinuxApp02"
  }
]

CMDB Instância - OBTER /now/cmdb/instance/

Retorna atributos e informações de relacionamento para um registro de item de configuração (IC) especificado.

Formato de URL

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

URL padrão: /api/now/cmdb/instance/

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

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
nomeClasse	CMDB nome da classe. Este é o nome da tabela que contém os registros de IC desejados, como cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do registro de IC a ser recuperado. 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)

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 16. Cabeçalhos da solicitação

Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: 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.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
405	Método inválido. A funcionalidade está desabilitada.
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)

Tabela 19. Parâmetros de resposta

Nome	Descrição
atributos	Atributos de dados atualmente no registro de IC. Os atributos disponíveis dependem do especificado CMDB classe. Você pode localizar os atributos disponíveis no associado CMDB tabela que normalmente começa com "cmdb_ci", como cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Tipo de dados: Objeto
erro	Informações sobre todos os erros encontrados ao processar a solicitação de endpoint. Tipo de dados: Objeto "error": { "detail": "String", "message": "String" }
error.detail	Informações adicionais sobre o erro. Tipo de dados: Cadeia de caracteres
mensagem.erro	Mensagem que identifica o erro. Tipo de dados: Cadeia de caracteres
inbound_relations	Lista de objetos que definem as relações de entrada associadas ao IC. Tipo de dados: Matriz "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
inbound_relations.sys_id	Sys_id do relacionamento de IC de entrada. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target	Informações que descrevem a relação de entrada de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.target.display_value	Nome da relação de entrada a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de entrada da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target.value	Sys_id do IC de entrada. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.type	Informações sobre o tipo de relacionamento de entrada. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.type.display_value	Nome do tipo de entrada a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar o tipo de relação de entrada da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
inbound_relations.type.value	Sys_id do tipo de relacionamento de entrada. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations	Lista de objetos que definem as relações de saída associadas ao IC. Tipo de dados: Matriz "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
outbound_relations.sys_id	Sys_id do relacionamento de IC de saída. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target	Obrigatório. Informações sobre a relação de saída de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.target.display_value	Nome da relação de saída a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target.value	Sys_id do IC de saída. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.type	Informações sobre o tipo de relacionamento de saída. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.type.display_value	Nome do tipo de saída a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations.type.value	Sys_id do tipo de relacionamento de saída. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
status	Aparece somente se um erro for encontrado. Status do processamento do endpoint. Valor possível: Falha Tipo de dados: Cadeia de caracteres

Solicitação de cURL de amostra

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/70bc4e11c0a8210d01f074cbe6bd73b4" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "outbound_relations": [
      {
        "sys_id": "3a62e64ac0a8ce0100aead1e3fd5439f",
        "type": {
          "display_value": "Depends on::Used by",
          "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
          "value": "1a9cb166f1571100a92eb60da2bce5c5"
        },
        "target": {
          "display_value": "PS ORA01",
          "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
          "value": "3a307c930a0a0bb400353965d0b8861f"
        }
      },
      {
        "sys_id": "3a67513fc0a8ce0100914a76cea11b02",
        "type": {
          "display_value": "Exchanges data with::Exchanges data with",
          "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90",
          "value": "607ad1b2c0a8010e01941856b365af90"
        },
        "target": {
          "display_value": "PS ORA01",
          "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
          "value": "3a307c930a0a0bb400353965d0b8861f"
        }
      }
    ],
    "attributes": {
      "firewall_status": "Intranet",
      "os_address_width": "",
      "attested_date": "",
      "operational_status": "1",
      "os_service_pack": "",
      "cpu_core_thread": "",
      "cpu_manufacturer": "",
      "sys_updated_on": "2020-07-08 11:16:51",
      "discovery_source": "",
      "first_discovered": "",
      "due_in": "",
      "used_for": "Production",
      "invoice_number": "",
      "gl_account": "",
      "sys_created_by": "glide.maint",
      "warranty_expiration": "",
      "ram": "2048",
      "cpu_name": "",
      "cpu_speed": "2800",
      "owned_by": "",
      "checked_out": "",
      "kernel_release": "",
      "sys_domain_path": "/",
      "classification": "Production",
      "disk_space": "40",
      "object_id": "",
      "maintenance_schedule": "",
      "cost_center": "",
      "attested_by": "",
      "dns_domain": "",
      "assigned": "2020-01-04 07:00:00",
      "purchase_date": "",
      "life_cycle_stage": "",
      "short_description": "",
      "cd_speed": "",
      "floppy": "",
      "managed_by": {
        "display_value": "Lynda Caraway",
        "link": "https://instance.service-now.com/api/now/table/sys_user/8a826bf03710200044e0bfc8bcbe5d72",
        "value": "8a826bf03710200044e0bfc8bcbe5d72"
      },
      "os_domain": "",
      "last_discovered": "",
      "can_print": "false",
      "sys_class_name": "cmdb_ci_linux_server",
      "manufacturer": {
        "display_value": "Iris",
        "link": "https://instance.servicenow.com/api/now/table/core_company/c115c2f737e3100044e0bfc8bcbe5d46",
        "value": "c115c2f737e3100044e0bfc8bcbe5d46"
      },
      "cpu_count": "1",
      "vendor": {
        "display_value": "Cloudward Inc",
        "link": "https://instance.servicenow.com/api/now/table/core_company/3efe8c4c37423000158bbfc8bcbe5d7d",
        "value": "3efe8c4c37423000158bbfc8bcbe5d7d"
      },
      "life_cycle_stage_status": "",
      "model_number": "",
      "assigned_to": "",
      "start_date": "",
      "os_version": "2.6.9-22.0.1.ELsmp",
      "serial_number": "",
      "cd_rom": "false",
      "support_group": "",
      "unverified": "false",
      "correlation_id": "",
      "attributes": "",
      "asset": {
        "display_value": "P1000091 - Iris 5875",
        "link": "https://instance.servicenow.com/api/now/table/alm_asset/0bc1ba8837f3100044e0bfc8bcbe5dbb",
        "value": "0bc1ba8837f3100044e0bfc8bcbe5dbb"
      },
      "form_factor": "",
      "cpu_core_count": "",
      "skip_sync": "false",
      "attestation_score": "",
      "sys_updated_by": "system",
      "sys_created_on": "2008-10-26 17:17:28",
      "sys_domain": {
        "display_value": "global",
        "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
        "value": "global"
      },
      "cpu_type": "Intel",
      "install_date": "2019-08-18 08:00:00",
      "asset_tag": "P1000091",
      "dr_backup": "",
      "hardware_substatus": "",
      "fqdn": "",
      "change_control": "",
      "internet_facing": "false",
      "delivery_date": "",
      "hardware_status": "",
      "install_status": "1",
      "supported_by": "",
      "name": "PS LinuxApp01",
      "subcategory": "",
      "default_gateway": "",
      "chassis_type": "",
      "virtual": "false",
      "assignment_group": "",
      "managed_by_group": "",
      "sys_id": "3a290cc60a0a0bb400000bdb386af1cf",
      "po_number": "",
      "checked_in": "",
      "sys_class_path": "/!!/!2/!(/!!/!0",
      "mac_address": "",
      "company": {
        "display_value": "ACME Corporation",
        "link": "https://instance.servicenow.com/api/now/table/core_company/e7c1f3d53790200044e0bfc8bcbe5deb",
        "value": "e7c1f3d53790200044e0bfc8bcbe5deb"
      },
      "justification": "",
      "department": "",
      "cost": "45557.5",
      "comments": "",
      "os": "Linux Red Hat",
      "sys_mod_count": "24",
      "monitor": "false",
      "model_id": {
        "display_value": "Iris 5875",
        "link": "https://instance.servicenow.com/api/now/table/cmdb_model/5f5fbcc3c0a8010e00f3b27814f3b96b",
        "value": "5f5fbcc3c0a8010e00f3b27814f3b96b"
      },
      "ip_address": "",
      "duplicate_of": "",
      "sys_tags": "",
      "cost_cc": "USD",
      "order_date": "",
      "schedule": "",
      "environment": "",
      "due": "",
      "attested": "false",
      "location": {
        "display_value": "322 West 52nd Street, New York,NY",
        "link": "https://instance.servicenow.com/api/now/table/cmn_location/25ab9f690a0a0bb3001c5fec1d0d7bcb",
        "value": "25ab9f690a0a0bb3001c5fec1d0d7bcb"
      },
      "category": "Do not migrate to asset",
      "fault_count": "0",
      "host_name": "",
      "lease_id": ""
    },
    "inbound_relations": [
      {
        "sys_id": "3a5e4d8ac0a8ce010005145afb730818",
        "type": {
          "display_value": "Depends on::Used by",
          "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
          "value": "1a9cb166f1571100a92eb60da2bce5c5"
        },
        "target": {
          "display_value": "PS Apache01",
          "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439",
          "value": "3a27d4370a0a0bb4006316812bf45439"
        }
      },
      {
        "sys_id": "3a5e4d9cc0a8ce010097f2f5c2f65fd8",
        "type": {
          "display_value": "Depends on::Used by",
          "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
          "value": "1a9cb166f1571100a92eb60da2bce5c5"
        },
        "target": {
          "display_value": "PS Apache02",
          "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27f1520a0a0bb400ecd6ff7afcf036",
          "value": "3a27f1520a0a0bb400ecd6ff7afcf036"
        }
      },
      {
        "sys_id": "3a5e4d9fc0a8ce0100a3754fac26fe56",
        "type": {
          "display_value": "Depends on::Used by",
          "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
          "value": "1a9cb166f1571100a92eb60da2bce5c5"
        },
        "target": {
          "display_value": "PS Apache03",
          "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a2810c20a0a0bb400268337d6e942ca",
          "value": "3a2810c20a0a0bb400268337d6e942ca"
        }
      }
    ]
  }
}

CMDB /Now/cmdb/instance/

Cria um único item de configuração (IC) com as relações de saída e entrada especificadas no especificado Configuration Management Database (CMDB) tabela.

Nota:

. CMDB A classe tem uma regra de identificação dependente definida, então a carga de entrada deve conter o sys_id de um IC existente. Por exemplo, para outbound_relations. targetO parâmetro deve conter o sys_id de um IC existente, que se torna o secundário. Para inbound_relations, ele se torna o primário.

  "depends_on": {
    "outbound_relations":
      {
        "target": "b4fd7c8437201000deeabfc8bcbe5dc1",
        "type": "60bc4e22c0a8010e01f074cbe6bd73c3"
      }
    }

Formato de URL

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

URL padrão: /api/now/cmdb/instance/

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 20. Parâmetros de caminho

Nome	Descrição
nomeClasse	CMDB nome da classe. Este é o nome da tabela que contém os registros de IC desejados, como cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Tipo de dados: Cadeia de caracteres

Tabela 21. Parâmetros de consulta

Nome	Descrição
Nenhum(a)

Tabela 22. Solicitar parâmetros do corpo (XML ou JSON)

Nome	Descrição
atributos	Atributos de dados a serem definidos no registro de IC. Os atributos disponíveis dependem do especificado CMDB classe. Você pode localizar os atributos disponíveis no associado CMDB tabela que normalmente começa com "cmdb_ci", como cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Tipo de dados: Objeto
inbound_relations	Lista de objetos que definem as relações de entrada a serem associadas ao IC. Tipo de dados: Matriz "inbound_relations": [ { "target": "String", "type": "String" } ]
inbound_relations.target	Necessário se inbound_relationsespecificado. Sys_id da relação de entrada de destino a ser associada ao IC especificado. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.type	Necessário se inbound_relationsespecificado. Sys_id do tipo de relacionamento de entrada. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations	Lista de objetos que definem as relações de saída a serem associadas ao IC. Tipo de dados: Matriz "outbound_relations": [ { "target": "String", "type": "String" } ]
outbound_relations.target	Necessário se outbound_relationsespecificado. Sys_id da relação de saída de destino. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.type	Necessário se outbound_relationsespecificado. Sys_id do tipo de relacionamento de saída. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
origem	Obrigatório. Entidade que atualizou as informações. Este deve ser um dos valores de opção especificados no campo discovery_source na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres

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 23. Cabeçalhos da solicitação

Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 24. 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 25. 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.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
405	Método inválido. A funcionalidade está desabilitada.
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)

Tabela 26. Parâmetros de resposta

Nome	Descrição
atributos	Atributos de dados atualmente no registro de IC. Os atributos disponíveis dependem do especificado CMDB classe. Você pode localizar os atributos disponíveis no associado CMDB tabela que normalmente começa com "cmdb_ci", como cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Tipo de dados: Objeto
erro	Informações sobre todos os erros encontrados ao processar a solicitação de endpoint. Tipo de dados: Objeto "error": { "detail": "String", "message": "String" }
error.detail	Informações adicionais sobre o erro. Tipo de dados: Cadeia de caracteres
mensagem.erro	Mensagem que identifica o erro. Tipo de dados: Cadeia de caracteres
inbound_relations	Lista de objetos que definem as relações de entrada associadas ao IC. Tipo de dados: Matriz "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
inbound_relations.sys_id	Sys_id do relacionamento de IC de entrada. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target	Informações que descrevem a relação de entrada de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.target.display_value	Nome da relação de entrada a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de entrada da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target.value	Sys_id do IC de entrada. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.type	Informações sobre o tipo de relacionamento de entrada. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.type.display_value	Nome do tipo de entrada a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar o tipo de relação de entrada da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
inbound_relations.type.value	Sys_id do tipo de relacionamento de entrada. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations	Lista de objetos que definem as relações de saída associadas ao IC. Tipo de dados: Matriz "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
outbound_relations.sys_id	Sys_id do relacionamento de IC de saída. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target	Obrigatório. Informações sobre a relação de saída de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.target.display_value	Nome da relação de saída a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target.value	Sys_id do IC de saída. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.type	Informações sobre o tipo de relacionamento de saída. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.type.display_value	Nome do tipo de saída a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations.type.value	Sys_id do tipo de relacionamento de saída. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
status	Aparece somente se um erro for encontrado. Status do processamento do endpoint. Valor possível: Falha Tipo de dados: Cadeia de caracteres

Solicitação de curl

O exemplo de código a seguir mostra como chamar este endpoint.

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json"\
--user "username":"password" \
--data {
  "outbound_relations": [
    {
      "type" : "1a9cb166f1571100a92eb60da2bce5c5",
      "target" : "3a307c930a0a0bb400353965d0b8861f"
    },
    {
      "type" : "607ad1b2c0a8010e01941856b365af90",
      "target" : "3a307c930a0a0bb400353965d0b8861f"
    }
  ],
  "attributes": {
    "name" : "lnux999",
    "firewall_status": "Intranet"
  },
  "source": "ServiceNow",
  "inbound_relations": [
    {
      "type" : "1a9cb166f1571100a92eb60da2bce5c5",
      "target" : "3a27d4370a0a0bb4006316812bf45439"
    }
  ]
}

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "403ff2641b425010593876a61a4bcb4b",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
                    "value": "1a9cb166f1571100a92eb60da2bce5c5"
                },
                "target": {
                    "display_value": "PS ORA01",
                    "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
                    "value": "3a307c930a0a0bb400353965d0b8861f"
                }
            },
            {
                "sys_id": "443ff2641b425010593876a61a4bcb4c",
                "type": {
                    "display_value": "Exchanges data with::Exchanges data with",
                    "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90",
                    "value": "607ad1b2c0a8010e01941856b365af90"
                },
                "target": {
                    "display_value": "PS ORA01",
                    "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
                    "value": "3a307c930a0a0bb400353965d0b8861f"
                }
            }
        ],
        "attributes": {
            "firewall_status": "Intranet",
            "os_address_width": "",
            "attested_date": "",
            "operational_status": "1",
            "os_service_pack": "",
            "cpu_core_thread": "",
            "cpu_manufacturer": "",
            "sys_updated_on": "2020-07-13 20:27:28",
            "discovery_source": "ServiceNow",
            "first_discovered": "2020-07-13 20:27:28",
            "due_in": "",
            "used_for": "Production",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "dora.gray",
            "warranty_expiration": "",
            "ram": "",
            "cpu_name": "",
            "cpu_speed": "",
            "owned_by": "",
            "checked_out": "",
            "kernel_release": "",
            "sys_domain_path": "/",
            "classification": "Production",
            "disk_space": "",
            "object_id": "",
            "maintenance_schedule": "",
            "cost_center": "",
            "attested_by": "",
            "dns_domain": "",
            "assigned": "",
            "purchase_date": "",
            "life_cycle_stage": "",
            "short_description": "",
            "cd_speed": "",
            "floppy": "",
            "managed_by": "",
            "os_domain": "",
            "last_discovered": "2020-07-13 20:27:28",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_linux_server",
            "manufacturer": "",
            "cpu_count": "",
            "vendor": "",
            "life_cycle_stage_status": "",
            "model_number": "",
            "assigned_to": "",
            "start_date": "",
            "os_version": "",
            "serial_number": "",
            "cd_rom": "false",
            "support_group": "",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "asset": "",
            "form_factor": "",
            "cpu_core_count": "",
            "skip_sync": "false",
            "attestation_score": "",
            "sys_updated_by": "dora.gray",
            "sys_created_on": "2020-07-13 20:27:28",
            "sys_domain": {
                "display_value": "global",
                "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "cpu_type": "",
            "install_date": "",
            "asset_tag": "",
            "dr_backup": "",
            "hardware_substatus": "",
            "fqdn": "",
            "change_control": "",
            "internet_facing": "true",
            "delivery_date": "",
            "hardware_status": "installed",
            "install_status": "1",
            "supported_by": "",
            "name": "lnux299",
            "subcategory": "Computer",
            "default_gateway": "",
            "chassis_type": "",
            "virtual": "false",
            "assignment_group": "",
            "managed_by_group": "",
            "sys_id": "0c3ff2641b425010593876a61a4bcb39",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!2/!(/!!/!0",
            "mac_address": "",
            "company": "",
            "justification": "",
            "department": "",
            "cost": "",
            "comments": "",
            "os": "",
            "sys_mod_count": "0",
            "monitor": "false",
            "model_id": "",
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "location": "",
            "category": "Hardware",
            "fault_count": "0",
            "host_name": "",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "c03ff2641b425010593876a61a4bcb49",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
                    "value": "1a9cb166f1571100a92eb60da2bce5c5"
                },
                "target": {
                    "display_value": "PS Apache01",
                    "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439",
                    "value": "3a27d4370a0a0bb4006316812bf45439"
                }
            }
        ]
    }
}

Solicitação de curl

O exemplo de código a seguir mostra como chamar este endpoint para uma classe que tem uma regra de identificação dependente definida. . outbound_relations.targetDeve ser incluído na carga e conter o sys_id de um IC existente.

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json"\
--user "username":"password" \
--data {
  "attributes": {
    "name": "test",
    "sys_class_name":"cmdb_ci_db_mssql_instance",
    "instance_name":"Iname"
  },
  "source": "ServiceNow",
  "depends_on": {
    "outbound_relations":
      {
        "target": "b4fd7c8437201000deeabfc8bcbe5dc1",
        "type": "60bc4e22c0a8010e01f074cbe6bd73c3"
      }
    }
  }
}

{
  "result": {
    "outbound_relations": [
      {
        "sys_id": "505cfa3a53662110af64ddeeff7b1217",
        "type": {
          "display_value": "Runs on::Runs",
          "link": http://instance.servicenow.com/api/now/table/cmdb_rel_type/60bc4e22c0a8010e01f074cbe6bd73c3,
          "value": "60bc4e22c0a8010e01f074cbe6bd73c3"
        },
        "target": {
          "display_value": "*ANNIE-IBM",
          "link": http://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/b4fd7c8437201000deeabfc8bcbe5dc1,
          "value": "b4fd7c8437201000deeabfc8bcbe5dc1"
        }
      }
    ],
    "attributes": {
      "attested_date": "",
      "operational_status": "1",
      "running_process_command": "",
      "sys_updated_on": "2023-05-05 21:28:24",
      "type": "",
      "running_process_key_parameters": "",
      "rp_command_hash": "",
      "discovery_source": "ServiceNow",
      "first_discovered": "2023-05-05 21:28:24",
      "due_in": "",
      "service_pack": "",
      "used_for": "Production",
      "is_clustered": "false",
      "invoice_number": "",
      "gl_account": "",
      "sys_created_by": "admin",
      "warranty_expiration": "",
      "owned_by": "",
      "checked_out": "",
      "rp_key_parameters_hash": "",
      "sys_domain_path": "/",
      "business_unit": "",
      "version": "",
      "cpu_sockets": "",
      "maintenance_schedule": "",
      "cost_center": "",
      "attested_by": "",
      "dns_domain": "",
      "assigned": "",
      "purchase_date": "",
      "life_cycle_stage": "",
      "short_description": "",
      "managed_by": "",
      "port_dynamic": "false",
      "last_discovered": "2023-05-05 21:28:24",
      "can_print": "false",
      "sys_class_name": "cmdb_ci_db_mssql_instance",
      "manufacturer": "",
      "cl_port": "",
      "vendor": "",
      "life_cycle_stage_status": "",
      "model_number": "",
      "config_file": "",
      "assigned_to": "",
      "start_date": "",
      "instance_name": "Iname",
      "serial_number": "",
      "engine_edition": "",
      "support_group": "",
      "version_name": "",
      "unverified": "false",
      "correlation_id": "",
      "attributes": "",
      "asset": "",
      "config_directory": "",
      "tcp_port": "",
      "listener_name": "",
      "skip_sync": "false",
      "pid": "",
      "attestation_score": "",
      "sys_updated_by": "admin",
      "install_directory": "",
      "sys_created_on": "2023-05-05 21:28:24",
      "sys_domain": {
        "display_value": "global",
        "link": http://instance.servicenow.com/api/now/table/sys_user_group/global,
        "value": "global"
      },
      "install_date": "",
      "asset_tag": "",
      "fqdn": "",
      "change_control": "",
      "delivery_date": "",
      "install_status": "1",
      "supported_by": "",
      "name": "test",
      "subcategory": "Database",
      "assignment_group": "",
      "edition": "",
      "managed_by_group": "",
      "sys_id": "185cba3a53662110af64ddeeff7b12af",
      "po_number": "",
      "database": "",
      "checked_in": "",
      "sys_class_path": "/!!/!(/!2/!,",
      "mac_address": "",
      "company": "",
      "justification": "",
      "department": "",
      "cost": "",
      "comments": "",
      "attestation_status": "Not Yet Reviewed",
      "sys_mod_count": "0",
      "monitor": "false",
      "model_id": "",
      "ip_address": "",
      "duplicate_of": "",
      "sys_tags": "",
      "cost_cc": "USD",
      "order_date": "",
      "schedule": "",
      "environment": "",
      "due": "",
      "attested": "false",
      "location": "",
      "category": "Resource",
      "fault_count": "0",
      "lease_id": ""
    },
    "inbound_relations": []
  }
}

Solicitação de curl

O exemplo de código a seguir mostra o que é retornado quando um sys_id não é aprovado para uma classe que tem uma regra de identificação dependente definida. O mesmo resultado ocorre se o sys_id for inválido.

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json"\
--user "username":"password" \
--data "{
  "attributes": {
    "name": "test",
    "sys_class_name":"cmdb_ci_db_mssql_instance",
    "instance_name":"Iname"
  },
  "source": "ServiceNow",
  "depends_on": {
    "outbound_relations": {
        "type": "60bc4e22c0a8010e01f074cbe6bd73c3"
    }
  }
}

{
  "error": {
    "detail": "Exception while executing request: null Check logs for error trace or enable glide.rest.debug property to verify REST request processing",
    "message": "Exception while executing request: null"
  },
  "status": "failure"
}

CMDB Instância - COLOQUE /now/cmdb/instance/

Atualiza o registro de item de configuração (IC) especificado com os pares nome-valor de atributo especificados. Este endpoint não cria, atualiza ou exclui as relações associadas.

Nota:

Este endpoint não está em conformidade com as especificações HTML. Os endpoints PUT padrão são destrutivos, pois removem todos os elementos que não estão incluídos na solicitação. Este endpoint não remove elementos não especificados.

Formato de URL

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

URL padrão: /api/now/cmdb/instance/

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 27. Parâmetros de caminho

Nome	Descrição
nomeClasse	CMDB nome da classe. Este é o nome da tabela que contém os registros de IC desejados, como cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do registro de IC a ser atualizado. Tipo de dados: Cadeia de caracteres

Tabela 28. Parâmetros de consulta

Nome	Descrição
Nenhum(a)

Tabela 29. Solicitar parâmetros do corpo (XML ou JSON)

Nome	Descrição
atributos	Atributos de dados a serem substituídos no registro de IC. Os atributos disponíveis dependem do especificado CMDB classe. Você pode localizar os atributos disponíveis no associado CMDB tabela que normalmente começa com "cmdb_ci", como cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Para obter informações sobre certificação, consulte CIs attestation. Tipo de dados: Objeto
origem	Obrigatório. Entidade que atualizou as informações. Este deve ser um dos valores de opção especificados no campo discovery_source na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres

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 30. Cabeçalhos da solicitação

Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 31. 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 32. 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.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
405	Método inválido. A funcionalidade está desabilitada.
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)

Tabela 33. Parâmetros de resposta

Nome	Descrição
atributos	Atributos de dados atualmente no registro de IC. Os atributos disponíveis dependem do especificado CMDB classe. Você pode localizar os atributos disponíveis no associado CMDB tabela que normalmente começa com "cmdb_ci", como cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Tipo de dados: Objeto
erro	Informações sobre todos os erros encontrados ao processar a solicitação de endpoint. Tipo de dados: Objeto "error": { "detail": "String", "message": "String" }
error.detail	Informações adicionais sobre o erro. Tipo de dados: Cadeia de caracteres
mensagem.erro	Mensagem que identifica o erro. Tipo de dados: Cadeia de caracteres
inbound_relations	Lista de objetos que definem as relações de entrada associadas ao IC. Tipo de dados: Matriz "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
inbound_relations.sys_id	Sys_id do relacionamento de IC de entrada. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target	Informações que descrevem a relação de entrada de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.target.display_value	Nome da relação de entrada a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de entrada da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target.value	Sys_id do IC de entrada. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.type	Informações sobre o tipo de relacionamento de entrada. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.type.display_value	Nome do tipo de entrada a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar o tipo de relação de entrada da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
inbound_relations.type.value	Sys_id do tipo de relacionamento de entrada. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations	Lista de objetos que definem as relações de saída associadas ao IC. Tipo de dados: Matriz "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
outbound_relations.sys_id	Sys_id do relacionamento de IC de saída. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target	Obrigatório. Informações sobre a relação de saída de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.target.display_value	Nome da relação de saída a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target.value	Sys_id do IC de saída. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.type	Informações sobre o tipo de relacionamento de saída. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.type.display_value	Nome do tipo de saída a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations.type.value	Sys_id do tipo de relacionamento de saída. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
status	Aparece somente se um erro for encontrado. Status do processamento do endpoint. Valor possível: Falha Tipo de dados: Cadeia de caracteres

Solicitação de cURL de amostra

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/70bc4e11c0a8210d01f074cbe6bd73b4" \
--request PUT \
--header "Accept:application/json" \
--header "Content-Type:application/json"\
--user "username":"password" \
--data {
  "attributes": {
    "firewall_status": "Extranet",
    "discovery_source": "ServiceNows",
    "name": "Linux299",
    "used_for": "Pre-production",
    "container": "Box"
  },
  "source": "ServiceNow"
}

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "403ff2641b425010593876a61a4bcb4b",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
                    "value": "1a9cb166f1571100a92eb60da2bce5c5"
                },
                "target": {
                    "display_value": "PS ORA01",
                    "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
                    "value": "3a307c930a0a0bb400353965d0b8861f"
                }
            },
            {
                "sys_id": "443ff2641b425010593876a61a4bcb4c",
                "type": {
                    "display_value": "Exchanges data with::Exchanges data with",
                    "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90",
                    "value": "607ad1b2c0a8010e01941856b365af90"
                },
                "target": {
                    "display_value": "PS ORA01",
                    "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
                    "value": "3a307c930a0a0bb400353965d0b8861f"
                }
            }
        ],
        "attributes": {
            "firewall_status": "Extranet",
            "os_address_width": "",
            "attested_date": "",
            "operational_status": "1",
            "os_service_pack": "",
            "cpu_core_thread": "",
            "cpu_manufacturer": "",
            "sys_updated_on": "2020-07-13 20:59:40",
            "discovery_source": "ServiceNow",
            "first_discovered": "2020-07-13 20:27:28",
            "due_in": "",
            "used_for": "Pre-production",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "dora.gray",
            "warranty_expiration": "",
            "ram": "",
            "cpu_name": "",
            "cpu_speed": "",
            "owned_by": "",
            "checked_out": "",
            "kernel_release": "",
            "sys_domain_path": "/",
            "classification": "Production",
            "disk_space": "",
            "object_id": "",
            "maintenance_schedule": "",
            "cost_center": "",
            "attested_by": "",
            "dns_domain": "",
            "assigned": "",
            "purchase_date": "",
            "life_cycle_stage": "",
            "short_description": "",
            "cd_speed": "",
            "floppy": "",
            "managed_by": "",
            "os_domain": "",
            "last_discovered": "2020-07-13 20:59:40",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_linux_server",
            "manufacturer": "",
            "cpu_count": "",
            "vendor": "",
            "life_cycle_stage_status": "",
            "model_number": "",
            "assigned_to": "",
            "start_date": "",
            "os_version": "",
            "serial_number": "",
            "cd_rom": "false",
            "support_group": "",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "asset": {
                "display_value": "Unknown",
                "link": "https://instance.service-now.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52",
                "value": "21cfba641b425010593876a61a4bcb52"
            },
            "form_factor": "",
            "cpu_core_count": "",
            "skip_sync": "false",
            "attestation_score": "",
            "sys_updated_by": "dora.gray",
            "sys_created_on": "2020-07-13 20:27:28",
            "sys_domain": {
                "display_value": "global",
                "link": "https://instance.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "cpu_type": "",
            "install_date": "",
            "asset_tag": "",
            "dr_backup": "",
            "hardware_substatus": "",
            "fqdn": "",
            "change_control": "",
            "internet_facing": "true",
            "delivery_date": "",
            "hardware_status": "installed",
            "install_status": "1",
            "supported_by": "",
            "name": "Linux299",
            "subcategory": "Computer",
            "default_gateway": "",
            "chassis_type": "",
            "virtual": "false",
            "assignment_group": "",
            "managed_by_group": "",
            "sys_id": "0c3ff2641b425010593876a61a4bcb39",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!2/!(/!!/!0",
            "mac_address": "",
            "company": "",
            "justification": "",
            "department": "",
            "cost": "",
            "comments": "",
            "os": "",
            "sys_mod_count": "3",
            "monitor": "false",
            "model_id": {
                "display_value": "Unknown",
                "link": "https://instance.service-now.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6",
                "value": "0ce0a2681b4e1010593876a61a4bcba6"
            },
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "location": "",
            "category": "Hardware",
            "fault_count": "0",
            "host_name": "",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "c03ff2641b425010593876a61a4bcb49",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://instance.service-now.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
                    "value": "1a9cb166f1571100a92eb60da2bce5c5"
                },
                "target": {
                    "display_value": "PS Apache01",
                    "link": "https://instance.service-now.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439",
                    "value": "3a27d4370a0a0bb4006316812bf45439"
                }
            }
        ]
    }
}

CMDB Instância - POST /now/cmdb/instance/classname/sys_id/relation

Adiciona uma relação de entrada e/ou saída ao item de configuração (IC) especificado. O IC especificado é o primário.

Formato de URL

URL com controle de versão: /api/now//cmdb/instance// sys_id/relation

URL padrão: /api/now/cmdb/instance/sys_id/relation

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 34. Parâmetros de caminho

Nome	Descrição
nomeClasse	CMDB nome da classe. Este é o nome da tabela que contém os registros de IC desejados, como cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do registro de IC a ser atualizado. Tipo de dados: Cadeia de caracteres

Tabela 35. Parâmetros de consulta

Nome	Descrição
Nenhum(a)

Tabela 36. Solicitar parâmetros do corpo (XML ou JSON)

Nome	Descrição
inbound_relations	Lista de objetos que definem as relações de entrada a serem associadas ao IC. Tipo de dados: Matriz "inbound_relations": [ { "target": "String", "type": "String" } ]
inbound_relations.target	Necessário se inbound_relationsespecificado. Sys_id da relação de entrada de destino a ser associada ao IC especificado. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.type	Necessário se inbound_relationsespecificado. Sys_id do tipo de relacionamento de entrada. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations	Lista de objetos que definem as relações de saída a serem associadas ao IC. Tipo de dados: Matriz "outbound_relations": [ { "target": "String", "type": "String" } ]
outbound_relations.target	Necessário se outbound_relationsespecificado. Sys_id da relação de saída de destino. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.type	Necessário se outbound_relationsespecificado. Sys_id do tipo de relacionamento de saída. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
origem	Obrigatório. Entidade que atualizou as informações. Este deve ser um dos valores de opção especificados no campo discovery_source na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres

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 37. Cabeçalhos da solicitação

Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 38. 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 39. 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.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
405	Método inválido. A funcionalidade está desabilitada.
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)

Tabela 40. Parâmetros de resposta

Nome	Descrição
atributos	Atributos de dados atualmente no registro de IC. Os atributos disponíveis dependem do especificado CMDB classe. Você pode localizar os atributos disponíveis no associado CMDB tabela que normalmente começa com "cmdb_ci", como cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Tipo de dados: Objeto
erro	Informações sobre todos os erros encontrados ao processar a solicitação de endpoint. Tipo de dados: Objeto "error": { "detail": "String", "message": "String" }
error.detail	Informações adicionais sobre o erro. Tipo de dados: Cadeia de caracteres
mensagem.erro	Mensagem que identifica o erro. Tipo de dados: Cadeia de caracteres
inbound_relations	Lista de objetos que definem as relações de entrada associadas ao IC. Tipo de dados: Matriz "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
inbound_relations.sys_id	Sys_id do relacionamento de IC de entrada. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target	Informações que descrevem a relação de entrada de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.target.display_value	Nome da relação de entrada a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de entrada da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target.value	Sys_id do IC de entrada. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.type	Informações sobre o tipo de relacionamento de entrada. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.type.display_value	Nome do tipo de entrada a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar o tipo de relação de entrada da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
inbound_relations.type.value	Sys_id do tipo de relacionamento de entrada. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations	Lista de objetos que definem as relações de saída associadas ao IC. Tipo de dados: Matriz "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
outbound_relations.sys_id	Sys_id do relacionamento de IC de saída. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target	Obrigatório. Informações sobre a relação de saída de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.target.display_value	Nome da relação de saída a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target.value	Sys_id do IC de saída. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.type	Informações sobre o tipo de relacionamento de saída. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.type.display_value	Nome do tipo de saída a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations.type.value	Sys_id do tipo de relacionamento de saída. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
status	Aparece somente se um erro for encontrado. Status do processamento do endpoint. Valor possível: Falha Tipo de dados: Cadeia de caracteres

Solicitação de cURL de amostra

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci_linux_server/3a290cc60a0a0bb400000bdb386af1cf/relation" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json"\
--user "username":"password" \
--data {
  "outbound_relations": [
    {
      "type" : "1a9cb166f1571100a92eb60da2bce5c5",
      "target" : "3a307c930a0a0bb400353965d0b8861f"
    },
    {
      "type" : "607ad1b2c0a8010e01941856b365af90",
      "target" : "3a307c930a0a0bb400353965d0b8861f"
    }
  ],
  "source": "ServiceNow",
  "inbound_relations": [
    {
      "type" : "1a9cb166f1571100a92eb60da2bce5c5",
      "target" : "3a27d4370a0a0bb4006316812bf45439"
    }
  ]
}

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "403ff2641b425010593876a61a4bcb4b",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
                    "value": "1a9cb166f1571100a92eb60da2bce5c5"
                },
                "target": {
                    "display_value": "PS ORA01",
                    "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
                    "value": "3a307c930a0a0bb400353965d0b8861f"
                }
            },
            {
                "sys_id": "443ff2641b425010593876a61a4bcb4c",
                "type": {
                    "display_value": "Exchanges data with::Exchanges data with",
                    "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90",
                    "value": "607ad1b2c0a8010e01941856b365af90"
                },
                "target": {
                    "display_value": "PS ORA01",
                    "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
                    "value": "3a307c930a0a0bb400353965d0b8861f"
                }
            }
        ],
        "attributes": {
            "firewall_status": "Active",
            "os_address_width": "",
            "attested_date": "",
            "operational_status": "1",
            "os_service_pack": "",
            "cpu_core_thread": "",
            "cpu_manufacturer": "",
            "sys_updated_on": "2020-07-13 21:24:05",
            "discovery_source": "ServiceNow",
            "first_discovered": "2020-07-13 20:27:28",
            "due_in": "",
            "used_for": "Production",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "dora.gray",
            "warranty_expiration": "",
            "ram": "",
            "cpu_name": "",
            "cpu_speed": "",
            "owned_by": "",
            "checked_out": "",
            "kernel_release": "",
            "sys_domain_path": "/",
            "classification": "Production",
            "disk_space": "",
            "object_id": "",
            "maintenance_schedule": "",
            "cost_center": "",
            "attested_by": "",
            "dns_domain": "",
            "assigned": "",
            "purchase_date": "",
            "life_cycle_stage": "",
            "short_description": "",
            "cd_speed": "",
            "floppy": "",
            "managed_by": "",
            "os_domain": "",
            "last_discovered": "2020-07-13 21:24:05",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_linux_server",
            "manufacturer": "",
            "cpu_count": "",
            "vendor": "",
            "life_cycle_stage_status": "",
            "model_number": "",
            "assigned_to": "",
            "start_date": "",
            "os_version": "",
            "serial_number": "",
            "cd_rom": "false",
            "support_group": "",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "asset": {
                "display_value": "Unknown",
                "link": "https://instance.servicenow.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52",
                "value": "21cfba641b425010593876a61a4bcb52"
            },
            "form_factor": "",
            "cpu_core_count": "",
            "skip_sync": "false",
            "attestation_score": "",
            "sys_updated_by": "dora.gray",
            "sys_created_on": "2020-07-13 20:27:28",
            "sys_domain": {
                "display_value": "global",
                "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "cpu_type": "",
            "install_date": "",
            "asset_tag": "",
            "dr_backup": "",
            "hardware_substatus": "",
            "fqdn": "",
            "change_control": "",
            "internet_facing": "true",
            "delivery_date": "",
            "hardware_status": "installed",
            "install_status": "1",
            "supported_by": "",
            "name": "Linux299",
            "subcategory": "Computer",
            "default_gateway": "",
            "chassis_type": "",
            "virtual": "false",
            "assignment_group": "",
            "managed_by_group": "",
            "sys_id": "0c3ff2641b425010593876a61a4bcb39",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!2/!(/!!/!0",
            "mac_address": "",
            "company": "",
            "justification": "",
            "department": "",
            "cost": "",
            "comments": "",
            "os": "",
            "sys_mod_count": "4",
            "monitor": "false",
            "model_id": {
                "display_value": "Unknown",
                "link": "https://instance.servicenow.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6",
                "value": "0ce0a2681b4e1010593876a61a4bcba6"
            },
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "location": "",
            "category": "Hardware",
            "fault_count": "0",
            "host_name": "",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "c03ff2641b425010593876a61a4bcb49",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
                    "value": "1a9cb166f1571100a92eb60da2bce5c5"
                },
                "target": {
                    "display_value": "PS Apache01",
                    "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439",
                    "value": "3a27d4370a0a0bb4006316812bf45439"
                }
            }
        ]
    }
}

CMDB Instância - PATCH /now/cmdb/instance/

Substitui os atributos no registro de item de configuração (IC) especificado pelos pares nome-valor especificados. Este endpoint não cria, atualiza ou exclui as relações associadas.

Formato de URL

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

URL padrão: /api/now/cmdb/instance/

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 41. Parâmetros de caminho

Nome	Descrição
nomeClasse	CMDB nome da classe. Este é o nome da tabela que contém os registros de IC desejados, como cmdb_ci_linux_server ou cmdb_ci_apache_web_server. Tipo de dados: Cadeia de caracteres
sys_id	Sys_id do registro de IC a ser atualizado. Tipo de dados: Cadeia de caracteres

Tabela 42. Parâmetros de consulta

Nome	Descrição
Nenhum(a)

Tabela 43. Solicitar parâmetros do corpo (XML ou JSON)

Nome	Descrição
atributos	Atributos de dados a serem substituídos no registro de IC. Os atributos disponíveis dependem do especificado CMDB classe. Você pode localizar os atributos disponíveis no associado CMDB tabela que normalmente começa com "cmdb_ci", como cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Para obter informações sobre certificação, consulte CIs attestation. Tipo de dados: Objeto
origem	Obrigatório. Entidade que atualizou as informações. Este deve ser um dos valores de opção especificados no campo discovery_source na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres

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 44. Cabeçalhos da solicitação

Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json
Tipo de conteúdo	Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 45. 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 46. 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.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
405	Método inválido. A funcionalidade está desabilitada.
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)

Tabela 47. Parâmetros de resposta

Nome	Descrição
atributos	Atributos de dados atualmente no registro de IC. Os atributos disponíveis dependem do especificado CMDB classe. Você pode localizar os atributos disponíveis no associado CMDB tabela que normalmente começa com "cmdb_ci", como cmdb_ci_linux_server ou cmdb_ci_mfp_printer. Tipo de dados: Objeto
erro	Informações sobre todos os erros encontrados ao processar a solicitação de endpoint. Tipo de dados: Objeto "error": { "detail": "String", "message": "String" }
error.detail	Informações adicionais sobre o erro. Tipo de dados: Cadeia de caracteres
mensagem.erro	Mensagem que identifica o erro. Tipo de dados: Cadeia de caracteres
inbound_relations	Lista de objetos que definem as relações de entrada associadas ao IC. Tipo de dados: Matriz "inbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
inbound_relations.sys_id	Sys_id do relacionamento de IC de entrada. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target	Informações que descrevem a relação de entrada de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.target.display_value	Nome da relação de entrada a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de entrada da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.target.value	Sys_id do IC de entrada. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
inbound_relations.type	Informações sobre o tipo de relacionamento de entrada. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
inbound_relations.type.display_value	Nome do tipo de entrada a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
inbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar o tipo de relação de entrada da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
inbound_relations.type.value	Sys_id do tipo de relacionamento de entrada. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations	Lista de objetos que definem as relações de saída associadas ao IC. Tipo de dados: Matriz "outbound_relations": [ { "sys_id": "String", "target": {Object}, "type": {Object} } ]
outbound_relations.sys_id	Sys_id do relacionamento de IC de saída. Localizado na tabela Relacionamento de IC [cmdb_rel_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target	Obrigatório. Informações sobre a relação de saída de destino. Tipo de dados: Objeto "target": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.target.display_value	Nome da relação de saída a ser exibida em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.target.link	CMDB URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.target.value	Sys_id do IC de saída. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: Cadeia de caracteres
outbound_relations.type	Informações sobre o tipo de relacionamento de saída. Tipo de dados: Objeto "type": { "display_value": "String", "link": "String", "value": "String" }
outbound_relations.type.display_value	Nome do tipo de saída a ser exibido em uma interface do usuário. Tipo de dados: Cadeia de caracteres
outbound_relations.type.link	Tabela URL do endpoint REST a ser usado para recuperar a relação de saída da tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
outbound_relations.type.value	Sys_id do tipo de relacionamento de saída. Localizado na tabela Tipo de relacionamento de IC [cmdb_rel_type]. Tipo de dados: Cadeia de caracteres
status	Aparece somente se um erro for encontrado. Status do processamento do endpoint. Valor possível: Falha Tipo de dados: Cadeia de caracteres

Solicitação de cURL de amostra

curl "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_class_sw/70bc4e11c0a8210d01f074cbe6bd73b4" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json"\
--user "username":"password"\
--data {
    "attributes": {
      "firewall_status": "Active",
      "name": "Linux299",
      "used_for": "Production"
    },
    "source": "ServiceNow"
}

{
  "result": {
    "outbound_relations": [
      {
        "sys_id": "403ff2641b425010593876a61a4bcb4b",
        "type": {
          "display_value": "Depends on::Used by",
          "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
          "value": "1a9cb166f1571100a92eb60da2bce5c5"
        },
        "target": {
          "display_value": "PS ORA01",
          "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
          "value": "3a307c930a0a0bb400353965d0b8861f"
        }
      },
      {
        "sys_id": "443ff2641b425010593876a61a4bcb4c",
        "type": {
          "display_value": "Exchanges data with::Exchanges data with",
          "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/607ad1b2c0a8010e01941856b365af90",
          "value": "607ad1b2c0a8010e01941856b365af90"
        },
        "target": {
          "display_value": "PS ORA01",
          "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a307c930a0a0bb400353965d0b8861f",
          "value": "3a307c930a0a0bb400353965d0b8861f"
        }
      }
    ],
    "attributes": {
      "firewall_status": "Active",
      "os_address_width": "",
      "attested_date": "",
      "operational_status": "1",
      "os_service_pack": "",
      "cpu_core_thread": "",
      "cpu_manufacturer": "",
      "sys_updated_on": "2020-07-13 21:24:05",
      "discovery_source": "ServiceNow",
      "first_discovered": "2020-07-13 20:27:28",
      "due_in": "",
      "used_for": "Production",
      "invoice_number": "",
      "gl_account": "",
      "sys_created_by": "dora.gray",
      "warranty_expiration": "",
      "ram": "",
      "cpu_name": "",
      "cpu_speed": "",
      "owned_by": "",
      "checked_out": "",
      "kernel_release": "",
      "sys_domain_path": "/",
      "classification": "Production",
      "disk_space": "",
      "object_id": "",
      "maintenance_schedule": "",
      "cost_center": "",
      "attested_by": "",
      "dns_domain": "",
      "assigned": "",
      "purchase_date": "",
      "life_cycle_stage": "",
      "short_description": "",
      "cd_speed": "",
      "floppy": "",
      "managed_by": "",
      "os_domain": "",
      "last_discovered": "2020-07-13 21:24:05",
      "can_print": "false",
      "sys_class_name": "cmdb_ci_linux_server",
      "manufacturer": "",
      "cpu_count": "",
      "vendor": "",
      "life_cycle_stage_status": "",
      "model_number": "",
      "assigned_to": "",
      "start_date": "",
      "os_version": "",
      "serial_number": "",
      "cd_rom": "false",
      "support_group": "",
      "unverified": "false",
      "correlation_id": "",
      "attributes": "",
      "asset": {
        "display_value": "Unknown",
        "link": "https://instance.servicenow.com/api/now/table/alm_asset/21cfba641b425010593876a61a4bcb52",
        "value": "21cfba641b425010593876a61a4bcb52"
      },
      "form_factor": "",
      "cpu_core_count": "",
      "skip_sync": "false",
      "attestation_score": "",
      "sys_updated_by": "dora.gray",
      "sys_created_on": "2020-07-13 20:27:28",
      "sys_domain": {
        "display_value": "global",
        "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
        "value": "global"
      },
      "cpu_type": "",
      "install_date": "",
      "asset_tag": "",
      "dr_backup": "",
      "hardware_substatus": "",
      "fqdn": "",
      "change_control": "",
      "internet_facing": "true",
      "delivery_date": "",
      "hardware_status": "installed",
      "install_status": "1",
      "supported_by": "",
      "name": "Linux299",
      "subcategory": "Computer",
      "default_gateway": "",
      "chassis_type": "",
      "virtual": "false",
      "assignment_group": "",
      "managed_by_group": "",
      "sys_id": "0c3ff2641b425010593876a61a4bcb39",
      "po_number": "",
      "checked_in": "",
      "sys_class_path": "/!!/!2/!(/!!/!0",
      "mac_address": "",
      "company": "",
      "justification": "",
      "department": "",
      "cost": "",
      "comments": "",
      "os": "",
      "sys_mod_count": "4",
      "monitor": "false",
      "model_id": {
        "display_value": "Unknown",
        "link": "https://instance.servicenow.com/api/now/table/cmdb_model/0ce0a2681b4e1010593876a61a4bcba6",
        "value": "0ce0a2681b4e1010593876a61a4bcba6"
      },
      "ip_address": "",
      "duplicate_of": "",
      "sys_tags": "",
      "cost_cc": "USD",
      "order_date": "",
      "schedule": "",
      "environment": "",
      "due": "",
      "attested": "false",
      "location": "",
      "category": "Hardware",
      "fault_count": "0",
      "host_name": "",
      "lease_id": ""
    },
    "inbound_relations": [
      {
        "sys_id": "c03ff2641b425010593876a61a4bcb49",
         "type": {
           "display_value": "Depends on::Used by",
            "link": "https://instance.servicenow.com/api/now/table/cmdb_rel_type/1a9cb166f1571100a92eb60da2bce5c5",
            "value": "1a9cb166f1571100a92eb60da2bce5c5"
          },
          "target": {
            "display_value": "PS Apache01",
            "link": "https://instance.servicenow.com/api/now/cmdb/instance/cmdb_ci/3a27d4370a0a0bb4006316812bf45439",
            "value": "3a27d4370a0a0bb4006316812bf45439"
          }
        }
      ]
    }
}