创建资源共享实例 - CreateResourceShare

X-Security-Token

否

String

参数解释：

如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。

约束限制：

不涉及

取值范围：

只能由英文字母、数字、加号、斜杠、等号及连字符组成，长度为1~16384个字符。

默认取值：

不涉及

name

是

String

参数解释：

资源共享实例的名称。

约束限制：

不涉及

取值范围：

只能由中文字符、英文字母、数字及“_”、“-”、“.”组成，且长度为1~64个字符。

默认取值：

无默认值

description

否

String

参数解释：

资源共享实例的描述。

约束限制：

不能包含“<” 与 “>”

取值范围：

只能由中文、字母、数字及"_"、"-"、"."组成，且长度为0~256个字符。

默认取值：

无默认值

allow_external_principals

否

Boolean

参数解释：

资源共享实例是否支持共享给组织外账号。

约束限制：

不涉及

取值范围：

• false: 资源共享实例不支持共享给组织外账号。

• true: 资源共享实例支持共享给组织外账号。

默认取值：

true

permission_ids

否

Array of strings

参数解释：

资源共享实例关联的RAM权限列表。一种资源类型只能关联一个RAM权限。如果您没有指定权限ID，RAM将自动为每个资源类型关联默认权限。数组元素为权限ID格式的字符串，只能由英文字母、数字及'-'、'_'组成，长度为1~36个字符，可通过查询共享资源权限列表接口获取。

约束限制：

不涉及

principals

否

Array of strings

参数解释：

资源共享实例关联的一个或多个资源使用者的列表。数组元素为账号ID或URN格式的字符串。

约束限制：

不涉及

resource_urns

否

Array of strings

参数解释：

资源共享实例关联的一个或多个共享资源URN的列表。数组元素为资源URN格式的字符串，格式为 [/topic/body/section/table/tgroup/tbody/row/entry/p/br {""}) (br]:[/topic/body/section/table/tgroup/tbody/row/entry/p/br {""}) (br]:[/topic/body/section/table/tgroup/tbody/row/entry/p/br {""}) (br]:[/topic/body/section/table/tgroup/tbody/row/entry/p/br {""}) (br]:[/topic/body/section/table/tgroup/tbody/row/entry/p/br {""}) (br]，可通过查询共享资源列表接口获取。

约束限制：

不涉及

tags

否

Array of Tag objects

参数解释：

资源共享标签列表。

约束限制：

不涉及

key

是

String

参数解释：

标签"键"的标识符或名称。

约束限制：

不涉及

取值范围：

只能由字母、数字、中文、下划线、点号、冒号、等号、加号、连字符、@符号及空格组成，不能以空格或"sys"开头，也不能以空格结尾。且长度为1~128个字符。

默认取值：

不涉及

value

是

String

参数解释：

标签"键"对应的"值"。您可以将标签的值设置为空字符串，但不能设置为null。

约束限制：

不涉及

取值范围：

只能由字母、数字、中文、下划线、点号、冒号、斜杠、等号、加号、连字符、@符号及空格组成。且长度为0~255个字符。

默认取值：

不涉及

resource_share

ResourceShare object

描述RAM中的资源共享。

id

String

参数解释：

资源共享实例的ID

取值范围：

只能由英文字母、数字及“-”组成，长度为0~36个字符。

name

String

参数解释：

资源共享实例的名称。

取值范围：

只能由中文字符、英文字母、数字及“_”、“-”、“.”组成，长度为0~128个字符。

description

String

参数解释：

资源共享实例的描述。

取值范围：

不涉及。

allow_external_principals

Boolean

参数解释：

资源共享实例是否支持共享给组织外账号。

取值范围：

• false: 资源共享实例不支持共享给组织外账号。

• true: 资源共享实例支持共享给组织外账号。

owning_account_id

String

参数解释：

资源共享实例的所有者ID。

取值范围：

只能由英文字母、数字及“-”组成，长度为0~36个字符。

status

String

参数解释：

资源共享实例的状态。

取值范围：

• active：资源共享实例处于活跃状态。

• deleting：资源共享实例正在删除中。

• deleted：资源共享实例已删除。

• failed：资源共享实例创建失败。

tags

Array of Tag objects

参数解释：

资源共享实例的标签列表。

created_at

String

参数解释：

创建资源共享实例的时间。UTC时间格式，格式为yyyy-MM-ddTHH:mm:ssZ，例如2020-09-25T12:05:00Z。

取值范围：

不涉及

updated_at

String

参数解释：

最后一次更新资源共享实例的时间。UTC时间格式，格式为yyyy-MM-ddTHH:mm:ssZ，例如2020-09-25T12:05:00Z。

取值范围：

不涉及

key

String

参数解释：

标签"键"的标识符或名称。

取值范围：

只能由字母、数字、中文、下划线、点号、冒号、等号、加号、连字符、@符号及空格组成，不能以空格或"sys"开头，也不能以空格结尾。且长度为1~128个字符。

value

String

参数解释：

标签"键"对应的"值"。您可以将标签的值设置为空字符串，但不能设置为null。

取值范围：

只能由字母、数字、中文、下划线、点号、冒号、斜杠、等号、加号、连字符、@符号及空格组成。且长度为0~255个字符。

201

请求成功。