en	# 14 Configuration export/import
pt-br	# 14. Configuração exportação/importação

en	#### Overview Zabbix export/import functionality makes it possible to exchange various configuration entities between one Zabbix system and another. Typical use cases for this functionality: - share templates or network maps - Zabbix users may share their configuration parameters - upload a template to [Zabbix Community templates](https://github.com/zabbix/community-templates). Then others can download the template and import the file into Zabbix. - integrate with third-party tools - universal YAML, XML and JSON formats make integration and data import/export possible with third-party tools and applications
pt-br	#### Visão geral A funcionalidade de exportação/importação do Zabbix torna possível trocar várias entidades de configuração entre um sistema Zabbix e outro. Casos de uso típicos para essa funcionalidade: - compartilhar templates ou mapas de rede - os usuários do Zabbix podem compartilhar seus parâmetros de configuração - fazer upload de um template para o [Zabbix Community templates](https://github.com/zabbix/community-templates). Assim, outros podem baixar o template e importar o arquivo para o Zabbix. - integrar com ferramentas de terceiros - os formatos universais YAML, XML e JSON tornam possível a integração e a importação/exportação de dados com ferramentas e aplicações de terceiros

en	##### What can be exported/imported Objects that can be exported/imported are: - [Host groups](/manual/xml_export_import/hostgroups) (*through Zabbix API only*) - [Template groups](/manual/xml_export_import/templategroups) (*through Zabbix API only*) - [Templates](/manual/xml_export_import/templates) - [Hosts](/manual/xml_export_import/hosts) - [Network maps](/manual/xml_export_import/maps) - [Media types](/manual/xml_export_import/media) - Images
pt-br	##### O que pode ser exportado/importado Os objetos que podem ser exportados/importados são: - [Grupos de hosts](/manual/xml_export_import/hostgroups) (*apenas via Zabbix API*) - [Grupos de templates](/manual/xml_export_import/templategroups) (*apenas via Zabbix API*) - [Templates](/manual/xml_export_import/templates) - [Hosts](/manual/xml_export_import/hosts) - [Mapas de rede](/manual/xml_export_import/maps) - [Tipos de mídia](/manual/xml_export_import/media) - Imagens

en	##### Export format Data can be exported using the Zabbix web frontend or [Zabbix API](/manual/api/reference/configuration). Supported export formats are YAML, XML and JSON.
pt-br	##### Formato de exportação Os dados podem ser exportados usando o frontend da web Zabbix ou [Zabbix API](/manual/api/referência/configuração). Os formatos de exportação suportados são YAML, XML e JSON.

en	#### Details about export - All supported elements are exported in one file. - Host and template entities (items, triggers, graphs, discovery rules) that are inherited from linked templates are not exported. Any changes made to those entities on a host level (such as changed item interval, modified regular expression or added prototypes to the low-level discovery rule) will be lost when exporting; when importing, all entities from linked templates are re-created as on the original linked template. - Entities created by low-level discovery and any entities depending on them are not exported. For example, a trigger created for an LLD-rule generated item will not be exported. - When the exported host/template contains entities supporting timeouts, the timeout values will be exported if these entities have their own timeouts configured.
pt-br	#### Detalhes sobre a exportação - Todos os elementos suportados são exportados em um único arquivo. - As entidades de host e template (itens, triggers, gráficos, regras de descoberta) que são herdadas de templates vinculados não são exportadas. Quaisquer alterações feitas nessas entidades no nível do host (como alteração do intervalo do item, expressão regular modificada ou protótipos adicionados à regra de descoberta de baixo nível) serão perdidas ao exportar; ao importar, todas as entidades dos templates vinculados são recriadas conforme no template vinculado original. - Entidades criadas por descoberta de baixo nível e quaisquer entidades dependentes delas não são exportadas. Por exemplo, um trigger criado para um item gerado por uma regra LLD não será exportado. - Quando o host/template exportado contém entidades que suportam timeouts, os valores de timeout serão exportados se essas entidades tiverem seus próprios timeouts configurados.

en	#### Details about import - Import stops at the first error. - When updating existing images during image import, "imagetype" field is ignored, i.e., it is impossible to change image type via import. - When importing hosts/templates using the "Delete missing" option, host/template macros not present in the import file will be deleted from the host/template after the import. - Empty tags for items, triggers, graphs, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes are meaningless, i.e., it's the same as if it was missing. - If entities of the imported host/template have their own timeouts configured, they will be applied; otherwise, proxy/global timeouts will be applied. - Import supports YAML, XML and JSON, the import file must have a correct file extension: .yaml and .yml for YAML, .xml for XML and .json for JSON. See [compatibility information](/manual/appendix/compatibility) about supported XML versions. - Import supports configuration files only in UTF-8 encoding (with or without [BOM](https://en.wikipedia.org/wiki/Byte_order_mark)); other encodings (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) will result in an import conversion error.
pt-br	#### Detalhes sobre a importação - A importação é interrompida no primeiro erro. - Ao atualizar imagens existentes durante a importação de imagens, o campo "imagetype" é ignorado, ou seja, não é possível alterar o tipo de imagem via importação. - Ao importar hosts/templates usando a opção "Excluir ausentes", macros de host/template não presentes no arquivo de importação serão excluídas do host/template após a importação. - Tags vazias para items, triggers, gráficos, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes são irrelevantes, ou seja, é o mesmo que se estivessem ausentes. - Se as entidades do host/template importado tiverem seus próprios timeouts configurados, eles serão aplicados; caso contrário, os timeouts do proxy/global serão aplicados. - A importação suporta YAML, XML e JSON, o arquivo de importação deve ter a extensão correta: .yaml e .yml para YAML, .xml para XML e .json para JSON. Veja [informações de compatibilidade](/manual/appendix/compatibility) sobre as versões XML suportadas. - A importação suporta arquivos de configuração apenas na codificação UTF-8 (com ou sem [BOM](https://en.wikipedia.org/wiki/Byte_order_mark)); outras codificações (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) resultarão em erro de conversão de importação.

en	#### YAML base format The YAML export format contains the following nodes: - Root node for Zabbix YAML export - Export version ```yaml zabbix_export: version: '7.4' ``` Other nodes are dependent on exported objects.
pt-br	#### Formato base YAML O formato de exportação YAML contém os seguintes nós: - Nó raiz para exportação YAML do Zabbix - Versão da exportação ```yaml zabbix_export: version: '7.4' ``` Outros nós dependem dos objetos exportados.

en	#### XML format The XML export format contains the following tags: - Default header for XML documents - Root tag for Zabbix XML export - Export version ```xml <?xml version="1.0" encoding="UTF-8"?> <zabbix_export> <version>7.4</version> </zabbix_export> ``` Other tags are dependent on exported objects.
pt-br	#### Formato XML O formato de exportação XML contém as seguintes tags: - Cabeçalho padrão para documentos XML - Tag raiz para exportação XML do Zabbix - Versão da exportação ```xml <?xml version="1.0" encoding="UTF-8"?> <zabbix_export> <version>7.4</version> </zabbix_export> ``` Outras tags dependem dos objetos exportados.

en	#### JSON format The JSON export format contains the following objects: - Root object for Zabbix JSON export - Export version ```json { "zabbix_export": { "version": "7.4" } } ``` Other objects are dependent on exported objects.
pt-br	#### Formato JSON O formato de exportação JSON contém os seguintes objetos: - Objeto raiz para exportação JSON do Zabbix - Versão da exportação ```json { "zabbix_export": { "version": "7.4" } } ``` Outros objetos dependem dos objetos exportados.