翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# データセットを に追加する AWS Data Exchange
**注記**
タイプ `AddDataSets` の Catalog API 変更セットを使用して追加されたデータセットには、デフォルトで製品の発行メソッドが設定されます。
AWS Data Exchange 製品にデータセットを追加するには、タイプ の変更セットを開始します`AddDataSets`。これを実行するには、`StartChangeSet` API 操作を使用して、変更タイプ、製品識別子、製品タイプ、およびデータセットの Amazonリソースネーム (ARN) を含めた詳細を指定することができます。
## チュートリアル: 公開済みのデータ製品への新しいデータセットの追加
このチュートリアルでは、公開済み製品に新しい AWS Data Exchange データセットを追加する詳細な手順について説明します。このチュートリアルのおおまかな手順は以下のとおりです。
**Topics**
+ [IAM 許可をセットアップする](#data-set-catalog-iam-permissions)
+ [AWS Marketplace Catalog API にアクセスする](#data-set-access-catalog-api)
+ [AWS Data Exchange コンソールから製品 ID を取得する](#get-data-set-exchange-product-id)
+ [変更リクエストを開始する](#start-data-set-change-request)
+ [変更セットのステータスをチェックする](#check-data-set-change-status)
### IAM 許可をセットアップする
開始する前に、 AWS Marketplace Catalog API を使用するための AWS Identity and Access Management (IAM) アクセス許可が必要です。これらのアクセス許可は、 を使用するために必要なアクセス許可に追加されます AWS Data Exchange。
1. ブラウザを IAM コンソールに移動し、IAM アクセス許可を管理 AWS アカウント できる を使用してサインインします。
1. 左側のナビゲーションペインで **[ポリシー]** を選択します。
1. **[ポリシーを作成]** を選択します。
1. **[JSON]** タブを選択して、以下の許可を入力します。これにより、 AWS Marketplace Catalog API へのフルアクセスが提供されます。アクセス権は、ユースケースの必要に応じて制限できます。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:CancelChangeSet",
"aws-marketplace:ListChangeSets",
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet",
"aws-marketplace:ListEntities",
"aws-marketplace:DescribeChangeSet",
"dataexchange:PublishDataSet"
],
"Resource": "*"
}
]
}
```
------
1. **[次へ: レビュー]** を選択します。
1. ポリシーの名前 (**CatalogAPIFullAccess** など) を入力してから、**[ポリシーを作成]** を選択します。
1. IAM コンソールを使用して、ポリシーをアタッチするユーザー、グループ、またはロールを選択します。
### AWS Marketplace Catalog API にアクセスする
AWS Marketplace Catalog API にアクセスするには、次の HTTP クライアントエンドポイントを使用します。
```
catalog.marketplace.us-east-1.amazonaws.com
```
### AWS Data Exchange コンソールから製品 ID を取得する
AWS Marketplace Catalog API を使用して新しいデータセットを発行する前に、 AWS Data Exchange コンソールから製品 ID を取得します。**[Product]** (製品) ダッシュボードに移動して、データセットを発行する製品 ID をコピーします。[AWS Marketplace Catalog API](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html) は、**DataProduct@1.0** エンティティタイプと共に `ListEntities` アクションを使用することで、製品 ID を検索するためにも使用できます。
### 変更リクエストを開始する
**変更リクエストを開始してテスト製品にデータセットを追加する**
1. 「[AWS Data Exchange コンソールから製品 ID を取得する](#get-data-set-exchange-product-id)」の手順に従って取得できるエンティティ ID をコピーします。
1. `AddDataSets` 変更タイプを使用して `StartChangeSet` リクエストを実行します。
**注記**
AWS Marketplace Catalog API での変更セットの操作については、[「変更セットの操作](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets)」を参照してください。エンティティの識別子の使用に関する詳細については、「[識別子](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#identifier)」を参照してください。
**リクエストの例**
```
https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet
```
**リクエストボディの例**
```
{
"Catalog": "AWSMarketplace",
"ChangeSetName": "Adding Data Set to my test Data Product",
"ChangeSet": [
{
"ChangeType": "AddDataSets",
"Entity": {
"Identifier": "entity-id@1",
"Type": "DataProduct@1.0"
},
"Details": "{ \"DataSets\": [ { \"Arn\": \"data-set-arn\" } ] }"
}
]
}
```
**レスポンスの例**
```
{
"ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh"
}
```
### 変更セットのステータスをチェックする
`StartChangeSet` API 操作を使用して変更リクエストを開始したら、`DescribeChangeSet` 操作を使用してそのステータスをチェックできます。`StartChangeSet` API レスポンスで返された変更セット ID を入力します。
**リクエストの例**
```
https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh
```
**リクエストボディの例**
```
{
"changeSetId":"cs-bnEXAMPLE4mkz9oh"
}
```
**レスポンスの例**
```
{
"ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh",
"ChangeSetName": "Adding Data Set to my test Data Product",
"StartTime": "2018-09-20T19:45:03.115+0000",
"EndTime": "2018-09-20T19:48:12.517+0000",
"Status": "SUCCEEDED",
"FailureDescription": null,
"ChangeSet": [
{
"ChangeType": "AddDataSets",
"Entity": {
"Type": "DataProduct@1.0",
"Identifier": "entity-id@1"
},
"ErrorList": []
}
]
}
```
## AddDataSets 例外
AWS Marketplace Catalog API を で使用すると、次の例外が発生する可能性があります AWS Data Exchange。
**DATA\$1SET\$1NOT\$1FOUND**
これは、リクエストされたデータセットが見つからなかった場合に発生します。この問題を解決するには、データセット ARN にタイプミスがなく、 がデータセット AWS アカウント を所有していることを確認し、もう一度試してください。
**INVALID\$1INPUT**
無効な入力が原因で、リクエストを処理できませんでした。この問題を解決するには、リクエストにタイプミスがないことと、製品がデータセットの許容最大数を超えていないことを確認してください。
**DATA\$1SET\$1ALREADY\$1PUBLISHED**
これは、製品にデータセットが既に追加されている場合に発生します。
**DATA\$1SET\$1DUPLIATE\$1PROVIDED**
これは、リクエスト内で同じデータセットが複数回提供されている場合に発生します。