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.

$class: 'RunSelectorParameter'

  • $class: 'RunSelectorParameter'

    Defines a parameter that specifies how a Copy Artifact build step should select which build to copy from. Note that this parameter type is easier to use when starting the build from a browser; to specify a value via direct HTTP POST or the CLI, valid XML must be given.

    Be aware that this string value is encoded selector configuration, and not compatible with different plugin versions.

    • name : String
    • defaultSelector
        Nested Choice of Objects
      • buildNumber
        • buildNumber : String
          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}").
      • fallback
        • entryList
            Array / List of Nested Object
          • runSelector
              Nested Choice of Objects
            • buildNumber
              • buildNumber : String
                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}").
            • fallback
            • parameterized
              • parameterName : String
                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.

            • permalink
              • id : String
            • status
              • buildStatus
                • Values: STABLE, SUCCESSFUL, UNSTABLE, FAILED, COMPLETED, ANY
            • triggering
              • allowUpstreamDependencies : boolean (optional)
                Tracks upstream builds not only with build-triggering relations, but also with relations via artifacts.
              • 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
          • runFilter
              Nested Choice of Objects
            • and
              • runFilterList
                  Array / List of Nested Choice of Objects
                • and
                • displayName
                  • runDisplayName : String
                    Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                • $class: 'DownstreamRunFilter'
                  • upstreamProjectName : String

                    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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                    Note: "Downsteram 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)

                  • upstreamBuildNumber : String
                    The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                • not
                  • runFilter
                      Nested Choice of Objects
                    • and
                    • displayName
                      • runDisplayName : String
                        Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                    • $class: 'DownstreamRunFilter'
                      • upstreamProjectName : String

                        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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                        Note: "Downsteram 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)

                      • upstreamBuildNumber : String
                        The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                    • not
                    • or
                      • runFilterList
                          Array / List of Nested Choice of Objects
                        • and
                        • displayName
                          • runDisplayName : String
                            Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                        • $class: 'DownstreamRunFilter'
                          • upstreamProjectName : String

                            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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                            Note: "Downsteram 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)

                          • upstreamBuildNumber : String
                            The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                        • not
                        • or
                        • parameterized
                          • parameter : String
                            Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                        • parameters
                          • paramsToMatch : String

                            Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                        • saved
                      • parameterized
                        • parameter : String
                          Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                      • parameters
                        • paramsToMatch : String

                          Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                      • saved
                    • or
                      • runFilterList
                          Array / List of Nested Choice of Objects
                        • and
                        • displayName
                          • runDisplayName : String
                            Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                        • $class: 'DownstreamRunFilter'
                          • upstreamProjectName : String

                            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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                            Note: "Downsteram 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)

                          • upstreamBuildNumber : String
                            The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                        • not
                          • runFilter
                              Nested Choice of Objects
                            • and
                            • displayName
                              • runDisplayName : String
                                Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                            • $class: 'DownstreamRunFilter'
                              • upstreamProjectName : String

                                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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                Note: "Downsteram 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)

                              • upstreamBuildNumber : String
                                The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                            • not
                            • or
                            • parameterized
                              • parameter : String
                                Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                            • parameters
                              • paramsToMatch : String

                                Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                            • saved
                          • or
                          • parameterized
                            • parameter : String
                              Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                          • parameters
                            • paramsToMatch : String

                              Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                          • saved
                        • parameterized
                          • parameter : String
                            Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                        • parameters
                          • paramsToMatch : String

                            Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                        • saved
                      • displayName
                        • runDisplayName : String
                          Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                      • $class: 'DownstreamRunFilter'
                        • upstreamProjectName : String

                          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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                          Note: "Downsteram 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)

                        • upstreamBuildNumber : String
                          The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                      • not
                        • runFilter
                            Nested Choice of Objects
                          • and
                            • runFilterList
                                Array / List of Nested Choice of Objects
                              • and
                              • displayName
                                • runDisplayName : String
                                  Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                              • $class: 'DownstreamRunFilter'
                                • upstreamProjectName : String

                                  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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                  Note: "Downsteram 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)

                                • upstreamBuildNumber : String
                                  The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                              • not
                              • or
                                • runFilterList
                                    Array / List of Nested Choice of Objects
                                  • and
                                  • displayName
                                    • runDisplayName : String
                                      Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                                  • $class: 'DownstreamRunFilter'
                                    • upstreamProjectName : String

                                      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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                      Note: "Downsteram 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)

                                    • upstreamBuildNumber : String
                                      The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                                  • not
                                  • or
                                  • parameterized
                                    • parameter : String
                                      Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                  • parameters
                                    • paramsToMatch : String

                                      Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                  • saved
                                • parameterized
                                  • parameter : String
                                    Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                • parameters
                                  • paramsToMatch : String

                                    Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                • saved
                              • displayName
                                • runDisplayName : String
                                  Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                              • $class: 'DownstreamRunFilter'
                                • upstreamProjectName : String

                                  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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                  Note: "Downsteram 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)

                                • upstreamBuildNumber : String
                                  The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                              • not
                              • or
                                • runFilterList
                                    Array / List of Nested Choice of Objects
                                  • and
                                    • runFilterList
                                        Array / List of Nested Choice of Objects
                                      • and
                                      • displayName
                                        • runDisplayName : String
                                          Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                                      • $class: 'DownstreamRunFilter'
                                        • upstreamProjectName : String

                                          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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                          Note: "Downsteram 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)

                                        • upstreamBuildNumber : String
                                          The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                                      • not
                                      • or
                                      • parameterized
                                        • parameter : String
                                          Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                      • parameters
                                        • paramsToMatch : String

                                          Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                      • saved
                                    • displayName
                                      • runDisplayName : String
                                        Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                                    • $class: 'DownstreamRunFilter'
                                      • upstreamProjectName : String

                                        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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                        Note: "Downsteram 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)

                                      • upstreamBuildNumber : String
                                        The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                                    • not
                                    • or
                                    • parameterized
                                      • parameter : String
                                        Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                    • parameters
                                      • paramsToMatch : String

                                        Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                    • saved
                                  • parameterized
                                    • parameter : String
                                      Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                  • parameters
                                    • paramsToMatch : String

                                      Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                  • saved
                                • or
                                  • runFilterList
                                      Array / List of Nested Choice of Objects
                                    • and
                                      • runFilterList
                                          Array / List of Nested Choice of Objects
                                        • and
                                        • displayName
                                          • runDisplayName : String
                                            Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                                        • $class: 'DownstreamRunFilter'
                                          • upstreamProjectName : String

                                            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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                            Note: "Downsteram 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)

                                          • upstreamBuildNumber : String
                                            The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                                        • not
                                          • runFilter
                                              Nested Choice of Objects
                                            • and
                                            • displayName
                                              • runDisplayName : String
                                                Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                                            • $class: 'DownstreamRunFilter'
                                              • upstreamProjectName : String

                                                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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                                Note: "Downsteram 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)

                                              • upstreamBuildNumber : String
                                                The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                                            • not
                                            • or
                                            • parameterized
                                              • parameter : String
                                                Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                            • parameters
                                              • paramsToMatch : String

                                                Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                            • saved
                                          • or
                                          • parameterized
                                            • parameter : String
                                              Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                          • parameters
                                            • paramsToMatch : String

                                              Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                          • saved
                                        • displayName
                                          • runDisplayName : String
                                            Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                                        • $class: 'DownstreamRunFilter'
                                          • upstreamProjectName : String

                                            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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                            Note: "Downsteram 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)

                                          • upstreamBuildNumber : String
                                            The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                                        • not
                                          • runFilter
                                              Nested Choice of Objects
                                            • and
                                              • runFilterList
                                                  Array / List of Nested Choice of Objects
                                                • and
                                                • displayName
                                                  • runDisplayName : String
                                                    Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                                                • $class: 'DownstreamRunFilter'
                                                  • upstreamProjectName : String

                                                    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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                                    Note: "Downsteram 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)

                                                  • upstreamBuildNumber : String
                                                    The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                                                • not
                                                • or
                                                • parameterized
                                                  • parameter : String
                                                    Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                                • parameters
                                                  • paramsToMatch : String

                                                    Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                                • saved
                                              • displayName
                                                • runDisplayName : String
                                                  Filter the run based on its display name. It accepts the first run that has the display name matching the given parameter. The iteration is done from newest to oldest run.
                                              • $class: 'DownstreamRunFilter'
                                                • upstreamProjectName : String

                                                  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 triggerd from a build isn't always considered downstream, but you need to fingerprint files used in builds to let Jenkins track them.

                                                  Note: "Downsteram 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)

                                                • upstreamBuildNumber : String
                                                  The number of the build to find its downstream build. You can also specify display names. You can use variable expressions.
                                              • not
                                              • or
                                              • parameterized
                                                • parameter : String
                                                  Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                              • parameters
                                                • paramsToMatch : String

                                                  Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                              • saved
                                            • or
                                            • parameterized
                                              • parameter : String
                                                Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                            • parameters
                                              • paramsToMatch : String

                                                Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                            • saved
                                          • parameterized
                                            • parameter : String
                                              Specify the value passed via the parameter "Build filter for Copy Artifact". E.g. You specified "Build filter for Copy Artifact" as PARAM, specify ${PARAM} here.
                                          • parameters
                                            • paramsToMatch : String

                                              Jobs may be filtered to select only builds matching particular parameters or other build variables. Use PARAM=VALUE,... to list the parameter filter; this is the same syntax as described for multiconfiguration jobs in Project name except with parameters instead of axis values. For example, FOO=bar,BAZ=true examines only builds that ran with parameter FOO set to bar and the checkbox for BAZ was checked.

                                          • saved
                                      • parameterized
                                        • parameterName : String
                                          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.

                                      • permalink
                                        • id : String
                                      • status
                                        • buildStatus
                                          • Values: STABLE, SUCCESSFUL, UNSTABLE, FAILED, COMPLETED, ANY
                                      • triggering
                                        • allowUpstreamDependencies : boolean (optional)
                                          Tracks upstream builds not only with build-triggering relations, but also with relations via artifacts.
                                        • 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
                                    • description : String (optional)

                                  • 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.