> User Documentation Home

User Handbook
Tutorials
Resources

The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

Azure Storage plugin

View this plugin on the Plugins site

azureDownload: Download from Azure storage

  • storageCredentialId
    • Type: String
  • downloadType
    • Type: String
  • buildSelector (optional)
      Nested Choice of Objects
    • downstream
      • upstreamProjectName

        Copy artifacts from a build that is a downstream of a build of the specified project. You can use variable expressions.

        Downstream builds are found using fingerprints of files. That is, a build that is triggered from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

        Note: "Downstream build of" is applicable only to AbstractProject based projects (both upstream and downstream projects).

        AbstractProject based projects:
        Freestyle projects
        Multi-configuration projects
        Maven projects
        Non AbstractProject based projects:
        Pipeline jobs (aka. Workflow jobs)

        • Type: String
      • upstreamBuildNumber
        The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
        • Type: String
    • lastWithArtifacts
      • lastCompleted
        • $class: 'MultiJobBuildSelector'
          • buildParameter
            • parameterName
              Name of the "build selector" parameter. A parameter with this name should be added in the build parameters section above. There is a special parameter type for choosing the build selector.

              You can pass not only the parameter name, but also the parameter value itself. This is useful especially used with workflow-plugin.

              • Type: String
          • permalink
            • id
              • Type: String
          • $class: 'PromotedBuildSelector'
            • level
              • Type: int
          • latestSavedBuild
            • specific
              • buildNumber
                While this selector is for build numbers (e.g. "22" for build #22), you can also resolve build parameters or environment variables (e.g. "${PARAM}"). The display name of a build and permalinks (e.g. "lastSuccessfulBuild", "lastBuild"...) can be used as well.
                • Type: String
            • lastSuccessful
              • stable (optional)
                • Type: boolean
            • upstream
              • allowUpstreamDependencies (optional)
                • Type: boolean
              • fallbackToLastSuccessful (optional)
                • Type: boolean
              • upstreamFilterStrategy (optional)
                Jenkins launches only one build when multiple upstreams triggered the same project at the same time. This field specifies from which upstream build to copy artifacts in those cases. "Use the oldest" copies artifacts from the upstream build with the smallest build number (that is, oldest). "Use the newest" copies artifacts from the upstream build with the largest build number (that is, newest). The default value is "Use global setting", which behaves as configured in "Manage Jenkins" > "Configure System".
                • Values: UseGlobalSetting, UseOldest, UseNewest
            • workspace
            • containerName (optional)
              Enter a storage container name.
              Environment variables can also be referenced.
              For example: ${JOB_NAME}
              • Type: String
            • deleteFromAzureAfterDownload (optional)
              If checked, the file copy on Azure will be removed after it's downloaded to local.
              • Type: boolean
            • downloadDirLoc (optional)
              Enter a download path. If not specified, the files will be downloaded into the job's workspace.
              Environment variables can also be referenced, for example: ${JOB_NAME} If "Flatten Directories" is checked, this directory will contain all outputs.
              • Type: String
            • excludeFilesPattern (optional)
              Enter a pattern of blobs to exclude from the download. Ant fileset syntax. Leaving blank will download the entire container. Environment variables can also be referenced.
              For example: ${JOB_NAME}
              • Type: String
            • fileShare (optional)
              Enter a Azure File Storage Share name.
              Environment variables can also be referenced.
              For example: ${JOB_NAME}
              • Type: String
            • flattenDirectories (optional)
              If checked, all files specified for download will be flattened to the single download directory. If two files are named the same in different directories, only one will remain.
              • Type: boolean
            • includeArchiveZips (optional)
              The archive zip files generated (archive.zip in the root of the container/virtual path) are typically excluded from download. Check this to enable downloading of the archive zip.
              • Type: boolean
            • includeFilesPattern (optional)
              Enter a pattern of blobs to download. Ant fileset syntax. Environment variables can also be referenced.
              For example: ${JOB_NAME}
              • Type: String
            • projectName (optional)
              The name of the project to download the managed artifact from.
              • Type: String
            • verbose (optional)

              Enabling this will provide more logging on downloading files.

              • Type: boolean

            azureUpload: Upload artifacts to Azure Storage

            • storageCredentialId
              • Type: String
            • filesPath
              • Type: String
            • storageType
              • Type: String
            • allowAnonymousAccess (optional)
              • Type: boolean
            • blobProperties (optional)
                Nested Object
              • cacheControl (optional)
                • Type: String
              • contentEncoding (optional)
                • Type: String
              • contentLanguage (optional)
                • Type: String
              • contentType (optional)
                • Type: String
              • detectContentType (optional)

                Auto detect content type based on file content and file name if content type is not set.

                This detection is provided by Apache Tika and may not always be accurate.

                • Type: boolean
            • cleanUpContainerOrShare (optional)
              • Type: boolean
            • cleanUpVirtualPath (optional)
              • Type: boolean
            • containerName (optional)
              • Type: String
            • doNotFailIfArchivingReturnsNothing (optional)
              • Type: boolean
            • doNotUploadIndividualFiles (optional)
              • Type: boolean
            • doNotWaitForPreviousBuild (optional)
              • Type: boolean
            • excludeFilesPath (optional)
              • Type: String
            • fileShareName (optional)
              • Type: String
            • metadata (optional)
                Array / List of Nested Object
              • key
                Metadata key for the files from this build. It will be prefixed by "x-ms-meta-" when uploaded to Azure. Can contain macros (e.g. environment variables).
                • Type: String
              • value
                Metadata value for the files from this build. Can contain macros (e.g. environment variables).
                • Type: String
            • onlyUploadModifiedArtifacts (optional)
              • Type: boolean
            • pubAccessible (optional)
              • Type: boolean
            • removePrefixPath (optional)
              • Type: String
            • uploadArtifactsOnlyIfSuccessful (optional)
              • Type: boolean
            • uploadZips (optional)
              • Type: boolean
            • verbose (optional)

              Enabling this will provide more logging on uploading files.

              • Type: boolean
            • virtualPath (optional)
              • Type: String

            Was this page helpful?

            Please submit your feedback about this page through this quick form.

            Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?

                


            See existing feedback here.