第4章 REST API を使用して Apicurio Registry コンテンツを管理する

手順

1. /groups/{group}/artifacts 操作を使用してアーティファクトをレジストリーに追加します。以下の curl コマンドの例は、株価アプリケーションの単純なアーティファクトを追加します。

   $ curl -X POST -H "Content-type: application/json; artifactType=AVRO" \
     -H "X-Registry-ArtifactId: share-price" \ 

   1

   
     --data '{"type":"record","name":"price","namespace":"com.example", \
      "fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}' \ 

   2

   
     http://MY-REGISTRY-HOST/apis/registry/v2/groups/my-group/artifacts 

   3

   1

   この例では、 share-price のアーティファクト ID を持つ Avro スキーマアーティファクトを追加します。一意のアーティファクト ID を指定しない場合、Apicurio Registry は UUID として自動的に生成します。

   2

   MY-REGISTRY-HOST は、Apicurio Registry がデプロイされているホスト名です。例: my-cluster-service-registry-myproject.example.com

   3

   この例では、API パスで my-group のグループ ID を指定します。一意のグループ ID を指定しない場合は、API パスで ../groups/default を指定する必要があります。

2. 応答に、アーティファクトが追加されたことを確認するために、想定される JSON body が含まれていることを確認します。以下に例を示します。

   {"createdBy":"","createdOn":"2021-04-16T09:07:51+0000","modifiedBy":"",
   "modifiedOn":"2021-04-16T09:07:51+0000","id":"share-price","version":"1", 

   1

   
   "type":"AVRO","globalId":2,"state":"ENABLED","groupId":"my-group","contentId":2} 

   2

   1

   アーティファクトの追加時にバージョンが指定されなかったため、デフォルトのバージョン 1 が自動的に作成されます。

   2

   これはレジストリーに追加された 2 つ目のアーティファクトであるため、グローバル ID とコンテンツ ID の値は 2 になります。

3. API パスでアーティファクト ID を使用して、レジストリーからアーティファクトコンテンツを取得します。この例では、指定された ID は share-price です。

   $ curl http://MY-REGISTRY-URL/apis/registry/v2/groups/my-group/artifacts/share-price \
   {"type":"record","name":"price","namespace":"com.example", \
     "fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}