Defining Azure Blob Storage Exist Job Properties

{"URL":["/*.*/awa/pa_view_pa_view_EXIST_blob"],"heroDescriptionIdentifier":"ice_hero_exist_job_blob","customCards":[{"id":"ice_specific_Blob_Exist_Job","title":"Adding Exist Job Parameters","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_BLOB/*.*/Agent%20Guide/Content/Azure_Blob/Azure_Blob_Jobs_Exist_Job.htm","languages":["en-us"]},{"id":"ice_RA_Integration_Report","title":"RA / Integration Reports","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_BLOB/*.*/Agent%20Guide/Content/Azure_Blob/Azure_Blob_Jobs_RA_Properties.htm","languages":["en-us"]},{"id":"ice_Exist_Job_script_Blob","title":"Setting Exist Job Properties through Scripts","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_BLOB/*.*/Agent%20Guide/Content/Azure_Blob/Azure_Blob_Script.htm","languages":["en-us"]},{"id":"ice_related_information_Blob_Exist_Job","title":"Related Information","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_BLOB/*.*/Agent%20Guide/Content/Azure_Blob/Azure_Blob_Jobs_Exist_Job.htm","languages":["en-us"]}]}

  • Context URL: /*.*/awa/pa_view_pa_view_EXIST_blob

    Hero: ice_hero_exist_job_blob

  • Adding Exist Job Parameters

    ice_specific_Blob_Exist_Job

    https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_BLOB/*.*/Agent%20Guide/Content/Azure_Blob/Azure_Blob_Jobs_Exist_Job.htm

  • RA / Integration Reports

    ice_RA_Integration_Report

    https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_BLOB/*.*/Agent%20Guide/Content/Azure_Blob/Azure_Blob_Jobs_RA_Properties.htm

  • Setting Job Properties through Scripts

    ice_Exist_Job_script_Blob

    https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_BLOB/*.*/Agent%20Guide/Content/Azure_Blob/Azure_Blob_Script.htm

  • Related Information

    ice_related_information_Blob_Exist_Job

    https://docs.automic.com/documentation/webhelp/english/ALL/components/IG_BLOB/*.*/Agent%20Guide/Content/Azure_Blob/Azure_Blob_Jobs_Exist_Job.htm

The Azure Blob Storage Exist Job allows you to check whether one or more blobs exist on a container. If the blob does not exist on the container, the Exist Job does not fail.

On the Exist Job page you define the parameters relevant to run that job on the Azure Blob Storage system from Automic Automation.

Note:

Some fields allow you to open a picker dialog from where you can select the file and the container. By default, only 200 entries are displayed. If the relevant file or container is not displayed among those 200, please type in the relevant name on the Search field to narrow down the list.

  • Connection

    Connection object that has the relevant information to connect to the Azure Blob Storage environment. To search for a Connection object, start typing its name to limit the list of the objects that match your input.

  • Container

    Azure Blob Storage container where the blob is stored. You can click the browse button to the right of the field to open a picker dialog with all the available containers.

  • Blob Name

    Name of the blob whose existence this job should check. If you leave this field empty, the name that you enter in the Source File Path field will be used. You can specify the exact name or write a regular expression.

  • Use Regex

    Select this checkbox if you want to use regular expressions rather than the exact name of the blob in the Blob Name field. If you do so, the job will return multiple blob names.

    After executing the job, the number of returned blobs is displayed in &FILES_COUNT in the Object variables section of the Details pane. You find this pane in the Process Monitoring perspective in the Executions lists and in the Tasks list. For more information, see Monitoring Job Details.

    Examples:

    Aut.*.txt: An asterisk (*) stands for any number of characters; therefore, the regex searches for text files starting with Aut and ending with .txt with any number of characters where the * is located, such as Automic.txt.

    tes.?.txt: A question mark (?) stands for a single character; therefore, the regex searches for text files with 4-character names starting with tes and ending with .txt with a single in the position where the ? is located.

    Note:

    If the Use Regex checkbox is not selected, any special characters (?, *) used are considered standard characters and part of the name string.

  • Retrieve Blob Names

    From snippet RetrieveFileName.flsnp where file is replaced with blob

    (Available only when you select Use Regex) If you select this option, the name of the blobs that match the regular expression (that is, the blobs found by the job) are printed to the job Report (REP) in a format that is easily parsed. Regardless of what you set here, the blobs that are found by the job are also listed in the Agent log (PLOG) report.

    Note:

    If you select Use Regex and do NOT select Retrieve File Names, the job Report (REP) will be empty even if the regular expression finds matches. In this case, you can still find the blob names in the Agent log (PLOG) report.

  • Query Parameters

    (Available only when you select Use Regex) If you use regular expressions so that the job returns a list of blobs, you can fine tune the results by entering query parameters here. For example, enter maxresults=2 to get only 2 blobs. You can use any API command here that is supported by the Azure REST API (URI parameters). For more information, please refer to the official Azure Blob Storage REST API documentation at learn.microsoft.com.

    Example:

    You want to check whether a text file exists in a container called my-container but you do not remember the full name of the file. However, you know that it starts with a t. Do the following:

    1. Select the Connection object and the Container.

    2. Select Use Regex.

    3. In Blob Name enter the following regular expression.

      .*.txt

    4. In Query Parameters enter the following:

      prefix=t

Note:

The Pre-Process page allows you to define the settings of all Azure Blob Storage jobs using script statements. These statements are processed before the Schedule Job is executed, see Setting Azure Blob Storage Job Properties Through Scripts.

See also: