CdmApplicationsApi

CdmApplicationsApi - DELETE /sn_cdm/applications/deployables

Exclui um implantável especificado do Configuration Data Management (CDM).

O solicitante deste endpoint deve ter a função de Administrador do CDM.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/deployables

URL padrão: /api/sn_cdm/applications/deployables

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 acessada. 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 2. Parâmetros de consulta
Nome	Descrição
appName	Obrigatório. Nome da aplicação de CDM à qual o implantável está associado. Localizado na tabela Implantável do CDM [sn_cdm_deployable]. Tipo de dados: cadeia de caracteres
nome	Nome do implantável a ser excluído. Localizado na tabela Implantável do CDM [sn_cdm_deployable]. Tipo de dados: cadeia de caracteres

Tabela 3. Parâmetros do corpo da solicitação
Nome	Descrição
Nenhum

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

Códigos de status

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

Tabela 6. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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


Nome	Descrição
Nenhum

Solicitação de cURL

O exemplo de código a seguir mostra como remover um implantável.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables?appName=testApp&name=Dep-1" \ 
--request DELETE \ 
--header "Accept:application/json" \ 
--user 'username':'password1'

Para uma exclusão bem-sucedida do implantável, nenhuma resposta é retornada além do código de status HTTP.

None - results defined by the HTTP status code

CdmApplicationsApi - DELETE /sn_cdm/applications/shared_components

Remove a referência de uso do componente compartilhado de uma aplicação Configuration Data Management (CDM) especificada.

A função de Administrador do CDM é necessária para acessar este endpoint.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/shared_components

URL padrão: /api/sn_cdm/applications/shared_components

Parâmetros de solicitação compatíveis

Tabela 7. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 8. Parâmetros de consulta
Nome	Descrição
appName	Obrigatório. Nome da aplicação da qual a associação de componente compartilhado especificada será removida. Localizado na tabela Aplicação do CDM [sn_cdm_application]. A aplicação especificada deve ter o campo de tipo definido como "shared_library". Tipo de dados: cadeia de caracteres
changesetNumber	Obrigatório. Identificador exclusivo do changeset associado, como "Chset-10". Localizado na tabela CDMChangeset [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres
sharedComponentName	Obrigatório. Nome exclusivo do componente compartilhado a ser removido da aplicação especificada. Localizado na tabela Componente compartilhado do CDM [sn_cdm_shared_component]. Tipo de dados: cadeia de caracteres

Tabela 9. Parâmetros do corpo da solicitação
Nome	Descrição
Nenhum

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/json ou application/xml. Padrão: application/json

Tabela 11. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 12. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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


Nome	Descrição
resultado	Vazio. O código de status HTTP indica o resultado da chamada.
Erro	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo de código a seguir mostra como excluir o componente compartilhado "paymentService-V1.1" da aplicação "App1".

curl "https://instance-name.service-now.com/api/sn_cdm/applications/shared_components?appName=App1&sharedComponentName=paymentService-V1.1&changesetNumber=Chset-25" \ 
--request DELETE \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Resposta:

""

CdmApplicationsApi - GET /sn_cdm/applications/deployables/exports/{export_id}/content

Retorna o conteúdo associado a uma solicitação de exportação de dados de configuração especificada.

Chame este endpoint somente depois de receber uma resposta completa do endpoint CdmApplicationsApi - GET /sn_cdm/applications/deployables/exports/{export_id}/status. Se você chamar este endpoint antes da conclusão da exportação, será retornado um erro de status 400.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/deployables/exports/{export_id}/content

URL padrão: /api/sn_cdm/applications/deployables/exports/{export_id}/content

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 acessada. 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
export_id	Identificador exclusivo da solicitação de exportação cujos dados de configuração serão retornados. Este valor é retornado pelo endpoint CdmApplicationsApi - POST /sn_cdm/applications/deployables/exports.

Tabela 14. Parâmetros de consulta
Nome	Descrição
Nenhum

Tabela 15. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Nenhum

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.

Tabela 17. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 18. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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
erros	Descrição dos erros encontrados durante a exportação. Tipo de dados: cadeia de caracteres
export_id	ID da solicitação de exportação. Igual ao passado para o endpoint. Tipo de dados: cadeia de caracteres
resultado_exportador	Conteúdo da exportação de dados de configuração especificada. Tipo de dados: Objeto JSON: se a solicitação fosse para exportar dados no formato JSON. Cadeia de caracteres: se a solicitação foi para exportar dados em qualquer outro formato.
request_id	ID da solicitação de exportação. Igual ao passado para o endpoint. Tipo de dados: cadeia de caracteres
state	Estado atual da exportação especificada. Valor da coluna de estado na tabela Fila de solicitações do CDM [sn_cdm_request_queue]. Valores possíveis: concluída Erro em_andamento new pronto Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir solicita os dados de configuração de uma solicitação de exportação com o ID 3ab14a7d53b1301096edddeeff7b12f.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables/exports/3ab14a7d53b1301096edddeeff7b12f/content" \ 
--request GET \ 
--header "Accept:application/json" \
--user 'username':'password'

Veja a seguir os resultados de retorno possíveis.

// Successful completion of the export request
{ 
  "result": { 
    "export_id": "3ab14a7d53b1301096edddeeff7b12f" 
    "exporter_result": "DEP1.COMP.cdi_1=cdi-1-value" 
  } 
}

// Response when an incorrect export_id is passed. Note: Status code is 200.
{ 
  "result": { 
    "request_id": "3ab14a7d53b1301096edddeeff7b12e", 
    "state": "error", 
    "errors": "Invalid requestId '3ab14a7d53b1301096edddeeff7b12fe'", 
    "export_id": "3ab14a7d53b1301096edddeeff7b12e" 
  } 
}

CdmApplicationsApi - GET /sn_cdm/applications/deployables/exports/{export_id}/status

Retorna o status atual da solicitação de exportação de dados de configuração especificada.

Use o endpoint CdmApplicationsApi - POST /sn_cdm/applications/deployables/exports para fazer uma solicitação de exportação.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/deployables/exports/{export_id}/status

URL padrão: /api/sn_cdm/applications/deployables/exports/{export_id}/status

Parâmetros de solicitação compatíveis

Tabela 19. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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
export_id	Sys_id da solicitação de exportação cujo status será retornado. Este valor é retornado pelo endpoint CdmApplicationsApi - POST /sn_cdm/applications/deployables/exports.

Tabela 20. Parâmetros de consulta
Nome	Descrição
Nenhum

Tabela 21. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Nenhum

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.

Tabela 23. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 24. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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
erros	Descrição dos erros encontrados durante a exportação. Tipo de dados: cadeia de caracteres
export_id	ID da solicitação de exportação. Igual ao passado para o endpoint. Tipo de dados: cadeia de caracteres
resultado_exportador	Detalhes sobre o erro associado. Tipo de dados: objeto
resultado_exportador.erros	Descrição dos erros encontrados durante a exportação. Tipo de dados: matriz
resultado_exportador.execução_id	Identificador exclusivo do registro de execução do exportador. Localizado na tabela sn_cdm_exporter_execution. Tipo de dados: cadeia de caracteres
resultado_exportador.estado	Estado atual da exportação especificada. Localizado na tabela sn_cdm_exporter_execution. Valores possíveis: concluir Erro em_andamento new Tipo de dados: cadeia de caracteres
request_id	ID da solicitação de exportação. Igual ao passado para o endpoint. Tipo de dados: cadeia de caracteres
state	Estado atual da exportação especificada. Valor da coluna de estado na tabela Fila de solicitações do CDM [sn_cdm_request_queue]. Valores possíveis: concluída Erro em_andamento new pronto Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir solicita o status de uma exportação com o ID 3ab14a7d53b1301096edddeeff7b12f.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables/exports/3ab14a7d53b1301096edddeeff7b12f/status" \ 
--request GET \ 
--header "Accept:application/json" \
--user 'username':'password'

A seguir estão os resultados de retorno possíveis.

// Successful completion of the export request
{ 
  "result": { 
    "state": "completed", 
    "export_id": "3ab14a7d53b1301096edddeeff7b12f0" 
  } 
}

// Response when an incorrect export_id is passed. Note: Status code is 200.
{ 
  "result": { 
    "request_id": "3ac8e1b05311301096edddeeff7b123c", 
    "state": "error", 
    "errors": "Invalid requestId '3ac8e1b05311301096edddeeff7b123c'", 
    "export_id": "3ac8e1b05311301096edddeeff7b123c" 
  } 
} 

// Response when the export encounters an error. The exporter_result array contains the error information. Note: Status code is 200.
{ 
  "result": { 
    "state": "completed", 
    "export_id": "24536c3353f9301096edddeeff7b12b1", 
    "exporter_result": { 
      "execution_id": "81536c3353f9301096edddeeff7b129e", 
      "state": "failure", 
      "errors": [ 
        "Snapshot 'SNA-001-published-non_compliant' has not passed validation. All snapshots of deployable '/ApplicationA/deployables/DEP3' are required to pass validation" 
      ] 
    } 
  } 
}

CdmApplicationsApi - GET /sn_cdm/applications/shared_components

Retorna a lista de componentes compartilhados usados por uma aplicação especificada. Você também pode especificar para retornar somente os componentes compartilhados que têm uma nova versão disponível.

A função de Administrador do CDM é necessária para acessar este endpoint.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/shared_components

URL padrão: /api/sn_cdm/applications/shared_components

Parâmetros de solicitação compatíveis

Tabela 25. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 26. Parâmetros de consulta
Nome	Descrição
appName	Obrigatório. Nome da aplicação cuja lista de componentes compartilhados você deseja retornar. Localizado na tabela Aplicação do CDM [sn_cdm_application]. O campo de tipo da aplicação deve ser definido como shared_library. Tipo de dados: cadeia de caracteres
withUpdatesOnly	Sinalizador que indica se somente componentes compartilhados que tenham uma nova versão atualizada disponível devem ser retornados. Valores válidos: verdadeiro: retorna somente componentes compartilhados que tenham uma nova versão atualizada disponível. falso: retorna todos os componentes compartilhados usados pela aplicação especificada. Padrão: falso

Tabela 27. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Nenhum

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 28. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json

Tabela 29. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 30. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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


Nome	Descrição
currentVersion	Versão atual da aplicação do CDM. Tipo de dados: inteiro
currentVersionName	Nome da versão do componente compartilhado atualmente em uso. Tipo de dados: cadeia de caracteres
description	Descrição do componente compartilhado. Tipo de dados: cadeia de caracteres
Erro	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
nome	Nome exclusivo do componente compartilhado. Tipo de dados: cadeia de caracteres
sharedLibraryName	Nome da biblioteca compartilhada à qual o componente compartilhado pertence. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
atualizarVersionName	Nome da versão do componente compartilhado disponível para atualização. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo de código a seguir mostra como chamar este endpoint para recuperar os componentes compartilhados que têm uma nova versão usada por "App1".

curl "https://instance-name.service-now.com/api/sn_cdm/applications/shared_components?updatesOnly=true&appName=App1" \ 
--request GET \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Resposta:

{ 
  "result": [
    {
      "name": "Component_Name",
      "description": "”,
      "sharedLibraryName": "Shared Library",
      "currentVersion": "2",
      "currentVersionName": "Component_A-v2.shc",
      "updateVersionName": "Component_A-v3.shc"
    } 
  ]
}

CdmApplicationsApi - GET /sn_cdm/applications/shared_libraries/components/applications

Retorna um mapa de componentes compartilhados e as aplicações que os usam que estão em uma biblioteca especificada.

A função de Administrador do CDM é necessária para acessar este endpoint.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/shared_libraries/components/applications

URL padrão: /api/sn_cdm/applications/shared_libraries/components/applications

Parâmetros de solicitação compatíveis

Tabela 31. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 32. Parâmetros de consulta
Nome	Descrição
sharedComponentName	Obrigatório. Nome do componente compartilhado a ser incluído no mapa. Localizado na tabela Componente compartilhado do CDM [sn_cdm_shared_component]. Tipo de dados: cadeia de caracteres
sharedLibraryName	Obrigatório. Nome da biblioteca compartilhada a ser incluída no mapa. Localizado na tabela Aplicação do CDM [sn_cdm_application]. A aplicação especificada deve ter o campo de tipo definido como "shared_library". Tipo de dados: cadeia de caracteres

Tabela 33. Parâmetros do corpo da solicitação
Nome	Descrição
Nenhum

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 34. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json

Tabela 35. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 36. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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


Nome	Descrição
description	Descrição da aplicação que usa o componente compartilhado Tipo de dados: cadeia de caracteres
Erro	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
managed_by_group	Lista separada por vírgulas de sys_ids dos grupos que podem gerenciar a aplicação. Tipo de dados: cadeia de caracteres
nome	Nome exclusivo da aplicação que usa o componente. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
sys_id	Sys_id da aplicação que utiliza o componente compartilhado. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo de código a seguir mostra como chamar este endpoint para recuperar o mapa que mostra as aplicações na biblioteca compartilhada "OracleG-Library-10" que usa o componente compartilhado "paymentService-V1.1".

curl "https://instance-name.service-now.com/api/sn_cdm/applications/shared_libraries/components/applications?sharedLibraryName=OracleG-Library-10&sharedComponentName=paymentService-V1.1" \ 
--request GET \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Resposta:

{
  "result": {
    "component_name": [
      { 
        "name": "App Name",
        "description": "desc",
        "managed_by_group": null,
        "sys_id": "4e7808bb1b371110636e0fe0604bcb08"
      }, 
      {
        "name": "Config App",
        "description": "desc",
        "managed_by_group": null,
        "sys_id": "55a75cfb1b771110636e0fe0604bcb5c"
      },
      {
        "name": "Database App",
        "description": "desc",
        "managed_by_group": null,
        "sys_id": "2eb7503f1b771110636e0fe0604bcb06"
      }
    ]
  } 
}

CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}

Retorna o status atual da solicitação de upload de dados de configuração especificada.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/upload-status/{upload_id}

URL padrão: /api/sn_cdm/applications/upload-status/{upload_id}

Parâmetros de solicitação compatíveis

Tabela 37. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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
upload_id	Sys_id da solicitação de upload cujo status será retornado. Este valor é retornado pelos vários endpoints de solicitação de upload de CdmApplications.

Tabela 38. Parâmetros de consulta
Nome	Descrição
Nenhum

Tabela 39. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Nenhum

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 40. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Oferece suporte somente a application/json.

Tabela 41. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 42. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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
erros	Descrição dos erros encontrados durante o upload. Tipo de dados: cadeia de caracteres
saída	Descrição dos dados carregados ou, se ocorreu um erro durante o upload, uma mensagem de erro descrevendo o erro encontrado. Tipo de dados: matriz de cadeia de caracteres `"output": { "auto_validate": "String", "cdm_application": "String", "committed_at": "String", "committed_by": "String", "description": "String", "last_conflict_detection_time": "String", "number": "String", "publish_option": "String", "snapshot_description": "String", "snapshot_name": "String", "state": "String", "sys_created_by": "String", "sys_id": "String", "title": "String" }`
saída.auto_validate	Indica se a validação deve ser invocada após a confirmação. Tipo de dados: cadeia de caracteres
saída.cdm_application	Nome da aplicação na qual o upload foi realizado. Tipo de dados: cadeia de caracteres
output.committed_at	Data e hora em que o conteúdo carregado foi confirmado. Tipo de dados: cadeia de caracteres
saída.confirmado_por	Sys_id do registro da entidade que realizou a confirmação. Tipo de dados: cadeia de caracteres
output.description	Não usado no momento. Tipo de dados: cadeia de caracteres
output.last_conflict_detection_time	Invocação de detecção de conflito de data e hora. Tipo de dados: cadeia de caracteres
número.saída	Número exclusivo do changeset. Tipo de dados: cadeia de caracteres
saída.publicar_opção	Opção de publicação para os snapshots configurados associados. Valores válidos: publicar_none: não publicar snapshots. publicar_valid: publique somente os snapshots aprovados na validação após a confirmação. Para obter informações adicionais sobre como publicar snapshots, consulte Publicar ou cancelar a publicação de um snapshot. Tipo de dados: cadeia de caracteres Padrão: publicar_none Nota: Esta opção só estará disponível se o valor do parâmetro autoCommit for verdadeiro.
output.snapshot_description	Descrição do snapshot associado. Tipo de dados: cadeia de caracteres
saída.snapshot_name	Nome do snapshot associado. Tipo de dados: cadeia de caracteres
estado.saída	Estado do conteúdo de carregamento. Valores possíveis: bloqueado verificação_para_conflito confirm_failed confirmação_em_progresso confirmado em aberto Tipo de dados: cadeia de caracteres
saída.sys_created_by	Sys_id da entidade que criou o registro. Tipo de dados: cadeia de caracteres
output.sys_id	Sys_id do registro que contém o changeset. Tipo de dados: cadeia de caracteres
saída.título	Título do changeset criado como parte do upload. Tipo de dados: cadeia de caracteres
processando_estado	Estado de processamento atual da solicitação de upload. Valores possíveis: NÃO_PROCESSADO PROCESSADO Tipo de dados: cadeia de caracteres
state	Estado atual da solicitação de upload. Valores possíveis: concluída Erro em_andamento new pronto
tipo	Tipo de solicitação de upload. Valores possíveis: confirmar exportar upload_and_commit Tipo de dados: cadeia de caracteres
upload_id	Sys_id da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir mostra a solicitação do status de um upload com o ID 5560a6895326301096edddeeff7b1230.

curl "http://instance.servicenow.com/api/sn_cdm/applications/upload-status/5560a6895326301096edddeeff7b1230" \ 
--request GET \ 
--header "Accept:application/json" \
--user 'username':'password'

A seguir estão os resultados de retorno possíveis.

// Successful completion of the upload request
{ 
  "result": { 
    "type": "upload_and_commit", 
    "state": "completed", 
    "output": { 
      "sys_id": "be681dc95362301096edddeeff7b12ba", 
      "number": "Chset-102", 
      "title": "admin2021-09-10 08:09:07", 
      "description": null, 
      "committed_at": "2021-09-10 20:23:37", 
      "committed_by": "6816f79cc0a8016401c5a33be04be441", 
      "sys_created_by": "admin", 
      "state": "committed", 
      "publish_option": "publish_none", 
      "auto_validate": false, 
      "snapshot_name": null, 
      "snapshot_description": null, 
      "cdm_application": "Demo_App1631126164773", 
      "last_conflict_detection_time": "1631305417894" 
    }, 
    "processing_state": "PROCESSED", 
    "upload_id": "5560a6895326301096edddeeff7b1230"
  } 
}

// Response when an incorrect upload_id is passed. Note: Status code is 200.
{ 
  "result": { 
    "state": "error", 
    "errors": "Invalid requestId '5560a6895326301096edddeeff7b1240'", 
    "upload_id": "5560a6895326301096edddeeff7b1240" 
  } 
} 

// Response when the upload encounters an error. The exporter_result array contains the error information. Note: Status code is 200.
{ 
  "result": { 
    "type": "upload_and_commit", 
    "state": "error", 
    "output": "Error encountered during execution of request.\nError: Node 'dbSettings' of type 'sg_cdm_node_component' cannot create child 'dbSettings' of type 'sg_cdm_node_folder'", 
    "processing_state": "PROCESSED", 
    "upload_id": "272f8a415326301096edddeeff7b1232" 
  } 
}

CdmApplicationsApi - POST /sn_cdm/applications/deployables

Cria um novo implantável e o conecta automaticamente a uma aplicação Configuration Data Management (CDM) especificada.

Você pode criar um implantável para qualquer um dos três tipos de ambiente: Desenvolvimento, Teste ou Produção.

Para acessar este endpoint, o solicitante deve ter a função de Administrador do CDM.

Se você precisar criar vários implantáveis, use o endpoint CdmApplicationsApi - POST /sn_cdm/applications/deployables/create.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/deployables

URL padrão: /api/sn_cdm/applications/deployables

Parâmetros de solicitação compatíveis

Tabela 43. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 44. Parâmetros de consulta
Nome	Descrição
appName	Obrigatório. Nome de uma aplicação de CDM ativa existente a ser associada ao implantável. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
envType	Obrigatório. Tipo de ambiente para o implantável. Valores válidos (diferencia maiúsculas de minúsculas): Desenvolvimento Produção Teste Nota: O tipo de ambiente implantável não pode ser alterado após a criação. Tipo de dados: cadeia de caracteres
nome	Obrigatório. Nome do implantável do CDM. Não deve ter mais de 255 caracteres. Os caracteres padrão permitidos são 0-9, AZ, az, _,-,., %, $, espaço em branco, :, #. Tipo de dados: cadeia de caracteres Tamanho máximo: 255 caracteres Caracteres permitidos: 0-9, AZ, az, _, -, ., %, $, espaço em branco, : e #
returnFields	Lista de campos a serem retornados como parte da resposta. Passe os nomes da coluna de registro, como sys_id, sys_updated_by ou state. Tipo de dados: matriz Padrão: todos os campos conforme determinado pelo endpoint

Tabela 45. Parâmetros do corpo da solicitação
Nome	Descrição
Nenhum

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 46. 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 47. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 48. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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


Nome	Descrição
cdi_count	Número de itens de dados de configuração (CDIs) contidos na aplicação de CDM associada. Tipo de dados: inteiro
cdi_usage	Percentual dos CDIs usados pelo implantável. Tipo de dados: inteiro
cdm_app	Objeto de aplicação do CDM associado ao implantável. Tipo de dados: objeto `"cdm_app": { "link": "String", "value": "String" }`
cdm_app.link	Chamada para usar para acessar o registro da aplicação do CDM usando a REST Table API. Tipo de dados: cadeia de caracteres
cdm_app.valor	Sys_id do registro da aplicação do CDM associado. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
cdm_ci	Objeto de serviço de aplicações associado ao implantável. Tipo de dados: objeto `"cdm_ci": { "link": "String", "value": "String" }`
cdm_ci.link	Chamada para usar para acessar o registro de serviço de aplicativos usando a REST Table API. Tipo de dados: cadeia de caracteres
cdm_ci.valor	Sys_id do registro de serviço de aplicativos associado. Localizado na tabela Item de configuração [cmdb_ci]. Tipo de dados: cadeia de caracteres
description	Descrição do implantável do CDM gerado. Tipo de dados: cadeia de caracteres
enviroment_type	Tipo de ambiente do implantável. Valores possíveis: Desenvolvimento Produção Teste Tipo de dados: cadeia de caracteres
Erro	Retornado somente se ocorrer um erro durante o processamento. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
nome	Nome do implantável do CDM. Tipo de dados: cadeia de caracteres
node	Detalhes sobre o nó implantável. Tipo de dados: objeto `"node": { "link": "String", "value": "String" }`
nó.link	Chamada para usar para acessar o registro de nó implantável usando a REST Table API. Tipo de dados: cadeia de caracteres
nó.valor	Sys_id do registro do nó implantável. Localizado na tabela Implantável do CDM [sn_cdm_deployable]. Tipo de dados: cadeia de caracteres
snapshot_version_counter	Número de snapshots criados para o implantável. Tipo de dados: inteiro
state	Estado atual do implantável. Valores possíveis: ativo excluído Tipo de dados: cadeia de caracteres
sys_created_by	Nome de usuário do usuário que criou o implantável do CDM. Por exemplo, enable.tuter. Tipo de dados: cadeia de caracteres
sys_created_on	Data e hora em que o implantável do CDM foi criado. Formato: AAAA-mm-DD hh:mm:ss Tipo de dados: cadeia de caracteres
sys_id	Sys_id do implantável criado. Localizado na tabela Implantável do CDM [sn_cdm_deployable]. Tipo de dados: cadeia de caracteres
sys_updated_by	Nome do usuário que atualizou pela última vez o implantável do CDM. Por exemplo, enable.tuter. Tipo de dados: cadeia de caracteres
sys_updated_on	Data e hora da última atualização do implantável do CDM. Formato: AAAA-mm-DD hh:mm:ss Tipo de dados: cadeia de caracteres

Solicitação cURL

O exemplo de código a seguir mostra como criar e associar um implantável a uma aplicação de CDM.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables?name=Dep-1&returnFields=name%2Csys_id%2Cstate&appName=testApp&envType=Test" \ 
--request POST \ 
--header "Accept:application/json" \ 
--user 'username':'password1'

Retornar resultados:

{ 
  "result": [ 
    { 
      "cmdb_ci": { 
        "value": "f5b9e00b53901110a1d3ddeeff7b12b8", 
        "link": "http://192.168.0.233:8080/api/now/table/cmdb_ci_service_auto/f5b9e00b53901110a1d3ddeeff7b12b8" 
      }, 
      "cdi_count": "0", 
      "snapshot_version_counter": "0", 
      "description": null, 
      "sys_updated_on": "2022-06-29 12:53:57", 
      "environment_type": "Test", 
      "node": { 
        "value": "7db9e00b53901110a1d3ddeeff7b12b6", 
        "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_node/7db9e00b53901110a1d3ddeeff7b12b6" 
      }, 
      "sys_id": "39b9e00b53901110a1d3ddeeff7b12b7", 
      "sys_updated_by": "admin", 
      "cdm_app": { 
        "value": "62b517a953b70110a1d3ddeeff7b128c", 
        "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
      }, 
      "sys_created_on": "2022-06-29 12:53:57", 
      "cdi_usage": "0", 
      "name": "Dep-2", 
      "state": "active", 
      "sys_created_by": "admin" 
    } 
  ] 
}

CdmApplicationsApi - POST /sn_cdm/applications/deployables/create

Cria um ou mais implantáveis novos.

Você pode criar um dos dois tipos de implantáveis:

Implantáveis que devem ser conectados manualmente a um modelo de aplicação (serviço de IC).
Implantáveis que são conectados automaticamente a novos modelos de aplicação (serviços de IC) criados dinamicamente.

Você pode criar um implantável para qualquer um dos três tipos de ambiente: Desenvolvimento, Teste ou Produção. Ao criar vários implantáveis, os nomes gerados automaticamente dos implantáveis seguem o padrão: DeployableType_Number, em que Número é um número de sequência em execução com base na criação de um novo implantável. Por exemplo, se você criar três implantáveis do tipo Teste em uma chamada de endpoint, eles serão chamados de Test_1, Test_2 e Test_3. Se você chamar o endpoint novamente e criar um implantável de Teste diferente, o nome gerado automaticamente será Test_4. Esses números nunca são reutilizados, mesmo se um implantável for excluído.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/deployables/create

URL padrão: /api/sn_cdm/applications/deployables/create

Parâmetros de solicitação compatíveis

Tabela 49. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 50. Parâmetros de consulta
Nome	Descrição
appSysId	Obrigatório. Sys_id de uma aplicação de CDM ativa a ser associada aos implantáveis. Tipo de dados: cadeia de caracteres
conexão automática	Obrigatório. Sinalizador que determina se os implantáveis recém-criados devem ser conectados automaticamente aos modelos de aplicação gerados dinamicamente. Valores válidos: verdadeiro: conecte os implantáveis recém-criados aos modelos de aplicação gerados dinamicamente. false: basta criar os implantáveis. Esses implantáveis devem ser mapeados manualmente para Modelos de aplicação usando a IU. Tipo de dados: booliano
envType	Obrigatório. Tipo de ambiente para o implantável. Valores válidos (diferencia maiúsculas de minúsculas): Desenvolvimento Produção Teste Nota: O tipo de ambiente implantável não pode ser alterado após a criação. Tipo de dados: cadeia de caracteres
quantidade	Obrigatório. Número de implantáveis a serem criados. Tipo de dados: número

Tabela 51. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Nenhum

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 52. 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 53. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 54. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
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


Nome	Descrição
Erro	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
resultado	Sys_ids dos implantáveis criados. Tipo de dados: matriz
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir mostra como criar um único implantável e associá-lo a uma aplicação de CDM existente.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables/create?envType=Production&appSysId=5e118055b712011054c1e5a6ce11a9d4&quantity=5&autoConnect=true" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:application/json" \
--user 'username':'password'

A seguir, são mostradas as possíveis respostas para esta chamada, como sucesso e erro.

// Successful completion of the upload request
{
  "result": [
    "8ba43a3db7d6011054c1e5a6ce11a9a4",
    "93a47a3db7d6011054c1e5a6ce11a90d",
    "dba47a3db7d6011054c1e5a6ce11a91d",
    "6fa47a3db7d6011054c1e5a6ce11a921",
    "efa47a3db7d6011054c1e5a6ce11a925"
  ]
} 

// Error response
{
  "error": {
    "message": "Error: CDM Application with SysID 5e118055b712011054c1e5a6ce11a9d1 was not found. (sys_script_include.8cf0fbf453626010a1d3ddeeff7b12fe.script; line 211)",
    "detail": ""
  },
  "status": "failure"
}

CdmApplicationsApi - POST /sn_cdm/applications/deployables/exports

Envia uma solicitação para exportar o snapshot atual de uma aplicação especificada e um ou mais implantáveis para a tabela Cache do exportador do CDM [sn_cdm_exporter_cache].

Este endpoint retorna um identificador exclusivo para a solicitação, que você usa para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/deployables/exports/{export_id}/status para recuperar o status da exportação. Quando a exportação estiver concluída, você poderá usar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/deployables/exports/{export_id}/content para recuperar os dados de configuração da aplicação associados.

Um snapshot é o modelo de dados completo de um implantável no momento em que uma mudança de configuração é confirmada. Isso inclui todos os componentes, coleções e variáveis incluídos, bem como variáveis e substituições específicas do implantável. Para obter informações adicionais sobre implantáveis, consulte Criar e atualizar um implantável.

Nota:

Os snapshots não podem exceder 10.000 itens de dados de configuração (CDIs) por implantável ou 100.000 CDIs por aplicação.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/deployables/exports

URL padrão: /api/sn_cdm/applications/deployables/exports

Parâmetros de solicitação compatíveis

Tabela 55. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 56. Parâmetros de consulta
Nome	Descrição
adicionaisImplantáveis	Não primários implantáveis para exportar. Tipo de dados: matriz de objetos `"additionalDeployables": [ { "app_name": "String", "deployable_name": "String" } ]` Por exemplo: `[{'app_name':'TestApp', "deployable_name:'DEP-1'}]` Padrão: matriz vazia - []
adicionaisImplantáveis.app_name	Obrigatório se a matriz additionalDeployables for especificada. Nome da aplicação associada ao implantável cujos dados de configuração você deseja exportar. Tipo de dados: cadeia de caracteres
adicionaisImplantáveis.deployable_name	Obrigatório se a matriz additionalDeployables for especificada. Nome do implantável não primário cujos dados de configuração você deseja exportar. Tipo de dados: cadeia de caracteres
appName	Obrigatório. Nome da aplicação cujos dados de configuração você deseja exportar. Tipo de dados: cadeia de caracteres
args	Um objeto JSON que contém pares de chave-valor para argumentos personalizados. Tipo de dados: objeto
dataFormat	Formato de saída dos dados exportados. Valores válidos (diferencia maiúsculas de minúsculas): ini json propriedades bruto (os dados são retornados no formato de cadeia de caracteres) xml yaml Tipo de dados: cadeia de caracteres Padrão: json
implantávelNome	Obrigatório. Nome do implantável cujos dados de configuração você deseja exportar. Tipo de dados: cadeia de caracteres
exportName	Obrigatório. Nome do exportador a ser usado para exportar os dados do snapshot. Os exportadores são personalizados para o implementador. Para obter detalhes sobre como criar um exportador personalizado, consulte Criação de um exportador personalizado. Tipo de dados: cadeia de caracteres
restringirExportar	Sinalizador que indica se o endpoint valida snapshots ao exportar os dados. Valores válidos: verdadeiro: validar snapshots. falso: não valide snapshots. Tipo de dados: booliano Padrão: falso
snapshotName	Nome do snapshot a ser exportado. Este só pode ser um dos nomes de snapshot associados ao implantável, conforme especificado em deployableName ou additionalDeployables.deployable_name. Padrão: o endpoint exporta o snapshot publicado mais recente. Se não houver um snapshot publicado, o sistema emitirá o erro "Falha ao encontrar o snapshot publicado mais recente do implantável '{0}'"

Tabela 57. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Nenhum

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 58. 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 59. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 60. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada. Possíveis mensagens de erro: Erro: parâmetro obrigatório "appName" ausente Erro: o usuário não tem a permissão necessária para criar uma solicitação de exportação Erro: valor booliano inválido (<xyz> ).
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


Nome	Descrição
Erro	Detalhes sobre o erro ocorrido. `"error": { "detail": "String", "message": "String" }` Tipo de dados: matriz
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
export_id	Identificador exclusivo da solicitação de exportação. Use este ID ao chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/deployables/exports/{export_id}/status para verificar o status atual da solicitação de exportação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir solicita a exportação dos dados de configuração para o seguinte: nome da aplicação = TestAppA, nome do implantável = DEP, usando o exportador = exporter-1-primary_deployable.

curl "http://instance.servicenow.com/api/sn_cdm/applications/deployables/exports?appName=TestAppA&args=%7B%22arg_A_required%22%20%3A%20%22value%20A%22%7D&exporterName=exporter-1-primary_deployable&deployableName=DEP1" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:application/json" \
--user 'username':'password'

Retorna o identificador exclusivo da solicitação de exportação.

{ 
  "result": {
    "export_id": "64b5f79f5379301096edddeeff7b12eb" 
  } 
}

CdmApplicationsApi - POST /sn_cdm/applications/shared_components

Associa o componente compartilhado especificado à aplicação em um conjunto de mudanças especificado.

A função de Administrador do CDM é necessária para acessar este endpoint.

Nota:

O componente compartilhado especificado deve ter uma versão publicada associada (snapshot).

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/shared_components

URL padrão: /api/sn_cdm/applications/shared_components

Parâmetros de solicitação compatíveis

Tabela 61. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 62. Parâmetros de consulta
Nome	Descrição
appName	Obrigatório. Nome da aplicação a ser associado ao componente compartilhado. Tipo de dados: cadeia de caracteres
changesetNumber	Obrigatório. Identificador exclusivo do changeset associado ao componente. Tipo de dados: cadeia de caracteres
returnFields	Lista de campos a serem retornados como parte da resposta. Passe os nomes da coluna de registro, como sys_id, sys_updated_by ou state. Tipo de dados: matriz Padrão: todos os campos conforme determinado pelo endpoint
sharedComponentName	Obrigatório. Nome do componente compartilhado a ser associado à aplicação especificada. Localizado na tabela Componente compartilhado do CDM [sn_cdm_shared_component]. Tipo de dados: cadeia de caracteres
sharedLibraryName	Obrigatório. Nome da biblioteca compartilhada na qual o componente será criado. Localizado na tabela Aplicação do CDM [sn_cdm_application]. A biblioteca compartilhada deve ter os seguintes campos definidos da seguinte forma: estado = ativo disponível = verdadeiro tipo = shared_library Tipo de dados: cadeia de caracteres

Tabela 63. Parâmetros do corpo da solicitação
Nome	Descrição
Nenhum

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 64. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json

Tabela 65. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 66. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. O changeset aprovado não existe.
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

Os campos de resposta dependem de quais campos foram especificados no parâmetro returnFields na solicitação. A seguir, descrevemos alguns dos campos mais importantes.


Nome	Descrição
changeset_id	Detalhes do registro do changeset associado ao nó. Tipo de dados: objeto `"changeset_id": { "link": "String", "value": "String" }`
changeset_id.link	Sintaxe de chamada para consultar este registro de conjunto de mudanças usando a REST API da tabela. Tipo de dados: cadeia de caracteres
changeset_id.value	Identificador exclusivo do registro do changeset. Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres
description	Descrição do nó do CDM. Tipo de dados: cadeia de caracteres
Erro	Retornado somente se ocorrer um erro durante o processamento. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Detalhes sobre o erro ocorrido. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem que fornece uma visão geral do erro. Tipo de dados: cadeia de caracteres
vinculado_a	ID do nó principal associado ao componente compartilhado. Tipo de dados: cadeia de caracteres
vinculado_para_versão	Detalhes do registro de snapshot do CDM associado ao nó. Tipo de dados: objeto `"linked_to_version": { "link": "String", "value": "String" }`
link_para_versão.link	Sintaxe de chamada para consultar este registro de versão usando a REST API da tabela. Tipo de dados: cadeia de caracteres
link_to_version.value	Sys_id do registro da versão. Tipo de dados: cadeia de caracteres
principal	Sinalizador que indica se o snapshot associado foi publicado. Valores válidos: verdadeiro: o snapshot foi publicado. false: o snapshot não foi publicado.
main_id	ID exclusivo do nó principal recém-criado. Tipo de dados: cadeia de caracteres
main_id_encoded	ID codificado do nó principal recém-criado. Tipo de dados: cadeia de caracteres
nome	Nome do nó do CDM. Tipo de dados: cadeia de caracteres
node	Sys_id do nó do componente compartilhado. Tipo de dados: cadeia de caracteres
nó_path	Caminho para o novo nó vinculado criado ao adicionar o componente compartilhado. Tipo de dados: cadeia de caracteres
status	Status do nó. Valores possíveis: Novo Tipo de dados: cadeia de caracteres
sys_created_by	Nome do usuário que cria o nó do CDM. Por exemplo, enable.tuter. Tipo de dados: cadeia de caracteres
sys_created_on	Data e hora em que o nó do CDM foi criado. Formato: AAAA-mm-DD hh:mm:ss Tipo de dados: cadeia de caracteres
sys_id	Sys_id do nó. Localizado na tabela Nó do CDM [sn_cdm_node]. Tipo de dados: cadeia de caracteres
sys_updated_by	Nome do usuário que atualizou o nó do CDM pela última vez. Por exemplo, enable.tuter. Tipo de dados: cadeia de caracteres
sys_updated_on	Data e hora da última atualização do nó do CDM. Formato: AAAA-mm-DD hh:mm:ss Tipo de dados: cadeia de caracteres
tipo	Tipo de nó. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir mostra como chamar este endpoint para associar a aplicação "App1" ao componente compartilhado "paymentService-V1.1" na biblioteca compartilhada "OracleG-Library-10" no changeset "Chset-20".

curl "https://instance.servicenow.com/api/sn_cdm/applications/shared_components?appName=App1&changesetNumber=Chset-20&sharedLibraryName=OracleG-Library-10&sharedComponentName=paymentService-V1.1" \ 
--request POST \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Resposta:

{ 
  "result": { 
    "changeset_id": { 
      "value": "74b7ff6fc33711100c257e2cc840dd6b", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_changeset/74b7ff6fc33711100c257e2cc840dd6b" 
    }, 
    "node_path": "!,0!,1!/D", 
    "description": null, 
    "sys_updated_on": "2022-12-22 17:07:29", 
    "type": "sn_cdm_node_linked_shared_component", 
    "sys_class_name": "sn_cdm_node", 
    "sys_id": "ff8b37ebc3b711100c257e2cc840ddba", 
    "sys_updated_by": "admin", 
    "previous_version": null, 
    "sys_created_on": "2022-12-22 17:07:29", 
    "value": null, 
    "effective_from": null, 
    "linked_to": "210", 
    "sys_created_by": "admin", 
    "restricted_to": null, 
    "linked_to_version": { 
      "value": "581fc3e9c3b311100c257e2cc840dd17", 
      "link": "http://instance.servicenow.com/api/now/table/sn_cdm_snapshot/581fc3e9c3b311100c257e2cc840dd17" 
    }, 
    "level": "2", 
    "conflict_type": null, 
    "main_id": "483",
    "effective_to": null,
    "secure_value": null, 
    "node_classifier": "/application/components", 
    "main_id_encoded": "/D",
    "name": "LIB2_C",
    "position": null,
    "reason_for_conflict": null,
    "system_folder": false,
    "status": "new",
    "conflict": false
  } 
}

CdmApplicationsApi - POST /sn_cdm/applications/uploads/components

Envia uma solicitação para carregar os dados de configuração passados para um componente específico, na pasta de componentes do sistema, para a aplicação especificada.

Este endpoint retorna o ID da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload.

Nota:

O tamanho máximo do conteúdo de carregamento padrão é de 2 MB. Você pode modificar este padrão atualizando a propriedade sn_cdm.max_allowed_upload_file_size.

A imagem a seguir mostra um exemplo de onde os dados de configuração do componente são carregados em referência à IU ServiceNow Configuração de DevOps. Supõe que o componente seja dbComponent e a aplicação sejapaymentSvc.

Exemplo de local de conteúdo de configuração na IU

Nota:

Este método de upload não pode ser usado para modificar nós. Use o método CdmApplicationsApi - POST sn_cdm/applications/uploads/components/file alternativo para modificar nós.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/uploads/components

URL padrão: /api/sn_cdm/applications/uploads/components

Parâmetros de solicitação compatíveis

Tabela 67. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 68. Parâmetros de consulta
Nome	Descrição
appName	Nome da aplicação a ser associada aos dados de configuração. Esta aplicação deve estar no estado ativo. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
confirmação automática	Sinalizador que indica se o changeset identificado no parâmetro changesetNumber foi confirmado para o modelo de dados após o upload. Valores válidos: verdadeiro: o changeset é confirmado após o upload. false: o changeset não é confirmado após o upload. Tipo de dados: booliano Padrão: falso
autoDelete	Sinalizador que indica se os nós existentes, que não fazem parte do conteúdo de upload, são excluídos após a conclusão do processamento. Valores válidos: verdadeiro: exclua automaticamente os nós existentes. falso: não exclua automaticamente os nós existentes. Tipo de dados: booliano Padrão: falso
autoValidate	Sinalizador que indica se os snapshots criados quando confirmados são validados. Valores válidos: verdadeiro: valida os snapshots. falso: não valide os snapshots. Nota: Esta opção só estará disponível se o parâmetro autoCommit for `verdadeiro`. Tipo de dados: booliano Padrão: falso
changesetNumber	Cadeia de caracteres que identifica exclusivamente o changeset associado à aplicação, como Chset-102. Este changeset deve estar no estado "Aberto". Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres Padrão: cria um conjunto de mudanças a ser usado. Os detalhes do changeset são retornados como parte dos resultados CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}.
dataFormat	Obrigatório. Formato dos dados de configuração. Valores válidos: csv ini json propriedades bruto xml yaml Tipo de dados: cadeia de caracteres
dataFormatAttributes	Compatível somente quando o parâmetro dataFormat é definido como `csv`. Atributos que definem o formato de dados CSV. Para obter informações adicionais, confira . Tipo de dados: objeto `"dataFormatAttributes" { "containsHeader": Boolean, "delimeter": "String" "headers": [Array], "securedHeaders": [Array] }`
dataFormatAttributes.containsHeaders	Sinalizador que indica se os dados contêm uma linha de cabeçalho. Valores válidos: verdadeiro: os dados contêm uma linha de cabeçalho. A primeira linha nos dados é considerada a linha de cabeçalho. falso: os dados não contêm uma linha de cabeçalho. Você deve passar as informações do cabeçalho no parâmetro dataFormatAttributes.headers. Tipo de dados: booliano Padrão: falso
dataFormatAttributes.delimeter	Caractere a ser usado para delinear campos nos dados. Tipo de dados: cadeia de caracteres Padrão: vírgula ","
dataFormatAttributes.headers	Obrigatório se o parâmetro dataFormatAttributes.containsHeaders for `falso`. Campos nos dados que compõem o cabeçalho. Esses cabeçalhos são convertidos nos nomes de chave dos CDIs no formato JSON. O número de cabeçalhos deve corresponder ao número de campos de registro. Tipo de dados: matriz Padrão: matriz vazia
dataFormatAttributes.securedHeaders	Campos nos dados que são campos seguros e devem ser criptografados nos dados carregados em CDM. O nome dos cabeçalhos protegidos deve corresponder ao nome dos cabeçalhos no atributo de cabeçalhos ou no arquivo de dados. Esses campos são armazenados em uma coluna do tipo Senha (criptografada bidirecionalmente). Nota: Você só pode proteger campos usando este atributo. Você não pode desproteger os campos protegidos. Tipo de dados: matriz Padrão: matriz vazia
deleteRedundantOverrides	Sinalizador que indica se uma substituição deve ser criada quando há valores redundantes. Valores válidos: verdadeiro: se houver valores redundantes, uma substituição não será criada. falso: se houver valores redundantes, prosseguirá com uma substituição. Padrão: verdadeiro
fileName	Nome do arquivo a ser carregado. Este nome pode ser diferente do nome real do arquivo e conter a extensão do arquivo. Por exemplo, .txt/.scv/.jar. O valor fileName é aplicado ao baixar o arquivo. Tipo de dados: cadeia de caracteres
fileNodeName	Nome do nó do arquivo. Este nome de arquivo é usado nos dados de configuração ao exportá-lo. Este nome não requer uma extensão de arquivo nem afeta o download. Tipo de dados: cadeia de caracteres
IdentifierKeys	Lista de nomes que indicam qual chave em uma matriz secundária usar para identificar o mesmo nó. Por exemplo, se você estiver carregando: `[ {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` no seguinte modelo existente: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"} ]` e você definir identifierKeys como `name`, ele produzirá a seguinte saída: `[ {"name" : "Karen, "city" : "Sydney"}, {"name" : "Allan, "city" : "Paris"} ]` Caso contrário, ele produzirá a seguinte saída: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"}, {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` Tipo de dados: matriz de cadeias de caracteres
ignoreAttributes	Sinalizador que indica se o formato de dados fornecido oferece suporte a atributos (atualmente somente XML). Valores válidos: verdadeiro: se o formato de dados fornecido oferecer suporte a atributos, todos os atributos nos dados de entrada serão ignorados durante o carregamento. falso: se o formato de dados fornecido oferecer suporte a atributos, todos os atributos nos dados de entrada serão incluídos no carregamento. Tipo de dados: booliano Padrão: falso
namePath	Caminho do nó de destino no qual os dados de configuração devem ser carregados. Este caminho é relativo aos componentes, à coleção ou à pasta implantável (dependendo do endpoint que está sendo chamado). Você pode passar o caminho do nome em qualquer um dos formatos a seguir. Por exemplo, para definir o caminho do nome do nó `testApp/deployables/Development1/cdi1`: Formato de barra invertida: testApp/deployables/Development1/cdi1 Nota: Se o nome do nó contiver uma barra invertida ("/"), você não poderá usar este formato. Caminho do nome de back-end com caracteres de substituição: testAppdeployablesDevelopment1cdi1 Matriz: ['testApp','deployables','Development1','cdi1'] Nota: Se o componente especificado não existir no caminho especificado, o sistema criará automaticamente o componente no caminho especificado e carregará os dados. Tipo de dados: cadeia de caracteres
sharedLibraryName	Obrigatório. Nome da biblioteca compartilhada onde o componente a ser excluído está localizado. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres

Tabela 69. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Dados de upload de variáveis	Dados de configuração a serem carregados. Pode ser qualquer dado no formato definido pelo parâmetro dataFormat dos parâmetros de consulta.

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 70. 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. Tipos compatíveis: text/plain e application/x-www-form-urlencoded. Padrão: text/plain

Tabela 71. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 72. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. A solicitação de upload foi rejeitada. Possíveis problemas: O tamanho da carga de configuração é maior que o máximo permitido - 2 MB por padrão. Os parâmetros obrigatórios estão ausentes na chamada.
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	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
upload_id	Sys_id da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir mostra uma solicitação de upload para a aplicação Demo_App1631126164773.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/components?namePath=%2FSettings%2FdbSettings&dataFormat=json&appName=Demo_App1631126164773&changesetNumber=Chset-8&autoCommit=false&publishOption=publish_none&autoValidate=false&autoDelete=true" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "{
  \"dbIPAddress\": \"10.10.10.110\",
  \"dbPort\": \"8080\",
  \"dbConnectionString\": \"admin:admin server1.xyz.com:8080 dbName_payments\",
  \"dbConnectionStringBackup\": \"admin:admin server2.xyz.com dbName_payments_backup\
"}" \ 
--user 'username':'password'

Os resultados de retorno a seguir mostram uma resposta bem-sucedida e uma de erro para esta solicitação.

// Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi - POST sn_cdm/applications/uploads/components/file

Carrega arquivos como parte do modelo de dados de configuração (CDM) para a pasta de componentes.

Use este método para carregar em um nó de arquivo de componentes.

Formato de URL

URL com controle de versões: POST /api/sn_cdm/{api_version}/applications/uploads/components/file

URL padrão: POST /api/sn_cdm/applications/uploads/components/file

Parâmetros de solicitação compatíveis

Tabela 73. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 74. Parâmetros de consulta
Nome	Descrição
appName	Nome da aplicação a ser associada aos dados de configuração. Esta aplicação deve estar no estado ativo. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
confirmação automática	Sinalizador que indica se o changeset identificado no parâmetro changesetNumber foi confirmado para o modelo de dados após o upload. Valores válidos: verdadeiro: o changeset é confirmado após o upload. false: o changeset não é confirmado após o upload. Tipo de dados: booliano Padrão: falso
autoValidate	Sinalizador que indica se os snapshots criados quando confirmados são validados. Valores válidos: verdadeiro: valida os snapshots. falso: não valide os snapshots. Nota: Esta opção só estará disponível se o parâmetro autoCommit for `verdadeiro`. Tipo de dados: booliano Padrão: falso
changesetNumber	Cadeia de caracteres que identifica exclusivamente o changeset associado à aplicação, como Chset-102. Este changeset deve estar no estado "Aberto". Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres Padrão: cria um conjunto de mudanças a ser usado. Os detalhes do changeset são retornados como parte dos resultados CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}.
fileName	Nome do arquivo a ser carregado. Este nome pode ser diferente do nome real do arquivo e conter a extensão do arquivo. Por exemplo, .txt/.scv/.jar. O valor fileName é aplicado ao baixar o arquivo. Tipo de dados: cadeia de caracteres
fileNodeName	Nome do nó do arquivo. Este nome de arquivo é usado nos dados de configuração ao exportá-lo. Este nome não requer uma extensão de arquivo nem afeta o download. Tipo de dados: cadeia de caracteres
namePath	Caminho do nó de destino no qual os dados de configuração devem ser carregados. Este caminho é relativo aos componentes, à coleção ou à pasta implantável (dependendo do endpoint que está sendo chamado). Você pode passar o caminho do nome em qualquer um dos formatos a seguir. Por exemplo, para definir o caminho do nome do nó `testApp/deployables/Development1/cdi1`: Formato de barra invertida: testApp/deployables/Development1/cdi1 Nota: Se o nome do nó contiver uma barra invertida ("/"), você não poderá usar este formato. Caminho do nome de back-end com caracteres de substituição: testAppdeployablesDevelopment1cdi1 Matriz: ['testApp','deployables','Development1','cdi1'] Nota: Se o componente especificado não existir no caminho especificado, o sistema criará automaticamente o componente no caminho especificado e carregará os dados. Tipo de dados: cadeia de caracteres
publicarOpção	Opção de publicação para os snapshots configurados associados. Valores válidos: publicar_none: não publicar snapshots. publicar_valid: publique somente os snapshots aprovados na validação após a confirmação. Para obter informações adicionais sobre como publicar snapshots, consulte Publicar ou cancelar a publicação de um snapshot. Tipo de dados: cadeia de caracteres Padrão: publicar_none Nota: Esta opção só estará disponível se o valor do parâmetro autoCommit for verdadeiro.

Tabela 75. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Dados de upload de variáveis	Dados de configuração a serem carregados. Por padrão, os carregamentos de tamanho de arquivo são limitados a 5 MB. Para obter informações sobre como ajustar os tamanhos e o tipo de arquivo de carregamento, consulte este Now Support artigo. Tipo de dados: cadeia de caracteres/fluxo

Cabeçalhos

Tabela 76. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json
Tipo de conteúdo	Tipo de dados do arquivo a ser carregado. Tipos compatíveis: application/zip, text/plain, application/json. Padrão: application/json

Tabela 77. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 78. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. A solicitação de upload foi rejeitada. Possíveis problemas: O tamanho da carga de configuração é maior que o máximo permitido - 2 MB por padrão. Os parâmetros obrigatórios estão ausentes na chamada.
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	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
upload_id	Sys_id da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir mostra como carregar um conteúdo em um arquivo de texto.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/components/file?autoValidate=true&appName=testApp&namePath=testComponent%2FfilesFolder&fileName=testFileNodeName.txt&publishOption=publish_valid&changesetNumber=Chset-108&autoCommit=true&fileNodeName=testFile.txt" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "This is sample content that will be uploaded to a plain text file."\ 
--user 'username':'password'

Os resultados de retorno a seguir mostram uma resposta bem-sucedida e uma de erro para esta solicitação.

// Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Could not find active application with name: ‘testApp’ of type application", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi - POST /sn_cdm/applications/uploads/components/vars

Envia uma solicitação para carregar os dados de configuração passados na pasta de variáveis, na pasta de componentes do sistema, para a aplicação especificada.

A imagem a seguir mostra um exemplo de onde os dados de configuração de variáveis do componente são carregados em referência à IU do espaço ServiceNow Configuração de DevOps. Supõe que a aplicação sejapaymentSvc.

Carregar diretório de variáveis

Nota:

O tamanho máximo do conteúdo de carregamento padrão é de 2 MB. Você pode modificar este padrão atualizando a propriedade sn_cdm.max_allowed_upload_file_size.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/uploads/components/vars

URL padrão: /api/sn_cdm/applications/uploads/components/vars

Parâmetros de solicitação compatíveis

Tabela 79. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 80. Parâmetros de consulta
Nome	Descrição
appName	Nome da aplicação a ser associada aos dados de configuração. Esta aplicação deve estar no estado ativo. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
confirmação automática	Sinalizador que indica se o changeset identificado no parâmetro changesetNumber foi confirmado para o modelo de dados após o upload. Valores válidos: verdadeiro: o changeset é confirmado após o upload. false: o changeset não é confirmado após o upload. Tipo de dados: booliano Padrão: falso
autoDelete	Sinalizador que indica se os nós existentes, que não fazem parte do conteúdo de upload, são excluídos após a conclusão do processamento. Valores válidos: verdadeiro: exclua automaticamente os nós existentes. falso: não exclua automaticamente os nós existentes. Tipo de dados: booliano Padrão: falso
autoValidate	Sinalizador que indica se os snapshots criados quando confirmados são validados. Valores válidos: verdadeiro: valida os snapshots. falso: não valide os snapshots. Nota: Esta opção só estará disponível se o parâmetro autoCommit for `verdadeiro`. Tipo de dados: booliano Padrão: falso
changesetNumber	Cadeia de caracteres que identifica exclusivamente o changeset associado à aplicação, como Chset-102. Este changeset deve estar no estado "Aberto". Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres Padrão: cria um conjunto de mudanças a ser usado. Os detalhes do changeset são retornados como parte dos resultados CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}.
dataFormat	Obrigatório. Formato dos dados de configuração. Valores válidos: ini json propriedades bruto xml yaml Tipo de dados: cadeia de caracteres
deleteRedundantOverrides	Sinalizador que indica se uma substituição deve ser criada quando há valores redundantes. Valores válidos: verdadeiro: se houver valores redundantes, uma substituição não será criada. falso: se houver valores redundantes, prosseguirá com uma substituição. Padrão: verdadeiro
fileName	Nome do arquivo a ser carregado. Este nome pode ser diferente do nome real do arquivo e conter a extensão do arquivo. Por exemplo, .txt/.scv/.jar. O valor fileName é aplicado ao baixar o arquivo. Tipo de dados: cadeia de caracteres
fileNodeName	Nome do nó do arquivo. Este nome de arquivo é usado nos dados de configuração ao exportá-lo. Este nome não requer uma extensão de arquivo nem afeta o download. Tipo de dados: cadeia de caracteres
IdentifierKeys	Lista de nomes que indicam qual chave em uma matriz secundária usar para identificar o mesmo nó. Por exemplo, se você estiver carregando: `[ {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` no seguinte modelo existente: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"} ]` e você definir identifierKeys como `name`, ele produzirá a seguinte saída: `[ {"name" : "Karen, "city" : "Sydney"}, {"name" : "Allan, "city" : "Paris"} ]` Caso contrário, ele produzirá a seguinte saída: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"}, {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` Tipo de dados: matriz de cadeias de caracteres
ignoreAttributes	Sinalizador que indica se o formato de dados fornecido oferece suporte a atributos (atualmente somente XML). Valores válidos: verdadeiro: se o formato de dados fornecido oferecer suporte a atributos, todos os atributos nos dados de entrada serão ignorados durante o carregamento. falso: se o formato de dados fornecido oferecer suporte a atributos, todos os atributos nos dados de entrada serão incluídos no carregamento. Tipo de dados: booliano Padrão: falso
namePath	Caminho do nó de destino no qual os dados de configuração devem ser carregados. Este caminho é relativo aos componentes, à coleção ou à pasta implantável (dependendo do endpoint que está sendo chamado). Você pode passar o caminho do nome em qualquer um dos formatos a seguir. Por exemplo, para definir o caminho do nome do nó `testApp/deployables/Development1/cdi1`: Formato de barra invertida: testApp/deployables/Development1/cdi1 Nota: Se o nome do nó contiver uma barra invertida ("/"), você não poderá usar este formato. Caminho do nome de back-end com caracteres de substituição: testAppdeployablesDevelopment1cdi1 Matriz: ['testApp','deployables','Development1','cdi1'] Nota: Se o componente especificado não existir no caminho especificado, o sistema criará automaticamente o componente no caminho especificado e carregará os dados. Tipo de dados: cadeia de caracteres
sharedLibraryName	Obrigatório. Nome da biblioteca compartilhada onde o componente a ser excluído está localizado. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres

Tabela 81. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Dados de upload de variáveis	Dados de configuração a serem carregados. Pode ser qualquer dado no formato definido pelo parâmetro dataFormat dos parâmetros de consulta.

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 82. 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. Tipos compatíveis: text/plain e application/x-www-form-urlencoded. Padrão: text/plain

Tabela 83. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 84. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. A solicitação de upload foi rejeitada. Possíveis problemas: O tamanho da carga de configuração é maior que o máximo permitido - 2 MB por padrão. Os parâmetros obrigatórios estão ausentes na chamada.
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	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
upload_id	Sys_id da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir mostra uma solicitação de carregamento de variáveis para a aplicação Demo_App1631126164773.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/components/vars?changesetNumber=Chset-102&autoValidate=false&autoDelete=true&publishOption=publish_none&appName=Demo_App1631126164773&namePath=%2FSettings%2FdbSettings&autoCommit=false&dataFormat=json" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "{ 
  \"dbSettings\": { 
    \"dbIPAddress\": \"10.10.10.110\", 
    \"dbPort\": \"8080\", 
    \"dbConnectionString\": \"username:password server1.xyz.com:8080 dbName_payments\", 
    \"dbConnectionStringBackup\": \"username:password server2.xyz.com dbName_payments_backup\"
  } 
}"
--user 'username':'password'

Os resultados de retorno a seguir mostram uma resposta bem-sucedida e uma de erro para esta solicitação.

// Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "d21f71f45322301096eccceaff7b1ce3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi - POST /sn_cdm/applications/uploads/collections

Envia uma solicitação para carregar os dados de configuração passados para uma coleção específica, na pasta de coleções do sistema, para a aplicação especificada.

Este endpoint retorna o ID da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload.

Nota:

O tamanho máximo do conteúdo de carregamento padrão é de 2 MB. Você pode modificar este padrão atualizando a propriedade sn_cdm.max_allowed_upload_file_size.

A imagem a seguir mostra um exemplo de onde os dados de configuração são carregados em referência à IU do espaço ServiceNow Configuração de DevOps. Supõe que a coleção seja db0Release1.0 e a aplicação sejapaymentSvc.

Pasta de carregamento de coleções

Nota:

Este método de upload não pode ser usado para modificar nós. Use o método alternativo CdmApplicationsApi - POST /sn_cdm/applications/uploads/collections/file para modificar os nós.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/uploads/collections

URL padrão: /api/sn_cdm/applications/uploads/collections

Parâmetros de solicitação compatíveis

Tabela 85. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 86. Parâmetros de consulta
Nome	Descrição
appName	Nome da aplicação a ser associada aos dados de configuração. Esta aplicação deve estar no estado ativo. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
confirmação automática	Sinalizador que indica se o changeset identificado no parâmetro changesetNumber foi confirmado para o modelo de dados após o upload. Valores válidos: verdadeiro: o changeset é confirmado após o upload. false: o changeset não é confirmado após o upload. Tipo de dados: booliano Padrão: falso
autoDelete	Sinalizador que indica se os nós existentes, que não fazem parte do conteúdo de upload, são excluídos após a conclusão do processamento. Valores válidos: verdadeiro: exclua automaticamente os nós existentes. falso: não exclua automaticamente os nós existentes. Tipo de dados: booliano Padrão: falso
autoValidate	Sinalizador que indica se os snapshots criados quando confirmados são validados. Valores válidos: verdadeiro: valida os snapshots. falso: não valide os snapshots. Nota: Esta opção só estará disponível se o parâmetro autoCommit for `verdadeiro`. Tipo de dados: booliano Padrão: falso
changesetNumber	Cadeia de caracteres que identifica exclusivamente o changeset associado à aplicação, como Chset-102. Este changeset deve estar no estado "Aberto". Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres Padrão: cria um conjunto de mudanças a ser usado. Os detalhes do changeset são retornados como parte dos resultados CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}.
collectionName	Obrigatório. Nome da coleção na qual armazenar a carga carregada. Nota: Se o namePath especificado não existir nesta coleção, o sistema criará automaticamente o(s) componente(s) nesta coleção e carregará o conteúdo de configuração. Por exemplo, se você quiser carregar a coleção `collA`, com o caminho `compA/comp/compC`, os dados serão carregados em `/collA/collections/compa/compB/compC`. Se `compA` existir, mas não `compB` e `compC`, o endpoint criará esses componentes e carregará os dados em `compC`. Tipo de dados: cadeia de caracteres
dataFormat	Obrigatório. Formato dos dados de configuração. Valores válidos: csv ini json propriedades bruto xml yaml Tipo de dados: cadeia de caracteres
dataFormatAttributes	Compatível somente quando o parâmetro dataFormat é definido como `csv`. Atributos que definem o formato de dados CSV. Para obter informações adicionais, confira . Tipo de dados: objeto `"dataFormatAttributes" { "containsHeader": Boolean, "delimeter": "String" "headers": [Array], "securedHeaders": [Array] }`
dataFormatAttributes.containsHeaders	Sinalizador que indica se os dados contêm uma linha de cabeçalho. Valores válidos: verdadeiro: os dados contêm uma linha de cabeçalho. A primeira linha nos dados é considerada a linha de cabeçalho. falso: os dados não contêm uma linha de cabeçalho. Você deve passar as informações do cabeçalho no parâmetro dataFormatAttributes.headers. Tipo de dados: booliano Padrão: falso
dataFormatAttributes.delimeter	Caractere a ser usado para delinear campos nos dados. Tipo de dados: cadeia de caracteres Padrão: vírgula ","
dataFormatAttributes.headers	Obrigatório se o parâmetro dataFormatAttributes.containsHeaders for `falso`. Campos nos dados que compõem o cabeçalho. Esses cabeçalhos são convertidos nos nomes de chave dos CDIs no formato JSON. O número de cabeçalhos deve corresponder ao número de campos de registro. Tipo de dados: matriz Padrão: matriz vazia
dataFormatAttributes.securedHeaders	Campos nos dados que são campos seguros e devem ser criptografados nos dados carregados em CDM. O nome dos cabeçalhos protegidos deve corresponder ao nome dos cabeçalhos no atributo de cabeçalhos ou no arquivo de dados. Esses campos são armazenados em uma coluna do tipo Senha (criptografada bidirecionalmente). Nota: Você só pode proteger campos usando este atributo. Você não pode desproteger os campos protegidos. Tipo de dados: matriz Padrão: matriz vazia
deleteRedundantOverrides	Sinalizador que indica se uma substituição deve ser criada quando há valores redundantes. Valores válidos: verdadeiro: se houver valores redundantes, uma substituição não será criada. falso: se houver valores redundantes, prosseguirá com uma substituição. Padrão: verdadeiro
ignoreAttributes	Sinalizador que indica se o formato de dados fornecido oferece suporte a atributos (atualmente somente XML). Valores válidos: verdadeiro: se o formato de dados fornecido oferecer suporte a atributos, todos os atributos nos dados de entrada serão ignorados durante o carregamento. falso: se o formato de dados fornecido oferecer suporte a atributos, todos os atributos nos dados de entrada serão incluídos no carregamento. Tipo de dados: booliano Padrão: falso
namePath	Caminho do nó de destino no qual os dados de configuração devem ser carregados. Este caminho é relativo aos componentes, à coleção ou à pasta implantável (dependendo do endpoint que está sendo chamado). Você pode passar o caminho do nome em qualquer um dos formatos a seguir. Por exemplo, para definir o caminho do nome do nó `testApp/deployables/Development1/cdi1`: Formato de barra invertida: testApp/deployables/Development1/cdi1 Nota: Se o nome do nó contiver uma barra invertida ("/"), você não poderá usar este formato. Caminho do nome de back-end com caracteres de substituição: testAppdeployablesDevelopment1cdi1 Matriz: ['testApp','deployables','Development1','cdi1'] Nota: Se o componente especificado não existir no caminho especificado, o sistema criará automaticamente o componente no caminho especificado e carregará os dados. Tipo de dados: cadeia de caracteres

Tabela 87. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Dados de upload de variáveis	Dados de configuração a serem carregados. Pode ser qualquer dado no formato definido pelo parâmetro dataFormat dos parâmetros de consulta.

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 88. 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. Tipos compatíveis: text/plain e application/x-www-form-urlencoded. Padrão: text/plain

Tabela 89. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 90. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. A solicitação de upload foi rejeitada. Possíveis problemas: O tamanho da carga de configuração é maior que o máximo permitido - 2 MB por padrão. Os parâmetros obrigatórios estão ausentes na chamada.
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	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
upload_id	Sys_id da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload. Tipo de dados: cadeia de caracteres

Solicitação de cURL

Este exemplo mostra como carregar a data de configuração dbSettings no formato JSON para a pasta de coleções da aplicação Demo_App1631126164773.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/collections?dataFormat=json&autoValidate=false&changesetNumber=Chset-102&appName=Demo_App1631126164773&autoDelete=true&namePath=%2FSettings%2FdbSettings&collectionName=release-1.0&autoCommit=false&publishOption=publish_none" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "{ 
  \"dbSettings\": { 
    \"dbIPAddress\": \"10.10.10.110\", 
    \"dbPort\": \"8080\", 
    \"dbConnectionString\": \"admin:admin server1.xyz.com:8080 dbName_payments\", 
    \"dbConnectionStringBackup\": \"admin:admin server2.xyz.com dbName_payments_backup\" 
  } 
}" \ 
--user 'username':'password'

A seguir, são mostradas as possíveis respostas para esta chamada, como sucesso e erro.

// Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi - POST /sn_cdm/applications/uploads/collections/file

Carrega um arquivo para a pasta de coleções no Configuration Data Model (CDM).

Formato de URL

URL com controle de versões: POST /api/sn_cdm/{api_version}/applications/uploads/collections/file

URL padrão: POST /api/sn_cdm/applications/uploads/collections/file

Parâmetros de solicitação compatíveis

Tabela 91. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 92. Parâmetros de consulta
Nome	Descrição
appName	Nome da aplicação a ser associada aos dados de configuração. Esta aplicação deve estar no estado ativo. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
confirmação automática	Sinalizador que indica se o changeset identificado no parâmetro changesetNumber foi confirmado para o modelo de dados após o upload. Valores válidos: verdadeiro: o changeset é confirmado após o upload. false: o changeset não é confirmado após o upload. Tipo de dados: booliano Padrão: falso
autoValidate	Sinalizador que indica se os snapshots criados quando confirmados são validados. Valores válidos: verdadeiro: valida os snapshots. falso: não valide os snapshots. Nota: Esta opção só estará disponível se o parâmetro autoCommit for `verdadeiro`. Tipo de dados: booliano Padrão: falso
collectionName	Obrigatório. Nome da coleção na qual armazenar a carga carregada. Nota: Se o `namePath` especificado não existir nesta coleção, o sistema criará automaticamente os componentes nesta coleção e carregará o conteúdo de configuração. Por exemplo, se você quiser carregar a coleção `collA`, com o caminho `compA/comp/compC`, os dados serão carregados em `/collA/collections/compa/compB/compC`. Se `compA` existir, mas não `compB` e `compC`, o endpoint criará esses componentes e carregará os dados em `compC`. Tipo de dados: cadeia de caracteres
changesetNumber	Cadeia de caracteres que identifica exclusivamente o changeset associado à aplicação, como Chset-102. Este changeset deve estar no estado "Aberto". Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres Padrão: cria um conjunto de mudanças a ser usado. Os detalhes do changeset são retornados como parte dos resultados CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}.
fileName	Nome do arquivo a ser carregado. Este nome pode ser diferente do nome real do arquivo e conter a extensão do arquivo. Por exemplo, .txt/.scv/.jar. O valor fileName é aplicado ao baixar o arquivo. Tipo de dados: cadeia de caracteres
fileNodeName	Nome do nó do arquivo. Este nome de arquivo é usado nos dados de configuração ao exportá-lo. Este nome não requer uma extensão de arquivo nem afeta o download. Tipo de dados: cadeia de caracteres
namePath	Caminho do nó de destino no qual os dados de configuração devem ser carregados. Este caminho é relativo aos componentes, à coleção ou à pasta implantável (dependendo do endpoint que está sendo chamado). Você pode passar o caminho do nome em qualquer um dos formatos a seguir. Por exemplo, para definir o caminho do nome do nó `testApp/deployables/Development1/cdi1`: Formato de barra invertida: testApp/deployables/Development1/cdi1 Nota: Se o nome do nó contiver uma barra invertida ("/"), você não poderá usar este formato. Caminho do nome de back-end com caracteres de substituição: testAppdeployablesDevelopment1cdi1 Matriz: ['testApp','deployables','Development1','cdi1'] Nota: Se o componente especificado não existir no caminho especificado, o sistema criará automaticamente o componente no caminho especificado e carregará os dados. Tipo de dados: cadeia de caracteres
publicarOpção	Opção de publicação para os snapshots configurados associados. Valores válidos: publicar_none: não publicar snapshots. publicar_valid: publique somente os snapshots aprovados na validação após a confirmação. Para obter informações adicionais sobre como publicar snapshots, consulte Publicar ou cancelar a publicação de um snapshot. Tipo de dados: cadeia de caracteres Padrão: publicar_none Nota: Esta opção só estará disponível se o valor do parâmetro autoCommit for verdadeiro.

Tabela 93. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Dados de upload de variáveis	Dados de configuração a serem carregados. Por padrão, os carregamentos de tamanho de arquivo são limitados a 5 MB. Para obter informações sobre como ajustar os tamanhos e o tipo de arquivo de carregamento, consulte este Now Support artigo. Tipo de dados: cadeia de caracteres/fluxo

Cabeçalhos

Tabela 94. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json
Tipo de conteúdo	Tipo de conteúdo do arquivo a ser carregado. Exemplos: aplicação/zip, texto/simples, aplicação/json.

Tabela 95. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 96. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. A solicitação de upload foi rejeitada. Possíveis problemas: O tamanho da carga de configuração é maior que o máximo permitido - 2 MB por padrão. Os parâmetros obrigatórios estão ausentes na chamada.
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	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
upload_id	Sys_id da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload. Tipo de dados: cadeia de caracteres

Solicitação de cURL

A chamada a seguir carrega um arquivo de texto sem formatação para a pasta de coleções do CDM.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/collections/file?autoValidate=true&collectionName=collA&appName=testApp&namePath=testComponent%2FfilesFolder&fileName=testFileNodeName.txt&publishOption=publish_valid&changesetNumber=Chset-108&autoCommit=true&fileNodeName=testFile.txt" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "This is sample content that will be uploaded to a plain text file."\ 
--user 'username':'password'

Os resultados de retorno a seguir mostram uma resposta bem-sucedida e uma de erro para esta solicitação.

// Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Could not find active application with name: ‘testApp’ of type application", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi - POST /sn_cdm/applications/uploads/deployables

Envia uma solicitação para carregar o conteúdo de configuração de um implantável específico na pasta do sistema de implantáveis de uma aplicação especificada.

Este endpoint retorna o ID da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload.

Nota:

O tamanho máximo do conteúdo de carregamento padrão é de 2 MB. Você pode modificar este padrão atualizando a propriedade sn_cdm.max_allowed_upload_file_size.

A imagem a seguir mostra um exemplo de onde os dados de configuração implantáveis são carregados em referência à IU ServiceNow Configuração de DevOps. Supõe que o implantável seja Development_1 e a aplicação sejapaymentSvc.

Local dos dados de configuração de implantáveis na IU

Nota:

Este método de upload não pode ser usado para modificar nós. Use o método alternativo CdmApplicationsApi - POST /sn_cdm/applications/uploads/deployables/file para modificar os nós.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/uploads/deployables

URL padrão: /api/sn_cdm/applications/uploads/deployables

Parâmetros de solicitação compatíveis

Tabela 97. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 98. Parâmetros de consulta
Nome	Descrição
appName	Nome da aplicação a ser associada aos dados de configuração. Esta aplicação deve estar no estado ativo. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
confirmação automática	Sinalizador que indica se o changeset identificado no parâmetro changesetNumber foi confirmado para o modelo de dados após o upload. Valores válidos: verdadeiro: o changeset é confirmado após o upload. false: o changeset não é confirmado após o upload. Tipo de dados: booliano Padrão: falso
autoDelete	Sinalizador que indica se os nós existentes, que não fazem parte do conteúdo de upload, são excluídos após a conclusão do processamento. Valores válidos: verdadeiro: exclua automaticamente os nós existentes. falso: não exclua automaticamente os nós existentes. Tipo de dados: booliano Padrão: falso
autoValidate	Sinalizador que indica se os snapshots criados quando confirmados são validados. Valores válidos: verdadeiro: valida os snapshots. falso: não valide os snapshots. Nota: Esta opção só estará disponível se o parâmetro autoCommit for `verdadeiro`. Tipo de dados: booliano Padrão: falso
changesetNumber	Cadeia de caracteres que identifica exclusivamente o changeset associado à aplicação, como Chset-102. Este changeset deve estar no estado "Aberto". Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres Padrão: cria um conjunto de mudanças a ser usado. Os detalhes do changeset são retornados como parte dos resultados CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}.
dataFormat	Obrigatório. Formato dos dados de configuração. Valores válidos: csv ini json propriedades bruto xml yaml Tipo de dados: cadeia de caracteres
dataFormatAttributes	Compatível somente quando o parâmetro dataFormat é definido como `csv`. Atributos que definem o formato de dados CSV. Para obter informações adicionais, confira . Tipo de dados: objeto `"dataFormatAttributes" { "containsHeader": Boolean, "delimeter": "String" "headers": [Array], "securedHeaders": [Array] }`
dataFormatAttributes.containsHeaders	Sinalizador que indica se os dados contêm uma linha de cabeçalho. Valores válidos: verdadeiro: os dados contêm uma linha de cabeçalho. A primeira linha nos dados é considerada a linha de cabeçalho. falso: os dados não contêm uma linha de cabeçalho. Você deve passar as informações do cabeçalho no parâmetro dataFormatAttributes.headers. Tipo de dados: booliano Padrão: falso
dataFormatAttributes.delimeter	Caractere a ser usado para delinear campos nos dados. Tipo de dados: cadeia de caracteres Padrão: vírgula ","
dataFormatAttributes.headers	Obrigatório se o parâmetro dataFormatAttributes.containsHeaders for `falso`. Campos nos dados que compõem o cabeçalho. Esses cabeçalhos são convertidos nos nomes de chave dos CDIs no formato JSON. O número de cabeçalhos deve corresponder ao número de campos de registro. Tipo de dados: matriz Padrão: matriz vazia
dataFormatAttributes.securedHeaders	Campos nos dados que são campos seguros e devem ser criptografados nos dados carregados em CDM. O nome dos cabeçalhos protegidos deve corresponder ao nome dos cabeçalhos no atributo de cabeçalhos ou no arquivo de dados. Esses campos são armazenados em uma coluna do tipo Senha (criptografada bidirecionalmente). Nota: Você só pode proteger campos usando este atributo. Você não pode desproteger os campos protegidos. Tipo de dados: matriz Padrão: matriz vazia
deleteRedundantOverrides	Sinalizador que indica se uma substituição deve ser criada quando há valores redundantes. Valores válidos: verdadeiro: se houver valores redundantes, uma substituição não será criada. falso: se houver valores redundantes, prosseguirá com uma substituição. Padrão: verdadeiro
implantávelNome	Obrigatório. Nome do implantável no qual a carga carregada será armazenada. Nota: Se o namePath especificado não existir neste implantável, o sistema criará automaticamente o(s) componente(s) neste implantável e carregará o conteúdo de configuração.
IdentifierKeys	Lista de nomes que indicam qual chave em uma matriz secundária usar para identificar o mesmo nó. Por exemplo, se você estiver carregando: `[ {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` no seguinte modelo existente: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"} ]` e você definir identifierKeys como `name`, ele produzirá a seguinte saída: `[ {"name" : "Karen, "city" : "Sydney"}, {"name" : "Allan, "city" : "Paris"} ]` Caso contrário, ele produzirá a seguinte saída: `[ {"name" : "Karen, "city" : "Manila"}, {"name" : "Allan, "city" : "Brussels"}, {"name" : "Allan, "city" : "Paris"}, {"name" : "Karen, "city" : "Sydney"} ]` Tipo de dados: matriz de cadeias de caracteres
ignoreAttributes	Sinalizador que indica se o formato de dados fornecido oferece suporte a atributos (atualmente somente XML). Valores válidos: verdadeiro: se o formato de dados fornecido oferecer suporte a atributos, todos os atributos nos dados de entrada serão ignorados durante o carregamento. falso: se o formato de dados fornecido oferecer suporte a atributos, todos os atributos nos dados de entrada serão incluídos no carregamento. Tipo de dados: booliano Padrão: falso
namePath	Caminho do nó de destino no qual os dados de configuração devem ser carregados. Este caminho é relativo aos componentes, à coleção ou à pasta implantável (dependendo do endpoint que está sendo chamado). Você pode passar o caminho do nome em qualquer um dos formatos a seguir. Por exemplo, para definir o caminho do nome do nó `testApp/deployables/Development1/cdi1`: Formato de barra invertida: testApp/deployables/Development1/cdi1 Nota: Se o nome do nó contiver uma barra invertida ("/"), você não poderá usar este formato. Caminho do nome de back-end com caracteres de substituição: testAppdeployablesDevelopment1cdi1 Matriz: ['testApp','deployables','Development1','cdi1'] Nota: Se o componente especificado não existir no caminho especificado, o sistema criará automaticamente o componente no caminho especificado e carregará os dados. Tipo de dados: cadeia de caracteres
publicarOpção	Opção de publicação para os snapshots configurados associados. Valores válidos: publicar_none: não publicar snapshots. publicar_valid: publique somente os snapshots aprovados na validação após a confirmação. Para obter informações adicionais sobre como publicar snapshots, consulte Publicar ou cancelar a publicação de um snapshot. Tipo de dados: cadeia de caracteres Padrão: publicar_none Nota: Esta opção só estará disponível se o valor do parâmetro autoCommit for verdadeiro.

Tabela 99. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Dados de upload de variáveis	Dados de configuração a serem carregados. Pode ser qualquer dado no formato definido pelo parâmetro dataFormat dos parâmetros de consulta.

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 100. 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. Tipos compatíveis: text/plain e application/x-www-form-urlencoded. Padrão: text/plain

Tabela 101. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 102. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. A solicitação de upload foi rejeitada. Possíveis problemas: O tamanho da carga de configuração é maior que o máximo permitido - 2 MB por padrão. Os parâmetros obrigatórios estão ausentes na chamada.
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	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
upload_id	Sys_id da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir mostra uma solicitação de upload para a aplicação Demo_App1631126164773.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/deployables?deployableName=TST-1&autoValidate=false&dataFormat=json&autoDelete=false&changesetNumber=Chset-102&appName=Demo_App1631126164773&publishOption=publish_none&autoCommit=true&namePath=%2FSettings%2FdbSettings" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "{
  \"dbIPAddress\": \"10.10.10.110\",
  \"dbPort\": \"8080\",
  \"dbConnectionString\": \"admin:admin server1.xyz.com:8080 dbName_payments\",
  \"dbConnectionStringBackup\": \"admin:admin server2.xyz.com dbName_payments_backup\"
}" \ 
--user 'username':'password'

Os resultados de retorno a seguir mostram uma resposta bem-sucedida e uma de erro para esta solicitação.

// Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Size of uploaded data:6853632.0(bytes) is greater than max allowed upload limit of 2097152.0(bytes)", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi - POST /sn_cdm/applications/uploads/deployables/file

Carrega arquivos para a pasta implantáveis no Configuration Data Model (CDM).

Formato de URL

URL com controle de versões: POST /api/sn_cdm/{api_version}/applications/uploads/deployables/file

URL padrão: POST /api/sn_cdm/applications/uploads/deployables/file

Parâmetros de solicitação compatíveis

Tabela 103. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 104. Parâmetros de consulta
Nome	Descrição
appName	Nome da aplicação a ser associada aos dados de configuração. Esta aplicação deve estar no estado ativo. Localizado na tabela Aplicação do CDM [sn_cdm_application]. Tipo de dados: cadeia de caracteres
confirmação automática	Sinalizador que indica se o changeset identificado no parâmetro changesetNumber foi confirmado para o modelo de dados após o upload. Valores válidos: verdadeiro: o changeset é confirmado após o upload. false: o changeset não é confirmado após o upload. Tipo de dados: booliano Padrão: falso
autoValidate	Sinalizador que indica se os snapshots criados quando confirmados são validados. Valores válidos: verdadeiro: valida os snapshots. falso: não valide os snapshots. Nota: Esta opção só estará disponível se o parâmetro autoCommit for `verdadeiro`. Tipo de dados: booliano Padrão: falso
changesetNumber	Cadeia de caracteres que identifica exclusivamente o changeset associado à aplicação, como Chset-102. Este changeset deve estar no estado "Aberto". Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres Padrão: cria um conjunto de mudanças a ser usado. Os detalhes do changeset são retornados como parte dos resultados CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id}.
implantávelNome	Obrigatório. Nome do implantável do CDM para o qual a política será mapeada. Localizado na tabela Implantável do CDM [sn_cdm_deployable]. Tipo de dados: cadeia de caracteres
fileName	Nome do arquivo a ser carregado. Este nome pode ser diferente do nome real do arquivo e conter a extensão do arquivo. Por exemplo, .txt/.scv/.jar. O valor fileName é aplicado ao baixar o arquivo. Tipo de dados: cadeia de caracteres
fileNodeName	Nome do nó do arquivo. Este nome de arquivo é usado nos dados de configuração ao exportá-lo. Este nome não requer uma extensão de arquivo nem afeta o download. Tipo de dados: cadeia de caracteres
namePath	Caminho do nó de destino no qual os dados de configuração devem ser carregados. Este caminho é relativo aos componentes, à coleção ou à pasta implantável (dependendo do endpoint que está sendo chamado). Você pode passar o caminho do nome em qualquer um dos formatos a seguir. Por exemplo, para definir o caminho do nome do nó `testApp/deployables/Development1/cdi1`: Formato de barra invertida: testApp/deployables/Development1/cdi1 Nota: Se o nome do nó contiver uma barra invertida ("/"), você não poderá usar este formato. Caminho do nome de back-end com caracteres de substituição: testAppdeployablesDevelopment1cdi1 Matriz: ['testApp','deployables','Development1','cdi1'] Nota: Se o componente especificado não existir no caminho especificado, o sistema criará automaticamente o componente no caminho especificado e carregará os dados. Tipo de dados: cadeia de caracteres
publicarOpção	Opção de publicação para os snapshots configurados associados. Valores válidos: publicar_none: não publicar snapshots. publicar_valid: publique somente os snapshots aprovados na validação após a confirmação. Para obter informações adicionais sobre como publicar snapshots, consulte Publicar ou cancelar a publicação de um snapshot. Tipo de dados: cadeia de caracteres Padrão: publicar_none Nota: Esta opção só estará disponível se o valor do parâmetro autoCommit for verdadeiro.

Tabela 105. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Dados de upload de variáveis	Dados de configuração a serem carregados. Por padrão, os carregamentos de tamanho de arquivo são limitados a 5 MB. Para obter informações sobre como ajustar os tamanhos e o tipo de arquivo de carregamento, consulte este Now Support artigo. Tipo de dados: cadeia de caracteres/fluxo

Cabeçalhos

Tabela 106. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json
Tipo de conteúdo	Tipo de dados do arquivo a ser carregado. Tipos compatíveis: application/zip, text/plain, application/json. Padrão: application/json

Tabela 107. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 108. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. A solicitação de upload foi rejeitada. Possíveis problemas: O tamanho da carga de configuração é maior que o máximo permitido - 2 MB por padrão. Os parâmetros obrigatórios estão ausentes na chamada.
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	Se ocorreu um erro durante o processamento, os detalhes sobre o erro. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Informações adicionais sobre o erro. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem de erro gerada ao tentar processar a solicitação. Tipo de dados: cadeia de caracteres
status	Status de erro da solicitação. Valores possíveis: falha Tipo de dados: cadeia de caracteres
upload_id	Sys_id da solicitação de upload. Use este ID para chamar o endpoint CdmApplicationsApi - GET /sn_cdm/applications/upload-status/{upload_id} para obter o status do upload. Tipo de dados: cadeia de caracteres

Solicitação de cURL

A solicitação a seguir carrega um arquivo de texto sem formatação para a pasta implantáveis da aplicação do CDM.

curl "http://instance.servicenow.com/api/sn_cdm/applications/uploads/deployables/file?autoValidate=true&deployableName=depA&appName=testApp&namePath=testComponent%2FfilesFolder&fileName=testFileNodeName.txt&publishOption=publish_valid&changesetNumber=Chset-108&autoCommit=true&fileNodeName=testFile.txt" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:text/plain" \ 
--data "This is sample content that will be uploaded to a plain text file."\ 
--user 'username':'password'

Os resultados de retorno a seguir mostram uma resposta bem-sucedida e uma de erro para esta solicitação.

// Successful completion of the upload request
{ 
  "result": { 
    "upload_id": "ec1f71f45322301096edddeeff7b12b3" 
  } 
} 

// Error response. Payload is too large.
{ 
  "error": { 
    "message": "Could not find active application with name: ‘testApp’ of type application", 
    "detail": "" 
  },
  "status": "failure"
}

CdmApplicationsApi - PUT /sn_cdm/applications/deployables

Atualiza o componente compartilhado especificado em uma aplicação em um conjunto de mudanças especificado.

Permite uma atualização nos seguintes campos:

Nome
Descrição
Serviço de aplicações\Grupo de IC dinâmico
Identificador de implantável

A função de Administrador do CDM é necessária para acessar este endpoint.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/deployables

URL padrão: /api/sn_cdm/applications/deployables

Parâmetros de solicitação compatíveis

Tabela 109. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 110. Parâmetros de consulta
Nome	Descrição
appName	Obrigatório. Nome da aplicação do CDM. Tipo de dados: cadeia de caracteres
nome	Obrigatório. Nome do implantável do CDM. Tipo de dados: cadeia de caracteres
novaDescrição	Opcional. Uma descrição do implantável do CDM. Tipo de dados: cadeia de caracteres
novoServiceId	Opcional. O ID do serviço de aplicações/grupo de ICs dinâmicos desejado. Na solicitação cURL, forneça `“”` para desconectar o implantável do serviço.
novoIdentificador	Opcional. O identificador do implantável. Tipo de dados: Opção (Desenvolvimento/Teste/Produção
novoNome	Opcional. O novo nome do implantável. Tipo de dados: cadeia de caracteres
returnFields	Opcional. Lista separada por vírgulas de campos a serem retornados como parte da resposta.

Tabela 111. Parâmetros do corpo da solicitação (XML ou JSON)
Nome	Descrição
Nenhum

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 112. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: aplicação/json

Códigos de status

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

Tabela 113. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação incorreta. Foi detectado um tipo de solicitação incorreto ou solicitação malformada.
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
sys_id	sys_Id implantável do CDM.
nome	Nome do implantável do CDM.
node	Objeto de nó implantável. `{ 'value': '<sysId> ', 'link': 'http://localhost:8081/api/now/table/*'}`
description	Descrição implantável do CDM.
identificador	Um identificador para o implantável.
cmdb_ci	O objeto de serviço de app que está conectado a um implantável. `{ 'value': '<sysId> ', 'link': 'http://localhost:8081/api/now/table/*'}`
cmdb_app	O objeto da aplicação do CDM. `{ 'value': '<sysId> ', 'link': 'http://localhost:8081/api/now/table/*'}`
snapshot_version_counter	A contagem de snapshots criados para um implantável.
cdi_count	O número de CDIs contidos neste implantável do CDM.
cdi_usage	A porcentagem de uso do CDI.
enviroment_type	O tipo de ambiente. Valores possíveis: desenvolvimento produção teste
state	O estado ativo ou excluído . Valores possíveis: ativo excluído
sys_created_by	CDM implantável criado por<username> .
sys_created_on	Carimbo de data/hora de criação implantável do CDM no formato de<yyyy-MM-dd hh:mm:ss> .
sys_updated_by	CDM implantável atualizado por<username> .
sys_updated_on	CDM implantável atualizado por carimbo de data/hora no formato de<yyyy-MM-dd hh:mm:ss> .

Solicitação de cURL

curl "http://localhost:8080/api/sn_cdm/applications/deployables?appName=testApp&name=Dep-1" \ 
--request PUT\ 
--header "Accept:application/json" \ 
--user 'cdm_admin':'password1!'

Saída:

{ 
  "result": { 
    "identifier": "identiy1", 
    "cmdb_ci": { 
      "value": "f5b9e00b53901110a1d3ddeeff7b12b8", 
      "link": "http://192.168.0.233:8080/api/now/table/cmdb_ci_service_auto/f5b9e00b53901110a1d3ddeeff7b12b8" 
    }, 
    "cdi_count": "3", 
    "snapshot_version_counter": "1", 
    "description": "cdcds", 
    "sys_updated_on": "2022-07-27 13:40:13", 
    "environment_type": "Test", 
    "node": { 
      "value": "30c00d4053015110a1d3ddeeff7b12bf", 
      "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_node/30c00d4053015110a1d3ddeeff7b12bf" 
    }, 
    "sys_id": "39b9e00b53901110a1d3ddeeff7b12b7", 
    "sys_updated_by": "admin", 
    "cdm_app": { 
      "value": "62b517a953b70110a1d3ddeeff7b128c", 
      "link": "http://192.168.0.233:8080/api/now/table/sn_cdm_application/62b517a953b70110a1d3ddeeff7b128c" 
    }, 
    "sys_created_on": "2022-06-29 12:53:57", 
    "cdi_usage": "0.03", 
    "name": "Dep-2", 
    "state": "active", 
    "sys_created_by": "admin" 
  } 
}

CdmApplicationsApi - PUT /sn_cdm/applications/shared_components

Atualiza o componente compartilhado especificado em uma aplicação em um conjunto de mudanças especificado.

A função de Administrador do CDM é necessária para acessar este endpoint.

Formato de URL

URL com controle de versões: /api/sn_cdm/{api_version}/applications/shared_components

URL padrão: /api/sn_cdm/applications/shared_components

Parâmetros de solicitação compatíveis

Tabela 114. Parâmetros de caminho
Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessada. 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 115. Parâmetros de consulta
Nome	Descrição
changesetNumber	Obrigatório. Identificador exclusivo do changeset associado ao componente. Tipo de dados: cadeia de caracteres
returnFields	Lista de campos a serem retornados como parte da resposta. Passe os nomes da coluna de registro, como sys_id, sys_updated_by ou state. Tipo de dados: matriz Padrão: todos os campos conforme determinado pelo endpoint
sharedComponentName	Obrigatório. Nome do componente compartilhado associado à aplicação especificada. Localizado na tabela Componente compartilhado do CDM [sn_cdm_shared_component]. Tipo de dados: cadeia de caracteres
sharedLibraryName	Obrigatório. Nome da biblioteca compartilhada na qual reside o componente. Localizado na tabela Aplicação do CDM [sn_cdm_application]. A biblioteca compartilhada deve ter os seguintes campos definidos da seguinte forma: estado = ativo disponível = verdadeiro tipo = shared_library Tipo de dados: cadeia de caracteres
versão	Obrigatório. Nome da versão associado ao componente compartilhado. Localizado na tabela Snapshot do CDM [sn_cdm_snapshot]. Tipo de dados: cadeia de caracteres

Tabela 116. Parâmetros do corpo da solicitação
Nome	Descrição
Nenhum

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 117. Cabeçalhos da solicitação
Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json

Tabela 118. Cabeçalhos de resposta
Cabeçalho	Descrição
Nenhum

Códigos de status

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

Tabela 119. Códigos de status
Código de status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. O changeset aprovado não existe.
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

Os campos de resposta dependem de quais campos foram especificados no parâmetro returnFields na solicitação. A seguir, descrevemos alguns dos campos mais importantes.


Nome	Descrição
changeset_id	Detalhes do registro do changeset associado ao nó. Tipo de dados: objeto `"changeset_id": { "link": "String", "value": "String" }`
changeset_id.link	Sintaxe de chamada para consultar este registro de conjunto de mudanças usando a REST API da tabela. Tipo de dados: cadeia de caracteres
changeset_id.value	Identificador exclusivo do registro do changeset. Localizado na tabela Changeset do CDM [sn_cdm_changeset]. Tipo de dados: cadeia de caracteres
description	Descrição do nó do CDM. Tipo de dados: cadeia de caracteres
Erro	Retornado somente se ocorrer um erro durante o processamento. Tipo de dados: objeto `"error": { "detail": "String", "message": "String" }`
erro.detalhe	Detalhes sobre o erro ocorrido. Tipo de dados: cadeia de caracteres
erro.mensagem	Mensagem que fornece uma visão geral do erro. Tipo de dados: cadeia de caracteres
vinculado_a	ID do nó principal associado ao componente compartilhado. Tipo de dados: cadeia de caracteres
vinculado_para_versão	Detalhes do registro de snapshot do CDM associado ao nó. Tipo de dados: objeto `"linked_to_version": { "link": "String", "value": "String" }`
link_para_versão.link	Sintaxe de chamada para consultar este registro de versão usando a REST API da tabela. Tipo de dados: cadeia de caracteres
link_to_version.value	Sys_id do registro da versão. Tipo de dados: cadeia de caracteres
principal	Sinalizador que indica se o snapshot associado foi publicado. Valores válidos: verdadeiro: o snapshot foi publicado. false: o snapshot não foi publicado.
main_id	ID exclusivo do nó principal recém-criado. Tipo de dados: cadeia de caracteres
main_id_encoded	ID codificado do nó principal recém-criado. Tipo de dados: cadeia de caracteres
nome	Nome do nó do CDM. Tipo de dados: cadeia de caracteres
node	Sys_id do nó do componente compartilhado. Tipo de dados: cadeia de caracteres
nó_path	Caminho para o novo nó vinculado criado ao adicionar o componente compartilhado. Tipo de dados: cadeia de caracteres
status	Status do nó. Valores possíveis: Novo Tipo de dados: cadeia de caracteres
sys_created_by	Nome do usuário que cria o nó do CDM. Por exemplo, enable.tuter. Tipo de dados: cadeia de caracteres
sys_created_on	Data e hora em que o nó do CDM foi criado. Formato: AAAA-mm-DD hh:mm:ss Tipo de dados: cadeia de caracteres
sys_id	Sys_id do nó. Localizado na tabela Nó do CDM [sn_cdm_node]. Tipo de dados: cadeia de caracteres
sys_updated_by	Nome do usuário que atualizou o nó do CDM pela última vez. Por exemplo, enable.tuter. Tipo de dados: cadeia de caracteres
sys_updated_on	Data e hora da última atualização do nó do CDM. Formato: AAAA-mm-DD hh:mm:ss Tipo de dados: cadeia de caracteres
tipo	Tipo de nó. Tipo de dados: cadeia de caracteres

Solicitação de cURL

O exemplo a seguir mostra como chamar este endpoint para atualizar a aplicação "App1" com o componente compartilhado "paymentService-V1.1" na biblioteca compartilhada "OracleG-Library-10" no changeset "Chset-20".

"https://instance-name.service-now.com/api/sn_cdm/applications/shared_components?sharedComponentName=paymentService-V1.1&sharedLibraryName=OracleG-Library-10&changesetNumber=Chset-20&versionName=sComp3-v2.shc&appName=App1" \ 
--request PUT \ 
--header "Accept:application/json" \ 
--user 'username':'password'

Resposta:

"result": {
  "changeset_id": {
    "value": "7343d0f71b771110636e0fe0604bcb0b",
    "link": "https://instance-name.service-now.com/api/now/table/sn_cdm_changeset/7343d0f71b771110636e0fe0604bcb0b"
  },
  "node_path": "!2!3!&`",
  "description": null,
  "sys_updated_on": "2022-12-22 18:52:38",
  "type": "sn_cdm_node_linked_shared_component",
  "sys_class_name": "sn_cdm_node",
  "sys_id": "339314b71b771110636e0fe0604bcba3",
  "sys_updated_by": ”admin",
  "previous_version": {
    "value": "a9ce80bf1b371110636e0fe0604bcb10",
    "link": "https://instance-name.service-now.com/api/now/table/sn_cdm_node/a9ce80bf1b371110636e0fe0604bcb10" 
  },
  "sys_created_on": "2022-12-22 18:52:38",
  "value": null,
  "effective_from": null,
  "linked_to": "146", 
  "sys_created_by": ”admin",
  "restricted_to": null,
  "linked_to_version": {
    "value": "54115c371b771110636e0fe0604bcb77",
    "link": "https://instance-name.service-now.com/api/now/table/sn_cdm_snapshot/54115c371b771110636e0fe0604bcb77"
  },
  "level": "2",
  "conflict_type": null,
  "main_id": "166",
  "effective_to": null,
  "secure_value": null,
  "node_classifier": "/application/components",
  "main_id_encoded": "&`",
  "name": "Component_A",
  "position": null,
  "reason_for_conflict": null,
  "system_folder": false,
  "status": "updated",
  "conflict": false
}