翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# パッケージのバージョンの詳細と依存関係の表示および更新
CodeArtifact では、依存関係を含むパッケージのバージョンに関する情報を表示できます。パッケージバージョンのステータスを更新することもできます。パッケージのバージョンのステータスの詳細については、[パッケージバージョンのステータス](packages-overview.md#package-version-status)を参照してください。
## パッケージバージョンの詳細を表示
`describe-package-version`コマンドを使用して、パッケージのバージョンの詳細を表示します。パッケージバージョンの詳細は、パッケージが CodeArtifact に公開されるときにパッケージから抽出されます。異なるパッケージの詳細は異なり、形式や作成者が追加した情報の量によって異なります。
`describe-package-version`コマンドの出力にあるほとんどの情報は、パッケージ形式に応じて異なります。例えば、`describe-package-version`は`package.json`ファイルから npm パッケージの情報を抽出します。リビジョンは CodeArtifact によって作成されます。詳細については、「[パッケージバージョンリビジョンの指定](copy-package.md#specify-package-version-revision)」を参照してください。
同じ名前を持つ二つのパッケージバージョンは、それぞれ異なるネームスペースに存在する場合、同じリポジトリに配置できます。オプションの`--namespace`パラメータを使用して、ネームスペースを指定します。詳細については、[npm パッケージバージョンの詳細の表示](#describe-package-version-npm)または[Maven パッケージバージョンの詳細の表示](#describe-package-version-maven)を参照してください。
次の例では、`my_repo`リポジトリ内の`pyhamcrest`という名前の Python パッケージのバージョン`1.9.0`の詳細を返します。
```
aws codeartifact describe-package-version --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format pypi --package pyhamcrest --package-version 1.9.0
```
出力は次のようになります。
```
{
"format": "pypi",
"package": "PyHamcrest",
"displayName": "PyHamcrest",
"version": "1.9.0",
"summary": "Hamcrest framework for matcher objects",
"homePage": "https://github.com/hamcrest/PyHamcrest",
"publishedTime": 1566002944.273,
"licenses": [
{
"id": "license-id",
"name": "license-name"
}
],
"revision": "REVISION-SAMPLE-55C752BEE9B772FC"
}
```
**注記**
CodeArtifact は、パッケージのホームページやパッケージライセンス情報などのパッケージバージョンの詳細を、パッケージ作成者が提供するメタデータから取得します。この情報のいずれかが DynamoDB 項目の上限サイズである 400 KB を超える場合、CodeArtifact はそのデータを処理できず、コンソールまたは `describe-package-version` のレスポンスにこの情報が表示されない可能性があります。例えば、[https://pypi.org/project/rapyd-sdk/](https://pypi.org/project/rapyd-sdk/) などの Python パッケージのライセンスフィールドは非常に大きいため、この情報は CodeArtifact では処理されません。
## npm パッケージバージョンの詳細の表示
npm パッケージバージョンの詳細を表示するには、`--format` オプションの値を **npm** に設定します。`--namespace` オプションで、パッケージバージョンの名前空間 (npm *scope*) をオプションに含めます。`--namespace`オプションの値には`@`の先頭を含めないでください。ネームスペース`@types`を検索するには、値を *[タイプ]* に設定します。
以下は、`@types` スコープ内の `webpack` という名前の npm パッケージバージョン `4.41.5` の詳細を返します。
```
aws codeartifact describe-package-version --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format npm --package webpack --namespace types --package-version 4.41.5
```
出力は次のようになります。
```
{
"format": "npm",
"namespace": "types",
"package": "webpack",
"displayName": "webpack",
"version": "4.41.5",
"summary": "Packs CommonJs/AMD modules for the browser. Allows ... further output omitted for brevity",
"homePage": "https://github.com/webpack/webpack",
"sourceCodeRepository": "https://github.com/webpack/webpack.git",
"publishedTime": 1577481261.09,
"licenses": [
{
"id": "license-id",
"name": "license-name"
}
],
"revision": "REVISION-SAMPLE-55C752BEE9B772FC",
"status": "Published",
"origin": {
"domainEntryPoint": {
"externalConnectionName": "public:npmjs"
},
"originType": "EXTERNAL"
}
}
```
## Maven パッケージバージョンの詳細の表示
Maven パッケージバージョンの詳細を表示するには、`--format` オプションの値を `maven` に設定し、パッケージバージョンの名前空間を `--namespace` オプションに含めます。
次の例では、`org.apache.commons`ネームスペースと`my_repo`リポジトリに存在する`commons-rng-client-api`という名前の Maven パッケージのバージョン`1.2`の詳細を返します。
```
aws codeartifact describe-package-version --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format maven --namespace org.apache.commons --package commons-rng-client-api --package-version 1.2
```
出力は次のようになります。
```
{
"format": "maven",
"namespace": "org.apache.commons",
"package": "commons-rng-client-api",
"displayName": "Apache Commons RNG Client API",
"version": "1.2",
"summary": "API for client code that uses random numbers generators.",
"publishedTime": 1567920624.849,
"licenses": [],
"revision": "REVISION-SAMPLE-55C752BEE9B772FC"
}
```
**注記**
CodeArtifact は、親 POM ファイルからパッケージバージョンの詳細情報を抽出しません。特定のパッケージバージョンのメタデータには、正確なパッケージバージョンの POM 内の情報のみが含まれ、POM `parent` タグを使用して推移的に参照される親 POM やその他の POM の情報は含まれません。つまり、`describe-package-version` の出力では、このメタデータを含む `parent` 参照に依存している Maven パッケージバージョンのメタデータ (ライセンス情報など) は省略されます。
## パッケージバージョンの依存関係を表示する
`list-package-version-dependencies`コマンドを使用すると、パッケージバージョンの依存関係のリストを取得できます。次のコマンドは、`my_domain`ドメインの`my_repo`リポジトリのバージョン`4.41.5`の`my-package`という名前の npm パッケージの依存関係を一覧表示します。
```
aws codeartifact list-package-version-dependencies --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format npm --package my-package --package-version 4.41.5
```
出力は次のようになります。
```
{
"dependencies": [
{
"namespace": "webassemblyjs",
"package": "ast",
"dependencyType": "regular",
"versionRequirement": "1.8.5"
},
{
"namespace": "webassemblyjs",
"package": "helper-module-context",
"dependencyType": "regular",
"versionRequirement": "1.8.5"
},
{
"namespace": "webassemblyjs",
"package": "wasm-edit",
"dependencyType": "regular",
"versionRequirement": "1.8.5"
}
],
"versionRevision": "REVISION-SAMPLE-55C752BEE9B772FC"
}
```
dependencyType フィールドでサポートされている値の範囲については、*CodeArtifact API* の [PackageDependency](https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageDependency.html) データ型を参照してください。
## パッケージバージョンの readme ファイルの表示
npm などの一部のパッケージ形式には、`README`ファイルが含まれます。`get-package-version-readme`を使用してパッケージバージョンの`README`ファイルを取得します。次のコマンドは、`my_domain`ドメインの`my_repo`リポジトリにあるバージョン`4.41.5`の`my-package`という名前の npm パッケージの`README`ファイルを返します。
**注記**
CodeArtifact は、ジェネリックパッケージまたは Maven パッケージの readme ファイルの表示をサポートしていません。
```
aws codeartifact get-package-version-readme --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format npm --package my-package --package-version 4.41.5
```
出力は次のようになります。
```
{
"format": "npm",
"package": "my-package",
"version": "4.41.5"
"readme": "