翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CodeArtifact イベントをモニタリングする
CodeArtifact は、CodeArtifact リポジトリの変更などのイベントに自動で対応するサービス Amazon EventBridge と統合されています。イベントのルールを作成し、イベントがルールに一致したときの動作を設定できます。EventBridge は、以前は CloudWatch Events と呼ばれていました。
イベントをトリガーとして、以下のアクションを実行できます。
+ AWS Lambda 関数の呼び出し。
+ AWS Step Functions ステートマシンのアクティブ化。
+ Amazon SNS トピックまたは Amazon SQS キューの通知。
+ でパイプラインを開始します AWS CodePipeline。
CodeArtifact は、パッケージのバージョンが作成、変更、または削除されたときにイベントを作成します。以下は、CodeArtifact のイベントの例です。
+ 新しいパッケージバージョンを公開する (例えば、`npm publish` を実行する)。
+ 既存のパッケージバージョンに新しいアセットを追加する (例えば、新しい JAR ファイルを既存の Maven パッケージにプッシュする)。
+ `copy-package-versions` を使用して、あるリポジトリから別のリポジトリにパッケージバージョンをコピーする。詳細については、「[リポジトリ間でのパッケージのコピー](copy-package.md)」を参照してください。
+ `delete-package-versions` を使用してパッケージバージョンを削除します。詳細については、「[パッケージまたはパッケージバージョンを削除する](delete-package.md)」を参照してください。
+ `delete-package` を使用してパッケージバージョンを削除します。削除されたパッケージバージョンごとに 1 つのイベントが公開されます。詳細については、「[パッケージまたはパッケージバージョンを削除する](delete-package.md)」を参照してください。
+ アップストリームリポジトリからフェッチされたパッケージバージョンをダウンストリームリポジトリに保持する。詳細については、「[CodeArtifact でアップストリームリポジトリを操作する](repos-upstream.md)」を参照してください。
+ 外部リポジトリからパッケージバージョンを CodeArtifact リポジトリに取り込みます。詳細については、「[CodeArtifact リポジトリをパブリックリポジトリに接続する](external-connection.md)」を参照してください。
イベントは、ドメインを所有するアカウントと、リポジトリを管理するアカウントの両方に配信されます。例えば、そのアカウント `111111111111` がドメイン `my_domain` を所有しているとします。アカウント `222222222222` が `repo2` という `my_domain` でリポジトリを作成します。新しいパッケージのバージョンが `repo2` に公開される際は、両方のアカウントが EventBridge イベントを受信します。ドメイン所有アカウント (`111111111111`) は、ドメイン内のすべてのリポジトリのイベントを受信します。ひとつのアカウントがドメインとその中のリポジトリの両方を所有している場合、1 つのイベントのみが配信されます。
次のトピックでは、CodeArtifact イベントの形式について説明します。CodeArtifact イベントを設定する方法と、他の AWS サービスでイベントを使用する方法について説明します。詳細については、*Amazon EventBridge ユーザーガイド*の[Amazon EventBridge の開始方法](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html)を参照してください 。
## CodeArtifact イベントの形式と例
以下は、CodeArtifactイベントの例と、イベントのフィールドとその説明です。
### CodeArtifact イベントの形式
すべての CodeArtifact イベントには次のフィールドがあります。
| イベントフィールド | 説明 |
| --- | --- |
| version (バージョン) | イベント形式のバージョン。現在は単一のバージョン、「0」しかありません。 |
| ID | イベントに固有の識別子。 |
| detail-type (ディテールタイプ) | イベントのタイプ。これにより、detail オブジェクト内のフィールドが決定されます。現在サポートされているひとつのdetail-type は CodeArtifact Package Version State Change です。 |
| source (ソース) | イベントのソース。CodeArtifact の場合、aws.codeartifactです。 |
| account (アカウント) | イベントを受信する AWS アカウントのアカウント ID。 |
| time (タイム) | イベントがトリガーされた正確な時刻。 |
| region (リージョン) | イベントがトリガーされたリージョン。 |
| resources (リソース) | 変更されたパッケージの ARN を含むリスト。リストにはひとつのエントリが含まれています。パッケージ ARN 形式の詳細については、[パッケージへの書き込みアクセスを許可する](repo-policies.md#granting-write-access-to-specific-packages)を参照してください。 |
| domainName (ドメインネーム) | パッケージを含むリポジトリを含むドメイン。 |
| domainOwner (ドメインオーナー) | ドメインの所有者の AWS アカウント ID。 |
| repositoryName (リポジトリネーム) | パッケージを含むリポジトリ。 |
| repositoryAdministrator | リポジトリの管理者の AWS アカウント ID。 |
| packageFormat (パッケージフォーマット) | イベントをトリガーしたパッケージの形式。 |
| packageNamespace (パッケージネームスペース) | イベントをトリガーしたパッケージの名前スペース。 |
| packageName (パッケージネーム) | イベントをトリガーしたパッケージの名前。 |
| packageVersion (パッケージバージョン) | イベントをトリガーしたパッケージのバージョン。 |
| packageVersionState (パッケージバージョンステート) | イベントがトリガーされたときのパッケージバージョンの状態。使用できる値は Unfinished、Published、Unlisted、Archived および Disposed です。 |
| packageVersionRevision (パッケージバージョンリビジョン) | イベントがトリガーされたときの、パッケージバージョンのアセットとメタデータの状態をユニークに識別する値。パッケージのバージョンが変更された場合 (例えば、別の JAR ファイルを Maven パッケージに追加した場合)、packageVersionRevision が変わります。 |
| changes.assetsAdded (チェンジズアセットアディッド) | イベントをトリガーしたパッケージに追加されたアセットの数。アセットの例としては、Maven JAR ファイルやPython ホイールがあります。 |
| changes.assetsRemoved (チェンジズアセットリムーブド) | イベントをトリガーしたパッケージから削除されたアセットの数。 |
| Changes.assetsUpdated (チェンジズアセットアップデーテッド) | イベントをトリガーしたパッケージ内で変更されたアセットの数。 |
| changes.metadataUpdated (チェンジズメタデータアップデ―テッド) | 変更されたパッケージレベルのメタデータがイベントに含まれている場合、trueに設定されたブール値。例えば、あるイベントが Maven pom.xml ファイルを変更する場合。 |
| changes.statusChanged (チェンジズステータスチェンジド) | イベントの packageVersionStatus が変更されている場合、true に設定されたブール値 (例えば、packageVersionStatus が Unfinished から Published に変更するなど)。 |
| operationType (オペレーションタイプ) | パッケージのバージョン変更の上位タイプについて説明します。指定できる値は、Created、Updated および Deleted です。 |
| sequenceNumber (シーケンスナンバー) | パッケージのイベント番号を指定する整数。パッケージ上の各イベントは、sequenceNumber を増加させるので、イベントを順次配置することができます イベントは、任意の整数によって sequenceNumber を増加させることができます。 EventBridge イベントは、順不同で受信される場合があります。`sequenceNumber` は実際の順序を決定するために使用できます。 |
| eventDeduplicationId (イベントデュプリケーションID) | 重複する EventBridge イベントを区別するために使用される ID。まれに、EventBridge は、単一のイベントまたはスケジュールされた時刻に対して、同じルールを複数回トリガーする場合があります。または、特定のトリガールールに対して、同じターゲットを複数回呼び出す場合があります。 |
### CodeArtifact イベントの例
以下は、npm パッケージの公開時にトリガーされる可能性がある CodeArtifact イベントの例です。
```
{
"version":"0",
"id":"73f03fec-a137-971e-6ac6-07c8ffffffff",
"detail-type":"CodeArtifact Package Version State Change",
"source":"aws.codeartifact",
"account":"123456789012",
"time":"2019-11-21T23:19:54Z",
"region":"us-west-2",
"resources":["arn:aws:codeartifact:us-west-2:111122223333:package/my_domain/myrepo/npm//mypackage"],
"detail":{
"domainName":"my_domain",
"domainOwner":"111122223333",
"repositoryName":"myrepo",
"repositoryAdministrator":"123456789012",
"packageFormat":"npm",
"packageNamespace":null,
"packageName":"mypackage",
"packageVersion":"1.0.0",
"packageVersionState":"Published",
"packageVersionRevision":"0E5DE26A4CD79FDF3EBC4924FFFFFFFF",
"changes":{
"assetsAdded":1,
"assetsRemoved":0,
"metadataUpdated":true,
"assetsUpdated":0,
"statusChanged":true
},
"operationType":"Created",
"sequenceNumber":1,
"eventDeduplicationId":"2mEO0A2Ke07rWUTBXk3CAiQhdTXF4N94LNaT/ffffff="
}
}
```