--- sourceDocument: Referência de API do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Referência de API do Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # API do catálogo de serviços em nuvem # API do catálogo de serviços em nuvem {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 31 min. de leitura A API do Catálogo de serviços em nuvem fornece métodos relacionados às operações Dia-1 (provisionamento) e Dia-2 (modificação) disponíveis no Catálogo de serviços em nuvem, como criar pilhas de serviços em nuvem e chamar solicitações de operação de recursos. Você também pode recuperar informações sobre solicitações de catálogo, pilhas que obtêm status e outras informações. Esta API está incluída no namespace `now` e requer a função sn_cmp.cloud_service_user. A aplicação Catálogo de serviços em nuvem (CSC) está disponível como uma assinatura separada e requer o pacote ITOM Enterprise ou o direito do produto ITOM Cloud Accelerate. A API Catálogo de serviços em nuvem apresenta ações que você executa durante as operações do dia 2. No contexto desta API, os itens do catálogo de recursos se referem aos itens do catálogo relacionados às operações do Dia 2. Para usar esta API, certifique-se de ter concluído o processo de configuração assistida do Catálogo de serviços em nuvem ou de ter uma configuração de trabalho em que as operações de provisionamento e catálogo estejam funcionando na IU. Para obter mais informações sobre essas etapas, consulte [Cloud Services Catalog](https://www.servicenow.com/docs/access?context=csc-home&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US). ## Catálogo de serviços em nuvem - GET /now/cmp_catalog_api/itemsbyciclass {#ariaid-title2} Retorna uma lista de itens do catálogo de recursos com base em uma determinada classe de item de configuração (IC). ### Formato da URL URL padrão: /api/now/cmp_catalog_api/itemsbyciclass ### Parâmetros de solicitação compatíveis {#cs-catalog-GET-itemsbyciclass__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 1. Parâmetros de caminho] {#cs-catalog-GET-itemsbyciclass__entry__6}{#cs-catalog-GET-itemsbyciclass__operation_name-ph-3} | Nome | Descrição | |-|-| | ci_class | Obrigatório. Nome da classe de IC da qual os itens do catálogo de recursos serão obtidos (por exemplo, "cmdb_ci_vm_instance"). Localizado no campo Tipo de IC de referência na tabela Item de configuração \[cmdb_ci\]. Tipo de dados: cadeia de caracteres | | variáveis_exibição | Sinalizador que indica se as variáveis de item do catálogo devem ser listadas associadas a cada item do catálogo. Valores válidos: * verdadeiro: exibe variáveis de item do catálogo de lista. * falso: não exibe variáveis de item do catálogo de lista. Tipo de dados: booliano Padrão: falso | | operação_nome | Opcional. Nome da operação. Localizado na coluna Nome da interface do recurso na tabela OperationSignature \[sn_cmp_rb_op_signature\]. Nota: Este parâmetro pode consultar parte ou toda a operação. Por exemplo, se você quiser listar todas as interfaces que começam com "ServiceNow", poderá definir a variável como `Operation_name = ServiceNow`. Padrão: todos os itens do catálogo de todos os tipos de operação são retornados.{#cs-catalog-GET-itemsbyciclass__operation_name-ph-2} Tipo de dados: cadeia de caracteres | | interface_recurso | Opcional. Interface de recursos na qual o item do catálogo de recursos está hospedado. Localizado na coluna Nome da tabela ResourceInterfaces \[sn_cmp_rb_resourceinterface\]. Tipo de dados: cadeia de caracteres | [Tabela 2. Parâmetros de consulta] {#cs-catalog-GET-itemsbyciclass__entry__16} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 3. Parâmetros do corpo da solicitação (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-itemsbyciclass__entry__20}{#cs-catalog-GET-itemsbyciclass__accept-RESTAPI} | 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 4. Cabeçalhos da solicitação] {#cs-catalog-GET-itemsbyciclass__entry__24} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 5. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status 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 de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-itemsbyciclass__table_kyz_xq3_1bc__entry__2}{#cs-catalog-GET-itemsbyciclass__entry-200-status-code}{#cs-catalog-GET-itemsbyciclass__entry-400-status-code}{#cs-catalog-GET-itemsbyciclass__entry-401-status-code}{#cs-catalog-GET-itemsbyciclass__entry-403-status-code}{#cs-catalog-GET-itemsbyciclass__entry-404-status-code}{#cs-catalog-GET-itemsbyciclass__entry-405-status-code}{#cs-catalog-GET-itemsbyciclass__entry-500-status-code} | 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. | | 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. | | 403 | Proibido. O usuário não tem direitos de acesso ao registro especificado. | | 404 | Não encontrado. O item solicitado não foi encontrado. | | 405 | Método inválido. A funcionalidade está desabilitada. | | 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. | [Tabela 6. Códigos de status] {#cs-catalog-GET-itemsbyciclass__table_kyz_xq3_1bc} ### Parâmetros do corpo da resposta (JSON ou XML) {#cs-catalog-GET-itemsbyciclass__entry__44} | Nome | Descrição | |-|-| | ativo | O estado ativo do item do catálogo de operação de recursos. Valores possíveis: * verdadeiro: o item do catálogo de operação de recursos está ativo. * falso: o item do catálogo de operação de recursos está inativo. {#cs-catalog-GET-itemsbyciclass__ul_c1g_4jp_gbc} Tipo de dados: cadeia de caracteres | | created_on | Carimbo de data/hora de quando o item do catálogo de operação de recursos foi criado. Formato: aaaa-MM-dd HH:mm:ss. Tipo de dados: cadeia de caracteres | | display_name | Nome da interface do recurso. Localizado na tabela ResourceInterfaces \[sn_cmp_rb_resourceinterface\]. Tipo de dados: cadeia de caracteres | | ID | Sys_id do item do catálogo de operação de recursos. Localizado na tabela Item do catálogo de operação de recursos \[sn_cmp_rsrc_opr_cat_item\]. Tipo de dados: cadeia de caracteres | | nome | Nome do item do catálogo de operação de recursos. Localizado na tabela Item do catálogo de operação de recursos \[sn_cmp_rsrc_opr_cat_item\]. Tipo de dados: cadeia de caracteres | | short_description | Breve descrição do item do catálogo de operação de recursos. Localizado na tabela Item do catálogo de operação de recursos \[sn_cmp_rsrc_opr_cat_item\]. Tipo de dados: cadeia de caracteres | | updated_on | Carimbo de data/hora da última atualização do item do catálogo de operações de recursos. Formato necessário: aaaa-MM-dd HH:mm:ss. Tipo de dados: cadeia de caracteres | [ ] ### Solicitação de cURL O exemplo a seguir solicita e retorna o status do item da solicitação. curl "https://instance.servicenow.com/api/now/cmp_catalog_api/itemsbyciclass?ci_class=cmdb_ci_vm_instance&resource_interface=Virtual%20Machine%20Store%20Extension%20Interface&operation_name=Execute%20Job%20Template" \ --request GET \ --header 'Accept: application/json' \ --user 'username':'password' Resposta: [ { "display_name": "Virtual Server-Virtual Machine Store Extension Interface-Execute Job Template", "id": "01b2341a56789012345d6ddeeff7b89fc", "created_on": "2019-04-28 12:58:26", "updated_on": "2019-04-28 12:58:26", "name": "Virtual Server-Virtual Machine Store Extension Interface-Execute Job Template", "short_description": "Catalog item to invoke operation", "active": true } ] ## Catálogo de serviços em nuvem - GET /now/cmp_catalog_api/itemsbyrb {#ariaid-title3} Retorna uma lista de itens do catálogo de recursos com base em um determinado bloco de recursos. ### Formato da URL URL padrão: /api/now/cmp_catalog_api/itemsbyrb ### Parâmetros de solicitação compatíveis {#cs-catalog-GET-itemsbyrb__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 7. Parâmetros de caminho] {#cs-catalog-GET-itemsbyrb__entry__6}{#cs-catalog-GET-itemsbyrb__operation_name-ph-3}{#cs-catalog-GET-itemsbyrb__resource_block-ph-3} | Nome | Descrição | |-|-| | variáveis_exibição | Sinalizador que indica se as variáveis de item do catálogo devem ser listadas associadas a cada item do catálogo. Valores válidos: * verdadeiro: exibe variáveis de item do catálogo de lista. * falso: não exibe variáveis de item do catálogo de lista. Tipo de dados: booliano Padrão: falso | | operação_nome | Opcional. Nome da operação. Localizado na coluna Nome da interface do recurso na tabela OperationSignature \[sn_cmp_rb_op_signature\]. Nota: Este parâmetro pode consultar parte ou toda a operação. Por exemplo, se você quiser listar todas as interfaces que começam com "ServiceNow", poderá definir a variável como `Operation_name = ServiceNow`. Padrão: todos os itens do catálogo de todos os tipos de operação são retornados.{#cs-catalog-GET-itemsbyrb__operation_name-ph-2} Tipo de dados: cadeia de caracteres | | resource_block | Obrigatório. O nome do bloco de recursos do qual os itens do catálogo de operação de recursos relacionados serão obtidos (por exemplo, servidor virtual). Disponível na tabela Bloco de recursos \[sn_cmp_rb_resourceblock\]. Padrão: todos os itens do catálogo de todos os tipos de operação são retornados.{#cs-catalog-GET-itemsbyrb__resource_block-ph-2} Tipo de dados: cadeia de caracteres | | interface_recurso | Opcional. Interface de recursos na qual o item do catálogo de recursos está hospedado. Localizado na coluna Nome da tabela ResourceInterfaces \[sn_cmp_rb_resourceinterface\]. Tipo de dados: cadeia de caracteres | [Tabela 8. Parâmetros de consulta] {#cs-catalog-GET-itemsbyrb__entry__16} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 9. Parâmetros do corpo da solicitação (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-itemsbyrb__entry__20}{#cs-catalog-GET-itemsbyrb__accept-RESTAPI} | 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 10. Cabeçalhos da solicitação] {#cs-catalog-GET-itemsbyrb__entry__24} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 11. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status 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 de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-itemsbyrb__table_kyz_xq3_1bc__entry__2}{#cs-catalog-GET-itemsbyrb__entry-200-status-code}{#cs-catalog-GET-itemsbyrb__entry-400-status-code}{#cs-catalog-GET-itemsbyrb__entry-401-status-code}{#cs-catalog-GET-itemsbyrb__entry-403-status-code}{#cs-catalog-GET-itemsbyrb__entry-404-status-code}{#cs-catalog-GET-itemsbyrb__entry-405-status-code}{#cs-catalog-GET-itemsbyrb__entry-500-status-code} | 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. | | 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. | | 403 | Proibido. O usuário não tem direitos de acesso ao registro especificado. | | 404 | Não encontrado. O item solicitado não foi encontrado. | | 405 | Método inválido. A funcionalidade está desabilitada. | | 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. | [Tabela 12. Códigos de status] {#cs-catalog-GET-itemsbyrb__table_kyz_xq3_1bc} ### Parâmetros do corpo da resposta (JSON ou XML) {#cs-catalog-GET-itemsbyrb__table_dbv_lt3_1bc__entry__2} | Nome | Descrição | |-|-| | ativo | O estado ativo do item do catálogo de operação de recursos. Valores possíveis: * verdadeiro: o item do catálogo de operação de recursos está ativo. * falso: o item do catálogo de operação de recursos está inativo. {#cs-catalog-GET-itemsbyrb__ul_c1g_4jp_gbc} Tipo de dados: cadeia de caracteres | | display_name | Nome da interface do recurso. Localizado na tabela ResourceInterfaces \[sn_cmp_rb_resourceinterface\]. Tipo de dados: cadeia de caracteres | | ID | Sys_id do item do catálogo de operação de recursos. Localizado na tabela Item do catálogo de operação de recursos \[sn_cmp_rsrc_opr_cat_item\]. Tipo de dados: cadeia de caracteres | | nome | Nome do item do catálogo de operação de recursos. Localizado na tabela Item do catálogo de operação de recursos \[sn_cmp_rsrc_opr_cat_item\]. Tipo de dados: cadeia de caracteres | | short_description | Breve descrição do item do catálogo de operação de recursos. Localizado na tabela Item do catálogo de operação de recursos \[sn_cmp_rsrc_opr_cat_item\]. Tipo de dados: cadeia de caracteres | | variáveis | Lista de detalhes extras sobre o item do catálogo de recursos. As variáveis retornadas nesta API variam com base nos parâmetros de consulta que foram passados. Tipo de dados: matriz de objetos "variables": [ { "parameter1": "String", "parameter2": "String" } ] | [ ] {#cs-catalog-GET-itemsbyrb__table_dbv_lt3_1bc} Esta lista de exemplo de itens do catálogo de recursos com base em um bloco de recursos do servidor virtual: curl "https://instance.servicenow.com/api/now/cmp_catalog_api/itemsbyrb?resource_interface=Virtual%20Machine%20Store%20Extension%20Interface&operation_name=Execute%20Job%20Template&resource_block=Virtual%20Server" \ --request GET \ --header 'Accept: application/json' \ --user 'username':'password' Resposta: [ { "display_name": "Virtual Server-Virtual Machine Store Extension Interface-Execute Job Template", "id": "01b2341a56789012345d6ddeeff7b89fc", "created_on": "2019-04-28 12:58:26", "updated_on": "2019-04-28 12:58:26", "name": "Virtual Server-Virtual Machine Store Extension Interface-Execute Job Template", "short_description": "Catalog item to invoke operation", "active": true } ] ## Catálogo de serviços em nuvem - GET /now/cmp_catalog_api/services {#ariaid-title4} Retorna uma lista de itens do catálogo com base no plano gráfico fornecido de um tipo de catálogo de Provisão ou Ciclo de vida. ### Formato da URL URL padrão: /api/now/cmp_catalog_api/services ### Parâmetros de solicitação compatíveis {#cs-catalog-GET-services__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 13. Parâmetros de caminho] {#cs-catalog-GET-services__entry__6} | Nome | Descrição | |-|-| | tipo_catálogo | Opcional. Tipo de item do catálogo. Valores aceitos (diferencia maiúsculas de minúsculas): * `Provisão` - Retorna todos os itens do catálogo do tipo Plano gráfico. * `Ciclo de vida` --- Retorna todos os itens do catálogo do tipo Operação de dia 2. {#cs-catalog-GET-services__ul_klg_1jg_cbc} Se a entrada estiver vazia (padrão), todos os serviços de ambos os tipos de catálogo serão retornados. Tipo de dados: cadeia de caracteres | | variáveis_exibição | Sinalizador que indica se as variáveis de item do catálogo devem ser listadas associadas a cada item do catálogo. Valores válidos: * verdadeiro: exibe variáveis de item do catálogo de lista. * falso: não exibe variáveis de item do catálogo de lista. Tipo de dados: booliano Padrão: falso | | blueprint_name | Opcional. Nome do plano gráfico no qual os itens do catálogo relacionados serão buscados. Localizado na tabela Item de categoria \[sn_cmp_bp_cat_item\]. Nota: Este parâmetro pode consultar parte ou todo o nome do plano gráfico. Por exemplo, se você quiser listar todos os planos gráficos que começam com "Servicenow", poderá definir a variável como `blueprint_name = Servicenow`. Padrão: todos os serviços de todos os planos gráficos são retornados. Tipo de dados: cadeia de caracteres | [Tabela 14. Parâmetros de consulta] {#cs-catalog-GET-services__entry__14} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 15. Parâmetros do corpo da solicitação (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-services__entry__18}{#cs-catalog-GET-services__accept-RESTAPI} | 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 16. Cabeçalhos da solicitação] {#cs-catalog-GET-services__entry__22} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 17. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status 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 de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-services__table_kyz_xq3_1bc__entry__2}{#cs-catalog-GET-services__entry-200-status-code}{#cs-catalog-GET-services__entry-400-status-code}{#cs-catalog-GET-services__entry-401-status-code}{#cs-catalog-GET-services__entry-403-status-code}{#cs-catalog-GET-services__entry-404-status-code}{#cs-catalog-GET-services__entry-405-status-code}{#cs-catalog-GET-services__entry-500-status-code} | 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. | | 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. | | 403 | Proibido. O usuário não tem direitos de acesso ao registro especificado. | | 404 | Não encontrado. O item solicitado não foi encontrado. | | 405 | Método inválido. A funcionalidade está desabilitada. | | 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. | [Tabela 18. Códigos de status] {#cs-catalog-GET-services__table_kyz_xq3_1bc} ### Parâmetros do corpo da resposta (JSON ou XML) {#cs-catalog-GET-services__table_mqx_4y3_1bc__entry__2} | Nome | Descrição | |-|-| | ativo | Sinalizador que indica se o catálogo está ativo. Valores possíveis: * verdadeiro: o catálogo está ativo. * falso: o catálogo não está ativo. {#cs-catalog-GET-services__ul_yxy_yl5_dcc} Tipo de dados: cadeia de caracteres | | plano gráfico | sys_id do plano gráfico. Localizado na tabela Blueprint \[sn_cmp_bp_ blueprint\]. Tipo de dados: cadeia de caracteres | | blueprint_category | sys_id da categoria de plano gráfico. Localizado na tabela Categoria de serviço em nuvem \[sn_capi_service_category\]. Tipo de dados: cadeia de caracteres | | blueprint_category_name | Nome da categoria do plano gráfico. Localizado na tabela Categoria de serviço em nuvem \[sn_capi_service_category\]. Valores possíveis: * Access * Análise * Serviços de aplicações * Blockchain * Produtividade de negócios * Computação * Gestão de configuração * Contêineres * Banco de dados * Ferramentas do desenvolvedor * Evento * Nuvem híbrida * IOT * IPAM * Balanceador alto * Aprendizado de Máquina * Ferramentas de gestão * Mercado * Móvel * Rede * Produtividade * Segurança * Acesso ao shell * Armazenamento * Ferramentas * Desconhecido * Realidade Virtual {#cs-catalog-GET-services__ul_qsx_xl5_dcc} Tipo de dados: cadeia de caracteres | | blueprint_name | Nome do plano gráfico. Localizado na tabela Blueprint \[sn_cmp_bp_ blueprint\]. Tipo de dados: cadeia de caracteres | | blueprint_type | Tipo de plano gráfico. Valor possível: `plano gráfico personalizado` Tipo de dados: cadeia de caracteres | | catalog_name | Nome do catálogo. Localizado na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | tipo_catálogo | O tipo de catálogo. Valores possíveis: * `1`: o catálogo é do tipo provisionamento. * `2`: o catálogo é do tipo ciclo de vida. Tipo de dados: cadeia de caracteres | | tipo_catálogo | O tipo de catálogo. Valores possíveis: * `1`: o catálogo é do tipo provisionamento. * `2`: o catálogo é do tipo ciclo de vida. Tipo de dados: cadeia de caracteres | | createdOn | Carimbo de data/hora de quando o item do catálogo foi criado. Tipo de dados: cadeia de caracteres | | createdBy | Usuário que criou o item do catálogo. Tipo de dados: cadeia de caracteres | | ID | sys_id do plano gráfico. Localizado na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | última_atualizada_em | Carimbo de data/hora da última atualização do item do catálogo. Tipo de dados: cadeia de caracteres | | última_atualizada_por | Usuário que atualizou o item do catálogo pela última vez, como um administrador ou o sistema. Tipo de dados: cadeia de caracteres | | operação | sys_id da operação. Disponível na tabela OperationSignature \[sn_cmp_rb_op_signature\]. | | operação_nome | Nome da operação. Valores possíveis: * Iniciar: inicia os recursos que estão em um estado desativado. * Parar: interrompe os recursos que estão em um estado ativado. * ModifySchedule: modifica a programação dos recursos provisionados. * Desprovisionamento: exclui recursos com um estado encerrado e atualiza as tabelas do CMDB de recursos de acordo. * ModifyLease: modifica a operação de leasing programada em recursos provisionados. Tipo de dados: cadeia de caracteres | | variáveis | Um objeto que contém detalhes extras sobre o item do catálogo de lista. As variáveis retornadas nesta API variam de acordo com os parâmetros de consulta passados na solicitação. Tipo de dados: objeto "variables": [ { "parameter1": "String", "parameter2": "String" } ] | [ ] {#cs-catalog-GET-services__table_mqx_4y3_1bc} Este exemplo retorna todos os itens do catálogo de um plano gráfico de tipo de ciclo de vida chamado "classiclb". curl "https://instance.servicenow.comapi/now/cmp_catalog_api/services?display_variables=true&catalog_type=LifeCycle&blueprint_name=classiclb" \ --request GET \ --header 'Accept: application/json' \ --user 'username':'password' Resposta: [ { "catalog_name": "Deprovision", "blueprint": "d90d9d80476c46104bf15222516d43b9", "blueprint_name": "classiclb", "blueprint_category": "57c0dbd9934b22004a9032bfa67ffb79", "active": true, "category": "86d85478678232005ca552e457415a79", "blueprint_category_name": "Compute", "shortDescription": "Are you sure you want to perform this operation?", "id": "01b2341a56789012345d6ddeeff7b89fc", "variables": [ { "id": "a12d34c5678c91234bf45678912d34e4", "name": "StackID", "question_text": "StackID", "default_value": "Not specified" } ], "last_updated_on": "2024-02-19 07:46:03", "last_updated_by": "system", "catalog_type": "2", "created_on": "2024-02-19 07:46:02", "created_by": "user@password.com", "operation": "a70d51c0476c46104bf15222516d4375", "blueprint_type": "Custom Blueprint", "operation_name": "Deprovision" }, { "catalog_name": "ModifySchedule", "blueprint": "d90d9d80476c46104bf15222516d43b9", "blueprint_name": "classiclb", "blueprint_category": "57c0dbd9934b22004a9032bfa67ffb79", "active": true, "category": "86d85478678232005ca552e457415a79", "blueprint_category_name": "Compute", "shortDescription": null, "id": "361d55c0476c46104bf15222516d4351", "variables": [ { "id": "031d55c0476c46104bf15222516d43af", "name": "ScheduleProfile", "question_text": "ScheduleProfile", "default_value": "Not specified" }, { "id": "0b1d55c0476c46104bf15222516d43c9", "name": "ScheduleTimeZone", "question_text": "ScheduleTimeZone", "default_value": "Not specified" } ], "last_updated_on": "2024-02-19 07:45:53", "last_updated_by": "system", "catalog_type": "2", "created_on": "2024-02-19 07:45:52", "created_by": "user@password.com", "operation": "130d51c0476c46104bf15222516d436c", "blueprint_type": "Custom Blueprint", "operation_name": "ModifySchedule" }, { "catalog_name": "Stop", "blueprint": "d90d9d80476c46104bf15222516d43b9", "blueprint_name": "classiclb", "blueprint_category": "57c0dbd9934b22004a9032bfa67ffb79", "active": true, "category": "86d85478678232005ca552e457415a79", "blueprint_category_name": "Compute", "shortDescription": "Are you sure you want to perform this operation?", "id": "542dd5c0476c46104bf15222516d43b0", "variables": [ { "id": "a02d19c0476c46104bf15222516d4301", "name": "StackID", "question_text": "StackID", "default_value": "Not specified" } ], "last_updated_on": "2024-02-19 07:46:00", "last_updated_by": "system", "catalog_type": "2", "created_on": "2024-02-19 07:45:58", "created_by": "user@password.com", "operation": "930d51c0476c46104bf15222516d436f", "blueprint_type": "Custom Blueprint", "operation_name": "Stop" }, { "catalog_name": "Cleanup", "blueprint": "d90d9d80476c46104bf15222516d43b9", "blueprint_name": "classiclb", "blueprint_category": "57c0dbd9934b22004a9032bfa67ffb79", "active": true, "category": "86d85478678232005ca552e457415a79", "blueprint_category_name": "Compute", "shortDescription": "Are you sure you want to perform this operation?", "id": "712d59c0476c46104bf15222516d435c", "variables": [ { "id": "da2d59c0476c46104bf15222516d43dc", "name": "resourceId", "question_text": "ResourceId", "default_value": "Not specified" }, { "id": "da2d59c0476c46104bf15222516d43e2", "name": "operationName", "question_text": "OperationName", "default_value": "Not specified" } ], "last_updated_on": "2024-02-19 07:46:06", "last_updated_by": "system", "catalog_type": "2", "created_on": "2024-02-19 07:46:04", "created_by": "user@password.com", "operation": "ab0d51c0476c46104bf15222516d437b", "blueprint_type": "Custom Blueprint", "operation_name": "Cleanup" }, { "catalog_name": "ModifyLease", "blueprint": "d90d9d80476c46104bf15222516d43b9", "blueprint_name": "classiclb", "blueprint_category": "57c0dbd9934b22004a9032bfa67ffb79", "active": true, "category": "86d85478678232005ca552e457415a79", "blueprint_category_name": "Compute", "shortDescription": null, "id": "bb1dd5c0476c46104bf15222516d4301", "variables": [ { "id": "142dd5c0476c46104bf15222516d4382", "name": "resourceId", "question_text": "ResourceId", "default_value": "Not specified" }, { "id": "d82dd5c0476c46104bf15222516d4394", "name": "operationName", "question_text": "OperationName", "default_value": "Not specified" } ], "last_updated_on": "2024-02-19 07:45:58", "last_updated_by": "system", "catalog_type": "2", "created_on": "2024-02-19 07:45:56", "created_by": "user@password.com", "operation": "2b0d51c0476c46104bf15222516d4378", "blueprint_type": "Custom Blueprint", "operation_name": "ModifyLease" }, { "catalog_name": "Start", "blueprint": "d90d9d80476c46104bf15222516d43b9", "blueprint_name": "classiclb", "blueprint_category": "57c0dbd9934b22004a9032bfa67ffb79", "active": true, "category": "86d85478678232005ca552e457415a79", "blueprint_category_name": "Compute", "shortDescription": "Are you sure you want to perform this operation?", "id": "d71d95c0476c46104bf15222516d4312", "variables": [ { "id": "731d95c0476c46104bf15222516d43ae", "name": "resourceId", "question_text": "ResourceId", "default_value": "Not specified" }, { "id": "731d95c0476c46104bf15222516d43b4", "name": "operationName", "question_text": "OperationName", "default_value": "Not specified" } ], "last_updated_on": "2024-02-19 07:45:55", "last_updated_by": "system", "catalog_type": "2", "created_on": "2024-02-19 07:45:54", "created_by": "user@password.com", "operation": "270d51c0476c46104bf15222516d4372", "blueprint_type": "Custom Blueprint", "operation_name": "Start" } ] ## Catálogo de serviços em nuvem - GET /now/cmp_catalog_api/stacks {#ariaid-title5} Retorna uma lista de itens do catálogo com base em planos gráficos do tipo Provisão (também conhecidos como pilhas). ### Formato da URL URL padrão: /api/now/cmp_catalog_api/stacks ### Parâmetros de solicitação compatíveis {#cs-catalog-GET-stacks__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 19. Parâmetros de caminho] {#cs-catalog-GET-stacks__entry__6} | Nome | Descrição | |-|-| | blueprint_name | Opcional. Nome do plano gráfico no qual os itens do catálogo relacionados serão buscados. Localizado na tabela Item de categoria \[sn_cmp_bp_cat_item\]. Nota: Este parâmetro pode consultar parte ou todo o nome do plano gráfico. Por exemplo, se você quiser listar todos os planos gráficos que começam com "Servicenow", poderá definir a variável como `blueprint_name = Servicenow`. Padrão: todos os serviços de todos os planos gráficos são retornados. Tipo de dados: cadeia de caracteres | | variáveis_exibição | Sinalizador que indica se as variáveis de item do catálogo devem ser listadas associadas a cada item do catálogo. Valores válidos: * verdadeiro: exibe variáveis de item do catálogo de lista. * falso: não exibe variáveis de item do catálogo de lista. Tipo de dados: booliano Padrão: falso | [Tabela 20. Parâmetros de consulta] {#cs-catalog-GET-stacks__entry__12} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 21. Parâmetros do corpo da solicitação (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-stacks__entry__16}{#cs-catalog-GET-stacks__accept-RESTAPI} | 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 22. Cabeçalhos da solicitação] {#cs-catalog-GET-stacks__entry__20} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 23. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status 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 de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-stacks__entry__24}{#cs-catalog-GET-stacks__entry-200-status-code}{#cs-catalog-GET-stacks__entry-400-status-code}{#cs-catalog-GET-stacks__entry-401-status-code}{#cs-catalog-GET-stacks__entry-403-status-code}{#cs-catalog-GET-stacks__entry-404-status-code}{#cs-catalog-GET-stacks__entry-405-status-code}{#cs-catalog-GET-stacks__entry-500-status-code} | 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. | | 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. | | 403 | Proibido. O usuário não tem direitos de acesso ao registro especificado. | | 404 | Não encontrado. O item solicitado não foi encontrado. | | 405 | Método inválido. A funcionalidade está desabilitada. | | 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. | [Tabela 24. Códigos de status] ### Parâmetros do corpo da resposta (JSON ou XML) {#cs-catalog-GET-stacks__entry__40} | Nome | Descrição | |-|-| | ativo | Sinalizador que indica se o catálogo está ativo. Valores possíveis: * verdadeiro: o catálogo está ativo. * falso: o catálogo não está ativo. {#cs-catalog-GET-stacks__ul_yxy_yl5_dcc} Tipo de dados: cadeia de caracteres | | plano gráfico | sys_id do plano gráfico. Localizado na tabela Blueprint \[sn_cmp_bp_ blueprint\]. Tipo de dados: cadeia de caracteres | | blueprint_category | sys_id da categoria de plano gráfico. Localizado na tabela Categoria de serviço em nuvem \[sn_capi_service_category\]. Tipo de dados: cadeia de caracteres | | blueprint_category_name | Nome da categoria do plano gráfico. Localizado na tabela Categoria de serviço em nuvem \[sn_capi_service_category\]. Valores possíveis: * Access * Análise * Serviços de aplicações * Blockchain * Produtividade de negócios * Computação * Gestão de configuração * Contêineres * Banco de dados * Ferramentas do desenvolvedor * Evento * Nuvem híbrida * IOT * IPAM * Balanceador alto * Aprendizado de Máquina * Ferramentas de gestão * Mercado * Móvel * Rede * Produtividade * Segurança * Acesso ao shell * Armazenamento * Ferramentas * Desconhecido * Realidade Virtual {#cs-catalog-GET-stacks__ul_qsx_xl5_dcc} Tipo de dados: cadeia de caracteres | | blueprint_name | Nome do plano gráfico. Localizado na tabela Blueprint \[sn_cmp_bp_ blueprint\]. Tipo de dados: cadeia de caracteres | | blueprint_type | Tipo de plano gráfico. Valor possível: `plano gráfico personalizado` Tipo de dados: cadeia de caracteres | | catalog_name | Nome do catálogo. Localizado na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | tipo_catálogo | O tipo de catálogo. Valores possíveis: * `1`: o catálogo é do tipo provisionamento. * `2`: o catálogo é do tipo ciclo de vida. Tipo de dados: cadeia de caracteres | | catálogo_type_name | O nome do tipo de catálogo. Valores possíveis: * Operação de provisionamento (dia 1): o tipo de catálogo é chamado de provisionamento. * Operação de ciclo de vida (dia 2): o tipo de catálogo é chamado de ciclo de vida. Tipo de dados: cadeia de caracteres | | ID | sys_id do plano gráfico. Localizado na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | lifecycleOperations | Objeto que contém o nome e o sys_id da operação de ciclo de vida. Tipo de data: matriz de objetos "lifecycleOperations": [ { "id": "String", "name": "String" } | | lifecycleOperations.id | sys_id da operação de ciclo de vida. Disponível na tabela OperationSignature \[sn_cmp_rb_op_signature\]. | | lifeCycleOperations.name | Tipo de operações de ciclo de vida. Valores possíveis: 1. Desprovisionamento: exclui recursos em um estado encerrado e atualiza as tabelas do CMDB de recursos de acordo. 2. ModifySchedule: executa a programação de horário comercial em pilhas no momento do provisionamento ou em pilhas existentes. 3. Parar: interrompe os recursos que estão em um estado ativado. 4. Limpeza: limpa os recursos com um estado encerrado. 5. ModifyLease: modifica a operação de leasing programada em recursos provisionados. 6. Iniciar: inicia os recursos que estão em um estado desativado. Tipo de data: objeto | | operação | sys_id da operação. Disponível na tabela OperationSignature \[sn_cmp_rb_op_signature\]. | | operação_nome | Nome da operação. Valores possíveis: * Iniciar: inicia os recursos que estão em um estado desativado. * Parar: interrompe os recursos que estão em um estado ativado. * ModifySchedule: modifica a programação dos recursos provisionados. * Desprovisionamento: exclui recursos com um estado encerrado e atualiza as tabelas do CMDB de recursos de acordo. * ModifyLease: modifica a operação de leasing programada em recursos provisionados. Tipo de dados: cadeia de caracteres | | shortDescription | Uma breve descrição do catálogo. Tipo de dados: cadeia de caracteres | | template_name | Nome do modelo. Disponível na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | template_type | sys_id do tipo de modelo. Disponível na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | template_cloud_product_name | Nome do produto. Disponível na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | variáveis | Um objeto que contém detalhes extras sobre o item do catálogo de lista. As variáveis retornadas nesta API variam de acordo com os parâmetros de consulta passados na solicitação. Tipo de dados: objeto "variables": [ { "parameter1": "String", "parameter2": "String" } ] | [ ] O exemplo a seguir retorna todos os itens do catálogo na instância com o tipo de catálogo de provisionamento. curl "https://instance.servicenow.com/api/now/cmp_catalog_api/stacks" \ --request GET \ --header 'Accept: application/json' \ --user 'username':'password' Retornar: [ { "catalog_type": "1", "catalog_type_name": "Provision Operation (Day 1)", "catalog_name": "classiclb", "blueprint": "d90d9d80476c46104bf15222516d43b9", "blueprint_name": "classiclb", "blueprint_category": "57c0dbd9934b22004a9032bfa67ffb79", "blueprint_category_name": "Compute", "active": true, "category": "8641fe260b212200eff7ef9bb4673a3d", "shortDescription": null, "id": "07cc9580476c46104bf15222516d43c3", "last_updated_on": "2024-02-19 07:46:13", "last_updated_by": "user@servicenow.com", "blueprint_type": "Cloud Template", "template_type": "932f81e49f00320048111f80a57fcf6e", "template_name": "CloudFormation Template", "template_cloud_product": "52cfc4749f00320048111f80a57fcf9a", "template_cloud_product_name": "AWS CloudFormation", "lifecycleOperations": [ { "id": "1d2d19c0476c46104bf15222516d4392", "name": "Deprovision" }, { "id": "361d55c0476c46104bf15222516d4351", "name": "ModifySchedule" }, { "id": "542dd5c0476c46104bf15222516d43b0", "name": "Stop" }, { "id": "712d59c0476c46104bf15222516d435c", "name": "Cleanup" }, { "id": "bb1dd5c0476c46104bf15222516d4301", "name": "ModifyLease" }, { "id": "d71d95c0476c46104bf15222516d4312", "name": "Start" } ], "created_on": "2024-02-19 07:44:44", "created_by": "user@servicenow.com", "operation": "130d51c0476c46104bf15222516d4368", "operation_name": "Provision" } ] ## Catálogo de serviços em nuvem - GET /now/cmp_catalog_api/status {#ariaid-title6} Retorna o status e os detalhes de um determinado RITM do catálogo (item da solicitação). Use este método para identificar e rastrear a origem da solicitação e monitorar seu fluxo. A resposta inclui o seguinte: 1. Número de RITM da solicitação enviada 2. A fase em que a solicitação está 3. Os usuários que abriram e estão atribuídos à solicitação 4. O grupo atribuído à solicitação 5. Quando a solicitação foi aberta 6. O estado em que a solicitação está 7. Dados de envio {#cs-catalog-GET-status__ol_rxn_n44_cbc} ### Formato da URL URL padrão: /api/now/cmp_catalog_api/status ### Parâmetros de solicitação compatíveis {#cs-catalog-GET-status__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 25. Parâmetros de caminho] {#cs-catalog-GET-status__entry__6} | Nome | Descrição | |-|-| | req_item | Número exclusivo do item da solicitação na tabela Item solicitado \[sc_req_item\]. Por exemplo, `RITM0000001`. Tipo de dados: cadeia de caracteres | [Tabela 26. Parâmetros de consulta] {#cs-catalog-GET-status__entry__10} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 27. Parâmetros do corpo da solicitação (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-status__entry__14}{#cs-catalog-GET-status__accept-RESTAPI} | 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 28. Cabeçalhos da solicitação] {#cs-catalog-GET-status__entry__18} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 29. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status 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 de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-GET-status__entry__22}{#cs-catalog-GET-status__entry-200-status-code}{#cs-catalog-GET-status__entry-400-status-code}{#cs-catalog-GET-status__entry-401-status-code}{#cs-catalog-GET-status__entry-403-status-code}{#cs-catalog-GET-status__entry-404-status-code}{#cs-catalog-GET-status__entry-405-status-code}{#cs-catalog-GET-status__entry-500-status-code} | 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. | | 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. | | 403 | Proibido. O usuário não tem direitos de acesso ao registro especificado. | | 404 | Não encontrado. O item solicitado não foi encontrado. | | 405 | Método inválido. A funcionalidade está desabilitada. | | 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. | [Tabela 30. Códigos de status] ### Parâmetros do corpo da resposta (JSON ou XML) {#cs-catalog-GET-status__entry__38} | Nome | Descrição | |-|-| | assignmentGroup | O grupo atribuído à solicitação. Tipo de dados: cadeia de caracteres | | assignedTo | O e-mail do usuário atribuído à solicitação. Tipo de dados: cadeia de caracteres | | catItem | sys_id da solicitação do item do catálogo. Localizado na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | erro | Uma mensagem com detalhes sobre um erro retornado. Possíveis mensagens de erro: * Registro não encontrado: o item da solicitação não existe. * Usuário não autenticado: as credenciais do usuário não estão autorizadas a fazer esta solicitação. Tipo de dados: cadeia de caracteres | | número | O número exclusivo do item da solicitação (RITM) fornecido ao novo item da solicitação. Localizado na tabela Item da solicitação \[sc_req_item\]. Tipo de dados: cadeia de caracteres | | openAt | Carimbo de data/hora de quando o item da solicitação foi aberto. Formato: aaaa-MM-dd HH:mm:ss. Tipo de data: cadeia de caracteres | | abertoPor | sys_id do usuário que abriu a solicitação. Tipo de dados: cadeia de caracteres | | fase | Fase de processamento atual do item da solicitação. Valores possíveis: * Tarefa Criada para o Usuário * Implantação Bem-sucedida * Aguardando aprovação de provisionamento * Limite de recursos excedido * Falha de Layout * Implantação Cancelada * Tentando Novamente a Implantação da Pilha * Implantação de Pilha {#cs-catalog-GET-status__ul_fg5_4l5_dcc} Tipo de dados: cadeia de caracteres | | estado | O estado de conclusão atual do item da solicitação. Valores possíveis: * Aberto * Trabalho em andamento * Encerradas concluídas * Encerrado incompleto * Encerrado ignorado * Pendente {#cs-catalog-GET-status__ul_o4x_4l5_dcc} Tipo de dados: cadeia de caracteres | | envioDados | Informações sobre o envio da solicitação, como conta na nuvem, local, aplicação e dados do centro de custos. Os dados de envio variam de acordo com o número do item da solicitação passado na solicitação. Tipo de dados: objeto "submissionData": "{\"key1\":\"value\", \"key2\":\"value\"}" } | | sys_id | sys_id do registro do item da solicitação. Localizado na tabela Item da solicitação \[sc_req_item\]. Tipo de dados: cadeia de caracteres | [ ] ### Solicitação de cURL O exemplo a seguir retorna informações de status para o número do item da solicitação, RITM0010076. curl "https://instance.servicenow.com/api/now/cmp_catalog_api/statusreq_item=RITM0010076" \ --request GET \ --header 'Accept: application/json' \ --user 'username':'password' Resposta: { "catItem": "39737024c390719005091d75e0013115", "stage": "Task Created for User", "sys_id": "ee1197db476cc2904bf15222516d439f", "assignedTo": null, "assignmentGroup": null, "number": "RITM0010072", "openedAt": "2024-02-29 18:32:55", "openedBy": "6816f79cc0a8016401c5a33be04be441", "state": "Open", "submissionData": "{\"CloudAccount\":\"AzureCA\",\"CSC_Azure_Functions_newResourceGroup\":\"test-rg-dnd\",\"CSC_Azure_Functions_runTimeVersion\":\"~18\",\"CSC_Azure_Functions_runTimeEngine\":\"node\",\"CSC_Azure_Functions_os\":\"Windows\",\"CSC_Azure_Functions_functionAppName\":\"sa02291029-fa\",\"LeaseEndDate\":\"2024-05-29 17:29:57\",\"ScheduleProfile\":\"-- No Schedule --\",\"UserGroup\":\"cfcbad03d711110050f5edcb9e61038f\",\"CSC_Azure_Functions_applicationName\":\"function-app\",\"ScheduleTimeZone\":\"America/Los_Angeles\",\"BusinessService\":\"\",\"environment\":\"Production\",\"CostCenter\":\"\",\"UseExistingWorkspace\":false,\"CSC_Azure_Functions_existingResourceGroup\":\"cpg-dnd\",\"CSC_Azure_Functions_isNewResourceGroup\":\"false\",\"CSC_Azure_Functions_storageAccountName\":\"sa02291029fasa\",\"Application\":\"\",\"StackName\":\"sa02291029\",\"Location\":\"Azure Datacenter - eastus\",\"Workspace\":\"\"}" } ## Catálogo de serviços em nuvem - POST /now/cmp_catalog_api/submitoprequest {#ariaid-title7} Envia uma solicitação de operação de recursos para executar operações de dia 2 em recursos provisionados. ### Formato da URL URL padrão: /api/now/cmp_catalog_api/submitoprequest ### Parâmetros de solicitação compatíveis {#cs-catalog-POST-submitoprequest__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 31. Parâmetros de caminho] {#cs-catalog-POST-submitoprequest__table_urr_lqw_cbc__entry__2} | Nome | Descrição | |-|-| | cat_id | Obrigatório. sys_id do item do catálogo na nuvem a ser invocado. Disponível na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | [Tabela 32. Parâmetros de consulta] {#cs-catalog-POST-submitoprequest__table_urr_lqw_cbc} {#cs-catalog-POST-submitoprequest__entry__10}{#cs-catalog-POST-submitoprequest__resource_block-ph-3} | Nome | Descrição | |-|-| | CloudAccount | Obrigatório. Nome da conta de nuvem na qual a solicitação será enviada. Os nomes de conta estão disponíveis na tabela Conta de nuvem \[cmdb_ci_cmp_cloud_account\]. Tipo de dados: cadeia de caracteres | | Local | Obrigatório. Local do datacenter no qual o recurso será provisionado. Por exemplo, `us-west-1` ou `asia-south-2`. Este valor deve corresponder ao local do datacenter do provedor de plataforma da conta na nuvem. Disponível na tabela Datacenter associado \[sn_cmp_ca_assc_datacenter\]. Tipo de dados: cadeia de caracteres | | StackName | Obrigatório. Nome da pilha. O nome da pilha é dinâmico e é refletido na gestão de recursos. Tipo de dados: cadeia de caracteres | | resourceId | Obrigatório. O sys_id do recurso em que as operações do Dia 2 serão executadas. Localizado na tabela Itens de pilha \[sn_cmp_stack_item\]. | | resource_block | Obrigatório. O nome do bloco de recursos do qual os itens do catálogo de operação de recursos relacionados serão obtidos (por exemplo, servidor virtual). Disponível na tabela Bloco de recursos \[sn_cmp_rb_resourceblock\]. Padrão: todos os itens do catálogo de todos os tipos de operação são retornados.{#cs-catalog-POST-submitoprequest__resource_block-ph-2} Tipo de dados: cadeia de caracteres | | operação_nome | Opcional. Nome da operação. Localizado na coluna Nome da interface do recurso na tabela OperationSignature \[sn_cmp_rb_op_signature\]. O nome da operação inserido depende do valor passado no parâmetro resourceBlock. Nota: Este parâmetro pode consultar parte ou toda a operação. Por exemplo, se você quiser listar todas as interfaces que começam com "ServiceNow", poderá definir a variável como `Operation_name = ServiceNow`. Padrão: todos os itens do catálogo de todos os tipos de operação são retornados.Tipo de dados: cadeia de caracteres | | interface de recurso | Obrigatório. O nome do bloco de recursos do qual os itens do catálogo de operação de recursos relacionados serão obtidos (por exemplo, servidor virtual). Disponível na tabela Bloco de recursos \[sn_cmp_rb_resourceblock\]. A interface do recurso que você insere depende do valor passado nos parâmetros resourceBlock e operation_name. Padrão: todos os itens do catálogo de todos os tipos de operação são retornados. Tipo de dados: cadeia de caracteres | [Tabela 33. Parâmetros do corpo da solicitação (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-POST-submitoprequest__entry__26}{#cs-catalog-POST-submitoprequest__accept-RESTAPI} | 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 34. Cabeçalhos da solicitação] {#cs-catalog-POST-submitoprequest__entry__30} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 35. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status 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 de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-POST-submitoprequest__table_xdr_41j_1bc__entry__2}{#cs-catalog-POST-submitoprequest__entry-200-status-code}{#cs-catalog-POST-submitoprequest__entry-400-status-code}{#cs-catalog-POST-submitoprequest__entry-401-status-code}{#cs-catalog-POST-submitoprequest__entry-403-status-code}{#cs-catalog-POST-submitoprequest__entry-404-status-code}{#cs-catalog-POST-submitoprequest__entry-405-status-code}{#cs-catalog-POST-submitoprequest__entry-500-status-code} | 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. | | 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. | | 403 | Proibido. O usuário não tem direitos de acesso ao registro especificado. | | 404 | Não encontrado. O item solicitado não foi encontrado. | | 405 | Método inválido. A funcionalidade está desabilitada. | | 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. | [Tabela 36. Códigos de status] {#cs-catalog-POST-submitoprequest__table_xdr_41j_1bc} ### Parâmetros do corpo da resposta (JSON ou XML) {#cs-catalog-POST-submitoprequest__section_fsy_vsw_cbc} {#cs-catalog-POST-submitoprequest__table_m3n_ndj_1bc__entry__2} | Nome | Descrição | |-|-| | assignmentGroup | O grupo atribuído à solicitação. Tipo de dados: cadeia de caracteres | | assignedTo | O e-mail do usuário atribuído à solicitação. Tipo de dados: cadeia de caracteres | | catItem | sys_id da solicitação do item do catálogo. Localizado na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | número | O número exclusivo do item da solicitação (RITM) fornecido ao novo item da solicitação. Localizado na tabela Item da solicitação \[sc_req_item\]. Tipo de dados: cadeia de caracteres | | openAt | Carimbo de data/hora de quando o item da solicitação foi aberto. Formato: aaaa-MM-dd HH:mm:ss. Tipo de data: cadeia de caracteres | | abertoPor | sys_id do usuário que abriu a solicitação. Tipo de dados: cadeia de caracteres | | fase | Fase de processamento atual do item da solicitação. Valores possíveis: * Tarefa Criada para o Usuário * Implantação Bem-sucedida * Aguardando aprovação de provisionamento * Limite de recursos excedido * Falha de Layout * Implantação Cancelada * Tentando Novamente a Implantação da Pilha * Implantação de Pilha {#cs-catalog-POST-submitoprequest__ul_fg5_4l5_dcc} Tipo de dados: cadeia de caracteres | | estado | O estado de conclusão atual do item da solicitação. Valores possíveis: * Aberto * Trabalho em andamento * Encerradas concluídas * Encerrado incompleto * Encerrado ignorado * Pendente {#cs-catalog-POST-submitoprequest__ul_o4x_4l5_dcc} Tipo de dados: cadeia de caracteres | | envioDados | Informações sobre o envio da solicitação, como conta na nuvem, local, aplicação e dados do centro de custos. Os dados de envio variam de acordo com o número do item da solicitação passado na solicitação. Tipo de dados: objeto "submissionData": "{\"key1\":\"value\", \"key2\":\"value\"}" } | | sys_id | sys_id do registro do item da solicitação. Localizado na tabela Item da solicitação \[sc_req_item\]. Tipo de dados: cadeia de caracteres | [ ] {#cs-catalog-POST-submitoprequest__table_m3n_ndj_1bc} O exemplo a seguir cria um item da solicitação de operação Dia 2. curl "https://instance.servicenow.com/api/now/cmp_catalog_api/submitoprequest?cat_id=e44dcd238731e5101126cbb4dabb3506" / --request POST\ --header 'Accept: application/json' \ --user 'username':'password' //Request body: {"StackName":"sa02292143","CloudAccount":"AWS","Location":"AWS Datacenter - us-east-1","resourceId":"df8c61e3eb2cc210d298fbbdbad0cd74","operationName":"Deprovision","resourceInterface":"S3 Interface","resourceBlock":"S3"} Corpo da resposta: { "number": "RITM0010078", "catItem": "e44dcd238731e5101126cbb4dabb3506", "stage": "request_approved", "sys_id": "9bf5cab3c3594610bc89b33605013190", "assignedTo": null, "assignmentGroup": null, "openedAt": "2024-04-08 09:08:47", "openedBy": "6816f79cc0a8016401c5a33be04be441", "state": "Open", "submissionData": "{\"StackName\":\"sa02292143\",\"CloudAccount\":\"AWS\",\"Location\":\"AWS Datacenter - us-east-1\",\"resourceId\":\"df8c61e3eb2cc210d298fbbdbad0cd74\",\"operationName\":\"Deprovision\",\"resourceInterface\":\"S3 Interface\",\"resourceBlock\":\"S3\"}" } Sample Request Body for CSC S3 Bucket Catalog Order: {"StackName":"sa02292143","CloudAccount":"AWS","Location":"AWS Datacenter - us-east-1","resourceId":"df8c61e3eb2cc210d298fbbdbad0cd74","operationName":"Deprovision","resourceInterface":"S3 Interface","resourceBlock":"S3"} ## Catálogo de serviços em nuvem - POST /now/cmp_catalog_api/submitrequest {#ariaid-title8} Envia uma solicitação de serviços em nuvem. Este método aceita solicitações provisionadas para operações de dia 2 e pilhas ou itens do catálogo de operação de recursos. ### Formato da URL URL padrão: /api/now/cmp_catalog_api/submitrequest ### Parâmetros de solicitação compatíveis {#cs-catalog-POST-submitrequest__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 37. Parâmetros de caminho] {#cs-catalog-POST-submitrequest__entry__6} | Nome | Descrição | |-|-| | cat_id | Obrigatório. sys_id do item do catálogo na nuvem a ser invocado. Disponível na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | [Tabela 38. Parâmetros de consulta] {#cs-catalog-POST-submitrequest__entry__10} | Nome | Descrição | |-|-| | CloudAccount | Obrigatório. Nome da conta de nuvem na qual a solicitação será enviada. Os nomes de conta estão disponíveis na tabela Conta de nuvem \[cmdb_ci_cmp_cloud_account\]. Tipo de dados: cadeia de caracteres | | Local | Obrigatório. Local do datacenter no qual o recurso será provisionado. Por exemplo, `us-west-1` ou `asia-south-2`. Este valor deve corresponder ao local do datacenter do provedor de plataforma da conta na nuvem. Disponível na tabela Datacenter associado \[sn_cmp_ca_assc_datacenter\]. Tipo de dados: cadeia de caracteres | | StackName | Obrigatório. Nome da pilha. O nome da pilha é dinâmico e é refletido na gestão de recursos. Tipo de dados: cadeia de caracteres | [Tabela 39. Parâmetros do corpo da solicitação (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-POST-submitrequest__entry__18}{#cs-catalog-POST-submitrequest__accept-RESTAPI} | 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 40. Cabeçalhos da solicitação] {#cs-catalog-POST-submitrequest__entry__22} | Cabeçalho | Descrição | |-|-| | Nenhum(a) | | [Tabela 41. Cabeçalhos de resposta] ### Códigos de status Os seguintes códigos de status 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 de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles."). {#cs-catalog-POST-submitrequest__table_xdr_41j_1bc__entry__2}{#cs-catalog-POST-submitrequest__entry-200-status-code}{#cs-catalog-POST-submitrequest__entry-400-status-code}{#cs-catalog-POST-submitrequest__entry-401-status-code}{#cs-catalog-POST-submitrequest__entry-403-status-code}{#cs-catalog-POST-submitrequest__entry-404-status-code}{#cs-catalog-POST-submitrequest__entry-405-status-code}{#cs-catalog-POST-submitrequest__entry-500-status-code} | 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. | | 401 | Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas. | | 403 | Proibido. O usuário não tem direitos de acesso ao registro especificado. | | 404 | Não encontrado. O item solicitado não foi encontrado. | | 405 | Método inválido. A funcionalidade está desabilitada. | | 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. | [Tabela 42. Códigos de status] {#cs-catalog-POST-submitrequest__table_xdr_41j_1bc} ### Parâmetros do corpo da resposta (JSON ou XML) {#cs-catalog-POST-submitrequest__table_m3n_ndj_1bc__entry__2} | Nome | Descrição | |-|-| | assignmentGroup | O grupo atribuído à solicitação. Tipo de dados: cadeia de caracteres | | assignedTo | O e-mail do usuário atribuído à solicitação. Tipo de dados: cadeia de caracteres | | catItem | sys_id da solicitação do item do catálogo. Localizado na tabela Item do catálogo na nuvem \[sn_cmp_bp_cat_item\]. Tipo de dados: cadeia de caracteres | | número | O número exclusivo do item da solicitação (RITM) fornecido ao novo item da solicitação. Localizado na tabela Item da solicitação \[sc_req_item\]. Tipo de dados: cadeia de caracteres | | openAt | Carimbo de data/hora de quando o item da solicitação foi aberto. Formato: aaaa-MM-dd HH:mm:ss. Tipo de data: cadeia de caracteres | | abertoPor | sys_id do usuário que abriu a solicitação. Tipo de dados: cadeia de caracteres | | fase | Fase de processamento atual do item da solicitação. Valores possíveis: * Tarefa Criada para o Usuário * Implantação Bem-sucedida * Aguardando aprovação de provisionamento * Limite de recursos excedido * Falha de Layout * Implantação Cancelada * Tentando Novamente a Implantação da Pilha * Implantação de Pilha {#cs-catalog-POST-submitrequest__ul_fg5_4l5_dcc} Tipo de dados: cadeia de caracteres | | estado | O estado de conclusão atual do item da solicitação. Valores possíveis: * Aberto * Trabalho em andamento * Encerradas concluídas * Encerrado incompleto * Encerrado ignorado * Pendente {#cs-catalog-POST-submitrequest__ul_o4x_4l5_dcc} Tipo de dados: cadeia de caracteres | | envioDados | Informações sobre o envio da solicitação, como conta na nuvem, local, aplicação e dados do centro de custos. Os dados de envio variam de acordo com o número do item da solicitação passado na solicitação. Tipo de dados: objeto "submissionData": "{\"key1\":\"value\", \"key2\":\"value\"}" } | | sys_id | sys_id do registro do item da solicitação. Localizado na tabela Item da solicitação \[sc_req_item\]. Tipo de dados: cadeia de caracteres | [ ] {#cs-catalog-POST-submitrequest__table_m3n_ndj_1bc} O exemplo a seguir envia uma solicitação de recurso de nuvem na conta de nuvem da AWS da instância. curl "https://instance.servicenow.com/api/now/cmp_catalog_api/submitrequest?cat_id=022e3deec3122910a769f44ed40131b9" / --request POST \ --header 'Accept: application/json' \ --user 'username':'password' //Request body: {"CloudAccount":"AWS","Location":"us-east-1","StackName":"ss"} Resposta: { "number": "RITM0010001", "catItem": "022e3deec3122910a769f44ed40131b9", "stage": "check_permissions", "sys_id": "86d34233c3594610bc89b336050131dd", "assignedTo": null, "assignmentGroup": null, "openedAt": "2024-04-08 08:59:25", "openedBy": "6816f79cc0a8016401c5a33be04be441", "state": "Open", "submissionData": "{\"CloudAccount\":\"AWS\",\"Location\":\"us-east-1\",\"StackName\":\"ss\"}" }