fastly logging sftp create
Create an SFTP logging endpoint on a Fastly service version
Options
| Name | Description |
|---|---|
--name <name> | The name of the SFTP logging object. Used as a primary key for API access |
--version <version> | 'latest', 'active', or the number of a specific version |
--autoclone | If the selected service version is not editable, clone it and use the clone |
--address <address> | The hostname or IPv4 address |
--user <user> | The username for the server |
--ssh-known-hosts <ssh-known-hosts> | A list of host keys for all hosts we can connect to over SFTP |
--service-id <service-id> | Service ID (falls back to FASTLY_SERVICE_ID, then fastly.toml) |
--service-name <service-name> | The name of the service |
--port <port> | The port number |
--password <password> | The password for the server. If both password and secret_key are passed, secret_key will be used in preference |
--public-key <public-key> | A PGP public key that Fastly will use to encrypt your log files before writing them to disk |
--secret-key <secret-key> | The SSH private key for the server. If both password and secret_key are passed, secret_key will be used in preference |
--path <path> | The path to upload logs to. The directory must exist on the SFTP server before logs can be saved to it |
--period <period> | How frequently log files are finalized so they can be available for reading (in seconds, default 3600) |
--format <format> | Apache style log formatting |
--format-version <format-version> | The version of the custom logging format used for the configured endpoint. Can be either 2 (default) or 1 |
--gzip-level <gzip-level> | What level of GZIP encoding to have when dumping logs (default 0, no compression) |
--message-type <message-type> | How the message should be formatted. One of: classic (default), loggly, logplex or blank |
--response-condition <response-condition> | The name of an existing condition in the configured endpoint, or leave blank to always execute |
--timestamp-format <timestamp-format> | Strftime specified timestamp formatting (default "%Y-%m-%dT%H:%M:%S.000") |
--placement <placement> | Where in the generated VCL the logging call should be placed, overriding any format_version default. Can be none or waf_debug |
--compression-codec <compression-codec> | The codec used for compression of your logs. Valid values are zstd, snappy, and gzip. If the specified codec is "gzip", gzip_level will default to 3. To specify a different level, leave compression_codec blank and explicitly set the level using gzip_level. Specifying both compression_codec and gzip_level in the same API request will result in an error |