使用 REST API 添加模型对象

您可以使用 REST API 通过两种方法之一来添加新的模型对象。

模型对象更新服务资源支持使用 HTTP POST 或 PUT 方法创建新的模型对象，具体取决于您是否要允许修改现有对象。

在任一情况下，必须首先使用 JSON 或 XML 格式描述新对象数据; 服务器会自动检测使用的格式。 如果需要指定复杂模型对象，那么首先使用模型对象类元数据服务来查询类元数据可能很有用。 此查询的结果将为对象提供正确的属性名称，然后您可以使用这些名称来指定 XML 或 JSON 格式的新数据。

在某些情况下，您可能需要添加包含另一个新模型对象作为属性的模型对象，并且子对象上需要 parent 属性。 这要求您首先确定父对象的 GUID ，以便可以设置子对象的 parent 属性。 您可以通过以下两种方法之一来完成此操作:
  • 首先创建父对象，省略子对象，这使您能够确定父对象的 GUID。 然后，您可以创建子对象，并指定父对象的 GUID。
  • 创建具有单个请求的两个对象。 要使用此方法，必须将父对象的 GUID 设置为 JSON 或 XML 文档中唯一的值，并在子对象的 parent 属性上指定相同的值。 此 JSON 示例使用标识 cs1 作为父对象的 GUID:
    [{"signature":"JsonRestExample1","_class":"LinuxUnitaryComputerSystem","
numCPUs":2,"guid":"cs1","OSRunning":{"_class":"Linux","parent":"cs1","na
me":"Linux","description":"Created by sample code"}}]
    有关更多示例，请参阅 $COLLATION_HOME/sdk/examples/rest 目录中的样本程序。

使用以下两种方法之一:

  • 使用模型对象更新服务和 HTTP POST 方法，在请求主体中传递新对象数据。
    仅当指定的对象尚不存在时，此方法才会成功。 如果该对象已存在，那么请求将失败。 如果要创建新对象但不希望对现有对象进行任何更改，请使用此方法。
  • 使用模型对象更新服务和 HTTP PUT 方法，在请求主体中传递新对象数据。
    如果指定的对象尚不存在，那么此方法将创建该对象; 如果该对象已存在，那么将使用新数据对其进行修改。 如果要确保指定的对象在 TADDM 数据库中，而不管它是否已存在，请使用此方法。