fastly logging s3/update

Update a S3 logging endpoint on a Fastly service version.


$ fastly logging s3/update --name=NAME --version=VERSION


--nameYesThe name of the S3 logging object
--versionYes'latest', 'active', or the number of a specific Fastly service version
--autocloneNoIf the selected service version is not editable, clone it and use the clone.
--access-keyNoYour S3 account access key
--bucketNoYour S3 bucket name
--compression-codecNoThe 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.
--domainNoThe domain of the S3 endpoint
--file-max-bytesNoThe maximum size of a log file in bytes
--formatNoApache style log formatting. Your log must produce valid JSON
--format-versionNoThe version of the custom logging format used for the configured endpoint. Can be either 2 (the default, version 2 log format) or 1 (the version 1 log format). The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1
--gzip-levelNoWhat level of GZIP encoding to have when dumping logs (default 0, no compression)
--iam-roleNoThe IAM role ARN for logging
--message-typeNoHow the message should be formatted. One of: classic (default), loggly, logplex or blank
--new-nameNoNew name of the S3 logging object
--pathNoThe path to upload logs to
--periodNoHow frequently log files are finalized so they can be available for reading (in seconds, default 3600)
--placementNoWhere in the generated VCL the logging call should be placed, overriding any format_version default. Can be none or waf_debug. This field is not required and has no default value
--public-keyNoA PGP public key that Fastly will use to encrypt your log files before writing them to disk
--redundancyNoThe S3 storage class. One of: standard, intelligent_tiering, standard_ia, onezone_ia, glacier, glacier_ir, deep_archive, or reduced_redundancy
--response-conditionNoThe name of an existing condition in the configured endpoint, or leave blank to always execute
--secret-keyNoYour S3 account secret key
--server-side-encryptionNoSet to enable S3 Server Side Encryption. Can be either AES256 or aws:kms
--server-side-encryption-kms-key-idNoServer-side KMS Key ID. Must be set if server-side-encryption is set to aws:kms
--service-idNoService ID (falls back to FASTLY_SERVICE_ID, then fastly.toml)
--service-nameNoThe name of the service
--timestamp-formatNostrftime specified timestamp formatting (default "%Y-%m-%dT%H:%M:%S.000")

Global options

--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
--debug-modeNoPrint API request and response details (NOTE: can disrupt the normal CLI flow output formatting)
--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')
--quietNoSilence all output except direct command output. This won't prevent interactive prompts (see: --accept-defaults, --auto-yes, --non-interactive)
--tokenNoFastly API token (or via FASTLY_API_TOKEN)
--verboseNoVerbose logging

API equivalent

This command internally uses the following Fastly public APIs: