个人版资源级 API 接口及授权方案变更指南

Recent Pages

个人版资源级 API 接口及授权方案变更指南

最后更新时间：2024-12-02 14:49:53

概述
容器镜像服务（TCR）同时向企业客户及个人用户提供容器镜像托管分发服务。其中，个人版为用户提供简单、免费的基础服务，即当前容器服务（TKE）内的镜像仓库。
为向用户提供接口定义更加规范，访问时延下降显著的 API 接口服务，原有个人版镜像仓库（CCR）的 API 接口已由 2.0 版本升级至最新的 3.0 版本，接口名称及授权方案也发生了相应变更。本文档介绍了支持资源级鉴权的 API 升级后新旧接口映射关系及如何使用最新的授权方案。
API 映射关系
API 2.0 名称
API 3.0 名称
接口描述
最新资源（Resource）描述方式
CreateCCRNamespace
CreateNamespacePersonal
创建个人版命名空间
qcs::tcr:$region:$account:repo/$namespace
DeleteUserNamespace
DeleteNamespacePersonal
删除个人版命名空间
qcs::tcr:$region:$account:repo/$namespace
GetUserRepositoryList
DescribeRepositoryOwnerPersonal
查询个人版所有仓库
qcs::tcr:$region:$account:repo/*
CreateRepository
CreateRepositoryPersonal
创建个人版镜像仓库
qcs::tcr:$region:$account:repo/$namespace/$repo
DeleteRepository
DeleteRepositoryPersonal
删除个人版镜像仓库
qcs::tcr:$region:$account:repo/$namespace/$repo
BatchDeleteRepository
BatchDeleteRepositoryPersonal
批量删除个人版镜像仓库
qcs::tcr:$region:$account:repo/$namespace/*
DeleteTag
DeleteImagePersonal
删除个人版仓库 tag
qcs::tcr:$region:$account:repo/$namespace/$repo
BatchDeleteTag
BatchDeleteImagePersonal
批量删除个人版仓库 tag
qcs::tcr:$region:$account:repo/$namespace/$repo
pull
PullRepositoryPersonal
拉取个人版镜像仓库内镜像
qcs::tcr:$region:$account:repo/$namespace/$repo
push
PushRepositoryPersonal
推送个人版镜像仓库内镜像
qcs::tcr:$region:$account:repo/$namespace/$repo
授权方案映射关系
由于产品名称及 API 接口版本的升级变更，TCR 个人版原有的资源（Resource）描述方式及动作（Action）发生了相应变更，请您在使用 API 3.0接口的同时，使用最新的资源及操作授权方案。
API 升级期间，访问管理相关接口将同时兼容新旧的资源（Resource）描述方式及动作（Action），以保障用户自定义策略仍然生效。为方便您统一管理 API 接口及授权方案，建议您统一将授权方案升级为最新版本，详情请参考 个人版授权方案示例。
旧版资源级授权方案
动作（Action）：以 ccr 作为产品前缀，API 接口名称为2.0版本。例如，创建命名空间为 ccr:CreateCCRNamespace。
资源描述（Resource）：以 ccr 作为产品名称，仅有 repo 资源类型。例如，描述命名空间 namespace-a 下的镜像仓库 repo-b，则为 qcs::ccr:::repo/namespace-a/repo-b。其中，$region，$account 若置空，则默认为全部地域，账号默认为创建策略的 CAM 用户所属的主账号。
具体授权方案请参考：TKE 镜像仓库资源级权限设置。
新版资源级授权方案
动作（Action）： 以 tcr 作为产品前缀，API 接口名称为3.0版本。例如，创建个人版命名空间为 tcr:CreateNamespacePersonal。
资源描述（Resource）：以 tcr 作为产品名称，具有 instance、repository 和repo 三种资源类型。其中，repo 为个人版专属的资源类型。例如，描述个人版命名空间 namespace-a 下的镜像仓库 repo-b，则为 qcs::tcr:$region:$account:repo/namespace-a/repo-b。其中，$region,$account 若置空，则默认为全部地域，账号默认为创建策略的 CAM 用户所属的主账号。
具体授权方案请参考：个人版接入 CAM 的 API 列表 及 个人版授权方案示例。
新旧授权方案兼容示例
例如，授权子账号可读默认地域下 namespace-a 命名空间内的 repo-b 的镜像仓库，该镜像仓库为个人版。则仅能查询仓库信息、拉取该仓库内镜像，但无法删除仓库、修改仓库属性及推送镜像。
旧版授权方案：
{
    "version": "2.0",
    "statement": [{
        "action": [
            "ccr:pull"
        ],
        "resource": "qcs::ccr:::repo/namespace-a/repo-b",
        "effect": "allow"
    }]
}
新版授权方案：
{
    "version": "2.0",
    "statement": [{
        "action": [
            "tcr:PullRepositoryPersonal"
        ],
        "resource": "qcs::tcr:::repo/namespace-a/repo-b",
        "effect": "allow"
    }]
}
﻿

联系我们

联系我们，为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持

tencent cloud

Recent Pages

个人版资源级 API 接口及授权方案变更指南

概述

API 映射关系

授权方案映射关系

旧版资源级授权方案

新版资源级授权方案

新旧授权方案兼容示例

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

API 2.0 名称	API 3.0 名称	接口描述	最新资源（Resource）描述方式
CreateCCRNamespace	CreateNamespacePersonal	创建个人版命名空间	`qcs::tcr:$region:$account:repo/$namespace`
DeleteUserNamespace	DeleteNamespacePersonal	删除个人版命名空间	`qcs::tcr:$region:$account:repo/$namespace`
GetUserRepositoryList	DescribeRepositoryOwnerPersonal	查询个人版所有仓库	`qcs::tcr:$region:$account:repo/*`
CreateRepository	CreateRepositoryPersonal	创建个人版镜像仓库	`qcs::tcr:$region:$account:repo/$namespace/$repo`
DeleteRepository	DeleteRepositoryPersonal	删除个人版镜像仓库	`qcs::tcr:$region:$account:repo/$namespace/$repo`
BatchDeleteRepository	BatchDeleteRepositoryPersonal	批量删除个人版镜像仓库	`qcs::tcr:$region:$account:repo/$namespace/*`
DeleteTag	DeleteImagePersonal	删除个人版仓库 tag	`qcs::tcr:$region:$account:repo/$namespace/$repo`
BatchDeleteTag	BatchDeleteImagePersonal	批量删除个人版仓库 tag	`qcs::tcr:$region:$account:repo/$namespace/$repo`
pull	PullRepositoryPersonal	拉取个人版镜像仓库内镜像	`qcs::tcr:$region:$account:repo/$namespace/$repo`
push	PushRepositoryPersonal	推送个人版镜像仓库内镜像	`qcs::tcr:$region:$account:repo/$namespace/$repo`

tencent cloud

注册

登录

Recent Pages

个人版资源级 API 接口及授权方案变更指南

概述

API 映射关系

授权方案映射关系

旧版资源级授权方案

新版资源级授权方案

新旧授权方案兼容示例

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？