fastly backend create

Create a backend on a Fastly service version.

Syntax

$ fastly backend create --version=VERSION --name=NAME --address=ADDRESS

Options

KeyRequired?DefaultDescription
--service-idNoService ID (falls back to FASTLY_SERVICE_ID, then fastly.toml)
--service-nameNoThe name of the service
--versionYes'latest', 'active', or the number of a specific version
--autocloneNoIf the selected service version is not editable, clone it and use the clone.
--nameYesBackend name
--addressYesA hostname, IPv4, or IPv6 address for the backend
--commentNoA descriptive note
--portNoPort number of the address
--override-hostNoThe hostname to override the Host header
--connect-timeoutNoHow long to wait for a timeout in milliseconds
--max-connNoMaximum number of connections
--first-byte-timeoutNoHow long to wait for the first bytes in milliseconds
--between-bytes-timeoutNoHow long to wait between bytes in milliseconds
--auto-loadbalanceNoWhether or not this backend should be automatically load balanced
--weightNoWeight used to load balance this backend against others
--request-conditionNoCondition, which if met, will select this backend during a request
--healthcheckNoThe name of the healthcheck to use with this backend
--shieldNoThe shield POP designated to reduce inbound load on this origin by serving the cached data to the rest of the network
--use-sslNoWhether or not to use SSL to reach the backend
--ssl-check-certNoBe strict on checking SSL certs
--ssl-ca-certNoCA certificate attached to origin
--ssl-client-certNoClient certificate attached to origin
--ssl-client-keyNoClient key attached to origin
--ssl-cert-hostnameNoOverrides ssl_hostname, but only for cert verification. Does not affect SNI at all.
--ssl-sni-hostnameNoOverrides ssl_hostname, but only for SNI in the handshake. Does not affect cert validation at all.
--min-tls-versionNoMinimum allowed TLS version on SSL connections to this backend
--max-tls-versionNoMaximum allowed TLS version on SSL connections to this backend
--ssl-ciphersNoColon delimited list of OpenSSL ciphers (see https://www.openssl.org/docs/man1.0.2/man1/ciphers for details)

Global options

KeyRequired?DefaultDescription
--helpNoShow context-sensitive help.
--accept-defaultsNoAccept default options for all interactive prompts apart from Yes/No confirmations
--auto-yesNoAnswer yes automatically to all Yes/No confirmations. This may suppress security warnings
--non-interactiveNoDo not prompt for user input - suitable for CI processes. Equivalent to --accept-defaults and --auto-yes
--profileNoSwitch account profile for single command execution (see also: 'fastly profile switch')
--tokenNoFastly API token (or via FASTLY_API_TOKEN)
--verboseNoVerbose logging

Examples

Create a backend on the currently active service version

Create a backend with a hostname assigned to the --address flag. The --override-host, --ssl-cert-hostname and --ssl-sni-hostname will default to the same hostname assigned to --address.

$ fastly backend create --name example --address example.com --version active --autoclone

API equivalent

This command internally uses the following Fastly public APIs: