{"items":[{"type":"link","label":"云存储 Local API","link":"/zh/api-reference/cloud-storage/local-api","routeSlug":"/zh/api-reference/cloud-storage/local-api","content":{"contentType":"overview","meta":{"name":"云存储 Local API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"local-api.json","url":"/_bundle/@l10n/zh/API Reference/Cloud Storage/local-api.json?download"},{"kind":"download","label":"local-api.yaml","url":"/_bundle/@l10n/zh/API Reference/Cloud Storage/local-api.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"http://127.0.0.1:40000"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"云存储 Local API (2026-09-05)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"通过 MoreLogin Local API 管理 MoreLogin 云存储的文件、上传、删除和文件标签。"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Base URL"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"http://127.0.0.1:40000"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Local API 的路径使用 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/api"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 前缀。"},"children":[]}]}]}]}],"sectionId":"/zh/api-reference/cloud-storage/local-api"}],"sectionId":"/zh/api-reference/cloud-storage/local-api"}]}]}},{"type":"separator","label":"Cloud Storage","content":null},{"type":"group","label":"Cloud Storage","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage","items":[{"label":"查询云存储信息","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage/querycloudstorageinfolocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage/querycloudstorageinfolocal","metadata":{"seo":{"title":"查询云存储信息","description":"返回团队的云存储容量与当前用量。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"queryCloudStorageInfoLocal","name":"查询云存储信息","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1info/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"查询云存储信息","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"返回团队的云存储容量与当前用量。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：团队必须已有云存储记录。"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"从未开通过云存储的团队会收到错误，而不是读到零容量"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"——该记录在购买存储时创建，不会由本接口惰性创建。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：无。只读。可带退避安全重试。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"单位"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"capacity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 与 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"usedCapacity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 都是字节数。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"精度"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"usedCapacity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 是在上传与删除时维护的累计计数器，不是对文件表的实时求和，因此可能与 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/cloudstorage/file/page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 中 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fileSize"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 的总和产生偏差。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"取值"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"capacityStatus"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 仅在配额为正且已用满时为 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"；"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"isExpired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 用到期时间与当前时间比较。从未确认上传的文件不计入 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"usedCapacity"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"已记录的业务错误码："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39001"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。 各错误码的含义见 "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/zh/api-reference/getting-started/error-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。任何接口还可能返回通用错误码。"},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/cloudstorage/info","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200"],"pointer":"/api/cloudstorage/info","href":"cloud-storage/querycloudstorageinfolocal","openApiOperationId":"queryCloudStorageInfoLocal","summary":"查询云存储信息"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4495"}},"schemaId":"schema_4495"}],"pointer":"/paths/~1api~1cloudstorage~1info/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4495","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4495"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage/querycloudstorageinfolocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/info"}],"content":{"contentType":"group","meta":{"name":"Cloud Storage"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cloud Storage","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"查询存储配额与用量"},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/cloudstorage/info","summary":"查询云存储信息","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cloud-storage/querycloudstorageinfolocal","deprecated":false}]}]}]}]}},{"type":"group","label":"Cloud Storage Files","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files","items":[{"label":"分页查询云存储文件","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files/pagecloudstoragefileslocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files/pagecloudstoragefileslocal","metadata":{"seo":{"title":"分页查询云存储文件","description":"分页列出云存储文件。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"pageCloudStorageFilesLocal","name":"分页查询云存储文件","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1file~1page/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"分页查询云存储文件","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"分页列出云存储文件。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：无。只读。可带退避安全重试。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"可见性"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"只列出已确认上传完成的文件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"——拿了预签名 URL 但从未完成登记的文件不会出现。没有全量数据权限的成员只能看到自己上传的文件。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"筛选"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fileName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 为模糊匹配；"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tagIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 为「命中任一即返回」；结果按创建时间倒序，顺序不可更改。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"注意"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：如果某个标签在仍挂在文件上时被删除，"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tagInfo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 里会出现 null 元素。"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FilePageRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1page/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/FilePageRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1page/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1file~1page/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/file/page","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/FilePageRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1page/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/file/page","href":"cloud-storage-files/pagecloudstoragefileslocal","openApiOperationId":"pageCloudStorageFilesLocal","summary":"分页查询云存储文件"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/FilePageRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1page/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FilePageRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1page/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4496"}},"schemaId":"schema_4496"}],"pointer":"/paths/~1api~1cloudstorage~1file~1page/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4496","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4496"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-files/pagecloudstoragefileslocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/file/page"},{"label":"批量申请预签名上传地址","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files/batchrequestcloudstoragepresigneduploadurlslocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files/batchrequestcloudstoragepresigneduploadurlslocal","metadata":{"seo":{"title":"批量申请预签名上传地址","description":"预留云存储记录并获取预签名上传 URL。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"batchRequestCloudStoragePresignedUploadUrlsLocal","name":"批量申请预签名上传地址","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1upload~1init/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"批量申请预签名上传地址","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"预留云存储记录并获取预签名上传 URL。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：团队必须已有云存储记录且未过期。每个文件基础名限 60 字符，且必须在本次请求内以及与团队现有全部文件之间唯一——"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"比对时不含扩展名"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，因此 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"a.png"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 会与已存在的 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"a.mp4"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 冲突。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"限制"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：全团队最多同时存在 100 个未确认的上传。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：为每个文件名插入一条上传中状态、大小为 0 的记录，并各返回 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{id, fileName, presignedUrl}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"容量"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"这一步不校验空间。"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 空间在确认上传时才扣减，因此 init 成功后 complete 仍可能因空间不足失败。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"完成信号"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：同步。"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"每个预签名 URL 有效期为 1 小时"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"；把文件字节 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 上去，然后调用 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/cloudstorage/upload/complete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"已记录的业务错误码："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39001"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39037"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39044"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39045"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39047"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39050"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39051"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。 各错误码的含义见 "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/zh/api-reference/getting-started/error-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。任何接口还可能返回通用错误码。"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadInitRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1init/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/UploadInitRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1init/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1upload~1init/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/upload/init","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/UploadInitRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1init/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/upload/init","href":"cloud-storage-files/batchrequestcloudstoragepresigneduploadurlslocal","openApiOperationId":"batchRequestCloudStoragePresignedUploadUrlsLocal","summary":"批量申请预签名上传地址"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/UploadInitRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1init/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadInitRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1init/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4497"}},"schemaId":"schema_4497"}],"pointer":"/paths/~1api~1cloudstorage~1upload~1init/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4497","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4497"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-files/batchrequestcloudstoragepresigneduploadurlslocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/upload/init"},{"label":"确认上传完成","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files/confirmcloudstorageuploadcompletelocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files/confirmcloudstorageuploadcompletelocal","metadata":{"seo":{"title":"确认上传完成","description":"确认已上传的云存储文件。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"confirmCloudStorageUploadCompleteLocal","name":"确认上传完成","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1upload~1complete/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"确认上传完成","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"确认已上传的云存储文件。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：文件记录必须属于你的团队，且对象必须已在存储中——服务端会读取其 ETag 与长度进行核验。大小必须大于 0 且小于 2 GB。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：原子地扣减团队存储容量，然后把记录标记为已上传并写入真实大小。在此成功之前，该文件"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"不会出现在 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/cloudstorage/file/page"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，并持续占用 100 个待确认槽位之一。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"失败即删除已上传对象。"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 过早调用、超出大小限制或空间不足，都会把字节从存储中删掉，并让记录停留在未确认状态。恢复方式是重新 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/cloudstorage/upload/init"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 并重新上传，而不是重试本接口。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"完成信号"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：同步；一旦成功即幂等——再次调用会返回同一文件且不再扣减容量。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"说明"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：始终未确认的记录会在 24 小时后被自动清理。"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"已记录的业务错误码："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39001"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39011"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39014"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39041"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39046"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39047"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。 各错误码的含义见 "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/zh/api-reference/getting-started/error-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。任何接口还可能返回通用错误码。"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadCompleteRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1complete/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/UploadCompleteRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1complete/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1upload~1complete/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/upload/complete","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/UploadCompleteRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1complete/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/upload/complete","href":"cloud-storage-files/confirmcloudstorageuploadcompletelocal","openApiOperationId":"confirmCloudStorageUploadCompleteLocal","summary":"确认上传完成"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/UploadCompleteRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1complete/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UploadCompleteRequest","exampleIds":["paths/~1api~1cloudstorage~1upload~1complete/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4498"}},"schemaId":"schema_4498"}],"pointer":"/paths/~1api~1cloudstorage~1upload~1complete/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4498","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4498"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-files/confirmcloudstorageuploadcompletelocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/upload/complete"},{"label":"批量删除云存储文件","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files/batchdeletecloudstoragefileslocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-files/batchdeletecloudstoragefileslocal","metadata":{"seo":{"title":"批量删除云存储文件","description":"按 ID 删除云存储文件。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"batchDeleteCloudStorageFilesLocal","name":"批量删除云存储文件","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1file~1delete~1batch/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"批量删除云存储文件","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"按 ID 删除云存储文件。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：每个 ID 都必须能在你的团队中解析；"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"只要有一个解析不到，整批都会被拒绝并回滚"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，包括那些已被删除的 ID。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：软删除。配额在同一事务内释放；已存储的对象以尽力而为的方式删除——存储侧失败只记日志、不会让调用失败，因此对象可能比记录活得更久。标签关联不会被清理。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"完成信号"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：同步。请用 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/cloudstorage/info"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 确认释放出的空间。"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"已记录的业务错误码："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39011"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。 各错误码的含义见 "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/zh/api-reference/getting-started/error-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。任何接口还可能返回通用错误码。"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FileDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1delete~1batch/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/FileDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1delete~1batch/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1file~1delete~1batch/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/file/delete/batch","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/FileDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1delete~1batch/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/file/delete/batch","href":"cloud-storage-files/batchdeletecloudstoragefileslocal","openApiOperationId":"batchDeleteCloudStorageFilesLocal","summary":"批量删除云存储文件"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/FileDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1delete~1batch/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FileDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1delete~1batch/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4499"}},"schemaId":"schema_4499"}],"pointer":"/paths/~1api~1cloudstorage~1file~1delete~1batch/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4499","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4499"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-files/batchdeletecloudstoragefileslocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/file/delete/batch"}],"content":{"contentType":"group","meta":{"name":"Cloud Storage Files"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cloud Storage Files","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"查询、上传和删除云存储文件"},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/cloudstorage/file/page","summary":"分页查询云存储文件","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-files/pagecloudstoragefileslocal","deprecated":false},{"title":"/api/cloudstorage/upload/init","summary":"批量申请预签名上传地址","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-files/batchrequestcloudstoragepresigneduploadurlslocal","deprecated":false},{"title":"/api/cloudstorage/upload/complete","summary":"确认上传完成","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-files/confirmcloudstorageuploadcompletelocal","deprecated":false},{"title":"/api/cloudstorage/file/delete/batch","summary":"批量删除云存储文件","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-files/batchdeletecloudstoragefileslocal","deprecated":false}]}]}]}]}},{"type":"group","label":"Cloud Storage File Tags","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags","items":[{"label":"设置文件标签","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/setcloudstoragefiletagslocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/setcloudstoragefiletagslocal","metadata":{"seo":{"title":"设置文件标签","description":"替换云存储文件上的标签。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"setCloudStorageFileTagsLocal","name":"设置文件标签","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1set/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"设置文件标签","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"替换云存储文件上的标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：每次调用只针对一个 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fileId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tagIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 不能为空，且必须是你团队的云存储标签。浏览器标签会被拒绝。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：请求中未出现的标签会从文件上移除，缺少的会被补上。"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"本接口无法清空全部标签"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，因为空列表会被拒绝。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"完成信号"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：同步，相同请求体幂等。"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"已记录的业务错误码："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39011"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39048"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39049"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。 各错误码的含义见 "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/zh/api-reference/getting-started/error-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。任何接口还可能返回通用错误码。"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1set/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1set/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1set/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/file/tag/set","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1set/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/file/tag/set","href":"cloud-storage-file-tags/setcloudstoragefiletagslocal","openApiOperationId":"setCloudStorageFileTagsLocal","summary":"设置文件标签"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1set/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1set/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4499"}},"schemaId":"schema_4499"}],"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1set/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4499","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4499"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-file-tags/setcloudstoragefiletagslocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/file/tag/set"},{"label":"追加文件标签","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/addcloudstoragefiletagslocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/addcloudstoragefiletagslocal","metadata":{"seo":{"title":"追加文件标签","description":"为云存储文件追加标签，不移除已有标签。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addCloudStorageFileTagsLocal","name":"追加文件标签","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1add/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"追加文件标签","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"为云存储文件追加标签，不移除已有标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：每次调用只针对一个 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fileId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tagIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 不能为空，且必须是你团队的云存储标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：只做追加，已有标签保持不变。要整体替换请用覆盖版接口。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"完成信号"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：同步且幂等——追加文件已有的标签不会产生任何变化。"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"已记录的业务错误码："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39011"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39048"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"39049"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。 各错误码的含义见 "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/zh/api-reference/getting-started/error-codes"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Codes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。任何接口还可能返回通用错误码。"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1add/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1add/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1add/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/file/tag/add","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1add/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/file/tag/add","href":"cloud-storage-file-tags/addcloudstoragefiletagslocal","openApiOperationId":"addCloudStorageFileTagsLocal","summary":"追加文件标签"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1add/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FileTagChangeRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1add/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4499"}},"schemaId":"schema_4499"}],"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1add/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4499","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4499"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-file-tags/addcloudstoragefiletagslocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/file/tag/add"},{"label":"查询文件标签","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/querycloudstoragefiletagslocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/querycloudstoragefiletagslocal","metadata":{"seo":{"title":"查询文件标签","description":"返回一个或多个云存储文件上挂载的标签。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"queryCloudStorageFileTagsLocal","name":"查询文件标签","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1query/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"查询文件标签","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"返回一个或多个云存储文件上挂载的标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：每个 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fileId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 都必须能在你的团队中解析；"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"只要有一个未知 ID，整个调用就失败"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，不会返回部分数据。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：无。只读。可带退避安全重试。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"注意"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tagIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 读自关联关系，而标签详情来自现存标签，所以一个仍挂在文件上却已被删除的标签会出现在 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tagIds"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 里而在详情中没有对应项。两个数组长度可能不一致。"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FileTagQueryRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1query/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/FileTagQueryRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1query/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1query/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/file/tag/query","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/FileTagQueryRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1query/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/file/tag/query","href":"cloud-storage-file-tags/querycloudstoragefiletagslocal","openApiOperationId":"queryCloudStorageFileTagsLocal","summary":"查询文件标签"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/FileTagQueryRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1query/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/FileTagQueryRequest","exampleIds":["paths/~1api~1cloudstorage~1file~1tag~1query/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4500"}},"schemaId":"schema_4500"}],"pointer":"/paths/~1api~1cloudstorage~1file~1tag~1query/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4500","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4500"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-file-tags/querycloudstoragefiletagslocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/file/tag/query"},{"label":"查询全部云存储文件标签","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/queryallcloudstoragefiletagslocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/queryallcloudstoragefiletagslocal","metadata":{"seo":{"title":"查询全部云存储文件标签","description":"返回团队内所有云存储文件标签。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"queryAllCloudStorageFileTagsLocal","name":"查询全部云存储文件标签","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1tag~1all/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"查询全部云存储文件标签","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"返回团队内所有云存储文件标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：无。只读。可带退避安全重试。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"说明"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：本接口"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"不分页，且云存储标签没有服务端数量上限"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，因此响应体会随团队创建的标签数增长。"},"children":[]}]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/api/cloudstorage/tag/all","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200"],"pointer":"/api/cloudstorage/tag/all","href":"cloud-storage-file-tags/queryallcloudstoragefiletagslocal","openApiOperationId":"queryAllCloudStorageFileTagsLocal","summary":"查询全部云存储文件标签"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4501"}},"schemaId":"schema_4501"}],"pointer":"/paths/~1api~1cloudstorage~1tag~1all/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4501","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4501"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-file-tags/queryallcloudstoragefiletagslocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/tag/all"},{"label":"创建云存储文件标签","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/createcloudstoragefiletaglocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/createcloudstoragefiletaglocal","metadata":{"seo":{"title":"创建云存储文件标签","description":"创建一个云存储文件标签。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createCloudStorageFileTagLocal","name":"创建云存储文件标签","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1tag~1create/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"创建云存储文件标签","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"创建一个云存储文件标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tagName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 不能为空。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：创建标签，颜色从固定色板中选取。"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"不校验重名，也没有数量上限"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"，因此重复调用会创建出第二个同名标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"完成信号"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：同步；响应携带新建的标签。"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TagCreateRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1create/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/TagCreateRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1create/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1tag~1create/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/tag/create","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/TagCreateRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1create/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/tag/create","href":"cloud-storage-file-tags/createcloudstoragefiletaglocal","openApiOperationId":"createCloudStorageFileTagLocal","summary":"创建云存储文件标签"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/TagCreateRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1create/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TagCreateRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1create/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4502"}},"schemaId":"schema_4502"}],"pointer":"/paths/~1api~1cloudstorage~1tag~1create/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4502","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4502"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-file-tags/createcloudstoragefiletaglocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/tag/create"},{"label":"编辑云存储文件标签","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/editcloudstoragefiletaglocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/editcloudstoragefiletaglocal","metadata":{"seo":{"title":"编辑云存储文件标签","description":"重命名一个云存储文件标签。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"editCloudStorageFileTagLocal","name":"编辑云存储文件标签","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1tag~1edit/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"编辑云存储文件标签","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"重命名一个云存储文件标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：标签必须存在于你的团队，且必须是云存储标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：只改名称；颜色和所有已有关联都保留，因此文件会立即显示新名称。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"完成信号"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：同步。没有乐观锁——并发重命名是后写覆盖。"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TagEditRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1edit/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/TagEditRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1edit/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1tag~1edit/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/tag/edit","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/TagEditRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1edit/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/tag/edit","href":"cloud-storage-file-tags/editcloudstoragefiletaglocal","openApiOperationId":"editCloudStorageFileTagLocal","summary":"编辑云存储文件标签"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/TagEditRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1edit/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TagEditRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1edit/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4503"}},"schemaId":"schema_4503"}],"pointer":"/paths/~1api~1cloudstorage~1tag~1edit/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4503","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4503"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-file-tags/editcloudstoragefiletaglocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/tag/edit"},{"label":"删除云存储文件标签","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/deletecloudstoragefiletagslocal","routeSlug":"/zh/api-reference/cloud-storage/local-api/cloud-storage-file-tags/deletecloudstoragefiletagslocal","metadata":{"seo":{"title":"删除云存储文件标签","description":"删除云存储文件标签。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteCloudStorageFileTagsLocal","name":"删除云存储文件标签","isWebhook":false,"pointer":"/paths/~1api~1cloudstorage~1tag~1delete~1batch/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"删除云存储文件标签","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"删除云存储文件标签。"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"前置条件"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：每个 ID 都必须是你团队的云存储标签；"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"只要有一个无效，整批都会失败"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"副作用"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：标签被删除，但"},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"它们与文件的关联不会被清理"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"。会有两个可预期的后果："},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/cloudstorage/file/tag/query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 仍会返回已删除的标签 ID 且详情里没有对应项；"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/cloudstorage/file/page"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 的 "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tagInfo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 里可能出现 null 元素。按已删除的标签 ID 筛选文件会返回空。"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"完成信号"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"：同步，且没有事务包裹。"},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TagDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1delete~1batch/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/TagDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1delete~1batch/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1api~1cloudstorage~1tag~1delete~1batch/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/api/cloudstorage/tag/delete/batch","servers":[{"url":"http://127.0.0.1:40000"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/TagDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1delete~1batch/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/api/cloudstorage/tag/delete/batch","href":"cloud-storage-file-tags/deletecloudstoragefiletagslocal","openApiOperationId":"deleteCloudStorageFileTagsLocal","summary":"删除云存储文件标签"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"http://127.0.0.1:40000"}],"schemaId":"components/schemas/TagDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1delete~1batch/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TagDeleteRequest","exampleIds":["paths/~1api~1cloudstorage~1tag~1delete~1batch/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"成功"},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4503"}},"schemaId":"schema_4503"}],"pointer":"/paths/~1api~1cloudstorage~1tag~1delete~1batch/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_4503","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4503"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/cloud-storage-file-tags/deletecloudstoragefiletagslocal"}],"panels":[]}]},"httpPath":"/api/cloudstorage/tag/delete/batch"}],"content":{"contentType":"group","meta":{"name":"Cloud Storage File Tags"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cloud Storage File Tags","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"管理云存储文件上的标签"},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/api/cloudstorage/file/tag/set","summary":"设置文件标签","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-file-tags/setcloudstoragefiletagslocal","deprecated":false},{"title":"/api/cloudstorage/file/tag/add","summary":"追加文件标签","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-file-tags/addcloudstoragefiletagslocal","deprecated":false},{"title":"/api/cloudstorage/file/tag/query","summary":"查询文件标签","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-file-tags/querycloudstoragefiletagslocal","deprecated":false},{"title":"/api/cloudstorage/tag/all","summary":"查询全部云存储文件标签","prefix":{"name":"get","color":"get"},"badges":[],"link":"/cloud-storage-file-tags/queryallcloudstoragefiletagslocal","deprecated":false},{"title":"/api/cloudstorage/tag/create","summary":"创建云存储文件标签","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-file-tags/createcloudstoragefiletaglocal","deprecated":false},{"title":"/api/cloudstorage/tag/edit","summary":"编辑云存储文件标签","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-file-tags/editcloudstoragefiletaglocal","deprecated":false},{"title":"/api/cloudstorage/tag/delete/batch","summary":"删除云存储文件标签","prefix":{"name":"post","color":"post"},"badges":[],"link":"/cloud-storage-file-tags/deletecloudstoragefiletagslocal","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/ApiResponseBase":{"id":"components/schemas/ApiResponseBase","kind":"json-schema","title":"ApiResponseBase","data":{"type":"object","properties":{"code":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"返回结果码。"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" 表示成功；其他值表示异常。"},"children":[]}]}]}],"example":0},"msg":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"错误信息。"},"children":[]}]}]}],"example":null},"requestId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"操作请求 ID。请求经过 API 网关时可能返回该字段。"},"children":[]}]}]}],"example":"1d4f3ea968664593860b94b35d4ebf5e"}},"required":["code","msg"]}},"components/schemas/StorageInfo":{"id":"components/schemas/StorageInfo","kind":"json-schema","title":"StorageInfo","data":{"type":"object","properties":{"capacity":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"云存储总容量，单位字节。"},"children":[]}]}]}],"example":"10737418240"},"usedCapacity":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"已使用的云存储容量，单位字节。"},"children":[]}]}]}],"example":"536870912"},"expireDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"云存储到期日期。"},"children":[]}]}]}]},"capacityStatus":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"容量状态：0 = 正常，1 = 已满。"},"children":[]}]}]}],"example":0},"isExpired":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"订阅套餐是否已过期。"},"children":[]}]}]}],"example":false}}}},"components/schemas/FilePageRequest":{"id":"components/schemas/FilePageRequest","kind":"json-schema","title":"FilePageRequest","data":{"type":"object","properties":{"pageNo":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"当前页码，从 1 开始，默认 1。"},"children":[]}]}]}],"minimum":1,"default":1,"example":1},"pageSize":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"每页条数，默认 10。"},"children":[]}]}]}],"minimum":1,"default":10,"example":20},"fileName":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"用于模糊搜索的文件名关键字。"},"children":[]}]}]}],"example":"report"},"tagIds":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"按标签 ID 筛选。"},"children":[]}]}]}],"items":{"type":"string"},"example":["1800000000000101"]},"fileType":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"文件类型筛选：0 = 图片，1 = 视频，2 = 应用，3 = 音频，4 = 文档，5 = 其他。"},"children":[]}]}]}],"example":0},"fileIds":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"按文件 ID 筛选。"},"children":[]}]}]}],"items":{"type":"string"},"example":["1800000000001001"]}}}},"components/schemas/TagInfo":{"id":"components/schemas/TagInfo","kind":"json-schema","title":"TagInfo","data":{"type":"object","properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签 ID。"},"children":[]}]}]}],"example":"1800000000000101"},"tagSource":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签来源，如 ENV、PROXY。"},"children":[]}]}]}],"example":"ENV"},"tagName":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签名称。"},"children":[]}]}]}],"example":"Invoice"},"tagType":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签类型：TAG 或 GROUP。"},"children":[]}]}]}],"example":"TAG"},"tagIcon":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签图标。"},"children":[]}]}]}],"example":""}}}},"components/schemas/CloudStorageFile":{"id":"components/schemas/CloudStorageFile","kind":"json-schema","title":"CloudStorageFile","data":{"type":"object","properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"云存储文件 ID。"},"children":[]}]}]}],"example":"1800000000001001"},"fileName":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"文件名（不含扩展名）。"},"children":[]}]}]}],"example":"example"},"fileExt":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"文件扩展名。"},"children":[]}]}]}],"example":"jpg"},"fileSize":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"文件大小，单位字节。"},"children":[]}]}]}],"example":"204800"},"fileType":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"文件类型：0 = 图片，1 = 视频，2 = 应用，3 = 音频，4 = 文档，5 = 其他。"},"children":[]}]}]}],"example":0},"tagInfo":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"文件上的标签详情。"},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/TagInfo"}},"createDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"上传时间。"},"children":[]}]}]}]},"updateDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"更新时间。"},"children":[]}]}]}]}}}},"components/schemas/FilePageData":{"id":"components/schemas/FilePageData","kind":"json-schema","title":"FilePageData","data":{"type":"object","properties":{"current":{"type":"string","example":"1"},"pages":{"type":"string","example":"7"},"total":{"type":"string","example":"128"},"dataList":{"type":"array","items":{"$ref":"#/components/schemas/CloudStorageFile"}}},"required":["current","pages","total","dataList"]}},"components/schemas/UploadInitRequest":{"id":"components/schemas/UploadInitRequest","kind":"json-schema","title":"UploadInitRequest","data":{"type":"object","properties":{"fileNames":{"type":"array","minItems":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"待上传的文件名列表（含扩展名），如 photo.jpg、video.mp4。"},"children":[]}]}]}],"items":{"type":"string"},"example":["photo.jpg","video.mp4"]}},"required":["fileNames"]}},"components/schemas/UploadInitResult":{"id":"components/schemas/UploadInitResult","kind":"json-schema","title":"UploadInitResult","data":{"type":"object","properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"云存储文件 ID。"},"children":[]}]}]}],"example":"1800000000000001"},"fileName":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"文件名（含扩展名）。"},"children":[]}]}]}],"example":"photo.jpg"},"presignedUrl":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"S3 预签名上传地址。使用 HTTPS PUT 上传文件内容。"},"children":[]}]}]}],"example":"https://example.com/presigned-upload-url"}}}},"components/schemas/UploadCompleteRequest":{"id":"components/schemas/UploadCompleteRequest","kind":"json-schema","title":"UploadCompleteRequest","data":{"type":"object","properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"预签名上传地址接口返回的云存储文件 ID。"},"children":[]}]}]}],"example":"1800000000000001"}},"required":["id"]}},"components/schemas/FileDeleteRequest":{"id":"components/schemas/FileDeleteRequest","kind":"json-schema","title":"FileDeleteRequest","data":{"type":"object","properties":{"ids":{"type":"array","minItems":1,"items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"待删除的云存储文件 ID 列表。"},"children":[]}]}]}],"example":["1800000000001001","1800000000001002"]}},"required":["ids"]}},"components/schemas/FileTagChangeRequest":{"id":"components/schemas/FileTagChangeRequest","kind":"json-schema","title":"FileTagChangeRequest","data":{"type":"object","properties":{"fileId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"云存储文件 ID。"},"children":[]}]}]}],"example":"1800000000001001"},"tagIds":{"type":"array","minItems":1,"items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签 ID 列表。"},"children":[]}]}]}],"example":["1800000000000101","1800000000000102"]}},"required":["fileId","tagIds"]}},"components/schemas/FileTagQueryRequest":{"id":"components/schemas/FileTagQueryRequest","kind":"json-schema","title":"FileTagQueryRequest","data":{"type":"object","properties":{"fileIds":{"type":"array","minItems":1,"items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"云存储文件 ID 列表。"},"children":[]}]}]}],"example":["1800000000001001"]}},"required":["fileIds"]}},"components/schemas/FileTagResultData":{"id":"components/schemas/FileTagResultData","kind":"json-schema","title":"FileTagResultData","data":{"type":"object","properties":{"fileId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"云存储文件 ID。"},"children":[]}]}]}],"example":"1800000000001001"},"tagIds":{"type":"array","items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"文件上的标签 ID 列表。"},"children":[]}]}]}],"example":["1800000000000101"]},"tagInfo":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签详情。"},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/TagInfo"}}}}},"components/schemas/TagCreateRequest":{"id":"components/schemas/TagCreateRequest","kind":"json-schema","title":"TagCreateRequest","data":{"type":"object","properties":{"tagName":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签名称。"},"children":[]}]}]}],"example":"Invoice"}},"required":["tagName"]}},"components/schemas/TagEditRequest":{"id":"components/schemas/TagEditRequest","kind":"json-schema","title":"TagEditRequest","data":{"type":"object","properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签 ID。"},"children":[]}]}]}],"example":"1800000000000101"},"tagName":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"标签名称。"},"children":[]}]}]}],"example":"Invoice 2026"}},"required":["id","tagName"]}},"components/schemas/TagDeleteRequest":{"id":"components/schemas/TagDeleteRequest","kind":"json-schema","title":"TagDeleteRequest","data":{"type":"object","properties":{"ids":{"type":"array","minItems":1,"items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"要删除的标签 ID。"},"children":[]}]}]}],"example":["1800000000000101"]}},"required":["ids"]}},"schema_4495":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/StorageInfo"}},"required":["data"]}]},"id":"schema_4495"},"schema_4496":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FilePageData"}},"required":["data"]}]},"id":"schema_4496"},"schema_4497":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/UploadInitResult"}}},"required":["data"]}]},"id":"schema_4497"},"schema_4498":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CloudStorageFile"}},"required":["data"]}]},"id":"schema_4498"},"schema_4499":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"type":"null","example":null}}}]},"id":"schema_4499"},"schema_4500":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FileTagResultData"}}},"required":["data"]}]},"id":"schema_4500"},"schema_4501":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TagInfo"}}},"required":["data"]}]},"id":"schema_4501"},"schema_4502":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TagInfo"}},"required":["data"]}]},"id":"schema_4502"},"schema_4503":{"kind":"json-schema","data":{"allOf":[{"$ref":"#/components/schemas/ApiResponseBase"},{"type":"object","properties":{"data":{"type":"boolean","example":true}},"required":["data"]}]},"id":"schema_4503"}},"exampleStore":{"paths/~1api~1cloudstorage~1file~1page/post/requestBody/content/application~1json/example":{"value":{"pageNo":1,"pageSize":20,"fileName":"report","tagIds":["1800000000000001"]},"id":"paths/~1api~1cloudstorage~1file~1page/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1upload~1init/post/requestBody/content/application~1json/example":{"value":{"fileNames":["example.jpg"]},"id":"paths/~1api~1cloudstorage~1upload~1init/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1upload~1complete/post/requestBody/content/application~1json/example":{"value":{"id":"1800000000000001"},"id":"paths/~1api~1cloudstorage~1upload~1complete/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1file~1delete~1batch/post/requestBody/content/application~1json/example":{"value":{"ids":["1800000000001001","1800000000001002"]},"id":"paths/~1api~1cloudstorage~1file~1delete~1batch/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1file~1tag~1set/post/requestBody/content/application~1json/example":{"value":{"fileId":"1800000000001001","tagIds":["1800000000000101","1800000000000102"]},"id":"paths/~1api~1cloudstorage~1file~1tag~1set/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1file~1tag~1add/post/requestBody/content/application~1json/example":{"value":{"fileId":"1800000000001001","tagIds":["1800000000000103"]},"id":"paths/~1api~1cloudstorage~1file~1tag~1add/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1file~1tag~1query/post/requestBody/content/application~1json/example":{"value":{"fileIds":["1800000000001001"]},"id":"paths/~1api~1cloudstorage~1file~1tag~1query/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1tag~1create/post/requestBody/content/application~1json/example":{"value":{"tagName":"Invoice"},"id":"paths/~1api~1cloudstorage~1tag~1create/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1tag~1edit/post/requestBody/content/application~1json/example":{"value":{"id":"1800000000000101","tagName":"Invoice 2026"},"id":"paths/~1api~1cloudstorage~1tag~1edit/post/requestBody/content/application~1json/example"},"paths/~1api~1cloudstorage~1tag~1delete~1batch/post/requestBody/content/application~1json/example":{"value":{"ids":["1800000000000101"]},"id":"paths/~1api~1cloudstorage~1tag~1delete~1batch/post/requestBody/content/application~1json/example"}},"securitySchemeStore":{},"servers":[{"url":"http://127.0.0.1:40000"}]},"options":{"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/@l10n/zh/API Reference/Cloud Storage/local-api.json?download"},{"url":"/_bundle/@l10n/zh/API Reference/Cloud Storage/local-api.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"云存储 Local API","description":"通过 MoreLogin Local API 管理 MoreLogin 云存储的文件、上传、删除和文件标签。\n**Base URL**：`http://127.0.0.1:40000`\nLocal API 的路径使用 `/api` 前缀。"}},"baseSlug":"/zh/api-reference/cloud-storage/local-api","routesMapping":{}}