cURLUploader@2 - cURL Upload Files v2 task
Use this task with cURL to upload files. Supported data transfer protocols include FTP, FTPS, SFTP, HTTP, and others.
Use cURL to upload files.
Syntax
# cURL Upload Files v2
# Use cURL's supported protocols to upload files.
- task: cURLUploader@2
inputs:
files: # string. Required. Files.
#authType: 'ServiceEndpoint' # 'ServiceEndpoint' | 'UserAndPass'. Authentication Method. Default: ServiceEndpoint.
serviceEndpoint: # string. Required when authType = ServiceEndpoint. Service Connection.
#username: # string. Optional. Use when authType = UserAndPass. Username.
#password: # string. Optional. Use when authType = UserAndPass. Password.
#url: # string. Required when authType = UserAndPass. URL.
#remotePath: 'upload/$(Build.BuildId)/' # string. Remote Directory. Default: upload/$(Build.BuildId)/.
#options: # string. Optional Arguments.
# Advanced
#redirectStderr: true # boolean. Redirect Standard Error to Standard Out. Default: true.
# cURL Upload Files v2
# Use cURL to upload files.
- task: cURLUploader@2
inputs:
files: # string. Required. Files.
#authType: 'ServiceEndpoint' # 'ServiceEndpoint' | 'UserAndPass'. Authentication Method. Default: ServiceEndpoint.
serviceEndpoint: # string. Required when authType = ServiceEndpoint. Service Connection.
#username: # string. Optional. Use when authType = UserAndPass. Username.
#password: # string. Optional. Use when authType = UserAndPass. Password.
#url: # string. Required when authType = UserAndPass. URL.
#remotePath: 'upload/$(Build.BuildId)/' # string. Remote Directory. Default: upload/$(Build.BuildId)/.
#options: # string. Optional Arguments.
# Advanced
#redirectStderr: true # boolean. Redirect Standard Error to Standard Out. Default: true.
Inputs
files - Files
string. Required.
File(s) to be uploaded. Wildcards can be used. For example, **/*.zip for all ZIP files in all subfolders.
authType - Authentication Method
string. Allowed values: ServiceEndpoint (Service connection), UserAndPass (Username and password). Default value: ServiceEndpoint.
Specifies the authentication method for server authentication.
serviceEndpoint - Service Connection
string. Required when authType = ServiceEndpoint.
Specifies the service connection with the credentials for the server authentication. Use the Generic service connection type for the service connection.
username - Username
string. Optional. Use when authType = UserAndPass.
Specifies the username for server authentication.
password - Password
string. Optional. Use when authType = UserAndPass.
Specifies the password for server authentication. Use a new build variable with its lock enabled on the Variables tab to encrypt this value. Use a secret variable to avoid exposing ths value.
url - URL
string. Required when authType = UserAndPass.
Specifies the URL to where the file(s) will be uploaded. The directory should end with a trailing slash. Possible URL protocols include DICT://, FILE://, FTP://, FTPS://, GOPHER://, HTTP://, HTTPS://, IMAP://, IMAPS://, LDAP://, LDAPS://, POP3://, POP3S://, RTMP://, RTSP://, SCP://, SFTP://, SMTP://, SMTPS://, TELNET:// and TFTP://.
remotePath - Remote Directory
string. Default value: upload/$(Build.BuildId)/.
Optional. Specifies the sub-folder on the remote server for the URL supplied in the credentials.
options - Optional Arguments
string.
Optional. The additional arguments that will be passed to cURL.
redirectStderr - Redirect Standard Error to Standard Out
boolean. Default value: true.
Adds --stderr - as an argument to cURL. By default, cURL writes its progress bar to stderr, which is interpreted by the build as error output. Enabling this checkbox suppresses that behavior.
Task control options
All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.
Output variables
None.
Remarks
Use this task to use cURL to upload files with supported protocols such as FTP, FTPS, SFTP, HTTP, and more.
Where can I learn more about file matching patterns?
Where can I learn FTP commands?
Requirements
| Requirement | Description |
|---|---|
| Pipeline types | YAML, Classic build, Classic release |
| Runs on | Agent, DeploymentGroup |
| Demands | None |
| Capabilities | This task does not satisfy any demands for subsequent tasks in the job. |
| Command restrictions | This task runs using the following command restrictions: restricted |
| Settable variables | This task has permission to set the following variables: Setting variables is disabled |
| Agent version | 2.182.1 or greater |
| Task category | Utility |
| Requirement | Description |
|---|---|
| Pipeline types | YAML, Classic build, Classic release |
| Runs on | Agent, DeploymentGroup |
| Demands | None |
| Capabilities | This task does not satisfy any demands for subsequent tasks in the job. |
| Command restrictions | Any |
| Settable variables | Any |
| Agent version | All supported agent versions. |
| Task category | Utility |
| Requirement | Description |
|---|---|
| Pipeline types | YAML, Classic build, Classic release |
| Runs on | Agent, DeploymentGroup |
| Demands | Self-hosted agents must have capabilities that match the following demands to run jobs that use this task: curl |
| Capabilities | This task does not satisfy any demands for subsequent tasks in the job. |
| Command restrictions | Any |
| Settable variables | Any |
| Agent version | All supported agent versions. |
| Task category | Utility |