- HTTP request
- Path parameters
- Request body
- Response body
- Authorization Scopes
- IAM Permissions
- Examples
- Try it!
Directly uploads a KFP artifact. The returned Operation will complete once the resource is uploaded. Package, Version, and File resources will be created based on the uploaded artifact. Uploaded artifacts that conflict with existing resources will be overwritten.
HTTP request
- Upload URI, for media upload requests:
POST https://artifactregistry.googleapis.com/upload/v1/{parent=projects/*/locations/*/repositories/*}/kfpArtifacts:create
- Metadata URI, for metadata-only requests:
POST https://artifactregistry.googleapis.com/v1/{parent=projects/*/locations/*/repositories/*}/kfpArtifacts:create
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
The resource name of the repository where the KFP artifact will be uploaded. Authorization requires the following IAM permission on the specified resource
|
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "tags": [ string ], "description": string } |
Fields | |
---|---|
tags[] |
Tags to be created with the version. |
description |
Description of the package version. |
Response body
If successful, the response body contains data with the following structure:
The response to upload an artifact.
JSON representation |
---|
{
"operation": {
object ( |
Fields | |
---|---|
operation |
Operation that will be returned to the user. |
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
Requires the following IAM permission on the parent
resource:
artifactregistry.kfpartifacts.create
For more information, see the IAM documentation.