# Download package version assets
<a name="download-assets"></a>

An *asset* is an individual file (for example, an npm `.tgz` file or Maven POM or JAR file) stored in CodeArtifact that is associated with a package version. You can download package assets using the `get-package-version-assets command`. This allows you to retrieve assets without using a package manager client such as `npm` or `pip`. To download an asset you must provide the asset's name which can be obtained using the `list-package-version-assets` command, for more information see [List package version assets](list-assets.md). The asset will be downloaded to local storage with a file name that you specify.

The following example downloads the {{guava-27.1-jre.jar}} asset from the Maven package {{com.google.guava:guava}} with version {{27.1-jre}}.

```
aws codeartifact get-package-version-asset --domain {{my_domain}} --domain-owner {{111122223333}} --repository {{my_repo}} \
    --format {{maven}} --namespace {{com.google.guava}} --package {{guava}} --package-version {{27.1-jre}} \
    --asset {{guava-27.1-jre.jar}} \
    {{guava-27.1-jre.jar}}
```

 In this example, the file name was specified as {{guava-27.1-jre.jar}} by the last argument in the preceding command, so the downloaded asset will be named {{guava-27.1-jre.jar}}. 

The output of the command will be:

```
{
    "assetName": "guava-27.1-jre.jar",
    "packageVersion": "27.1-jre",
    "packageVersionRevision": "YGp9ck2tmy03PGSxioclfYzQ0BfTLR9zzhQJtERv62I="
}
```

**Note**  
To download assets from a scoped npm package, include the scope in the `--namespace` option. The `@` symbol must be omitted when using `--namespace`. For example, if the scope is `@types`, use `--namespace types`.

 Downloading assets using `get-package-version-asset` requires `codeartifact:GetPackageVersionAsset` permission on the package resource. For more information about resource-based permission policies, see [Resource-based policies](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_resource-based) in the *AWS Identity and Access Management User Guide*.