---
title: fastly service logging s3 update
summary: Update a S3 logging endpoint on a Fastly service version
url: https://www.fastly.com/documentation/reference/cli/service/logging/s3/update
---

Update a S3 logging endpoint on a Fastly service version

## Flags

| Flag | Description | Required | Default |
|------|-------------|----------|----------|
| `--name` | The name of the S3 logging object | Yes | - |
| `--version` | 'latest', 'active', 'staged', or the number of a specific Fastly service version | Yes | - |
| `--autoclone` | If the selected service version is not editable, clone it and use the clone. | No | - |
| `--access-key` | Your S3 account access key | No | - |
| `--bucket` | Your S3 bucket name | No | - |
| `--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. | No | - |
| `--domain` | The domain of the S3 endpoint | No | - |
| `--file-max-bytes` | The maximum size of a log file in bytes | No | - |
| `--format` | Apache style log formatting. Your log must produce valid JSON. Can be a string or a file path to a file containing formatting | No | - |
| `--format-version` | The 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 | No | - |
| `--gzip-level` | What level of GZIP encoding to have when dumping logs (default 0, no compression) | No | - |
| `--iam-role` | The IAM role ARN for logging | No | - |
| `--message-type` | How the message should be formatted. One of: classic (default), loggly, logplex or blank | No | - |
| `--new-name` | New name of the S3 logging object | No | - |
| `--path` | The path to upload logs to | No | - |
| `--period` | How frequently log files are finalized so they can be available for reading (in seconds, default 3600) | No | - |
| `--placement` | Where 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 | No | - |
| `--processing-region` | The region where logs will be processed before streaming to S3. One of 'none', 'eu', or 'us'. Defaults to 'none' for no specific region | No | - |
| `--public-key` | A PGP public key that Fastly will use to encrypt your log files before writing them to disk | No | - |
| `--redundancy` | The S3 storage class. One of: standard, intelligent_tiering, standard_ia, onezone_ia, glacier, glacier_ir, deep_archive, or reduced_redundancy | No | - |
| `--response-condition` | The name of an existing condition in the configured endpoint, or leave blank to always execute | No | - |
| `--secret-key` | Your S3 account secret key | No | - |
| `--server-side-encryption` | Set to enable S3 Server Side Encryption. Can be either AES256 or aws:kms | No | - |
| `--server-side-encryption-kms-key-id` | Server-side KMS Key ID. Must be set if server-side-encryption is set to aws:kms | No | - |
| `--service-id` | Service ID (falls back to FASTLY_SERVICE_ID, then fastly.toml) | No | - |
| `--service-name` | The name of the service | No | - |
| `--timestamp-format` | strftime specified timestamp formatting (default "%Y-%m-%dT%H:%M:%S.000") | No | - |

## Global options

| Flag | Description | Required | Default |
|------|-------------|----------|----------|
| `--help` | Show context-sensitive help. | No | - |
| `--accept-defaults` | Accept default options for all interactive prompts apart from Yes/No confirmations | No | - |
| `--auto-yes` | Answer yes automatically to all Yes/No confirmations. This may suppress security warnings | No | - |
| `--debug-mode` | Print API request and response details (NOTE: can disrupt the normal CLI flow output formatting) | No | - |
| `--non-interactive` | Do not prompt for user input - suitable for CI processes. Equivalent to --accept-defaults and --auto-yes | No | - |
| `--quiet` | Silence all output except direct command output. This won't prevent interactive prompts (see: --accept-defaults, --auto-yes, --non-interactive) | No | - |
| `--token` | Fastly API token, or name of a stored auth token (use 'default' for the default token). Falls back to FASTLY_API_TOKEN env var | No | - |
| `--verbose` | Verbose logging | No | - |