{
  "name": "smh",
  "display_name": "智能媒资托管",
  "description": "为 SMH 服务提供媒体库的管理",
  "domain": "other",
  "api_version": "2021-07-12",
  "endpoint": "smh.tencentcloudapi.com",
  "actions": [
    {
      "name": "CreateLibrary",
      "description": "创建 PaaS 服务媒体库",
      "status": "online",
      "parameters": [
        {
          "name": "Name",
          "type": "string",
          "required": true,
          "description": "媒体库名称，最多 50 个字符",
          "example": "家庭云盘"
        },
        {
          "name": "Remark",
          "type": "string",
          "required": false,
          "description": "备注，最多 250 个字符",
          "example": "用于家庭内部共享"
        },
        {
          "name": "BucketName",
          "type": "string",
          "required": false,
          "description": "存储桶全名，新建后不可更改。当前版本不再支持指定存储桶。",
          "example": "demo-bucket-13000000000"
        },
        {
          "name": "BucketRegion",
          "type": "string",
          "required": false,
          "description": "存储桶所在地域，新建后不可更改。当前版本不再支持指定存储桶所在地域。",
          "example": "ap-guangzhou"
        },
        {
          "name": "LibraryExtension",
          "type": "object",
          "required": false,
          "description": "媒体库配置项，部分参数新建后不可更改",
          "example": "无",
          "children": [
            {
              "name": "IsFileLibrary",
              "type": "boolean",
              "required": false,
              "description": "true 为文件类型媒体库，可存储任何类型文件；false 为媒体类型媒体库，仅可存储照片和视频类型文件。默认为 false。在媒体库创建后不能修改。",
              "example": "true"
            },
            {
              "name": "IsMultiSpace",
              "type": "boolean",
              "required": false,
              "description": "true 为多租户空间媒体库，可创建多个租户空间；false 为单租户空间媒体库，不能创建租户空间，仅可使用默认的单一租户空间。默认为 false。在媒体库创建后不能修改。",
              "example": "true"
            },
            {
              "name": "CosStorageClass",
              "type": "string",
              "required": false,
              "description": "保存至 COS 对象存储的文件的存储类型，仅支持 STANDARD、STANDARD_IA、INTELLIGENT_TIERING、MAZ_STANDARD、MAZ_STANDARD_IA 和 MAZ_INTELLIGENT_TIERING，默认为 STANDARD，当使用多 AZ 存储桶时将自动使用 MAZ_ 开头的用于多 AZ 的存储类型，否则自动使用非 MAZ_ 开头的用于非多 AZ 的存储类型。当指定智能分层存储 INTELLIGENT_TIERING 或 MAZ_INTELLIGENT_TIERING 时，需要事先为存储桶开启智能分层存储，否则将返回\ufffd...",
              "example": "STANDARD_IA"
            },
            {
              "name": "UseRecycleBin",
              "type": "boolean",
              "required": false,
              "description": "是否开启回收站功能。默认为 false。",
              "example": "true"
            },
            {
              "name": "AutoRemoveRecycledDays",
              "type": "integer",
              "required": false,
              "description": "当开启回收站时，自动删除回收站项目的天数，不能超过 1095（3 年），指定为 0 则不自动删除，默认为 0。当未开启回收站时，该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "7"
            },
            {
              "name": "EnableSearch",
              "type": "boolean",
              "required": false,
              "description": "是否启用文件路径搜索功能。默认为 false。",
              "example": "true"
            },
            {
              "name": "DenyOnQuotaLessThanUsage",
              "type": "boolean",
              "required": false,
              "description": "设置媒体库或租户空间配额且配额小于已使用存储量时，是否拒绝设置请求。默认为 false。",
              "example": "true"
            },
            {
              "name": "EnableFileHistory",
              "type": "boolean",
              "required": false,
              "description": "是否开启历史版本。默认为 false。",
              "example": "true"
            },
            {
              "name": "FileHistoryCount",
              "type": "integer",
              "required": false,
              "description": "当开启历史版本时，指定单个文件保留的历史版本的数量上限，取值范围为 1 到 999。当未开启历史版本时，该属性可能为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "10"
            },
            {
              "name": "FileHistoryExpireDay",
              "type": "integer",
              "required": false,
              "description": "当开启历史版本时，指定历史版本保留的最长天数，取值范围为 0 到 999，当指定为 0 时代表永久保留。当未开启历史版本时，该属性可能为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "30"
            },
            {
              "name": "MaxDirFileNameLength",
              "type": "integer",
              "required": false,
              "description": "目录或文件名的最长长度，不能超过 255，默认为 255。修改该参数不会影响存量目录或文件名，即如果将该字段的值改小，已经存在的长度超过目标值的目录或文件名不会发生变化。",
              "example": "200"
            },
            {
              "name": "IsPublicRead",
              "type": "boolean",
              "required": false,
              "description": "是否开启公有读，开启后读操作无需使用访问令牌，默认为 false。仅单租户空间媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            },
            {
              "name": "IsMultiAlbum",
              "type": "boolean",
              "required": false,
              "description": "媒体类型媒体库是否开启多相簿，开启后可创建一级目录（即相簿）且媒体文件只能保存在各相簿中，否则不能创建相簿且媒体文件只能保存在根目录。默认为 false。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。在媒体库创建后不能修改。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            },
            {
              "name": "AllowPhoto",
              "type": "boolean",
              "required": false,
              "description": "媒体类型媒体库是否允许上传照片，默认为 true。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            },
            {
              "name": "AllowPhotoExtName",
              "type": "array",
              "required": false,
              "description": "当媒体类型媒体库允许上传照片时，指定允许的扩展名，默认为空数组，此时将根据文件扩展名对应的 MIME 类型自动判断。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "[ '.jpg', '.png', '.heic' ]",
              "item_type": "string"
            },
            {
              "name": "AllowVideo",
              "type": "boolean",
              "required": false,
              "description": "媒体类型媒体库是否允许上传视频，默认为 true。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            },
            {
              "name": "AllowVideoExtName",
              "type": "array",
              "required": false,
              "description": "当媒体类型媒体库允许上传视频时，指定允许的扩展名，默认为空数组，此时将根据文件扩展名对应的 MIME 类型自动判断。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "[ '.mp4', '.mov' ]",
              "item_type": "string"
            },
            {
              "name": "AllowFileExtName",
              "type": "array",
              "required": false,
              "description": "指定文件类型媒体库允许的文件扩展名，默认为空数组，此时允许上传所有类型文件。仅单租户空间文件类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "[ '.docx', '.xslx', '.pptx' ]",
              "item_type": "string"
            },
            {
              "name": "RecognizeSensitiveContent",
              "type": "boolean",
              "required": false,
              "description": "照片上传时是否进行敏感内容鉴定，默认为 false。仅单租户空间媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            }
          ]
        }
      ],
      "required": [
        "Name"
      ]
    },
    {
      "name": "CreateUser",
      "description": "新建用户。",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryId",
          "type": "string",
          "required": true,
          "description": "媒体库 ID。",
          "example": "smh08gcw6500e6jl"
        },
        {
          "name": "Role",
          "type": "string",
          "required": true,
          "description": "用户角色，当只支持 user。",
          "example": "user"
        },
        {
          "name": "Enabled",
          "type": "boolean",
          "required": true,
          "description": "是否启用。",
          "example": "true"
        },
        {
          "name": "CountryCode",
          "type": "string",
          "required": false,
          "description": "手机号国家码，不传默认为 null，此时无法使用该登录方式进行登录。",
          "example": "+86"
        },
        {
          "name": "PhoneNumber",
          "type": "string",
          "required": false,
          "description": "手机号码，不传默认为 null，此时无法使用该登录方式进行登录。如果与同一媒体库内已有手机号重复则报错。CountryCode 和 PhoneNumber 必须同时传入或同时不传入。",
          "example": "13800138000"
        },
        {
          "name": "Email",
          "type": "string",
          "required": false,
          "description": "邮箱，不传默认为 null，此时无法使用该登录方式进行登录。如果与同一媒体库内已有邮箱重复则报错。",
          "example": "admin@mail.foobar.com"
        },
        {
          "name": "AccountName",
          "type": "string",
          "required": false,
          "description": "账号，不传默认为 null，此时无法使用该登录方式进行登录。如果与同一媒体库内已有账号重复则报错。只能使用大小写字母、数字、中划线、下划线、小数点，长度不超过 50 个字符。",
          "example": "account_name"
        },
        {
          "name": "AccountPassword",
          "type": "string",
          "required": false,
          "description": "密码的 base64 形式，不传默认为 null，此时无法使用该登录方式进行登录。AccountName 和 AccountPassword 必须同时传入或同时不传入。",
          "example": "UEBzc3cwcmQ="
        },
        {
          "name": "AccountUserId",
          "type": "string",
          "required": false,
          "description": "第三方账号 ID，用于关联第三方账号体系，不传默认为 null，此时无法使用该登录方式进行登录。如果与同一媒体库内已有第三方账号重复则报错。只能使用大小写字母、数字、中划线、下划线、小数点，长度不超过 200 个字符。",
          "example": "x53mYVqykfPqTCqekbNwwa4aXk4"
        },
        {
          "name": "Comment",
          "type": "string",
          "required": false,
          "description": "备注。不超过 255 个字符。",
          "example": "腾讯云助手账号"
        },
        {
          "name": "Nickname",
          "type": "string",
          "required": false,
          "description": "昵称。不超过 100 个字符。",
          "example": "腾讯云助手"
        },
        {
          "name": "Avatar",
          "type": "string",
          "required": false,
          "description": "用户头像地址。不超过 255 个字符。",
          "example": "https://cloudcache.tencent-cloud.com/qcloud/portal/kit/images/slice/logo.23996906.svg"
        },
        {
          "name": "Customize",
          "type": "string",
          "required": false,
          "description": "自定义信息。不超过 255 个字符。",
          "example": "普通用户"
        }
      ],
      "required": [
        "LibraryId",
        "Role",
        "Enabled"
      ]
    },
    {
      "name": "CreateUserLifecycle",
      "description": "设置用户生命周期。如果指定的用户已经设置了生命周期，重复调用此接口将覆盖已有的设置。也可用于清除指定用户的生命周期。",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryId",
          "type": "string",
          "required": true,
          "description": "媒体库 ID。",
          "example": "smh08gcw6500e6jl"
        },
        {
          "name": "Filter",
          "type": "object",
          "required": true,
          "description": "用于唯一查找用户的过滤器。",
          "example": "{ \"Key\": \"PhoneNumber\", \"Value\": \"+86-13800000000\" }",
          "children": [
            {
              "name": "Key",
              "type": "string",
              "required": true,
              "description": "过滤类型，当前支持：UserId、PhoneNumber、Email、AccountName、AccountUserId。",
              "example": "PhoneNumber"
            },
            {
              "name": "Value",
              "type": "string",
              "required": true,
              "description": "过滤值，只支持完全匹配，不支持模糊搜索。针对不同的 Key，Value 的取值如下： UserId: user12345678abcde PhoneNumber: +86-13800000000（格式为：{CountryCode}-{PhoneNumber}） Email: admin@mail.foobar.com AccountName: account_name AccountUserId: x53mYVqykfPqTCqekbNwwa4aXk4",
              "example": "+86-13800000000"
            }
          ]
        },
        {
          "name": "IsolateTime",
          "type": "string",
          "required": false,
          "description": "隔离时间，当时间超过该时间点后，指定用户将无法登录，但他的账号信息、文件资源会被保留，可以通过再次调用本接口更新隔离时间，恢复登录。如不指定，则代表不设置隔离时间，且当前用户已经设置的隔离时间会被删除。",
          "example": "2025-06-30T15:59:59Z"
        },
        {
          "name": "DestroyTime",
          "type": "string",
          "required": false,
          "description": "销毁时间，当时间超过该时间点后，指定用户的资源将被销毁且无法通过再次调用此接口更新时间。如果同时指定了 IsolateTime 则不能早于 IsolateTime 指定的时间。如不指定，则代表不设置销毁时间，且当前用户已经设置的销毁时间会被删除。",
          "example": "2025-07-30T15:59:59Z"
        }
      ],
      "required": [
        "LibraryId",
        "Filter"
      ]
    },
    {
      "name": "DeleteLibrary",
      "description": "删除 PaaS 服务媒体库",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryId",
          "type": "string",
          "required": true,
          "description": "媒体库 ID",
          "example": "smh3ptyc9mscifdi"
        }
      ],
      "required": [
        "LibraryId"
      ]
    },
    {
      "name": "DeleteUser",
      "description": "一次删除多个用户。",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryId",
          "type": "string",
          "required": true,
          "description": "媒体库 ID。",
          "example": "smh08gcw6500e6jl"
        },
        {
          "name": "Filters",
          "type": "array",
          "required": true,
          "description": "用于唯一查找用户的过滤器数组，数组之间为 **或** 的关系，即满足任意一个过滤器的用户，都将被删除，单次传入的过滤器最多为 100 个。",
          "example": "[ { \"Key\": \"PhoneNumber\", \"Value\": \"+86-13800000000\" }, { \"Key\": \"Email\", \"Value\": \"admin@mail.foobar.com\" } ]",
          "item_type": "object",
          "children": [
            {
              "name": "Key",
              "type": "string",
              "required": true,
              "description": "过滤类型，当前支持：UserId、PhoneNumber、Email、AccountName、AccountUserId。",
              "example": "PhoneNumber"
            },
            {
              "name": "Value",
              "type": "string",
              "required": true,
              "description": "过滤值，只支持完全匹配，不支持模糊搜索。针对不同的 Key，Value 的取值如下： UserId: user12345678abcde PhoneNumber: +86-13800000000（格式为：{CountryCode}-{PhoneNumber}） Email: admin@mail.foobar.com AccountName: account_name AccountUserId: x53mYVqykfPqTCqekbNwwa4aXk4",
              "example": "+86-13800000000"
            }
          ]
        }
      ],
      "required": [
        "LibraryId",
        "Filters"
      ]
    },
    {
      "name": "DescribeLibraries",
      "description": "查询 PaaS 服务媒体库列表",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryIds",
          "type": "array",
          "required": false,
          "description": "按照一个或者多个媒体库 ID 查询，每次请求的上限为 100 个。",
          "example": "[ 'smh3ptyc9mscifdi', 'smh2dugfmc1jrnzd' ]",
          "item_type": "string"
        },
        {
          "name": "PageNumber",
          "type": "integer",
          "required": false,
          "description": "页码，整型，配合 PageSize 使用，默认值为 1。",
          "example": "2"
        },
        {
          "name": "PageSize",
          "type": "integer",
          "required": false,
          "description": "每页数目，整型，配合 PageNumber 使用，默认值为 20，最大值为 100。",
          "example": "20"
        }
      ],
      "required": []
    },
    {
      "name": "DescribeLibrarySecret",
      "description": "查询 PaaS 服务媒体库密钥",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryId",
          "type": "string",
          "required": true,
          "description": "媒体库 ID",
          "example": "smh3ptyc9mscifdi"
        }
      ],
      "required": [
        "LibraryId"
      ]
    },
    {
      "name": "DescribeOfficialInstances",
      "description": "查询官方云盘实例",
      "status": "online",
      "parameters": [
        {
          "name": "SuperAdminAccount",
          "type": "boolean",
          "required": false,
          "description": "是否查询实例绑定的超级管理员账号，默认值为 false。",
          "example": "true"
        },
        {
          "name": "InstanceIds",
          "type": "array",
          "required": false,
          "description": "按照一个或者多个实例 ID 查询，每次请求的上限为 100 个。",
          "example": "[ 'tyc9msci', 'ugfmc1jr' ]",
          "item_type": "string"
        },
        {
          "name": "PageNumber",
          "type": "integer",
          "required": false,
          "description": "页码，整型，配合 PageSize 使用，默认值为 1。",
          "example": "2"
        },
        {
          "name": "PageSize",
          "type": "integer",
          "required": false,
          "description": "每页数目，整型，配合 PageNumber 使用，默认值为 20，最大值为 100。",
          "example": "20"
        },
        {
          "name": "OrderBy",
          "type": "string",
          "required": false,
          "description": "对指定列进行排序",
          "example": "'effectiveTime'"
        },
        {
          "name": "OrderByType",
          "type": "string",
          "required": false,
          "description": "排序方式",
          "example": "'desc'"
        },
        {
          "name": "AutoRenew",
          "type": "integer",
          "required": false,
          "description": "续费管理筛选类型",
          "example": "0"
        },
        {
          "name": "BindPhone",
          "type": "boolean",
          "required": false,
          "description": "超级管理管理员账号是否绑定了手机号",
          "example": "true"
        }
      ],
      "required": []
    },
    {
      "name": "DescribeOfficialOverview",
      "description": "查询官方云盘实例概览数据",
      "status": "online",
      "parameters": [],
      "required": []
    },
    {
      "name": "DescribeTrafficPackages",
      "description": "查询流量资源包",
      "status": "online",
      "parameters": [
        {
          "name": "ResourceIds",
          "type": "array",
          "required": false,
          "description": "按照一个或者多个资源 ID 查询，每次请求的上限为 100 个。",
          "example": "[ 'tp-1201', 'tp-1202' ]",
          "item_type": "string"
        },
        {
          "name": "PageNumber",
          "type": "integer",
          "required": false,
          "description": "页码，整型，配合 PageSize 使用，默认值为 1。",
          "example": "2"
        },
        {
          "name": "PageSize",
          "type": "integer",
          "required": false,
          "description": "每页数目，整型，配合 PageNumber 使用，默认值为 20，最大值为 100。",
          "example": "20"
        },
        {
          "name": "OrderBy",
          "type": "string",
          "required": false,
          "description": "对指定列进行排序",
          "example": "effectiveTime"
        },
        {
          "name": "OrderByType",
          "type": "string",
          "required": false,
          "description": "排序方式",
          "example": "desc"
        },
        {
          "name": "Type",
          "type": "integer",
          "required": false,
          "description": "来源类型筛选",
          "example": "0"
        }
      ],
      "required": []
    },
    {
      "name": "DescribeUserLifecycle",
      "description": "查询用户生命周期。",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryId",
          "type": "string",
          "required": true,
          "description": "媒体库 ID。",
          "example": "smh08gcw6500e6jl"
        },
        {
          "name": "Filter",
          "type": "object",
          "required": true,
          "description": "用于唯一查找用户的过滤器。",
          "example": "{ \"Key\": \"PhoneNumber\", \"Value\": \"+86-13800000000\" }",
          "children": [
            {
              "name": "Key",
              "type": "string",
              "required": true,
              "description": "过滤类型，当前支持：UserId、PhoneNumber、Email、AccountName、AccountUserId。",
              "example": "PhoneNumber"
            },
            {
              "name": "Value",
              "type": "string",
              "required": true,
              "description": "过滤值，只支持完全匹配，不支持模糊搜索。针对不同的 Key，Value 的取值如下： UserId: user12345678abcde PhoneNumber: +86-13800000000（格式为：{CountryCode}-{PhoneNumber}） Email: admin@mail.foobar.com AccountName: account_name AccountUserId: x53mYVqykfPqTCqekbNwwa4aXk4",
              "example": "+86-13800000000"
            }
          ]
        }
      ],
      "required": [
        "LibraryId",
        "Filter"
      ]
    },
    {
      "name": "ModifyLibrary",
      "description": "修改 PaaS 服务媒体库配置项",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryId",
          "type": "string",
          "required": true,
          "description": "媒体库 ID",
          "example": "smh3ptyc9mscifdi"
        },
        {
          "name": "Name",
          "type": "string",
          "required": false,
          "description": "媒体库名称，最多 50 个字符。如不传则不修改。",
          "example": "家庭云盘"
        },
        {
          "name": "Remark",
          "type": "string",
          "required": false,
          "description": "备注，最多 250 个字符。如不传则不修改。",
          "example": "用于家庭内部共享"
        },
        {
          "name": "LibraryExtension",
          "type": "object",
          "required": false,
          "description": "媒体库配置项，部分参数在新建后不可更改，且仅修改传入的参数。如不传该参数则不修改任何配置项。",
          "example": "无",
          "children": [
            {
              "name": "IsFileLibrary",
              "type": "boolean",
              "required": false,
              "description": "true 为文件类型媒体库，可存储任何类型文件；false 为媒体类型媒体库，仅可存储照片和视频类型文件。默认为 false。在媒体库创建后不能修改。",
              "example": "true"
            },
            {
              "name": "IsMultiSpace",
              "type": "boolean",
              "required": false,
              "description": "true 为多租户空间媒体库，可创建多个租户空间；false 为单租户空间媒体库，不能创建租户空间，仅可使用默认的单一租户空间。默认为 false。在媒体库创建后不能修改。",
              "example": "true"
            },
            {
              "name": "CosStorageClass",
              "type": "string",
              "required": false,
              "description": "保存至 COS 对象存储的文件的存储类型，仅支持 STANDARD、STANDARD_IA、INTELLIGENT_TIERING、MAZ_STANDARD、MAZ_STANDARD_IA 和 MAZ_INTELLIGENT_TIERING，默认为 STANDARD，当使用多 AZ 存储桶时将自动使用 MAZ_ 开头的用于多 AZ 的存储类型，否则自动使用非 MAZ_ 开头的用于非多 AZ 的存储类型。当指定智能分层存储 INTELLIGENT_TIERING 或 MAZ_INTELLIGENT_TIERING 时，需要事先为存储桶开启智能分层存储，否则将返回\ufffd...",
              "example": "STANDARD_IA"
            },
            {
              "name": "UseRecycleBin",
              "type": "boolean",
              "required": false,
              "description": "是否开启回收站功能。默认为 false。",
              "example": "true"
            },
            {
              "name": "AutoRemoveRecycledDays",
              "type": "integer",
              "required": false,
              "description": "当开启回收站时，自动删除回收站项目的天数，不能超过 1095（3 年），指定为 0 则不自动删除，默认为 0。当未开启回收站时，该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "7"
            },
            {
              "name": "EnableSearch",
              "type": "boolean",
              "required": false,
              "description": "是否启用文件路径搜索功能。默认为 false。",
              "example": "true"
            },
            {
              "name": "DenyOnQuotaLessThanUsage",
              "type": "boolean",
              "required": false,
              "description": "设置媒体库或租户空间配额且配额小于已使用存储量时，是否拒绝设置请求。默认为 false。",
              "example": "true"
            },
            {
              "name": "EnableFileHistory",
              "type": "boolean",
              "required": false,
              "description": "是否开启历史版本。默认为 false。",
              "example": "true"
            },
            {
              "name": "FileHistoryCount",
              "type": "integer",
              "required": false,
              "description": "当开启历史版本时，指定单个文件保留的历史版本的数量上限，取值范围为 1 到 999。当未开启历史版本时，该属性可能为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "10"
            },
            {
              "name": "FileHistoryExpireDay",
              "type": "integer",
              "required": false,
              "description": "当开启历史版本时，指定历史版本保留的最长天数，取值范围为 0 到 999，当指定为 0 时代表永久保留。当未开启历史版本时，该属性可能为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "30"
            },
            {
              "name": "MaxDirFileNameLength",
              "type": "integer",
              "required": false,
              "description": "目录或文件名的最长长度，不能超过 255，默认为 255。修改该参数不会影响存量目录或文件名，即如果将该字段的值改小，已经存在的长度超过目标值的目录或文件名不会发生变化。",
              "example": "200"
            },
            {
              "name": "IsPublicRead",
              "type": "boolean",
              "required": false,
              "description": "是否开启公有读，开启后读操作无需使用访问令牌，默认为 false。仅单租户空间媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            },
            {
              "name": "IsMultiAlbum",
              "type": "boolean",
              "required": false,
              "description": "媒体类型媒体库是否开启多相簿，开启后可创建一级目录（即相簿）且媒体文件只能保存在各相簿中，否则不能创建相簿且媒体文件只能保存在根目录。默认为 false。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。在媒体库创建后不能修改。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            },
            {
              "name": "AllowPhoto",
              "type": "boolean",
              "required": false,
              "description": "媒体类型媒体库是否允许上传照片，默认为 true。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            },
            {
              "name": "AllowPhotoExtName",
              "type": "array",
              "required": false,
              "description": "当媒体类型媒体库允许上传照片时，指定允许的扩展名，默认为空数组，此时将根据文件扩展名对应的 MIME 类型自动判断。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "[ '.jpg', '.png', '.heic' ]",
              "item_type": "string"
            },
            {
              "name": "AllowVideo",
              "type": "boolean",
              "required": false,
              "description": "媒体类型媒体库是否允许上传视频，默认为 true。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            },
            {
              "name": "AllowVideoExtName",
              "type": "array",
              "required": false,
              "description": "当媒体类型媒体库允许上传视频时，指定允许的扩展名，默认为空数组，此时将根据文件扩展名对应的 MIME 类型自动判断。仅单租户空间媒体类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "[ '.mp4', '.mov' ]",
              "item_type": "string"
            },
            {
              "name": "AllowFileExtName",
              "type": "array",
              "required": false,
              "description": "指定文件类型媒体库允许的文件扩展名，默认为空数组，此时允许上传所有类型文件。仅单租户空间文件类型媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "[ '.docx', '.xslx', '.pptx' ]",
              "item_type": "string"
            },
            {
              "name": "RecognizeSensitiveContent",
              "type": "boolean",
              "required": false,
              "description": "照片上传时是否进行敏感内容鉴定，默认为 false。仅单租户空间媒体库支持该属性，否则该属性为 null。 注意：此字段可能返回 null，表示取不到有效值。",
              "example": "true"
            }
          ]
        }
      ],
      "required": [
        "LibraryId"
      ]
    },
    {
      "name": "ModifyUser",
      "description": "更新用户信息。",
      "status": "online",
      "parameters": [
        {
          "name": "LibraryId",
          "type": "string",
          "required": true,
          "description": "媒体库 ID。",
          "example": "smh08gcw6500e6jl"
        },
        {
          "name": "Filter",
          "type": "object",
          "required": true,
          "description": "用于唯一查找用户的过滤器。",
          "example": "{ \"Key\": \"PhoneNumber\", \"Value\": \"+86-13800000000\" }",
          "children": [
            {
              "name": "Key",
              "type": "string",
              "required": true,
              "description": "过滤类型，当前支持：UserId、PhoneNumber、Email、AccountName、AccountUserId。",
              "example": "PhoneNumber"
            },
            {
              "name": "Value",
              "type": "string",
              "required": true,
              "description": "过滤值，只支持完全匹配，不支持模糊搜索。针对不同的 Key，Value 的取值如下： UserId: user12345678abcde PhoneNumber: +86-13800000000（格式为：{CountryCode}-{PhoneNumber}） Email: admin@mail.foobar.com AccountName: account_name AccountUserId: x53mYVqykfPqTCqekbNwwa4aXk4",
              "example": "+86-13800000000"
            }
          ]
        },
        {
          "name": "Role",
          "type": "string",
          "required": false,
          "description": "用户角色，当只支持 user。",
          "example": "user"
        },
        {
          "name": "Enabled",
          "type": "boolean",
          "required": false,
          "description": "是否启用。",
          "example": "true"
        },
        {
          "name": "CountryCode",
          "type": "string",
          "required": false,
          "description": "手机号国家码，不传默认为 null，此时无法使用该登录方式进行登录。",
          "example": "+86"
        },
        {
          "name": "PhoneNumber",
          "type": "string",
          "required": false,
          "description": "手机号码，不传默认为 null，此时无法使用该登录方式进行登录。如果与同一媒体库内已有手机号重复则报错。CountryCode 和 PhoneNumber 必须同时传入或同时不传入。",
          "example": "13800138000"
        },
        {
          "name": "Email",
          "type": "string",
          "required": false,
          "description": "邮箱，不传默认为 null，此时无法使用该登录方式进行登录。如果与同一媒体库内已有邮箱重复则报错。",
          "example": "admin@mail.foobar.com"
        },
        {
          "name": "AccountName",
          "type": "string",
          "required": false,
          "description": "账号，不传默认为 null，此时无法使用该登录方式进行登录。如果与同一媒体库内已有账号重复则报错。只能使用大小写字母、数字、中划线、下划线、小数点，长度不超过 50 个字符。",
          "example": "account_name"
        },
        {
          "name": "AccountPassword",
          "type": "string",
          "required": false,
          "description": "密码的 base64 形式，不传默认为 null，此时无法使用该登录方式进行登录。AccountName 和 AccountPassword 必须同时传入或同时不传入。",
          "example": "UEBzc3cwcmQ="
        },
        {
          "name": "AccountUserId",
          "type": "string",
          "required": false,
          "description": "第三方账号 ID，用于关联第三方账号体系，不传默认为 null，此时无法使用该登录方式进行登录。如果与同一媒体库内已有第三方账号重复则报错。只能使用大小写字母、数字、中划线、下划线、小数点，长度不超过 200 个字符。",
          "example": "x53mYVqykfPqTCqekbNwwa4aXk4"
        },
        {
          "name": "Comment",
          "type": "string",
          "required": false,
          "description": "备注。不超过 255 个字符。",
          "example": "腾讯云助手账号"
        },
        {
          "name": "Nickname",
          "type": "string",
          "required": false,
          "description": "昵称。不超过 100 个字符。",
          "example": "腾讯云助手"
        },
        {
          "name": "Avatar",
          "type": "string",
          "required": false,
          "description": "用户头像地址。不超过 255 个字符。",
          "example": "https://cloudcache.tencent-cloud.com/qcloud/portal/kit/images/slice/logo.23996906.svg"
        },
        {
          "name": "Customize",
          "type": "string",
          "required": false,
          "description": "自定义信息。不超过 255 个字符。",
          "example": "普通用户"
        }
      ],
      "required": [
        "LibraryId",
        "Filter"
      ]
    },
    {
      "name": "SendSmsCode",
      "description": "发送用于换绑官方云盘实例的超级管理员账号的短信验证码",
      "status": "online",
      "parameters": [
        {
          "name": "Purpose",
          "type": "string",
          "required": true,
          "description": "验证码目的，当前支持换绑超级管理员账号， BindSuperAdmin；体验版企业升级，ChannelUpdateVerify等",
          "example": "BindSuperAdmin"
        },
        {
          "name": "PhoneNumber",
          "type": "string",
          "required": true,
          "description": "将作为超级管理员账号的手机号码",
          "example": "18988888888"
        },
        {
          "name": "InstanceId",
          "type": "string",
          "required": false,
          "description": "官方云盘实例 ID",
          "example": "tyc9msci"
        },
        {
          "name": "CountryCode",
          "type": "string",
          "required": false,
          "description": "将作为超级管理员账号的手机号码的国家代码。默认为 +86。",
          "example": "+86"
        }
      ],
      "required": [
        "Purpose",
        "PhoneNumber"
      ]
    },
    {
      "name": "VerifySmsCode",
      "description": "验证短信验证码以换绑官方云盘实例的超级管理员账号",
      "status": "online",
      "parameters": [
        {
          "name": "Purpose",
          "type": "string",
          "required": true,
          "description": "验证码目的，当前支持换绑超级管理员账号，BindSuperAdmin；体验版企业升级验证ChannelUpdateVerify，等",
          "example": "BindSuperAdmin"
        },
        {
          "name": "PhoneNumber",
          "type": "string",
          "required": true,
          "description": "将作为超级管理员账号的手机号码",
          "example": "18988888888"
        },
        {
          "name": "Code",
          "type": "string",
          "required": true,
          "description": "短信验证码",
          "example": "2261"
        },
        {
          "name": "InstanceId",
          "type": "string",
          "required": false,
          "description": "官方云盘实例 ID",
          "example": "tyc9msci"
        },
        {
          "name": "CountryCode",
          "type": "string",
          "required": false,
          "description": "将作为超级管理员账号的手机号码的国家代码。默认为 +86。",
          "example": "+86"
        }
      ],
      "required": [
        "Purpose",
        "PhoneNumber",
        "Code"
      ]
    }
  ]
}