Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

验证连接

本文档可帮助您确认服务账号和 AWS 账号已成功启用，可以访问 Assured Open Source Software 服务。

如需验证您的 Google Cloud 服务账号或（仅限免费层级）AWS 账号 ID 是否已启用，可以访问 Assured OSS 代码库和精选软件包组合，请使用 API 列出可用的 Java 或 Python 软件包。为此，您可以直接调用 API，也可以使用 Cloud Shell 运行 curl 命令行调用 API。

如果您使用的是免费层级，在极少数情况下，您在提交客户启用表单后可能会遇到权限被拒错误，持续时间为一小时或更长时间。

本文档适用于高级层级和免费层级。

准备工作

安装最新版本的 Google Cloud CLI。如果您之前安装了 Google Cloud CLI，请运行以下命令，确保您拥有最新版本：
```
gcloud components update
```
如需使用访问 Assured OSS Google Cloud，请为已启用 Assured OSS 的服务账号的父 Google Cloud 项目启用 Artifact Registry API 。如果您使用的是高级层级，则该 API 会在设置期间启用。
将以下网址添加到网络的许可名单中：
- *.pkg.dev
- artifactregistry.googleapis.com

设置身份验证

对于 Google Cloud

生成并下载服务账号密钥。我们建议您遵循管理服务帐号的最佳实践。
如果您已登录 Google Cloud CLI，请撤消所有现有身份验证：
```
gcloud auth revoke
```
向进行身份验证 Google Cloud：
```
gcloud auth login --cred-file=FILEPATH.json
```
其中，FILEPATH 是服务帐号密钥的路径。
更新应用默认凭证：
```
export GOOGLE_APPLICATION_CREDENTIALS=FILEPATH.json
```
其中，FILEPATH 是服务帐号密钥的路径。

对于 AWS

以下步骤仅适用于 Assured OSS 的免费层级。

设置 EC2 实例以允许请求临时凭证。
1. 登录 AWS Management Console。
2. 在 AWS Management Console 中，前往 EC2 信息中心，然后选择目标 EC2 实例。
3. 依次选择 Actions > Security > Modify IAM Role 。
4. 依次选择 Create New IAM Role > Create role 。
5. 对于受信任的实体类型，请选择 AWS Service 。
6. 对于用例，请选择 EC2 。
7. 添加 AmazonEC2ReadOnlyAccess 权限，然后点击下一步 。
8. 为 IAM 角色提供一个有意义的名称，然后点击下一步 。
9. 返回修改 IAM 角色 。选择新创建的角色，然后点击 Update IAM Role 。
生成凭据配置文件：
```
gcloud iam workload-identity-pools create-cred-config \
projects/ASSIGNED_PROJECT_NUMBER/locations/global/workloadIdentityPools/aoss-wif-pool/providers/aws-AWS_ACCOUNT_ID-provider \
--service-account=aoss-wif-aws-AWS_ACCOUNT_ID-sa@ASSIGNED_PROJECT_ID.iam.gserviceaccount.com \
--aws \
--output-file=FILEPATH.json
```
替换以下内容：
- AWS_ACCOUNT_ID：您的 AWS 账号的 12 位数字（例如 123456789012）。
- FILEPATH：用于保存配置的文件。+ ASSIGNED_PROJECT_ID：分配给您的项目 ID，如启用邮件中所述。 Google Cloud + ASSIGNED_PROJECT_NUMBER：分配给您的 Google Cloud 项目编号，如启用邮件中所述。
如果您使用的是 AWS IMDSv2，请将标志 --enable-imdsv2 添加到前面的命令中。如需了解详情，请参阅创建凭据配置。
如果您已登录 Google Cloud CLI，请撤消所有现有身份验证：
```
gcloud auth revoke
```
向进行身份验证 Google Cloud：
```
gcloud auth login --cred-file=FILEPATH.json
```
其中，FILEPATH 是凭据配置文件的路径。
更新应用默认凭证：
```
export GOOGLE_APPLICATION_CREDENTIALS=FILEPATH.json
```
其中，FILEPATH 是服务帐号密钥或凭据配置文件的路径。

如需排查与身份验证相关的问题，请参阅排查身份验证错误。

列出 Assured OSS 中提供的所有 Java 软件包

您可以使用 REST API 列出所有 Java 软件包及其版本。

对于 Assured OSS 的免费层级，请输入以下 HTTP 请求：

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts"

对于 Assured OSS 的高级层级，请输入以下 HTTP 请求：

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/us/repositories/assuredoss-java/packages

将 PROJECT_ID 替换为您在设置 Assured OSS 时选择的项目的 ID。

以下是连接到免费层级中的 Java 代码库的示例 curl 命令：

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts"

该请求会返回类似于以下示例响应的响应：

  {
    "mavenArtifacts": [
      {
        "name":
  "projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts/com.alibaba:fastjson:1.2.83",
        "pomUri":
  "us-maven.pkg.dev/cloud-aoss/cloud-aoss-java/com/alibaba/fastjson/1.2.83/fastjson-1.2.83.pom",
        "groupId": "com.alibaba",
        "artifactId": "fastjson",
        "version": "1.2.83",
        "createTime": "2022-06-24T09:10:05.166879Z",
        "updateTime": "2022-06-24T09:10:05.166879Z"
      },
      {
        "name":
  "projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts/org.apache.logging.log4j:log4j-api:2.17.1",
        "pomUri":
  "us-maven.pkg.dev/cloud-aoss/cloud-aoss-java/org/apache/logging/log4j/log4j-api/2.17.1/log4j-api-2.17.1.pom",
        "groupId": "org.apache.logging.log4j",
        "artifactId": "log4j-api",
        "version": "2.17.1",
        "createTime": "2022-03-16T12:22:50.113695Z",
        "updateTime": "2022-03-16T12:22:50.113695Z"
      },
      {
        "name":
  "projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts/org.apache.logging.log4j:log4j-core:2.17.1",
      "pomUri":
  "us-maven.pkg.dev/cloud-aoss/cloud-aoss-java/org/apache/logging/log4j/log4j-core/2.17.1/log4j-core-2.17.1.pom",
        "groupId": "org.apache.logging.log4j",
        "artifactId": "log4j-core",
        "version": "2.17.1",
        "createTime": "2022-03-16T12:26:40.317215Z",
        "updateTime": "2022-03-16T12:26:40.317215Z"
      }
    ]
  }

如果有许多可用的软件包，API 响应可能会进行分页。如果列表不完整，则响应中会返回连续令牌 nextPageToken。nextPageToken 表示返回的最后一个结果。将 nextPageToken 的值传递给后续请求的 pageToken 参数时，系统将从最后一个结果之后开始返回下一页结果。

如需查看下一页结果，或增加每页返回的对象数量，请使用以下网址：

  "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts?pageSize=NUMBER&pageToken=NEXT_PAGE_TOKEN"

替换以下内容：

NUMBER：每页要返回的项数。接受的最大值为 1000。
NEXT_PAGE_TOKEN：JSON 响应中返回的 nextPageToken 令牌值。

或者，您也可以使用以下脚本将上述 API 请求的分页结果收集到一个文件中：

tempFile=$(mktemp)
nextPageToken=""
while
    curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
    "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts?pageSize=1000&pageToken=$nextPageToken" > $tempFile
    nextPageToken=$(grep nextPageToken $tempFile | sed 's/  "nextPageToken": "//' | sed 's/.$//')
    grep -v nextPageToken $tempFile >> FILENAME1
    [ -n "$nextPageToken" ]
do
:
done

可选：将主要 Java 软件包名称的排序列表写入 `FILENAME2`

以下额外的命令行操作会过滤返回的原始 Java 软件包列表，以便为您提供仅包含主要软件包名称的列表。

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts?pageSize=1000" \
      | grep artifactId | sort -f | uniq >  FILENAME2

可选：将 Java 软件包版本的排序列表写入 `FILENAME3`

以下额外的命令行操作会过滤返回的原始 Java 软件包列表，以便为您提供仅包含软件包版本的列表。

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-java/mavenArtifacts?pageSize=1000" \
      | grep name | sort -f | uniq >  FILENAME3

列出 Assured OSS 中提供的所有 Python 软件包

您可以使用 REST API 列出所有 Python 软件包及其版本。这些软件包适用于 Python 3.8。

对于 Assured OSS 的免费层级，请输入以下 HTTP 请求：

  GET https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages

对于 Assured OSS 的高级层级，请输入以下 HTTP 请求：

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
    "https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/us/repositories/assuredoss-python/packages"

将 PROJECT_ID 替换为您在设置 Assured OSS 时选择的项目的 ID。

如需列出特定于您的环境的所有软件包，请使用 generator.sh 脚本。

以下命令是连接到免费层级中的 Assured OSS Python 代码库的示例 curl 命令：

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages"

该请求会返回类似于以下示例响应的响应：

  {
  "pythonPackages": [
    {
      "name":
  "projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages/Flask:2.1.2",
      "uri":
  "us-python.pkg.dev/cloud-aoss/cloud-aoss-python/flask/Flask-2.1.2-py3-none-any.whl",
        "packageName": "Flask",
        "version": "2.1.2",
        "createTime": "2022-07-13T11:06:54.163313Z",
        "updateTime": "2022-07-13T11:06:54.163313Z"
    },
    {
      "name":
  "projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages/ujson:5.3.0",
        "uri":
  "us-python.pkg.dev/cloud-aoss/cloud-aoss-python/ujson/ujson-5.3.0-cp38-cp38-linux_x86_64.whl",
        "packageName": "ujson",
        "version": "5.3.0",
        "createTime": "2022-07-13T11:06:17.263638Z",
        "updateTime": "2022-07-13T11:06:17.263638Z"
      },
      {
        "name":
  "projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages/ujson:5.4.0",
        "uri":
  "us-python.pkg.dev/cloud-aoss/cloud-aoss-python/ujson/ujson-5.4.0-cp38-cp38-linux_x86_64.whl",
        "packageName": "ujson",
        "version": "5.4.0",
        "createTime": "2022-07-13T11:09:00.865162Z",
        "updateTime": "2022-07-13T11:09:00.865162Z"
      },
      {
        "name":
  "projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages/urllib3:1.26.8",
        "uri":
  "us-python.pkg.dev/cloud-aoss/cloud-aoss-python/urllib3/urllib3-1.26.8-py2.py3-none-any.whl",
        "packageName": "urllib3",
        "version": "1.26.8",
        "createTime": "2022-07-13T11:05:56.529484Z",
        "updateTime": "2022-07-13T11:05:56.529484Z"
      }
    ]
  }

如需查看下一页结果，或增加每页返回的对象数量，请在免费层级中使用以下网址：

  "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages?pageSize=NUMBER&pageToken=NEXT_PAGE_TOKEN"

替换以下内容：

NUMBER：每页要返回的项数。接受的最大值为 1000。
NEXT_PAGE_TOKEN：JSON 响应中返回的 nextPageToken 令牌值。

或者，您也可以使用以下脚本将上述 API 请求的分页结果收集到一个文件中。

tempFile=$(mktemp)
nextPageToken=""
while
    curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
    "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages?pageSize=1000&pageToken=$nextPageToken" > $tempFile
    nextPageToken=$(grep nextPageToken $tempFile | sed 's/  "nextPageToken": "//' | sed 's/.$//')
    grep -v nextPageToken $tempFile >> FILENAME4
    [ -n "$nextPageToken" ]
do
:
done

可选：将主要 Python 软件包名称的排序列表写入 `FILENAME5`

以下额外的命令行操作会过滤返回的原始 Python 软件包列表，以便为您提供仅包含主要软件包名称的列表。

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages?pageSize=1000" \
      | grep packageName | sort -f | uniq > FILENAME5

可选：将 Python 软件包版本的排序列表写入 `FILENAME6`

以下额外的命令行操作会过滤返回的原始 Python 软件包列表，以便为您提供仅包含软件包版本的列表。

  curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/cloud-aoss-python/pythonPackages?pageSize=1000" \
      | grep name | sort -f | uniq >  FILENAME6

列出 Assured OSS 中提供的所有 Go 软件包

您可以使用 REST API 列出所有 Go 软件包及其版本。

对于 Assured OSS 的免费层级，请输入以下 HTTP 请求：

curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages"

对于 Assured OSS 的高级层级，请输入以下 HTTP 请求：

curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://artifactregistry.googleapis.com/v1/projects/PROJECT_ID/locations/us/repositories/assuredoss-go/packages

将 PROJECT_ID 替换为您在设置 Assured OSS 时选择的项目的 ID。

以下是连接到免费层级中的 Go 代码库的示例 curl 命令：

curl -X GET -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages

该请求会返回类似于以下示例的响应：

{
  "packages": [
    {
      "name": "projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages/cloud.google.com%2Fgo%2Fauth",
      "createTime": "2025-08-05T06:04:54.442071Z",
      "updateTime": "2025-08-05T06:04:54.442071Z"
    },
    {
      "name": "projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages/cloud.google.com%2Fgo%2Fauth%2Foauth2adapt",
      "createTime": "2025-08-05T06:04:41.242052Z",
      "updateTime": "2025-08-05T06:04:41.242052Z"
    },
    {
      "name": "projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages/cloud.google.com%2Fgo%2Fcompute%2Fmetadata",
      "createTime": "2025-08-05T06:05:31.140186Z",
      "updateTime": "2025-08-05T06:05:31.140186Z"
    },
    {
      "name": "projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages/cloud.google.com%2Fgo%2Fiam",
      "createTime": "2025-08-05T06:04:54.455300Z",
      "updateTime": "2025-08-05T06:04:54.455300Z"
    },
    {
      "name": "projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages/cloud.google.com%2Fgo%2Flogging",
      "createTime": "2025-08-05T06:05:36.186851Z",
      "updateTime": "2025-08-05T06:05:36.186851Z"
    }
  ]
}

如果有许多可用的软件包，API 响应可能会进行分页。如果列表不完整，则响应中会返回连续令牌 nextPageToken。nextPageToken 表示返回的最后一个结果。将 nextPageToken 的值传递给后续请求的 pageToken 参数时，系统将从最后一个结果之后开始返回下一页结果。

如需查看下一页结果，或增加每页返回的对象数量，请使用以下网址：

"https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages?pageSize=NUMBER&pageToken=NEXT_PAGE_TOKEN"

替换以下内容：

NUMBER：每页要返回的项数。接受的最大值为 1000。
NEXT_PAGE_TOKEN：JSON 响应中返回的 nextPageToken 令牌值。

或者，您也可以使用以下脚本将 API 请求的分页结果收集到一个文件中：

tempFile=$(mktemp)
nextPageToken=""
while
    curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
    "https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages?pageSize=1000&pageToken=$nextPageToken" > $tempFile
    nextPageToken=$(grep nextPageToken $tempFile | sed 's/  "nextPageToken": "//' | sed 's/.$//')
    grep -v nextPageToken $tempFile >> FILENAME7
    [ -n "$nextPageToken" ]
do
:
done

可选：将主要 Go 软件包名称的排序列表写入 `FILENAME8`

以下操作会过滤返回的原始 Go 模块列表，以便为您提供主要软件包名称的列表：

curl -X GET -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages?pageSize=1000" \
      | grep name | sort -f | uniq >  FILENAME8

可选：将 Go 软件包版本的排序列表写入 `FILENAME9`

虽然无法直接发出 HTTP 请求来列出所有 Go 软件包版本，但您可以列出特定 Go 软件包的所有版本。您可以迭代列出 FILENAME8 列表中标识的每个 Go 软件包的版本，从而生成所有 Go 软件包版本的完整列表。

以下操作会过滤返回的原始 Go 软件包版本列表，以便为您提供软件包版本的列表：

grep -o "packages/.*" FILENAME8 | tr -d '",' | cut -d '/' -f 2 | while read package_name; do curl -X GET -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" https://artifactregistry.googleapis.com/v1/projects/cloud-aoss/locations/us/repositories/assuredoss-go-free/packages/$package_name/versions | grep name | sort -f | uniq >> FILENAME9; done

验证连接 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

设置身份验证

对于 Google Cloud

对于 AWS

列出 Assured OSS 中提供的所有 Java 软件包

可选：将主要 Java 软件包名称的排序列表写入 FILENAME2

可选：将 Java 软件包版本的排序列表写入 FILENAME3

列出 Assured OSS 中提供的所有 Python 软件包

可选：将主要 Python 软件包名称的排序列表写入 FILENAME5

可选：将 Python 软件包版本的排序列表写入 FILENAME6

列出 Assured OSS 中提供的所有 Go 软件包

可选：将主要 Go 软件包名称的排序列表写入 FILENAME8

可选：将 Go 软件包版本的排序列表写入 FILENAME9

后续步骤

验证连接

可选：将主要 Java 软件包名称的排序列表写入 `FILENAME2`

可选：将 Java 软件包版本的排序列表写入 `FILENAME3`

可选：将主要 Python 软件包名称的排序列表写入 `FILENAME5`

可选：将 Python 软件包版本的排序列表写入 `FILENAME6`

可选：将主要 Go 软件包名称的排序列表写入 `FILENAME8`

可选：将 Go 软件包版本的排序列表写入 `FILENAME9`