.. _ref_commands_upload-resource:

upload-resource
===============

Upload a resource to Charmhub.

Push a resource content to Charmhub, associating it to the
specified charm. This charm needs to have the resource declared
in its metadata (in a previously uploaded to Charmhub revision).

The resource can be a file from your computer (use the `--filepath`
option) or an OCI Image (use the `--image` option to indicate the
image digest or id), which can be already in Canonical's registry
and used directly, or locally in your computer and will be uploaded
and used.

Upload will take you through login if needed.


Usage
-----

:command:`charmcraft upload-resource [options] <charm-name> <resource-name>`

Required
--------

``charm-name``
   The charm name to associate the resource.
``resource-name``
   The resource name.

Options
-------

``--arch``
   The architectures valid for this file resource. If none are provided, the resource is uploaded without architecture information.
``--filepath``
   The file path of the resource content to upload.
``--format``
   Produce the result in the specified format (currently only 'json').
``--image``
   The digest (remote or local) or id (local, exclude "sha256:") of the OCI image.

Global options
--------------

``-h`` or ``--help``
   Show this help message and exit.
``-q`` or ``--quiet``
   Only show warnings and errors, not progress.
``-v`` or ``--verbose``
   Show debug information and be more verbose.
``--verbosity``
   Set the verbosity level to 'quiet', 'brief', 'verbose', 'debug' or 'trace'.
``-V`` or ``--version``
   Show the application version and exit.