“google-artifactregistry1”库允许访问Google Artifact Registry服务（协议v1）的所有功能。

此文档是从Artifact Registrycrate版本5.0.5+20240608生成的，其中20240608是mako代码生成器v5.0.5构建的artifactregistry:v1模式的精确版本。

有关Artifact Registry v1 API的所有其他信息，请参阅官方文档网站。

功能

从中心枢纽轻松处理以下资源...

• 项目
• get project settings, locations get, locations get vpcsc config, locations list, locations operations get, locations repositories apt artifacts import, locations repositories apt artifacts upload, locations repositories create, locations repositories delete, locations repositories docker images get, locations repositories docker images list, locations repositories files delete, locations repositories files download, locations repositories files get, locations repositories files list, locations repositories generic artifacts upload, locations repositories get, locations repositories get iam policy, locations repositories go modules upload, locations repositories googet artifacts import, locations repositories googet artifacts upload, locations repositories kfp artifacts upload, locations repositories list, locations repositories maven artifacts get, locations repositories maven artifacts list, locations repositories npm packages get, locations repositories npm packages list, locations repositories packages delete, locations repositories packages get, locations repositories packages list, locations repositories packages patch, locations repositories packages tags create, locations repositories packages tags delete, locations repositories packages tags get, locations repositories packages tags list, locations repositories packages tags patch, locations repositories packages versions batch delete, locations repositories packages versions delete, locations repositories packages versions get, locations repositories packages versions list, locations repositories patch, locations repositories python packages get, locations repositories python packages list, locations repositories set iam policy, locations repositories test iam permissions, locations repositories yum artifacts import, locations repositories yum artifacts upload, locations update vpcsc config and update project settings

支持上传...

• locations repositories apt artifacts upload projects
• locations repositories generic artifacts upload projects
• locations repositories go modules upload projects
• locations repositories googet artifacts upload projects
• locations repositories kfp artifacts upload projects
• locations repositories yum artifacts upload projects

支持下载...

• locations repositories files download projects

本库结构

API结构如下

• 枢纽
  • 一个中心对象，用于维护状态并允许访问所有活动
  • 创建方法构建器，后者反过来允许访问单个调用构建器
• 资源
  • 你可以将其应用于活动的基本类型
  • 属性和部分的集合
  • 部分
    • 属性的集合
    • 从未在活动中直接使用
• 活动
  • 应用于资源的操作

所有结构都标记了适用的特性和，以进一步分类它们并简化浏览。

一般来说，你可以像这样调用活动

let r = hub.resource().activity(...).doit().await

或者具体...

let r = hub.projects().locations_operations_get(...).doit().await
let r = hub.projects().locations_repositories_apt_artifacts_import(...).doit().await
let r = hub.projects().locations_repositories_files_delete(...).doit().await
let r = hub.projects().locations_repositories_googet_artifacts_import(...).doit().await
let r = hub.projects().locations_repositories_packages_versions_batch_delete(...).doit().await
let r = hub.projects().locations_repositories_packages_versions_delete(...).doit().await
let r = hub.projects().locations_repositories_packages_delete(...).doit().await
let r = hub.projects().locations_repositories_yum_artifacts_import(...).doit().await
let r = hub.projects().locations_repositories_create(...).doit().await
let r = hub.projects().locations_repositories_delete(...).doit().await

资源resource()和活动activity(...)调用创建构建器。第二个处理Activities，支持各种配置即将进行的操作（此处未显示）的方法。它设计成所有必需的参数必须立即指定（即(...)），而所有可选参数都可以按需构建。doit()方法执行与服务器的实际通信并返回相应的结果。

用法

设置你的项目

要使用这个库，你需要在你的Cargo.toml文件中放入以下几行

[dependencies]
google-artifactregistry1 = "*"
serde = "^1.0"
serde_json = "^1.0"

一个完整的例子

extern crate hyper;
extern crate hyper_rustls;
extern crate google_artifactregistry1 as artifactregistry1;
use artifactregistry1::api::Repository;
use artifactregistry1::{Result, Error};
use std::default::Default;
use artifactregistry1::{ArtifactRegistry, oauth2, hyper, hyper_rustls, chrono, FieldMask};

// Get an ApplicationSecret instance by some means. It contains the `client_id` and 
// `client_secret`, among other things.
let secret: oauth2::ApplicationSecret = Default::default();
// Instantiate the authenticator. It will choose a suitable authentication flow for you, 
// unless you replace  `None` with the desired Flow.
// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about 
// what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and
// retrieve them from storage.
let auth = oauth2::InstalledFlowAuthenticator::builder(
        secret,
        oauth2::InstalledFlowReturnMethod::HTTPRedirect,
    ).build().await.unwrap();
let mut hub = ArtifactRegistry::new(hyper::Client::builder().build(hyper_rustls::HttpsConnectorBuilder::new().with_native_roots().unwrap().https_or_http().enable_http1().build()), auth);
// As the method needs a request, you would usually fill it with the desired information
// into the respective structure. Some of the parts shown here might not be applicable !
// Values shown here are possibly random and not representative !
let mut req = Repository::default();

// You can configure optional parameters by calling the respective setters at will, and
// execute the final call using `doit()`.
// Values shown here are possibly random and not representative !
let result = hub.projects().locations_repositories_create(req, "parent")
             .repository_id("magna")
             .doit().await;

match result {
    Err(e) => match e {
        // The Error enum provides details about what exactly happened.
        // You can also just use its `Debug`, `Display` or `Error` traits
         Error::HttpError(_)
        |Error::Io(_)
        |Error::MissingAPIKey
        |Error::MissingToken(_)
        |Error::Cancelled
        |Error::UploadSizeLimitExceeded(_, _)
        |Error::Failure(_)
        |Error::BadRequest(_)
        |Error::FieldClash(_)
        |Error::JsonDecodeError(_, _) => println!("{}", e),
    },
    Ok(res) => println!("Success: {:?}", res),
}

错误处理

系统产生的所有错误都作为Result枚举提供，作为doit方法的返回值，或者作为可能的中继结果传递给Hub Delegate或Authenticator Delegate。