Merge pull request #1340 from vyos/update-translations-master

Github: update translations

1 files changed, 124 insertions, 100 deletions

diff --git a/docs/_locale/ja/automation.pot b/docs/_locale/ja/automation.pot
index c6ec841f..3763fd50 100644
--- a/docs/_locale/ja/automation.pot
+++ b/docs/_locale/ja/automation.pot
@@ -49,7 +49,7 @@ msgstr "#terraform plan"
 msgid "#yes"
 msgstr "#yes"
 
-#: ../../automation/cloud-init.rst:363
+#: ../../automation/cloud-init.rst:366
 msgid "**NOTE**: be careful while copying and pasting previous commands. Double quotes may need to be corrected."
 msgstr "**NOTE**: be careful while copying and pasting previous commands. Double quotes may need to be corrected."
 
@@ -57,51 +57,51 @@ msgstr "**NOTE**: be careful while copying and pasting previous commands. Double
 msgid "**NOTE**: be carefull while copying and pasting previous commands. Doble quotes may need to be corrected."
 msgstr "**NOTE**: be carefull while copying and pasting previous commands. Doble quotes may need to be corrected."
 
-#: ../../automation/cloud-init.rst:305
+#: ../../automation/cloud-init.rst:308
 msgid "**meta-data**: empty file (required)."
 msgstr "**meta-data**: empty file (required)."
 
-#: ../../automation/cloud-init.rst:300
+#: ../../automation/cloud-init.rst:303
 msgid "**network-config**: file that will indicate to avoid dhcp client on first interface."
 msgstr "**network-config**: file that will indicate to avoid dhcp client on first interface."
 
-#: ../../automation/cloud-init.rst:333
+#: ../../automation/cloud-init.rst:336
 msgid "**network-config** file only has configuration that disables the automatic dhcp client on first interface."
 msgstr "**network-config** file only has configuration that disables the automatic dhcp client on first interface."
 
-#: ../../automation/cloud-init.rst:303
+#: ../../automation/cloud-init.rst:306
 msgid "**user-data**: includes vyos-commands."
 msgstr "**user-data**: includes vyos-commands."
 
-#: ../../automation/cloud-init.rst:314
+#: ../../automation/cloud-init.rst:317
 msgid "**user-data** file must start with ``#cloud-config`` and contains vyos-commands. For example:"
 msgstr "**user-data** file must start with ``#cloud-config`` and contains vyos-commands. For example:"
 
-#: ../../automation/vyos-api.rst:323
+#: ../../automation/vyos-api.rst:355
 msgid "/config-file"
 msgstr "/config-file"
 
-#: ../../automation/vyos-api.rst:266
+#: ../../automation/vyos-api.rst:298
 msgid "/configure"
 msgstr "/configure"
 
-#: ../../automation/vyos-api.rst:246
+#: ../../automation/vyos-api.rst:278
 msgid "/generate"
 msgstr "/generate"
 
-#: ../../automation/vyos-api.rst:184
+#: ../../automation/vyos-api.rst:216
 msgid "/image"
 msgstr "/image"
 
-#: ../../automation/vyos-api.rst:165
+#: ../../automation/vyos-api.rst:197
 msgid "/poweroff"
 msgstr "/poweroff"
 
-#: ../../automation/vyos-api.rst:147
+#: ../../automation/vyos-api.rst:179
 msgid "/reboot"
 msgstr "/reboot"
 
-#: ../../automation/vyos-api.rst:129
+#: ../../automation/vyos-api.rst:161
 msgid "/reset"
 msgstr "/reset"
 
@@ -109,7 +109,7 @@ msgstr "/reset"
 msgid "/retrieve"
 msgstr "/retrieve"
 
-#: ../../automation/vyos-api.rst:222
+#: ../../automation/vyos-api.rst:254
 msgid "/show"
 msgstr "/show"
 
@@ -342,7 +342,7 @@ msgstr "AWS"
 msgid "AWS_terraform_ansible_single_vyos_instance"
 msgstr "AWS_terraform_ansible_single_vyos_instance"
 
-#: ../../automation/cloud-init.rst:270
+#: ../../automation/cloud-init.rst:273
 msgid "A VyOS qcow image with cloud-init options is needed. This can be obtained using `vyos-vm-images`_ repo. After cloning the repo, edit the file **qemu.yml** and comment the **download-iso** role."
 msgstr "A VyOS qcow image with cloud-init options is needed. This can be obtained using `vyos-vm-images`_ repo. After cloning the repo, edit the file **qemu.yml** and comment the **download-iso** role."
 
@@ -350,7 +350,7 @@ msgstr "A VyOS qcow image with cloud-init options is needed. This can be obtaine
 msgid "A VyOS qcow image with cloud-init options is needed. This can be obtained using `vyos-vm-images`_ repo. After clonning the repo, edit the file **qemu.yml** and comment the **download-iso** role."
 msgstr "A VyOS qcow image with cloud-init options is needed. This can be obtained using `vyos-vm-images`_ repo. After clonning the repo, edit the file **qemu.yml** and comment the **download-iso** role."
 
-#: ../../automation/cloud-init.rst:63
+#: ../../automation/cloud-init.rst:64
 msgid "A cloud-config document is written in YAML. The file must begin with ``#cloud-config`` line. The only supported top-level keys are ``vyos_config_commands`` and ``write_files``. The use of these keys is described in the following two sections."
 msgstr "A cloud-config document is written in YAML. The file must begin with ``#cloud-config`` line. The only supported top-level keys are ``vyos_config_commands`` and ``write_files``. The use of these keys is described in the following two sections."
 
@@ -358,7 +358,7 @@ msgstr "A cloud-config document is written in YAML. The file must begin with ``#
 msgid "A simple example is shown below, where the ops command executed in the post-hook script is \"show interfaces\"."
 msgstr "A simple example is shown below, where the ops command executed in the post-hook script is \"show interfaces\"."
 
-#: ../../automation/cloud-init.rst:82
+#: ../../automation/cloud-init.rst:83
 msgid "A single-quote symbol is not allowed inside command or value."
 msgstr "A single-quote symbol is not allowed inside command or value."
 
@@ -378,6 +378,10 @@ msgstr "After executing all the commands you will have your VyOS instance on the
 msgid "After executing all the commands you will have your VyOS instance on the vSphere with your configuration, it's a very convenient desition. If you need to delete the instance please type the command:"
 msgstr "After executing all the commands you will have your VyOS instance on the vSphere with your configuration, it's a very convenient desition. If you need to delete the instance please type the command:"
 
+#: ../../automation/cloud-init.rst:92
+msgid "After the ``vyos_config_commands`` are executed, cloud-init will automatically  perform a ``commit`` and ``save`` operation."
+msgstr "After the ``vyos_config_commands`` are executed, cloud-init will automatically  perform a ``commit`` and ``save`` operation."
+
 #: ../../automation/vyos-api.rst:15
 msgid "All endpoints only listen on HTTP POST requests and the API KEY must set as ``key`` in the formdata."
 msgstr "All endpoints only listen on HTTP POST requests and the API KEY must set as ``key`` in the formdata."
@@ -388,7 +392,7 @@ msgstr "All endpoints only listen on HTTP POST requests and the API KEY must set
 msgid "All files about the article can be found here_"
 msgstr "All files about the article can be found here_"
 
-#: ../../automation/cloud-init.rst:115
+#: ../../automation/cloud-init.rst:119
 msgid "All of these can be overridden using the configuration in user-data."
 msgstr "All of these can be overridden using the configuration in user-data."
 
@@ -396,7 +400,7 @@ msgstr "All of these can be overridden using the configuration in user-data."
 msgid "Also, increase the time in the file instance.yml from 300 sec to 500 sec or more. (It depends on your location). Make sure that you have opened access to the instance in the security group."
 msgstr "Also, increase the time in the file instance.yml from 300 sec to 500 sec or more. (It depends on your location). Make sure that you have opened access to the instance in the security group."
 
-#: ../../automation/cloud-init.rst:256
+#: ../../automation/cloud-init.rst:259
 msgid "Also, this lab considers:"
 msgstr "Also, this lab considers:"
 
@@ -429,7 +433,7 @@ msgstr "Azure"
 msgid "Azure_terraform_ansible_single_vyos_instance"
 msgstr "Azure_terraform_ansible_single_vyos_instance"
 
-#: ../../automation/cloud-init.rst:241
+#: ../../automation/cloud-init.rst:244
 msgid "Before starting, please refer to cloud-init `network-config-docs`_ in order to know how to import user and network configurations."
 msgstr "Before starting, please refer to cloud-init `network-config-docs`_ in order to know how to import user and network configurations."
 
@@ -453,11 +457,11 @@ msgstr "Check that salt master can communicate with minions"
 msgid "Cloud-config modules"
 msgstr "Cloud-config modules"
 
-#: ../../automation/cloud-init.rst:420
+#: ../../automation/cloud-init.rst:423
 msgid "Cloud-init `network-config-docs`_."
 msgstr "Cloud-init `network-config-docs`_."
 
-#: ../../automation/cloud-init.rst:239
+#: ../../automation/cloud-init.rst:242
 msgid "Cloud-init on Proxmox"
 msgstr "Cloud-init on Proxmox"
 
@@ -465,7 +469,7 @@ msgstr "Cloud-init on Proxmox"
 msgid "Cloud and virtualized instances of VyOS are initialized using the industry-standard cloud-init. Via cloud-init, the system performs tasks such as injecting SSH keys and configuring the network. In addition, the user can supply a custom configuration at the time of instance launch."
 msgstr "Cloud and virtualized instances of VyOS are initialized using the industry-standard cloud-init. Via cloud-init, the system performs tasks such as injecting SSH keys and configuring the network. In addition, the user can supply a custom configuration at the time of instance launch."
 
-#: ../../automation/cloud-init.rst:120
+#: ../../automation/cloud-init.rst:124
 msgid "Command Execution at Initial Boot"
 msgstr "Command Execution at Initial Boot"
 
@@ -473,11 +477,11 @@ msgstr "Command Execution at Initial Boot"
 msgid "Command Scripting"
 msgstr "Command Scripting"
 
-#: ../../automation/cloud-init.rst:356
+#: ../../automation/cloud-init.rst:359
 msgid "Command for generating ``seed.iso``"
 msgstr "Command for generating ``seed.iso``"
 
-#: ../../automation/cloud-init.rst:78
+#: ../../automation/cloud-init.rst:79
 msgid "Commands requirements:"
 msgstr "Commands requirements:"
 
@@ -530,19 +534,19 @@ msgstr "Content"
 msgid "Content of commands.conf"
 msgstr "Content of commands.conf"
 
-#: ../../automation/cloud-init.rst:337
+#: ../../automation/cloud-init.rst:340
 msgid "Content of network-config file:"
 msgstr "Content of network-config file:"
 
-#: ../../automation/cloud-init.rst:351
+#: ../../automation/cloud-init.rst:354
 msgid "Create seed.iso"
 msgstr "Create seed.iso"
 
-#: ../../automation/cloud-init.rst:189
+#: ../../automation/cloud-init.rst:193
 msgid "Create text files named user-data and meta-data. On linux-based systems, the mkisofs utility can be used to create the seed ISO. The following syntax will add these files to the ISO 9660 file system."
 msgstr "Create text files named user-data and meta-data. On linux-based systems, the mkisofs utility can be used to create the seed ISO. The following syntax will add these files to the ISO 9660 file system."
 
-#: ../../automation/cloud-init.rst:368
+#: ../../automation/cloud-init.rst:371
 msgid "Creating the VM"
 msgstr "Creating the VM"
 
@@ -550,7 +554,7 @@ msgstr "Creating the VM"
 msgid "Custom scripts are not executed with root privileges (Use sudo inside if this is necessary)."
 msgstr "Custom scripts are not executed with root privileges (Use sudo inside if this is necessary)."
 
-#: ../../automation/cloud-init.rst:113
+#: ../../automation/cloud-init.rst:117
 msgid "DHCP on first Ethernet interface if no network configuration is provided."
 msgstr "DHCP on first Ethernet interface if no network configuration is provided."
 
@@ -634,11 +638,11 @@ msgstr "File contents of Terrafom for Azure"
 msgid "File contents of Terrafom for vSphere"
 msgstr "File contents of Terrafom for vSphere"
 
-#: ../../automation/cloud-init.rst:284
+#: ../../automation/cloud-init.rst:287
 msgid "File generated with previous command: ``/tmp/vyos-1.3.0-cloud-init-10G-qemu.qcow2``"
 msgstr "File generated with previous command: ``/tmp/vyos-1.3.0-cloud-init-10G-qemu.qcow2``"
 
-#: ../../automation/cloud-init.rst:347
+#: ../../automation/cloud-init.rst:350
 msgid "Finally, file **meta-data** has no content, but it's required."
 msgstr "Finally, file **meta-data** has no content, but it's required."
 
@@ -654,11 +658,15 @@ msgstr "For configuration/upgrade management issues, modification of this script
 msgid "For configuration and enabling the API see :ref:`http-api`"
 msgstr "For configuration and enabling the API see :ref:`http-api`"
 
+#: ../../automation/vyos-api.rst:130
+msgid "For example, check an existing path:"
+msgstr "For example, check an existing path:"
+
 #: ../../automation/vyos-api.rst:109
 msgid "For example, get the addresses of a ``dum0`` interface."
 msgstr "For example, get the addresses of a ``dum0`` interface."
 
-#: ../../automation/vyos-api.rst:226
+#: ../../automation/vyos-api.rst:258
 msgid "For example, show which images are installed."
 msgstr "For example, show which images are installed."
 
@@ -666,7 +674,11 @@ msgstr "For example, show which images are installed."
 msgid "For more information on the NoCloud data source, visit its `page <https://cloudinit.readthedocs.io/en/latest/reference/datasources/nocloud.html>`_ in the cloud-init documentation."
 msgstr "For more information on the NoCloud data source, visit its `page <https://cloudinit.readthedocs.io/en/latest/reference/datasources/nocloud.html>`_ in the cloud-init documentation."
 
-#: ../../automation/cloud-init.rst:411
+#: ../../automation/cloud-init.rst:221
+msgid "For more information on the NoCloud data source, visit its page `nocloud`_ in the cloud-init documentation."
+msgstr "For more information on the NoCloud data source, visit its page `nocloud`_ in the cloud-init documentation."
+
+#: ../../automation/cloud-init.rst:414
 msgid "From cli or GUI, power on VM, and after it boots, verify configuration"
 msgstr "From cli or GUI, power on VM, and after it boots, verify configuration"
 
@@ -678,7 +690,7 @@ msgstr "General commands that we will use for running Terraform scripts"
 msgid "Generate Object"
 msgstr "Generate Object"
 
-#: ../../automation/cloud-init.rst:268
+#: ../../automation/cloud-init.rst:271
 msgid "Generate qcow image"
 msgstr "Generate qcow image"
 
@@ -690,7 +702,7 @@ msgstr "Getting Started"
 msgid "Here is a simple example:"
 msgstr "Here is a simple example:"
 
-#: ../../automation/cloud-init.rst:91
+#: ../../automation/cloud-init.rst:95
 msgid "Here is an example cloud-config that appends configuration at the time of first boot."
 msgstr "Here is an example cloud-config that appends configuration at the time of first boot."
 
@@ -710,23 +722,23 @@ msgstr "How to create a single instance and install your configuration using Ter
 msgid "How to create a single instance and install your configuration using Terraform+Ansible+vSphere Step by step:"
 msgstr "How to create a single instance and install your configuration using Terraform+Ansible+vSphere Step by step:"
 
-#: ../../automation/cloud-init.rst:377
+#: ../../automation/cloud-init.rst:380
 msgid "ISO files storage: ``local`` volume is used for ``.iso`` file storage. In this scenario ``local`` volume type is set to **directory**, abd attached to ``/var/lib/vz``."
 msgstr "ISO files storage: ``local`` volume is used for ``.iso`` file storage. In this scenario ``local`` volume type is set to **directory**, abd attached to ``/var/lib/vz``."
 
-#: ../../automation/cloud-init.rst:81
+#: ../../automation/cloud-init.rst:82
 msgid "If command ends in a value, it must be inside single quotes."
 msgstr "If command ends in a value, it must be inside single quotes."
 
-#: ../../automation/cloud-init.rst:250
+#: ../../automation/cloud-init.rst:253
 msgid "If no networking configuration is provided, then dhcp client is going to be enabled on first interface. Bare in mind that this configuration will be inyected at an OS level, so don't expect to find dhcp client configuration on vyos cli. Because of this behavior, in next example lab we will disable dhcp-client configuration on eth0."
 msgstr "If no networking configuration is provided, then dhcp client is going to be enabled on first interface. Bare in mind that this configuration will be inyected at an OS level, so don't expect to find dhcp client configuration on vyos cli. Because of this behavior, in next example lab we will disable dhcp-client configuration on eth0."
 
-#: ../../automation/cloud-init.rst:225
+#: ../../automation/cloud-init.rst:228
 msgid "If you encounter problems, verify that the cloud-config document contains valid YAML. Online resources such as https://www.yamllint.com/ provide a simple tool for validating YAML."
 msgstr "If you encounter problems, verify that the cloud-config document contains valid YAML. Online resources such as https://www.yamllint.com/ provide a simple tool for validating YAML."
 
-#: ../../automation/cloud-init.rst:153
+#: ../../automation/cloud-init.rst:157
 msgid "If you need to gather information from linux commands to configure VyOS, you can execute commands and then configure VyOS in the same script."
 msgstr "If you need to gather information from linux commands to configure VyOS, you can execute commands and then configure VyOS in the same script."
 
@@ -738,7 +750,7 @@ msgstr "If you want to script the configs in a language other than bash you can
 msgid "Importing and Disabling Warnings for verify=False"
 msgstr "Importing and Disabling Warnings for verify=False"
 
-#: ../../automation/cloud-init.rst:298
+#: ../../automation/cloud-init.rst:301
 msgid "In Proxmox server three files are going to be used for this setup:"
 msgstr "In Proxmox server three files are going to be used for this setup:"
 
@@ -758,15 +770,15 @@ msgstr "In this case, we'll create the necessary files for Terraform and Ansible
 msgid "In this case, we'll create the necessary files for Terraform and Ansible next using Terraform we'll create a single instance on the vSphere cloud and make provisioning using Ansible."
 msgstr "In this case, we'll create the necessary files for Terraform and Ansible next using Terraform we'll create a single instance on the vSphere cloud and make provisioning using Ansible."
 
-#: ../../automation/cloud-init.rst:307
+#: ../../automation/cloud-init.rst:310
 msgid "In this lab, all files are located in ``/tmp/``. So, before going on, lets move to that directory:"
 msgstr "In this lab, all files are located in ``/tmp/``. So, before going on, lets move to that directory:"
 
-#: ../../automation/cloud-init.rst:274
+#: ../../automation/cloud-init.rst:277
 msgid "In this lab, we are using 1.3.0 VyOS version and setting a disk of 10G. Download VyOS .iso file and save it as ``/tmp/vyos.iso``. Command used for generating qcow image:"
 msgstr "In this lab, we are using 1.3.0 VyOS version and setting a disk of 10G. Download VyOS .iso file and save it as ``/tmp/vyos.iso``. Command used for generating qcow image:"
 
-#: ../../automation/cloud-init.rst:71
+#: ../../automation/cloud-init.rst:72
 msgid "Initial Configuration"
 msgstr "Initial Configuration"
 
@@ -774,7 +786,7 @@ msgstr "Initial Configuration"
 msgid "Initializing a VyDevice Object"
 msgstr "Initializing a VyDevice Object"
 
-#: ../../automation/cloud-init.rst:180
+#: ../../automation/cloud-init.rst:184
 msgid "Injecting configuration data is not limited to cloud platforms. Users can employ the NoCloud data source to inject user-data and meta-data on virtualization platforms such as VMware, Hyper-V and KVM."
 msgstr "Injecting configuration data is not limited to cloud platforms. Users can employ the NoCloud data source to inject user-data and meta-data on virtualization platforms such as VMware, Hyper-V and KVM."
 
@@ -802,7 +814,7 @@ msgstr "Make sure that Ansible is pinging from Terrafom."
 msgid "Metadata - Metadata is sourced by the cloud platform or hypervisor. In some clouds, there is implemented as an HTTP endpoint at ``http://169.254.169.254``."
 msgstr "Metadata - Metadata is sourced by the cloud platform or hypervisor. In some clouds, there is implemented as an HTTP endpoint at ``http://169.254.169.254``."
 
-#: ../../automation/cloud-init.rst:244
+#: ../../automation/cloud-init.rst:247
 msgid "Most important keys that needs to be considered:"
 msgstr "Most important keys that needs to be considered:"
 
@@ -830,11 +842,11 @@ msgstr "Network Topology Diagram"
 msgid "Network configuration - This config source informs the system about the network settings like IP addresses, routes, DNS. Available only in several cloud and virtualization platforms."
 msgstr "Network configuration - This config source informs the system about the network settings like IP addresses, routes, DNS. Available only in several cloud and virtualization platforms."
 
-#: ../../automation/cloud-init.rst:248
+#: ../../automation/cloud-init.rst:251
 msgid "Networking configurations shouldn't be passed in user-data file."
 msgstr "Networking configurations shouldn't be passed in user-data file."
 
-#: ../../automation/cloud-init.rst:178
+#: ../../automation/cloud-init.rst:182
 msgid "NoCloud"
 msgstr "NoCloud"
 
@@ -843,15 +855,15 @@ msgstr "NoCloud"
 msgid "Nornir"
 msgstr "Nornir"
 
-#: ../../automation/cloud-init.rst:131
+#: ../../automation/cloud-init.rst:135
 msgid "Note that the /opt/vyatta/etc/config is used instead of the /config/scripts directory referenced in the :ref:`command-scripting` section of the documentation because the /config/script directory isn't mounted when the ``write_files`` module executes."
 msgstr "Note that the /opt/vyatta/etc/config is used instead of the /config/scripts directory referenced in the :ref:`command-scripting` section of the documentation because the /config/script directory isn't mounted when the ``write_files`` module executes."
 
-#: ../../automation/cloud-init.rst:370
+#: ../../automation/cloud-init.rst:373
 msgid "Notes for this particular example, that may need to be modified in other setups:"
 msgstr "Notes for this particular example, that may need to be modified in other setups:"
 
-#: ../../automation/cloud-init.rst:287
+#: ../../automation/cloud-init.rst:290
 msgid "Now, that file needs to be copied to proxmox server:"
 msgstr "Now, that file needs to be copied to proxmox server:"
 
@@ -859,15 +871,15 @@ msgstr "Now, that file needs to be copied to proxmox server:"
 msgid "On VyOS this will cause the following problem: After modifying the configuration via script like this once, it is not possible to manually modify the config anymore:"
 msgstr "On VyOS this will cause the following problem: After modifying the configuration via script like this once, it is not possible to manually modify the config anymore:"
 
-#: ../../automation/cloud-init.rst:390
+#: ../../automation/cloud-init.rst:393
 msgid "On proxmox server:"
 msgstr "On proxmox server:"
 
-#: ../../automation/cloud-init.rst:353
+#: ../../automation/cloud-init.rst:356
 msgid "Once the three files were created, it's time to generate the ``seed.iso`` image, which needs to be mounted to the new VM as a cd."
 msgstr "Once the three files were created, it's time to generate the ``seed.iso`` image, which needs to be mounted to the new VM as a cd."
 
-#: ../../automation/cloud-init.rst:80
+#: ../../automation/cloud-init.rst:81
 msgid "One command per line."
 msgstr "One command per line."
 
@@ -896,7 +908,7 @@ msgstr "Please take a look at the Contributing Guide for our :ref:`documentation
 msgid "Postconfig on boot"
 msgstr "Postconfig on boot"
 
-#: ../../automation/cloud-init.rst:409
+#: ../../automation/cloud-init.rst:412
 msgid "Power on VM and verifications"
 msgstr "Power on VM and verifications"
 
@@ -916,15 +928,15 @@ msgstr "Preparation steps for deploying VyOS on Azure"
 msgid "Preparation steps for deploying VyOS on vSphere"
 msgstr "Preparation steps for deploying VyOS on vSphere"
 
-#: ../../automation/cloud-init.rst:296
+#: ../../automation/cloud-init.rst:299
 msgid "Prepare cloud-init files"
 msgstr "Prepare cloud-init files"
 
-#: ../../automation/cloud-init.rst:258
+#: ../../automation/cloud-init.rst:261
 msgid "Proxmox IP address: **192.168.0.253/24**"
 msgstr "Proxmox IP address: **192.168.0.253/24**"
 
-#: ../../automation/cloud-init.rst:422
+#: ../../automation/cloud-init.rst:425
 msgid "Proxmox `Cloud-init-Support`_."
 msgstr "Proxmox `Cloud-init-Support`_."
 
@@ -936,11 +948,11 @@ msgstr "PyVyOS"
 msgid "PyVyOS is a Python library for interacting with VyOS devices via their API. This documentation guides you on using PyVyOS to manage your VyOS devices programmatically. The complete PyVyOS documentation is available on [Read the Docs](https://pyvyos.readthedocs.io/en/latest/), and the library can be found on [GitHub](https://github.com/robertoberto/pyvyos) and [PyPI](https://pypi.org/project/pyvyos/)."
 msgstr "PyVyOS is a Python library for interacting with VyOS devices via their API. This documentation guides you on using PyVyOS to manage your VyOS devices programmatically. The complete PyVyOS documentation is available on [Read the Docs](https://pyvyos.readthedocs.io/en/latest/), and the library can be found on [GitHub](https://github.com/robertoberto/pyvyos) and [PyPI](https://pypi.org/project/pyvyos/)."
 
-#: ../../automation/cloud-init.rst:416
+#: ../../automation/cloud-init.rst:419
 msgid "References"
 msgstr "References"
 
-#: ../../automation/cloud-init.rst:263
+#: ../../automation/cloud-init.rst:266
 msgid "Remove default dhcp client on first interface, and load other configuration during first boot, using cloud-init."
 msgstr "Remove default dhcp client on first interface, and load other configuration during first boot, using cloud-init."
 
@@ -968,7 +980,7 @@ msgstr "Run configuration commands"
 msgid "Run operational commands"
 msgstr "Run operational commands"
 
-#: ../../automation/cloud-init.rst:111
+#: ../../automation/cloud-init.rst:115
 msgid "SSH is configured on port 22."
 msgstr "SSH is configured on port 22."
 
@@ -980,11 +992,11 @@ msgstr "Salt"
 msgid "Salt master configuration:"
 msgstr "Salt master configuration:"
 
-#: ../../automation/vyos-api.rst:345
+#: ../../automation/vyos-api.rst:377
 msgid "Save a running configuration to a file."
 msgstr "Save a running configuration to a file."
 
-#: ../../automation/vyos-api.rst:327
+#: ../../automation/vyos-api.rst:359
 msgid "Save a running configuration to the startup configuration. When you don't specify the file when saving, it saves to ``/config/config.boot``."
 msgstr "Save a running configuration to the startup configuration. When you don't specify the file when saving, it saves to ``/config/config.boot``."
 
@@ -1030,7 +1042,7 @@ msgstr "Start"
 msgid "Start creating an AWS instance and check the result"
 msgstr "Start creating an AWS instance and check the result"
 
-#: ../../automation/cloud-init.rst:260
+#: ../../automation/cloud-init.rst:263
 msgid "Storaged used: volume local, which is mounted on directory **/var/lib/vz**, and contains all type of content, including snippets."
 msgstr "Storaged used: volume local, which is mounted on directory **/var/lib/vz**, and contains all type of content, including snippets."
 
@@ -1081,7 +1093,7 @@ msgstr "Structure of files Terrafom for vSphere"
 msgid "Structure of files in the standard Terraform project:"
 msgstr "Structure of files in the standard Terraform project:"
 
-#: ../../automation/cloud-init.rst:107
+#: ../../automation/cloud-init.rst:111
 msgid "System Defaults/Fallbacks"
 msgstr "System Defaults/Fallbacks"
 
@@ -1099,7 +1111,7 @@ msgstr "Terraform doesn't connect via SSH to your Ansible instance: you have to
 msgid "Terraform for VyOS"
 msgstr "Terraform for VyOS"
 
-#: ../../automation/vyos-api.rst:302
+#: ../../automation/vyos-api.rst:334
 msgid "The API pushes every request to a session and commit it. But some of VyOS components like DHCP and PPPoE Servers, IPSec, VXLAN, and other tunnels require full configuration for commit. The endpoint will process multiple commands when you pass them as a list to the ``data`` field."
 msgstr "The API pushes every request to a session and commit it. But some of VyOS components like DHCP and PPPoE Servers, IPSec, VXLAN, and other tunnels require full configuration for commit. The endpoint will process multiple commands when you pass them as a list to the ``data`` field."
 
@@ -1111,23 +1123,23 @@ msgstr "The ``/config/scripts/vyos-postconfig-bootup.script`` script is called o
 msgid "The ``/config/scripts/vyos-preconfig-bootup.script`` script is called on boot before the VyOS configuration during boot process."
 msgstr "The ``/config/scripts/vyos-preconfig-bootup.script`` script is called on boot before the VyOS configuration during boot process."
 
-#: ../../automation/vyos-api.rst:224
+#: ../../automation/vyos-api.rst:256
 msgid "The ``/show`` endpoint is to show everything in the operational mode."
 msgstr "The ``/show`` endpoint is to show everything in the operational mode."
 
-#: ../../automation/vyos-api.rst:248
+#: ../../automation/vyos-api.rst:280
 msgid "The ``generate`` endpoint run a ``generate`` command."
 msgstr "The ``generate`` endpoint run a ``generate`` command."
 
-#: ../../automation/vyos-api.rst:131
+#: ../../automation/vyos-api.rst:163
 msgid "The ``reset`` endpoint run a ``reset`` command."
 msgstr "The ``reset`` endpoint run a ``reset`` command."
 
-#: ../../automation/cloud-init.rst:84
+#: ../../automation/cloud-init.rst:85
 msgid "The commands list produced by the ``show configuration commands`` command on a VyOS router should comply with all the requirements, so it is easy to get a proper commands list by copying it from another router."
 msgstr "The commands list produced by the ``show configuration commands`` command on a VyOS router should comply with all the requirements, so it is easy to get a proper commands list by copying it from another router."
 
-#: ../../automation/cloud-init.rst:88
+#: ../../automation/cloud-init.rst:89
 msgid "The configuration specified in the cloud-config document overwrites default configuration values and values configured via Metadata."
 msgstr "The configuration specified in the cloud-config document overwrites default configuration values and values configured via Metadata."
 
@@ -1144,23 +1156,23 @@ msgstr "The default file looks like this:"
 msgid "The easiest way to configure the system via user-data is the Cloud-config syntax described below."
 msgstr "The easiest way to configure the system via user-data is the Cloud-config syntax described below."
 
-#: ../../automation/vyos-api.rst:325
+#: ../../automation/vyos-api.rst:357
 msgid "The endpoint ``/config-file`` is to save or load a configuration."
 msgstr "The endpoint ``/config-file`` is to save or load a configuration."
 
-#: ../../automation/cloud-init.rst:156
+#: ../../automation/cloud-init.rst:160
 msgid "The following example sets the hostname based on the instance identifier obtained from the EC2 metadata service."
 msgstr "The following example sets the hostname based on the instance identifier obtained from the EC2 metadata service."
 
-#: ../../automation/cloud-init.rst:136
+#: ../../automation/cloud-init.rst:140
 msgid "The following example shows how to execute commands after the initial configuration."
 msgstr "The following example shows how to execute commands after the initial configuration."
 
-#: ../../automation/cloud-init.rst:74
+#: ../../automation/cloud-init.rst:75
 msgid "The key used to designate a VyOS configuration is ``vyos_config_commands``. What follows is VyOS configuration using the \"set-style\" syntax. Both \"set\" and \"delete\" commands are supported."
 msgstr "The key used to designate a VyOS configuration is ``vyos_config_commands``. What follows is VyOS configuration using the \"set-style\" syntax. Both \"set\" and \"delete\" commands are supported."
 
-#: ../../automation/cloud-init.rst:197
+#: ../../automation/cloud-init.rst:201
 msgid "The seed.iso file can be attached to the virtual machine. As an example, the method with KVM to attach the ISO as a CD drive follows."
 msgstr "The seed.iso file can be attached to the virtual machine. As an example, the method with KVM to attach the ISO as a CD drive follows."
 
@@ -1168,7 +1180,7 @@ msgstr "The seed.iso file can be attached to the virtual machine. As an example,
 msgid "There is a pitfall when working with configuration scripts. It is tempting to call configuration scripts with \"sudo\" (i.e., temporary root permissions), because that's the common way on most Linux platforms to call system commands."
 msgstr "There is a pitfall when working with configuration scripts. It is tempting to call configuration scripts with \"sudo\" (i.e., temporary root permissions), because that's the common way on most Linux platforms to call system commands."
 
-#: ../../automation/cloud-init.rst:109
+#: ../../automation/cloud-init.rst:113
 msgid "These are the VyOS defaults and fallbacks."
 msgstr "These are the VyOS defaults and fallbacks."
 
@@ -1180,11 +1192,11 @@ msgstr "This section needs improvements, examples and explanations."
 msgid "This will result in the following error message: ``Set failed`` If this happens, a reboot is required to be able to edit the config manually again."
 msgstr "This will result in the following error message: ``Set failed`` If this happens, a reboot is required to be able to edit the config manually again."
 
-#: ../../automation/vyos-api.rst:361
+#: ../../automation/vyos-api.rst:393
 msgid "To Load a configuration file."
 msgstr "To Load a configuration file."
 
-#: ../../automation/vyos-api.rst:186
+#: ../../automation/vyos-api.rst:218
 msgid "To add or delete an image, use the ``/image`` endpoint."
 msgstr "To add or delete an image, use the ``/image`` endpoint."
 
@@ -1192,6 +1204,10 @@ msgstr "To add or delete an image, use the ``/image`` endpoint."
 msgid "To avoid these problems, the proper way is to call a script with the ``vyattacfg`` group, e.g., by using the ``sg`` (switch group) command:"
 msgstr "To avoid these problems, the proper way is to call a script with the ``vyattacfg`` group, e.g., by using the ``sg`` (switch group) command:"
 
+#: ../../automation/vyos-api.rst:128
+msgid "To check existence of a configuration path, use the ``exists`` operation."
+msgstr "To check existence of a configuration path, use the ``exists`` operation."
+
 #: ../../automation/vyos-api.rst:48
 msgid "To get the whole configuration, pass an empty list to the ``path`` field"
 msgstr "To get the whole configuration, pass an empty list to the ``path`` field"
@@ -1200,7 +1216,7 @@ msgstr "To get the whole configuration, pass an empty list to the ``path`` field
 msgid "To include VyOS specific functions and aliases you need to ``source /opt/vyatta/etc/functions/script-template`` files at the top of your script."
 msgstr "To include VyOS specific functions and aliases you need to ``source /opt/vyatta/etc/functions/script-template`` files at the top of your script."
 
-#: ../../automation/vyos-api.rst:149
+#: ../../automation/vyos-api.rst:181
 msgid "To initiate a reboot use the ``reboot`` endpoint."
 msgstr "To initiate a reboot use the ``reboot`` endpoint."
 
@@ -1212,11 +1228,11 @@ msgstr "To make sure that a script is not accidentally called without the ``vyat
 msgid "To only get a part of the configuration, for example ``system syslog``."
 msgstr "To only get a part of the configuration, for example ``system syslog``."
 
-#: ../../automation/vyos-api.rst:167
+#: ../../automation/vyos-api.rst:199
 msgid "To power off the system use the ``poweroff`` endpoint."
 msgstr "To power off the system use the ``poweroff`` endpoint."
 
-#: ../../automation/cloud-init.rst:223
+#: ../../automation/cloud-init.rst:226
 #: ../../automation/terraform/terraformAWS.rst:264
 msgid "Troubleshooting"
 msgstr "Troubleshooting"
@@ -1236,6 +1252,10 @@ msgid "User-data"
 msgstr "User-data"
 
 #: ../../automation/cloud-init.rst:28
+msgid "User-data - User-data is specified by the user. This config source offers the ability to insert any CLI configuration commands into the configuration before   the first boot."
+msgstr "User-data - User-data is specified by the user. This config source offers the ability to insert any CLI configuration commands into the configuration before   the first boot."
+
+#: ../../automation/cloud-init.rst:28
 msgid "User-data - User-data is specified by the user. This config source offers the ability to insert any CLI configuration commands into the configuration before the first boot."
 msgstr "User-data - User-data is specified by the user. This config source offers the ability to insert any CLI configuration commands into the configuration before the first boot."
 
@@ -1251,15 +1271,15 @@ msgstr "Using PyVyOS"
 msgid "Using pyvyos"
 msgstr "Using pyvyos"
 
-#: ../../automation/cloud-init.rst:373
+#: ../../automation/cloud-init.rst:376
 msgid "VM ID: in this example, VM ID used is 555."
 msgstr "VM ID: in this example, VM ID used is 555."
 
-#: ../../automation/cloud-init.rst:381
+#: ../../automation/cloud-init.rst:384
 msgid "VM Resources: these parameters can be modified as needed."
 msgstr "VM Resources: these parameters can be modified as needed."
 
-#: ../../automation/cloud-init.rst:375
+#: ../../automation/cloud-init.rst:378
 msgid "VM Storage: ``local`` volume is used."
 msgstr "VM Storage: ``local`` volume is used."
 
@@ -1279,7 +1299,7 @@ msgstr "VyOS Automation"
 msgid "VyOS Terraform"
 msgstr "VyOS Terraform"
 
-#: ../../automation/cloud-init.rst:418
+#: ../../automation/cloud-init.rst:421
 msgid "VyOS `cloud-init-docs`_."
 msgstr "VyOS `cloud-init-docs`_."
 
@@ -1287,7 +1307,7 @@ msgstr "VyOS `cloud-init-docs`_."
 msgid "VyOS cloud-init"
 msgstr "VyOS cloud-init"
 
-#: ../../automation/cloud-init.rst:246
+#: ../../automation/cloud-init.rst:249
 msgid "VyOS configuration commands are defined in user-data file."
 msgstr "VyOS configuration commands are defined in user-data file."
 
@@ -1331,7 +1351,7 @@ msgstr "VyOS supports op-mode and configuration via salt_."
 msgid "VyOS supports some napalm_ functions for configuration and op-mode. It requires more tests."
 msgstr "VyOS supports some napalm_ functions for configuration and op-mode. It requires more tests."
 
-#: ../../automation/cloud-init.rst:122
+#: ../../automation/cloud-init.rst:126
 msgid "VyOS supports the execution of operational commands and linux commands at initial boot. This is accomplished using ``write_files`` to certain files in the /opt/vyatta/etc/config/scripts directory. Commands specified in opt/vyatta/etc/config/scripts/vyos-preconfig-bootup.script are executed prior to configuration. The /opt/vyatta/etc/config/scripts/vyos-postconfig-bootup.script file contains commands to be executed after configuration. In both cases, commands are executed as the root user."
 msgstr "VyOS supports the execution of operational commands and linux commands at initial boot. This is accomplished using ``write_files`` to certain files in the /opt/vyatta/etc/config/scripts directory. Commands specified in opt/vyatta/etc/config/scripts/vyos-preconfig-bootup.script are executed prior to configuration. The /opt/vyatta/etc/config/scripts/vyos-postconfig-bootup.script file contains commands to be executed after configuration. In both cases, commands are executed as the root user."
 
@@ -1339,7 +1359,7 @@ msgstr "VyOS supports the execution of operational commands and linux commands a
 msgid "We need 2 files, commands.conf and script itself."
 msgstr "We need 2 files, commands.conf and script itself."
 
-#: ../../automation/cloud-init.rst:184
+#: ../../automation/cloud-init.rst:188
 msgid "While other methods exist, the most straightforward method for using the NoCloud data source is creating a seed ISO and attaching it to the virtual machine as a CD drive. The volume must be formatted as a vfat or ISO 9660 file system with the label \"cidata\" or \"CIDATA\"."
 msgstr "While other methods exist, the most straightforward method for using the NoCloud data source is creating a seed ISO and attaching it to the virtual machine as a CD drive. The volume must be formatted as a vfat or ISO 9660 file system with the label \"cidata\" or \"CIDATA\"."
 
@@ -1391,27 +1411,27 @@ msgstr "You can install PyVyOS using pip:"
 msgid "You can install pyvyos using pip:"
 msgstr "You can install pyvyos using pip:"
 
-#: ../../automation/vyos-api.rst:268
+#: ../../automation/vyos-api.rst:300
 msgid "You can pass a ``set``, ``delete`` or ``comment`` command to the ``/configure`` endpoint."
 msgstr "You can pass a ``set``, ``delete`` or ``comment`` command to the ``/configure`` endpoint."
 
-#: ../../automation/vyos-api.rst:287
+#: ../../automation/vyos-api.rst:319
 msgid "``delete`` a single command"
 msgstr "``delete`` a single command"
 
-#: ../../automation/cloud-init.rst:383
+#: ../../automation/cloud-init.rst:386
 msgid "``seed.iso`` was previously created in directory ``/tmp/``. It's necessary to move it to ``/var/lib/vz/template/iso``"
 msgstr "``seed.iso`` was previously created in directory ``/tmp/``. It's necessary to move it to ``/var/lib/vz/template/iso``"
 
-#: ../../automation/vyos-api.rst:271
+#: ../../automation/vyos-api.rst:303
 msgid "``set`` a single command"
 msgstr "``set`` a single command"
 
-#: ../../automation/cloud-init.rst:55
+#: ../../automation/cloud-init.rst:56
 msgid "``vyos_userdata`` - the module accepts a list of CLI configuration commands in a ``vyos_config_commands`` section, which gives an easy way to configure the system during deployment."
 msgstr "``vyos_userdata`` - the module accepts a list of CLI configuration commands in a ``vyos_config_commands`` section, which gives an easy way to configure the system during deployment."
 
-#: ../../automation/cloud-init.rst:112
+#: ../../automation/cloud-init.rst:116
 msgid "``vyos``/``vyos`` credentials if no others specified by data source."
 msgstr "``vyos``/``vyos`` credentials if no others specified by data source."
 
@@ -1431,7 +1451,7 @@ msgstr "`pyvyos Source Code on GitHub <https://github.com/robertoberto/pyvyos>`_
 msgid "`pyvyos on PyPI <https://pypi.org/project/pyvyos/>`_ for easy installation via pip, the Python package installer. Execute `pip install pyvyos` in your terminal to install."
 msgstr "`pyvyos on PyPI <https://pypi.org/project/pyvyos/>`_ for easy installation via pip, the Python package installer. Execute `pip install pyvyos` in your terminal to install."
 
-#: ../../automation/vyos-api.rst:188
+#: ../../automation/vyos-api.rst:220
 msgid "add an image"
 msgstr "add an image"
 
@@ -1446,11 +1466,11 @@ msgstr "all"
 msgid "ansible.cfg"
 msgstr "ansible.cfg"
 
-#: ../../automation/cloud-init.rst:61
+#: ../../automation/cloud-init.rst:62
 msgid "cloud-config file format"
 msgstr "cloud-config file format"
 
-#: ../../automation/cloud-init.rst:229
+#: ../../automation/cloud-init.rst:232
 msgid "cloud-init logs to /var/log/cloud-init.log. This file can be helpful in determining why the configuration varies from what you expect. You can fetch the most important data filtering output for ``vyos`` keyword:"
 msgstr "cloud-init logs to /var/log/cloud-init.log. This file can be helpful in determining why the configuration varies from what you expect. You can fetch the most important data filtering output for ``vyos`` keyword:"
 
@@ -1458,7 +1478,7 @@ msgstr "cloud-init logs to /var/log/cloud-init.log. This file can be helpful in
 msgid "commands.txt"
 msgstr "commands.txt"
 
-#: ../../automation/vyos-api.rst:205
+#: ../../automation/vyos-api.rst:237
 msgid "delete an image, for example ``1.3-rolling-202006070117``"
 msgstr "delete an image, for example ``1.3-rolling-202006070117``"
 
@@ -1550,6 +1570,10 @@ msgstr "variables.tf"
 msgid "versions.tf"
 msgstr "versions.tf"
 
+#: ../../automation/vyos-api.rst:145
+msgid "versus a non-existent path:"
+msgstr "versus a non-existent path:"
+
 #: ../../automation/terraform/terraformAWS.rst:300
 #: ../../automation/terraform/terraformAZ.rst:95
 #: ../../automation/terraform/terraformvSphere.rst:98