| project_id | Google Cloud project ID to use for billing and API requests. If not
provided, the project will be inferred from the environment, best-effort.
To explicitly set the value:
```yaml
project_id: 'my-project'
``` | no | — |
| universe | The Google Cloud universe to use for constructing API endpoints. Trusted
Partner Cloud and Google Distributed Hosted Cloud should set this to their
universe address.
You can also override individual API endpoints by setting the environment
variable `GHA_ENDPOINT_OVERRIDE_<endpoint>` where `<endpoint>` is the API
endpoint to override. For example:
```yaml
env:
GHA_ENDPOINT_OVERRIDE_oauth2: 'https://oauth2.myapi.endpoint/v1'
```
For more information about universes, see the Google Cloud documentation. | no | googleapis.com |
| path | The path to a file or folder inside the action's filesystem that should be
uploaded to the bucket.
You can specify either the absolute path or the relative path from the
action:
```yaml
path: '/path/to/file'
```
```yaml
path: '../path/to/file'
``` | yes | — |
| destination | The destination for the file/folder in the form bucket-name or with an
optional prefix in the form `bucket-name/prefix`. For example, to upload a
file named `file` to the GCS bucket `bucket-name`:
```yaml
destination: 'bucket-name'
```
To upload to a subfolder:
```yaml
destination: 'bucket-name/prefix'
``` | yes | — |
| gzip | Upload file(s) with gzip content encoding. To disable gzip
content-encoding, set the value to false:
```yaml
gzip: false
``` | no | true |
| resumable | Enable resumable uploads. To disable resumable uploads, set the value to
false:
```yaml
resumable: false
``` | no | true |
| predefinedAcl | Apply a predefined set of access controls to the files being uploaded. For
example, to grant project team members access to the uploaded files
according to their roles:
```yaml
predefinedAcl: 'projectPrivate'
```
Acceptable values are: `authenticatedRead`, `bucketOwnerFullControl`,
`bucketOwnerRead`, `private`, `projectPrivate`, `publicRead`. See [the
document](https://googleapis.dev/nodejs/storage/latest/global.html#UploadOptions)
for details. | no | — |
| headers | Set object metadata. For example, to set the `Content-Type` header to
`application/json` and custom metadata with key `custom-field` and value
`custom-value`:
```yaml
headers: |-
content-type: 'application/json'
x-goog-meta-custom-field: 'custom-value'
```
Settable fields are: `cache-control`, `content-disposition`,
`content-encoding`, `content-language`, `content-type`, `custom-time`. See
[the
document](https://cloud.google.com/storage/docs/gsutil/addlhelp/WorkingWithObjectMetadata#settable-fields;-field-values)
for details. All custom metadata fields must be prefixed with
`x-goog-meta-`. | no | — |
| parent | Whether the parent directory should be included in GCS destination path. To disable this:
```yaml
parent: false
``` | no | true |
| glob | Glob pattern to match for files to upload.
```yaml
glob: '*.txt'
``` | no | — |
| concurrency | Number of files to simultaneously upload.
```yaml
concurrency: '10'
``` | no | 100 |
| gcloudignore_path | Path to a gcloudignore file within the repository.
```yaml
gcloudignore_path: '.gcloudignore.dev'
``` | no | .gcloudignore |
| process_gcloudignore | Process a `.gcloudignore` file present in the top-level of the repository.
If true, the file is parsed and any filepaths that match are not uploaded
to the storage bucket. To disable, set the value to false:
```yaml
process_gcloudignore: false
``` | no | true |