搜索 <book_title>...

产品文档

Last Published: 2019-11-18

Product(s): Resiliency Platform & CloudMobility (3.4)

应用程序属性

使用此类别的 API 定义和检索应用程序属性。

set_property

说明：使用此接口设置应用程序类型对象的预定义属性。应用程序类型对象是应用程序实例、应用程序单元和应用程序文件。

如果要设置自定义或用户定义的属性，请使用 set_custom_property API。

下表列出了应用程序实例、单元和文件的属性。

表：应用程序实例、单元和文件的属性

属性名称	说明	预期值	注释
VERSION	版本号	任何有效的字符串值。
OWNER	所有者名称	任何有效的字符串值。
STATE	状态	联机或脱机。	此属性对于应用程序实例是必需的。
IS_PARALLEL	应用程序是否支持并行实例。	是或否。	如果应用程序支持并行实例，则将此属性设置为“是”，否则设置为“否”。此属性适用于应用程序实例和单元。
HOMEDIR	主目录	任何有效的字符串值。	此属性适用于应用程序实例和单元。
TOTAL_SIZE	总大小	任何有效的字符串值。	此属性适用于应用程序实例和单元。
USED_SIZE	已用大小	任何有效的字符串值。	此属性适用于应用程序实例和单元。
TYPE	类型	任何有效的字符串值。	此属性适用于应用程序单元和文件。对于应用程序文件，如果希望 Resiliency Platform 考虑将此文件用于灾难恢复 (DR) 配置，请将此属性设置为“数据”。
SIZE	大小	任何有效的字符串值。	此属性仅适用于应用程序文件。
PERMISSION	应用程序文件的权限。		此属性仅适用于应用程序文件。
FILE_PATH			此属性仅适用于应用程序文件。如果希望 Resiliency Platform 考虑将此文件用于 DR 配置，请将此属性设置为应用程序文件的完整路径。

强制：否

输入参数：字符串：属性名称和属性值

返回值：如果成功则返回 0，否则返回任意正数。

示例：

Application instance:
my $inst = $appObj->add_application_inst("app_inst");
if (defined $inst)
{
		$inst->set_property("FRIENDLY_NAME", "MyAppInstance");
}

Application unit:
my $inst = $appObj->add_application_inst("app_inst");
if (defined $inst)
{
		my $unit = $inst->add_application_unit("app_unit");
		$unit->set_property("OWNER", "MyOwner");
}

Application file:
my $inst = $appObj->add_application_inst("app_inst");
if (defined $inst)
{
my $file = $inst->add_application_file("master.data");
$file->set_property("SIZE", "100");
}

set_custom_property

说明：使用此接口定义所选的自定义属性。

使用此接口设置应用程序实例、应用程序单元和应用程序文件的自定义属性。

强制：否

输入参数：字符串：属性名称、属性值、is_secure（true 或 false）和属性类型。is_secure 和 type 属性是可选属性。如果 is_secure 设置为 true，则会加密属性值。

返回值：如果成功添加属性则返回 0，否则返回任意正数。

示例：

Application instance:
my $inst = $appObj->add_application_inst("app_inst");
if (defined $inst)
{
		$inst->set_custom_property("HOMEDIR", "MyDir");
}

Application unit:
my $inst = $appObj->add_application_inst("app_inst");
if (defined $inst)
{
		my $unit = $inst->add_application_unit("app_unit");
		$unit->set_custom_property("USER", "MyUser");
}

Application file:
my $inst = $appObj->add_application_inst("app_inst");
if (defined $inst)
{
my $file = $inst->add_application_file("master.data");
$file->set_custom_property("CHECKSUM", "123456789");
}