# manage-runners cache test

> Write, read and delete a test object in a saved or unsaved HTTPS cache; --name also needs runners:read

Source: https://managerunners.com/docs/cli/reference/cache-test/

| | |
| --- | --- |
| Required scopes | `runners:write` |
| Required flags | none |
| Changes state | no |
| Destructive | no |
| Paid resource effect | none |
| Confirmation | none |
| Non-interactive use | supported |

## Usage

```text
Write, read and delete a test object in a saved or unsaved HTTPS cache; --name also needs runners:read

Usage:
  manage-runners cache test [flags]

Flags:
      --access-key-id string    S3 access key ID
      --bucket string           bucket name
      --id string               cache id
      --insecure                use plain HTTP instead of HTTPS
      --name string             cache name; resolving it needs runners:read
      --path-prefix string      optional object path prefix inside the bucket
      --path-style string       addressing style: auto|path|virtual (default auto for create)
      --profile string          configuration profile
      --region string           bucket region, for example fsn1 or eu-central-1
      --secret-key-env string   environment variable containing the S3 secret key
      --secret-key-stdin        read the S3 secret key from stdin
      --server-address string   S3 server host[:port] without scheme, for example fsn1.your-objectstorage.com
      --shared string           share the cache between runners: on|off (default on for create)
```

Every command also accepts the [global flags](https://managerunners.com/docs/cli/reference/#global-flags). For machine-readable help, run `manage-runners help cache test --output json`.