tencent cloud

Tencent Container Registry

ドキュメントTencent Container Registry操作ガイドパーソナル版操作ガイドアクセス権限の設定パーソナル版リソースレベル API インターフェースおよび権限付与ソリューション変更ガイド

パーソナル版リソースレベル API インターフェースおよび権限付与ソリューション変更ガイド

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-20 20:16:47
AI翻訳

概要

Tencent Container Registry（TCR）は、企業のお客様と個人ユーザーの両方にコンテナイメージのホスティングおよび配信サービスを提供しています。このうち、パーソナル版はユーザーにシンプルで無料の基本サービス、すなわち現在の Tencent Kubernetes Engine（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
パーソナル版リポジトリのタグを削除します
qcs::tcr:$region:$account:repo/$namespace/$repo
BatchDeleteTag
BatchDeleteImagePersonal
パーソナル版リポジトリのタグを一括削除します
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 アップグレード期間中、アクセス管理（CAM）関連のインターフェースは新旧両方のリソース（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 の 3 種類のリソースタイプがあります。このうち、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"
    }]
}

前の記事へ: パーソナル版権限付与ソリューション例次の記事へ: イメージクリーンアップの設定

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック

キーワードで検索
    Enter keywords to search documentation