Method: projects.assets.copy
HTTP request
POST https://earthengine.googleapis.com/v1beta/{sourceName=projects/*/assets/**}:copy
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
sourceName |
string
The name of the asset to copy. name is of the format "projects/*/assets/**" (e.g., "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). All user-owned assets are under the project "earthengine-legacy" (e.g., "projects/earthengine-legacy/assets/users/foo/bar"). All other assets are under the project "earthengine-public" (e.g., "projects/earthengine-public/assets/LANDSAT"). (e.g., "assets/users/[USER]/[ASSET]").
Authorization requires the following IAM permission on the specified resource sourceName :
|
Request body
The request body contains data with the following structure:
JSON representation |
{
"destinationName": string,
"overwrite": boolean
} |
Fields |
destinationName |
string
The destination name to which to copy the asset. name is of the format "projects/*/assets/**" (e.g., "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). All user-owned assets are under the project "earthengine-legacy" (e.g., "projects/earthengine-legacy/assets/users/foo/bar"). All other assets are under the project "earthengine-public" (e.g., "projects/earthengine-public/assets/LANDSAT").
Authorization requires the following IAM permission on the specified resource destinationName :
earthengine.assets.create
|
overwrite |
boolean
Whether to allow overwriting an existing asset.
|
Response body
If successful, the response body contains an instance of EarthEngineAsset
.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-06 UTC.
[null,null,["Last updated 2025-03-06 UTC."],[[["Copies an Earth Engine asset from a source to a destination location."],["Requires specifying the source and destination asset names in the request."],["Allows overwriting an existing asset at the destination with the `overwrite` parameter."],["Needs appropriate IAM permissions for both source (get) and destination (create) assets."],["Authentication can be achieved using Earth Engine or Cloud Platform OAuth scopes."]]],["To copy an asset, send a POST request to `https://earthengine.googleapis.com/v1beta/{sourceName=projects/*/assets/**}:copy`. Specify the `sourceName` path parameter to indicate the asset to copy and include a request body with the `destinationName` string and an `overwrite` boolean, which indicates if an existing asset can be overwritten. User-owned assets are under `earthengine-legacy`, and all other assets are under `earthengine-public`. The response will contain the copied asset information. Authorization is required.\n"]]