调用SetTemplatePermission共享模板或取消共享模板

为指定模板设置共享或取消共享。

接口说明

本文将提供一个示例，将 ID 为5ecd1e10-b0e9-4389-a565-e4c15efc****的模板共享给 ID 为151266687691****的阿里云账号。

说明阿里云账号151266687691****可以授权 RAM 用户使用共享模板。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作	访问级别	资源类型	条件关键字	关联操作
ros:SetTemplatePermission	update	全部资源 ``	无	无

名称	类型	必填	描述	示例值
ShareOption	string	是	共享选项。取值： ShareToAccounts：共享给其他阿里云账号。 CancelSharing：取消共享。	ShareToAccounts
VersionOption	string	否	共享版本选项。当 ShareOption 为 ShareToAccounts 时生效。取值： AllVersions（默认值）：共享模板所有版本。 Latest：只共享模板最新版本。模板版本增加时，共享的版本也随之变化，始终保持最新版本。 Current：只共享模板当前版本。模板版本增加时，共享的版本不变。 Specified：只共享模板指定的单个版本。	Specified
TemplateVersion	string	否	共享的模板版本。当 ShareOption 为 ShareToAccounts，且 VersionOption 为 Specified 时生效。取值范围：v1~v100。	v1
TemplateId	string	是	模板 ID。	5ecd1e10-b0e9-4389-a565-e4c15efc****
AccountIds	array	是	共享或取消共享的阿里云账号。 N 的取值范围：1~5。说明不支持为同一阿里云账号和阿里云账号中的 RAM 用户共享或取消共享模板。当 ShareOption 为 CancelSharing 时，支持指定星号（*），表示取消所有共享。
	string	是	共享或取消共享的阿里云账号。 N 的取值范围：1~5。说明不支持为同一阿里云账号和阿里云账号中的 RAM 用户共享或取消共享模板。当 ShareOption 为 CancelSharing 时，支持指定星号（*），表示取消所有共享。	100406424347****

关于公共请求参数的详情，请参见公共参数。

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	B288A0BE-D927-4888-B0F7-B35EF84B6E6F

正常返回示例

JSON格式

{
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F"
}

访问错误中心查看更多错误码。

变更时间	变更内容概要	操作
2024-11-20	API 内部配置变更，不影响调用	查看变更详情

HttpCode	错误码	错误信息	描述
400	TemplateBeingProcessed	Template { ID } is being processed, retry later.	模板正在处理中，稍后再试。ID 为模板 ID。
404	TemplateNotFound	The Tempalte ({ ID }) could not be found.	模板不存在。ID 为模板 ID。
404	TemplateNotFound	The Template { ID } with version { version } could not be found.	模板或指定版本不存在。ID 为模板 ID，version 为模板版本。