4.2. 使用 Registry REST API 命令管理 schema 和 API 工件版本

流程

1. 使用 /groups/{group}/artifacts 操作在注册表中添加工件版本。以下示例 curl 命令为共享价格应用程序添加简单的工件：

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

   1

   
     --data '{"type":"record","name":" p","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

   这个示例添加了一个 Avro schema 工件，其工件 ID 为 my-share-price 和 1.1.1 版本。如果没有指定版本，Apicurio Registry 会自动生成默认版本 1。

   2

   MY-REGISTRY-HOST 是部署 Apicurio Registry 的主机名。例如： my-cluster-service-registry-myproject.example.com。

   3

   本例在 API 路径中指定 my-group 的组 ID。如果没有指定唯一组 ID，则必须在 API 路径中指定 ./groups/default。

2. 验证响应是否包含预期的 JSON 正文，以确认是否添加了自定义工件版本。例如：

   {"createdBy":"","createdOn":"2021-04-16T10:51:43+0000","modifiedBy":"",
   "modifiedOn":"2021-04-16T10:51:43+0000","id":"my-share-price","version":"1.1.1", 

   1

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

   2

   1

   在添加工件时，指定了自定义 1.1.1 版本。

   2

   这是添加到 registry 中的第三个工件，因此全局 ID 和内容 ID 的值为 3。

3. 使用 API 路径中的工件 ID 和版本从 registry 检索工件内容。在这个示例中，指定的 ID 是 my-share-price，版本是 1.1.1 ：

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