

Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用した CodeArtifact の例 AWS CLI
<a name="cli_2_codeartifact_code_examples"></a>

次のコード例は、CodeArtifact AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。

**Topics**
+ [アクション](#actions)

## アクション
<a name="actions"></a>

### `associate-external-connection`
<a name="codeartifact_AssociateExternalConnection_cli_2_topic"></a>

次のコード例は、`associate-external-connection` を使用する方法を示しています。

**AWS CLI**  
**リポジトリに外部接続を追加するには**  
次の `associate-external-connection` の例では、test-repo という名前のリポジトリに npmjs.com への外部接続を追加します。  

```
aws codeartifact associate-external-connection \
    --repository test-repo \
    --domain test-domain \
    --external-connection public:npmjs
```
出力:  

```
{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Add an external connection](https://docs.aws.amazon.com/codeartifact/latest/ug/external-connection.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[AssociateExternalConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/associate-external-connection.html)」を参照してください。

### `copy-package-versions`
<a name="codeartifact_CopyPackageVersions_cli_2_topic"></a>

次のコード例は、`copy-package-versions` を使用する方法を示しています。

**AWS CLI**  
**あるリポジトリから別のリポジトリにパッケージバージョンをコピーするには**  
次の `copy-package-versions` では、test-package という名前のパッケージのバージョン 4.0.0 および 5.0.0 を my-repo から test-repo に移動しています。  

```
aws codeartifact copy-package-versions \
    --domain test-domain \
    --source-repository my-repo \
    --destination-repository test-repo \
    --format npm \
    --package test-package \
    --versions '["4.0.0", "5.0.0"]'
```
出力:  

```
{
    "format": "npm",
    "package": "test-package",
    "versions": [
        {
        "version": "5.0.0",
        "revision": "REVISION-1-SAMPLE-6C81EFF7DA55CC",
        "status": "Published"
        },
        {
        "version": "4.0.0",
        "revision": "REVISION-2-SAMPLE-55C752BEE772FC",
        "status": "Published"
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Copy packages between repositories](https://docs.aws.amazon.com/codeartifact/latest/ug/copy-package.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CopyPackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/copy-package-versions.html)」を参照してください。

### `create-domain`
<a name="codeartifact_CreateDomain_cli_2_topic"></a>

次のコード例は、`create-domain` を使用する方法を示しています。

**AWS CLI**  
**ドメインを作成するには**  
次の `create-domain` の例では、test-domain という名前のドメインを作成します。  

```
aws codeartifact create-domain \
    --domain test-domain
```
出力:  

```
{
    "domain": {
        "name": "test-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain",
        "status": "Active",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Create a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-create.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/create-domain.html)」を参照してください。

### `create-repository`
<a name="codeartifact_CreateRepository_cli_2_topic"></a>

次のコード例は、`create-repository` を使用する方法を示しています。

**AWS CLI**  
**リポジトリを作成するには**  
次の `create-repository` の例では、test-domain という名前のドメイン内に test-repo という名前のリポジトリを作成します。  

```
aws codeartifact create-repository \
    --domain test-domain \
    --domain-owner 111122223333 \
    --repository test-repo \
    --description "This is a test repository."
```
出力:  

```
{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository.",
        "upstreams": [],
        "externalConnections": []
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Create a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/create-repo.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/create-repository.html)」を参照してください。

### `delete-domain-permissions-policy`
<a name="codeartifact_DeleteDomainPermissionsPolicy_cli_2_topic"></a>

次のコード例は、`delete-domain-permissions-policy` を使用する方法を示しています。

**AWS CLI**  
**ドメインからアクセス許可ポリシードキュメントを削除するには**  
次の `delete-domain-permissions-policy` の例では、test-domain という名前のドメインからアクセス許可ポリシーを削除します。  

```
aws codeartifact delete-domain-permissions-policy \
    --domain test-domain
```
出力:  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "BasicDomainPolicy",
            "Action": [
                "codeartifact:GetDomainPermissionsPolicy",
                "codeartifact:ListRepositoriesInDomain",
                "codeartifact:GetAuthorizationToken",
                "codeartifact:CreateRepository"
            ],
            "Effect": "Allow",
            "Resource": "*",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            }
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Delete a domain policy](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#deleting-a-domain-policy)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-domain-permissions-policy.html)」を参照してください。

### `delete-domain`
<a name="codeartifact_DeleteDomain_cli_2_topic"></a>

次のコード例は、`delete-domain` を使用する方法を示しています。

**AWS CLI**  
**ドメインを削除するには**  
次の `delete-domain` の例では、`test-domain` という名前のドメインを削除します。  

```
aws codeartifact delete-domain \
    --domain test-domain
```
出力:  

```
{
    "domain": {
        "name": "test-domain",
        "owner": "417498243647",
        "arn": "arn:aws:codeartifact:us-west-2:417498243647:domain/test-domain",
        "status": "Deleted",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:417498243647:key/c9fe2447-0795-4fda-afbe-8464574ae162",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Delete a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-domain.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-domain.html)」を参照してください。

### `delete-package-versions`
<a name="codeartifact_DeletePackageVersions_cli_2_topic"></a>

次のコード例は、`delete-package-versions` を使用する方法を示しています。

**AWS CLI**  
**パッケージのバージョンを削除するには**  
次の `delete-package-versions` の例では、test-package という名前のパッケージのバージョン 4.0.0 を削除します。  

```
aws codeartifact delete-package-versions \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0
```
出力:  

```
{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Deleted"
        }
    },
    "failedVersions": {}
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Delete a package version](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-package.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeletePackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-package-versions.html)」を参照してください。

### `delete-repository-permissions-policy`
<a name="codeartifact_DeleteRepositoryPermissionsPolicy_cli_2_topic"></a>

次のコード例は、`delete-repository-permissions-policy` を使用する方法を示しています。

**AWS CLI**  
**リポジトリからアクセス許可ポリシーを削除するには**  
次の `delete-repository-permissions-policy` の例では、test-repo という名前のリポジトリからアクセス許可ポリシーを削除します。  

```
aws codeartifact delete-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo
```
出力:  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": [
                "codeartifact:DescribePackageVersion",
                "codeartifact:DescribeRepository",
                "codeartifact:GetPackageVersionReadme",
                "codeartifact:GetRepositoryEndpoint",
                "codeartifact:ListPackages",
                "codeartifact:ListPackageVersions",
                "codeartifact:ListPackageVersionAssets",
                "codeartifact:ListPackageVersionDependencies",
                "codeartifact:ReadFromRepository"
            ],
            "Resource": "*"
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Delete a policy](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#deleting-a-policy)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-repository-permissions-policy.html)」を参照してください。

### `delete-repository`
<a name="codeartifact_DeleteRepository_cli_2_topic"></a>

次のコード例は、`delete-repository` を使用する方法を示しています。

**AWS CLI**  
**リポジトリを削除するには**  
次の `delete-repository` の例では、`test-domain` という名前のドメイン内にある `test-repo` という名前のリポジトリを削除します。  

```
aws codeartifact delete-repository \
    --domain test-domain \
    --repository test-repo
```
出力:  

```
{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository",
        "upstreams": [],
        "externalConnections": []
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Delete a repository](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-repo.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-repository.html)」を参照してください。

### `describe-domain`
<a name="codeartifact_DescribeDomain_cli_2_topic"></a>

次のコード例は、`describe-domain` を使用する方法を示しています。

**AWS CLI**  
**ドメインに関する情報を取得するには**  
次の `describe-domain` の例では、test-domain という名前のドメインに対して DomainDescription オブジェクトを返します。  

```
aws codeartifact describe-domain \
    --domain test-domain
```
出力:  

```
{
    "domain": {
        "name": "test-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain",
        "status": "Active",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryCount": 2,
        "assetSizeBytes": 0,
        "s3BucketArn": "arn:aws:s3:::assets-111122223333-us-west-2"
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Domain overview](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-overview.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/describe-domain.html)」を参照してください。

### `describe-repository`
<a name="codeartifact_DescribeRepository_cli_2_topic"></a>

次のコード例は、`describe-repository` を使用する方法を示しています。

**AWS CLI**  
**リポジトリに関する情報を取得するには**  
次の `describe-repository` の例では、test-repo という名前のリポジトリに対して RepositoryDescription オブジェクトを返します。  

```
aws codeartifact describe-repository \
    --domain test-domain \
    --repository test-repo
```
出力:  

```
{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository.",
        "upstreams": [],
        "externalConnections": []
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Create a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/create-repo.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/describe-repository.html)」を参照してください。

### `disassociate-external-connection`
<a name="codeartifact_DisassociateExternalConnection_cli_2_topic"></a>

次のコード例は、`disassociate-external-connection` を使用する方法を示しています。

**AWS CLI**  
**リポジトリから外部接続を削除するには**  
次の `disassociate-external-connection` の例では、test-repo という名前のリポジトリから npmjs.com への外部接続を削除します。  

```
aws codeartifact disassociate-external-connection \
    --repository test-repo \
    --domain test-domain \
    --external-connection public:npmjs
```
出力:  

```
{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "upstreams": [],
        "externalConnections": []
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Remove an external connection](https://docs.aws.amazon.com/codeartifact/latest/ug/external-connection.html#removing-an-external-connection)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DisassociateExternalConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/disassociate-external-connection.html)」を参照してください。

### `dispose-package-versions`
<a name="codeartifact_DisposePackageVersions_cli_2_topic"></a>

次のコード例は、`dispose-package-versions` を使用する方法を示しています。

**AWS CLI**  
**パッケージバージョンのアセットを削除し、そのステータスを [廃棄] に設定するには**  
次の `dispose-package-versions` の例では、test-package のバージョン 4.0.0 のアセットを削除し、そのステータスを [廃棄] に設定します。  

```
aws codeartifact dispose-package-versions \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0
```
出力:  

```
{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Disposed"
        }
    },
    "failedVersions": {}
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Working with packages in CodeArtifact](https://docs.aws.amazon.com/codeartifact/latest/ug/packages.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DisposePackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/dispose-package-versions.html)」を参照してください。

### `get-authorization-token`
<a name="codeartifact_GetAuthorizationToken_cli_2_topic"></a>

次のコード例は、`get-authorization-token` を使用する方法を示しています。

**AWS CLI**  
**認証トークンを取得するには**  
次の `get-authorization-token` の例では、CodeArtifact 認証トークンを取得します。  

```
aws codeartifact get-authorization-token \
    --domain test-domain \
    --query authorizationToken \
    --output text
```
出力:  

```
This command will return the authorization token. You can store the output in an environment variable when calling the command.
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Configure pip without the login command](https://docs.aws.amazon.com/codeartifact/latest/ug/python-configure-without-pip.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetAuthorizationToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-authorization-token.html)」を参照してください。

### `get-domain-permissions-policy`
<a name="codeartifact_GetDomainPermissionsPolicy_cli_2_topic"></a>

次のコード例は、`get-domain-permissions-policy` を使用する方法を示しています。

**AWS CLI**  
**ドメインのアクセス許可ポリシードキュメントを取得するには**  
次の `get-domain-permissions-policy` の例では、test-domain という名前のドメインにアタッチされたアクセス許可ポリシーを取得します。  

```
aws codeartifact get-domain-permissions-policy \
    --domain test-domain
```
出力:  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "BasicDomainPolicy",
            "Action": [
                "codeartifact:GetDomainPermissionsPolicy",
                "codeartifact:ListRepositoriesInDomain",
                "codeartifact:GetAuthorizationToken",
                "codeartifact:CreateRepository"
            ],
            "Effect": "Allow",
            "Resource": "*",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            }
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Read a domain policy](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#reading-a-domain-policy)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-domain-permissions-policy.html)」を参照してください。

### `get-package-version-asset`
<a name="codeartifact_GetPackageVersionAsset_cli_2_topic"></a>

次のコード例は、`get-package-version-asset` を使用する方法を示しています。

**AWS CLI**  
**パッケージバージョンからアセットを取得するには**  
次の `get-package-version-asset` の例では、test-package という名前の npm パッケージのバージョン 4.0.0 の `package.tgz` アセットを取得します。  

```
aws codeartifact get-package-version-asset \
    --domain test-domain \
    --repository test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0 \
    --asset 'package.tgz' \
    outfileName
```
出力:  

```
The output for this command will also store the raw asset in the file provided in place of outfileName.

{
    "assetName": "package.tgz",
    "packageVersion": "4.0.0",
    "packageVersionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs="
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[List package version assets](https://docs.aws.amazon.com/codeartifact/latest/ug/list-assets.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetPackageVersionAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-package-version-asset.html)」を参照してください。

### `get-package-version-readme`
<a name="codeartifact_GetPackageVersionReadme_cli_2_topic"></a>

次のコード例は、`get-package-version-readme` を使用する方法を示しています。

**AWS CLI**  
**パッケージバージョンの readme ファイルを取得するには**  
次の `get-package-version-readme` の例では、test-package という名前の npm パッケージのバージョン 4.0.0 の readme ファイルを取得します。  

```
aws codeartifact get-package-version-readme \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0
```
出力:  

```
{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "readme": "<div align=\"center\">\n   <a href=\https://github.com/test-package/testpack\"> ... more content ... \n",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs="
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[View package version readme file](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html#view-package-readme)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetPackageVersionReadme](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-package-version-readme.html)」を参照してください。

### `get-repository-endpoint`
<a name="codeartifact_GetRepositoryEndpoint_cli_2_topic"></a>

次のコード例は、`get-repository-endpoint` を使用する方法を示しています。

**AWS CLI**  
**リポジトリの URL エンドポイントを取得するには**  
次の `get-repository-endpoint` の例では、test-repo リポジトリに対して npm エンドポイントを返します。  

```
aws codeartifact get-repository-endpoint \
    --domain test-domain \
    --repository test-repo \
    --format npm
```
出力:  

```
{
    "repositoryEndpoint": "https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/"
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Connect to a repository](https://docs.aws.amazon.com/codeartifact/latest/ug/connect-repo.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetRepositoryEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-repository-endpoint.html)」を参照してください。

### `get-repository-permissions-policy`
<a name="codeartifact_GetRepositoryPermissionsPolicy_cli_2_topic"></a>

次のコード例は、`get-repository-permissions-policy` を使用する方法を示しています。

**AWS CLI**  
**リポジトリのアクセス許可ポリシードキュメントを取得するには**  
次の `get-repository-permissions-policy` の例では、test-repo という名前のリポジトリにアタッチされたアクセス許可ポリシーを取得します。  

```
aws codeartifact get-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo
```
出力:  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": [
                "codeartifact:DescribePackageVersion",
                "codeartifact:DescribeRepository",
                "codeartifact:GetPackageVersionReadme",
                "codeartifact:GetRepositoryEndpoint",
                "codeartifact:ListPackages",
                "codeartifact:ListPackageVersions",
                "codeartifact:ListPackageVersionAssets",
                "codeartifact:ListPackageVersionDependencies",
                "codeartifact:ReadFromRepository"
            ],
            "Resource": "*"
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Read a policy](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#setting-a-policy)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-repository-permissions-policy.html)」を参照してください。

### `list-domains`
<a name="codeartifact_ListDomains_cli_2_topic"></a>

次のコード例は、`list-domains` を使用する方法を示しています。

**AWS CLI**  
**ドメインを一覧表示するには**  
次の の`list-domains`例では、呼び出しを行う AWS アカウントが所有するすべてのドメインの概要を返します。  

```
aws codeartifact list-domains
```
出力:  

```
{
    "domains": [
        {
            "name": "my-domain",
            "owner": "111122223333",
            "status": "Active",
            "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
        },
        {
            "name": "test-domain",
            "owner": "111122223333",
            "status": "Active",
            "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Working with domains in CodeArtifact](https://docs.aws.amazon.com/codeartifact/latest/ug/domains.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-domains.html)」を参照してください。

### `list-package-version-assets`
<a name="codeartifact_ListPackageVersionAssets_cli_2_topic"></a>

次のコード例は、`list-package-version-assets` を使用する方法を示しています。

**AWS CLI**  
**パッケージバージョンのアセットを表示するには**  
次の `list-package-version-assets` の例では、test-package という名前の npm パッケージのバージョン 4.0.0 のアセットを取得します。  

```
aws codeartifact list-package-version-assets \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0
```
出力:  

```
{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
    "assets": [
        {
            "name": "package.tgz",
            "size": 316680,
            "hashes": {
                "MD5": "60078ec6d9e76b89fb55c860832742b2",
                "SHA-1": "b44a9b6297bcb698f1c51a3545a2b3b368d59c52",
                "SHA-256": "d2aa8c6afc3c8591765785a37d1c5acae482a8eb3ab9729ed28922692454f2e2",
                "SHA-512": "3e585d15c8a594e20d7de57b362ea81754c011acb2641a19f1b72c8531ea39825896bab344ae616a0a5a824cb9a381df0b3cddd534645cf305aba70a93dac698"
            }
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[List package version assets](https://docs.aws.amazon.com/codeartifact/latest/ug/list-assets.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListPackageVersionAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-version-assets.html)」を参照してください。

### `list-package-version-dependencies`
<a name="codeartifact_ListPackageVersionDependencies_cli_2_topic"></a>

次のコード例は、`list-package-version-dependencies` を使用する方法を示しています。

**AWS CLI**  
**パッケージバージョンの依存関係を表示するには**  
次の `list-package-version-dependencies` 例では、test-package という名前の npm パッケージのバージョン 4.0.0 の依存関係を取得します。  

```
aws codeartifact list-package-version-dependencies \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0
```
出力:  

```
{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
    "dependencies": [
        {
            "namespace": "testns",
            "package": "testdep1",
            "dependencyType": "regular",
            "versionRequirement": "1.8.5"
        },
        {
            "namespace": "testns",
            "package": "testdep2",
            "dependencyType": "regular",
            "versionRequirement": "1.8.5"
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[View and update package version details and dependencies](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListPackageVersionDependencies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-version-dependencies.html)」を参照してください。

### `list-package-versions`
<a name="codeartifact_ListPackageVersions_cli_2_topic"></a>

次のコード例は、`list-package-versions` を使用する方法を示しています。

**AWS CLI**  
**パッケージのパッケージバージョンを一覧表示するには**  
次の `list-package-versions` の例では、`kind-of` という名前のパッケージに対してパッケージバージョンのリストを返します。  

```
aws codeartifact list-package-versions \
    --package kind-of \
    --domain test-domain \
    --repository test-repo \
    --format npm
```
出力:  

```
{
    "defaultDisplayVersion": "1.0.1",
    "format": "npm",
    "package": "kind-of",
    "versions": [
        {
            "version": "1.0.1",
            "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
            "status": "Published"
        },
        {
            "version": "1.0.0",
            "revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC",
            "status": "Published"
        },
        {
            "version": "0.1.2",
            "revision": "REVISION-SAMPLE-3-654S65A5C5E1FC",
            "status": "Published"
        },
        {
            "version": "0.1.1",
            "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"",
            "status": "Published"
        },
        {
            "version": "0.1.0",
            "revision": "REVISION-SAMPLE-4-AF669139B772FC",
            "status": "Published"
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[List package versions](https://docs.aws.amazon.com/codeartifact/latest/ug/list-packages-versions.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListPackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-versions.html)」を参照してください。

### `list-packages`
<a name="codeartifact_ListPackages_cli_2_topic"></a>

次のコード例は、`list-packages` を使用する方法を示しています。

**AWS CLI**  
**リポジトリ内のパッケージを一覧表示するには**  
次の `list-packages` の例では、`test-domain` という名前のドメインにある `test-repo` という名前のリポジトリのパッケージを一覧表示します。  

```
aws codeartifact list-packages \
    --domain test-domain \
    --repository test-repo
```
出力:  

```
{
    "packages": [
        {
            "format": "npm",
            "package": "lodash"
        }
        {
            "format": "python",
            "package": "test-package"
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[List package names](https://docs.aws.amazon.com/codeartifact/latest/ug/list-packages.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListPackages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-packages.html)」を参照してください。

### `list-repositories-in-domain`
<a name="codeartifact_ListRepositoriesInDomain_cli_2_topic"></a>

次のコード例は、`list-repositories-in-domain` を使用する方法を示しています。

**AWS CLI**  
**ドメインのリポジトリを一覧表示するには**  
次の `list-repositories-in-domain` の例では、test-domain ドメイン内のすべてのリポジトリの概要を返します。  

```
aws codeartifact list-repositories-in-domain \
    --domain test-domain
```
出力:  

```
{
    "repositories": [
        {
            "name": "test-repo",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
            "description": "This is a test repository."
        },
        {
            "name": "test-repo2",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2",
            "description": "This is a test repository."
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[List repositories](https://docs.aws.amazon.com/codeartifact/latest/ug/list-repos.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListRepositoriesInDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-repositories-in-domain.html)」を参照してください。

### `list-repositories`
<a name="codeartifact_ListRepositories_cli_2_topic"></a>

次のコード例は、`list-repositories` を使用する方法を示しています。

**AWS CLI**  
**リポジトリを一覧表示するには**  
次の の`list-repositories`例では、呼び出しを行う AWS アカウントが所有するドメイン内のすべてのリポジトリの概要を返します。  

```
aws codeartifact list-repositories
```
出力:  

```
{
    "repositories": [
        {
            "name": "npm-store",
            "administratorAccount": "111122223333",
            "domainName": "my-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
            "description": "Provides npm artifacts from npm, Inc."
        },
        {
            "name": "target-repo",
            "administratorAccount": "111122223333",
            "domainName": "my-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/target-repo",
            "description": "test target repo"
        },
        {
            "name": "test-repo2",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2",
            "description": "This is a test repository."
        }
    ]
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[List repositories](https://docs.aws.amazon.com/codeartifact/latest/ug/list-repos.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListRepositories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-repositories.html)」を参照してください。

### `login`
<a name="codeartifact_Login_cli_2_topic"></a>

次のコード例は、`login` を使用する方法を示しています。

**AWS CLI**  
**ログインコマンドを使用してリポジトリへの認証を設定するには**  
次の `login` の例では、test-domain という名前のドメインにある test-repo という名前のリポジトリを使用して npm パッケージマネージャーを設定します。  

```
aws codeartifact login \
    --domain test-domain \
    --repository test-repo \
    --tool npm
```
出力:  

```
Successfully configured npm to use AWS CodeArtifact repository https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/
Login expires in 12 hours at 2020-11-12 01:53:16-05:00
```
詳細については、*AWS 「 CodeArtifact ユーザーガイド*[」の「 CLI AWS の開始方法](https://docs.aws.amazon.com/codeartifact/latest/ug/getting-started-cli.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[Login](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/login.html)」を参照してください。

### `put-domain-permissions-policy`
<a name="codeartifact_PutDomainPermissionsPolicy_cli_2_topic"></a>

次のコード例は、`put-domain-permissions-policy` を使用する方法を示しています。

**AWS CLI**  
**アクセス許可ポリシーをドメインにアタッチするには**  
次の `put-domain-permissions-policy` の例では、policy.json ファイルで定義されているアクセス許可ポリシーを test-domain という名前のドメインにアタッチします。  

```
aws codeartifact put-domain-permissions-policy \
    --domain test-domain \
    --policy-document file://PATH/TO/policy.json
```
出力:  

```
{
    "policy": {
        "resourceArn": "arn:aws:codeartifact:region-id:111122223333:domain/test-domain",
        "document": "{ ...policy document content...}",
        "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx="
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Set a domain policy](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#set-domain-policy)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[PutDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/put-domain-permissions-policy.html)」を参照してください。

### `put-repository-permissions-policy`
<a name="codeartifact_PutRepositoryPermissionsPolicy_cli_2_topic"></a>

次のコード例は、`put-repository-permissions-policy` を使用する方法を示しています。

**AWS CLI**  
**アクセス許可ポリシーをリポジトリにアタッチするには**  
次の `put-repository-permissions-policy` の例では、policy.json ファイルで定義されているアクセス許可ポリシーを test-repo という名前のリポジトリにアタッチします。  

```
aws codeartifact put-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo \
    --policy-document file://PATH/TO/policy.json
```
出力:  

```
{
    "policy": {
        "resourceArn": "arn:aws:codeartifact:region-id:111122223333:repository/test-domain/test-repo",
        "document": "{ ...policy document content...}",
        "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx="
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Set a policy](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#setting-a-policy)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[PutRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/put-repository-permissions-policy.html)」を参照してください。

### `update-package-versions-status`
<a name="codeartifact_UpdatePackageVersionsStatus_cli_2_topic"></a>

次のコード例は、`update-package-versions-status` を使用する方法を示しています。

**AWS CLI**  
**パッケージバージョンのステータスを更新するには**  
次の `update-package-versions-status` の例では、test-package パッケージのバージョン 4.0.0 のステータスを [アーカイブ済み] に更新します。  

```
aws codeartifact update-package-versions-status \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0 \
    --target-status Archived
```
出力:  

```
{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Archived"
        }
    },
    "failedVersions": {}
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[Update package version status](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html#update-package-version-status)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdatePackageVersionsStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/update-package-versions-status.html)」を参照してください。

### `update-repository`
<a name="codeartifact_UpdateRepository_cli_2_topic"></a>

次のコード例は、`update-repository` を使用する方法を示しています。

**AWS CLI**  
**リポジトリを更新するには**  
次の `update-repository` の例では、test-domain という名前のドメインの test-repo という名前のリポジトリの説明を「これは更新された説明です」に更新します。  

```
aws codeartifact update-repository \
    --domain test-domain \
    --repository test-repo \
    --description "this is an updated description"
```
出力:  

```
{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "this is an updated description",
        "upstreams": [],
        "externalConnections": []
    }
}
```
詳細については、「*AWS CodeArtifact ユーザーガイド*」の「[View or modify a repository configuration](https://docs.aws.amazon.com/codeartifact/latest/ug/config-repos.html)」を参照してください。  
+  API の詳細については、「*AWS CLI コマンドリファレンス*」の「[UpdateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/update-repository.html)」を参照してください。