云服务器内容精选

  • 响应示例 状态码: 200 请求成功。 { "shared_resources" : [ { "resource_urn" : "string", "created_at" : "2022-09-19T02:32:23.735Z", "updated_at" : "2022-09-19T02:32:23.735Z", "resource_type" : "string", "resource_share_id" : "string", "status" : "string" } ], "page_info" : { "previous_marker" : "string", "next_marker" : "string", "current_count" : 2000 }}
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 shared_resources Array of SharedResource objects 共享资源的信息列表。 page_info PageInfo object 分页详细信息。 表4 SharedResource 参数 参数类型 描述 resource_urn String 资源的统一资源名称。 created_at String 资源与资源共享实例关联的时间。 updated_at String 最后一次更新资源共享实例的时间。 resource_type String 资源的类型。 resource_share_id String 资源绑定的资源共享实例的ID。 status String 资源绑定的当前状态。 表5 PageInfo 参数 参数类型 描述 previous_marker String 上一页的页面标识。 next_marker String 下一页的页面标识。 current_count Integer 页面数量。
  • 请求示例 检索您共享的或共享给您的资源。 POST https://{endpoint}/v1/shared-resources/search{ "limit" : 2000, "marker" : "string", "principal" : "string", "resource_ids" : [ "string" ], "resource_urns" : [ "string" ], "resource_owner" : "self", "resource_share_ids" : [ "string" ], "resource_region" : "string", "resource_type" : "string"}
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。 表2 请求Body参数 参数 是否必选 参数类型 描述 limit 否 Integer 分页页面的最大值。 marker 否 String 页面标记。 principal 否 String 指定资源使用者。 resource_ids 否 Array of strings 指定资源ID列表。 resource_urns 否 Array of strings 指定资源URN的列表。 resource_owner 是 String 指定资源共享实例的所有者(self或者other-accounts)。 resource_share_ids 否 Array of strings 指定资源共享实例的ID列表。 resource_region 否 String 资源所在的区域。 resource_type 否 String 指定资源类型。
  • 响应示例 状态码: 200 请求成功。 { "associated_permissions" : [ { "permission_id" : "string", "permission_name" : "string", "resource_type" : "string", "status" : "string", "created_at" : "2022-09-19T02:12:30.736Z", "updated_at" : "2022-09-19T02:12:30.736Z" } ], "page_info" : { "previous_marker" : "string", "next_marker" : "string", "current_count" : 2000 }}
  • URI GET https://{endpoint}/v1/resource-shares/{resource_share_id}/associated-permissions 表1 路径参数 参数 是否必选 参数类型 描述 resource_share_id 是 String 资源共享实例的ID。 表2 Query参数 参数 是否必选 参数类型 描述 permission_name 否 String 共享资源权限的名称。 limit 否 Integer 分页页面的最大值。 marker 否 String 页面标记。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 associated_permissions Array of AssociatedPermission objects 资源共享实例关联的共享资源权限信息列表。 page_info PageInfo object 分页详细信息。 表5 AssociatedPermission 参数 参数类型 描述 permission_id String 权限的ID。 permission_name String 共享资源权限的名称。 resource_type String 权限适用的资源类型。 status String 权限的当前状态。 created_at String 创建权限的时间。 updated_at String 最后一次更新权限的时间。 表6 PageInfo 参数 参数类型 描述 previous_marker String 上一页的页面标识。 next_marker String 下一页的页面标识。 current_count Integer 页面数量。
  • 响应示例 状态码: 200 请求成功。 { "permissions" : [ { "id" : "string", "name" : "string", "resource_type" : "string", "is_resource_type_default" : true, "created_at" : "2022-09-19T02:02:18.155Z", "updated_at" : "2022-09-19T02:02:18.155Z", "permission_urn" : "string", "permission_type" : "string", "default_version" : false, "version" : 1, "status" : "string" } ], "page_info" : { "previous_marker" : "string", "next_marker" : "string", "current_count" : 2000 }}
  • URI GET https://{endpoint}/v1/permissions 表1 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 分页页面的最大值。 marker 否 String 页面标记。 resource_type 否 String 资源类型的名称。 permission_type 否 String 权限类型。 RAM _MANAGED表示RAM托管的权限,CUSTOMER_MANAGED表示租户创建的自定义的权限,ALL表示所有的权限。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 permissions Array of PermissionSummary objects 共享资源权限的详细信息列表。 page_info PageInfo object 分页详细信息。 表4 PermissionSummary 参数 参数类型 描述 id String 权限ID。 name String 权限名称。 resource_type String 此权限适用的资源类型。 is_resource_type_default Boolean 该权限是否是此资源类型的默认权限。 created_at String 权限的创建时间。 updated_at String 上次更新权限的时间。 permission_urn String 权限URN。 permission_type String 权限类型,RAM托管或者租户自定义权限。 default_version Boolean 是否是默认版本。 version Integer 权限版本。 status String 权限的状态 表5 PageInfo 参数 参数类型 描述 previous_marker String 上一页的页面标识。 next_marker String 下一页的页面标识。 current_count Integer 页面数量。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 resource_share_associations Array of ResourceShareAssociation objects 与资源共享实例关联的资源使用者或共享资源的详细信息。 表5 ResourceShareAssociation 参数 参数类型 描述 associated_entity String 绑定的实体。这可以是共享资源的URN、账号ID、组织根的URN或OU的URN之一。 association_type String 绑定中包含的实体类型。 created_at String 绑定被创建的时间。 updated_at String 最后一次更新绑定的时间。 external Boolean 标识资源使用者是否和共享的拥有者属于同一个组织 resource_share_id String 资源共享实例的ID。 resource_share_name String 资源共享实例的名称。 status String 绑定的当前状态。 status_message String 绑定的当前状态的描述。
  • 响应示例 状态码: 200 请求成功。 { "resource_share_associations" : [ { "associated_entity" : "string", "association_type" : "string", "created_at" : "2022-08-22T11:50:25.639Z", "updated_at" : "2022-08-22T11:50:25.639Z", "external" : true, "resource_share_id" : "string", "resource_share_name" : "string", "status" : "string", "status_message" : "string" } ]}
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Security-Token 否 String 如果正在使用临时安全凭据,则此header是必需的,该值是临时安全凭据的安全令牌(会话令牌)。 表3 请求Body参数 参数 是否必选 参数类型 描述 principals 否 Array of strings 指定与资源共享实例关联的一个或多个资源使用者的列表。 resource_urns 否 Array of strings 指定与资源共享实例关联的一个或多个共享资源URN的列表。
  • 操作场景 要访问共享资源,资源所有者必须将您指定为共享资源的使用者。 如果资源所有者与您属于同一组织,且启用“启用与组织共享资源”功能,则您将自动获得共享资源的访问权限,无需接受邀请。 如果资源所有者与您不属于同一组织,或者属于同一组织但未启用“启用与组织共享资源”功能,则您将收到加入资源共享实例的邀请。 如果您收到加入资源共享实例的邀请,则必须接受该邀请才能访问其共享的资源。这些资源可直接在每个资源的管理控制台上使用。如果您拒绝资源共享实例的邀请,您将无法访问此共享资源。 资源共享实例的邀请默认保留7天,如果您在到期前未接受邀请,系统会自动拒绝邀请,如您还需使用共享资源,请再次创建共享实例以生成新的邀请。