Method: projects.assets.copy

  • The POST request to https://earthengine.googleapis.com/v1/{sourceName=projects/*/assets/**}:copy is used to copy an asset.

  • The sourceName path parameter specifies the asset to copy, requiring earthengine.assets.get IAM permission.

  • The request body requires a destinationName and optionally includes an overwrite boolean.

  • The destinationName field in the request body specifies where the asset will be copied to, requiring earthengine.assets.create IAM permission.

  • A successful response contains an EarthEngineAsset instance.

Copies an asset.

HTTP request

POST https://earthengine.googleapis.com/v1/{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:

  • earthengine.assets.get

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.