# データセットのバージョンを管理する
<a name="datasets-versions"></a>

を使用して`CreateDatasetVersion`、現在のドラフトをイミュータブルな番号付きバージョンとして公開します。ドラフトは公開後も変更されず、 `draftStatus`から `MODIFIED`に変更されます`UNMODIFIED`。

## CreateDatasetVersion
<a name="datasets-create-version"></a>

次の例は、バージョンを発行する方法を示しています。

**Example**  

1. 

   ```
   agentcore dataset publish-version --name my_eval_dataset
   ```

1. 

   ```
   from bedrock_agentcore.evaluation import DatasetClient
   
   client = DatasetClient(region_name="us-west-2")
   
   ds = client.create_dataset_version_and_wait(datasetId="my-dataset-id")
   print(f"Published, draftStatus: {ds.get('draftStatus')}")
   ```

1. 

   ```
   import boto3
   
   client = boto3.client('bedrock-agentcore-control')
   
   client.create_dataset_version(datasetId='my-dataset-id')
   ```

1. 

   ```
   aws bedrock-agentcore-control create-dataset-version \
       --dataset-id my-dataset-id
   ```

## ListDatasetVersions
<a name="datasets-list-versions"></a>

最初にソートされた最新の公開バージョンを返します。各バージョンの概要には、`datasetVersion`、`exampleCount`、および が含まれます`createdAt`。

次の例は、バージョンを一覧表示する方法を示しています。

**Example**  

1. 

   ```
   agentcore status --type dataset
   ```

1. 

   ```
   from bedrock_agentcore.evaluation import DatasetClient
   
   client = DatasetClient(region_name="us-west-2")
   
   resp = client.list_dataset_versions(datasetId="my-dataset-id")
   for v in resp["versions"]:
       print(f"  Version {v['datasetVersion']}: {v['exampleCount']} examples")
   ```

1. 

   ```
   import boto3
   
   client = boto3.client('bedrock-agentcore-control')
   
   resp = client.list_dataset_versions(datasetId='my-dataset-id')
   for v in resp['versions']:
       print(f"  Version {v['datasetVersion']}: {v['exampleCount']} examples")
   ```

1. 

   ```
   aws bedrock-agentcore-control list-dataset-versions \
       --dataset-id my-dataset-id
   ```