目录或相簿

import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.DirectoryApi;
import com.tencent.cloud.smh.model.ListDirectory200Response;

// 使用 marker/limit 分页查询（推荐）
String nextMarker = null;
try {
    DirectoryApi.APIListDirectoryRequest request = DirectoryApi.APIListDirectoryRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .filePath("/images")
        .byMarker(1)
        .limit(20)
        .orderBy("creationTime")
        .orderByType("desc")
        .filter("onlyFile")
        .sortType("union")
        .withInode(0)
        .withFavoriteStatus(0)
        .accessToken("your-access-token")
        .userId("xxx")
        .build();

    ApiResponse<Object> apiResponse = client.directory().listDirectoryWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 200) {
        ListDirectory200Response result = (ListDirectory200Response) apiResponse.getData();
        System.out.println("Directory contents: " + result.getContents().size() + " items");

        nextMarker = result.getNextMarker();
        if (nextMarker != null) {
            System.out.println("More data available, next marker: " + nextMarker);
        }
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}

// 获取下一页：将上一次响应中的 nextMarker 作为 marker 传入
try {
    DirectoryApi.APIListDirectoryRequest request2 = DirectoryApi.APIListDirectoryRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .filePath("/images")
        .byMarker(1)
        .marker(nextMarker)
        .limit(20)
        .accessToken("your-access-token")
        .build();

    ApiResponse<Object> apiResponse2 = client.directory().listDirectoryWithHttpInfo(request2);
    // 处理响应...
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}

import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.DirectoryApi;
import com.tencent.cloud.smh.model.ListDirectoryByPage200Response;

// 使用 page/pageSize 分页查询（不推荐）
try {
    DirectoryApi.APIListDirectoryByPageRequest request = DirectoryApi.APIListDirectoryByPageRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .filePath("/images")
        .byPage(1)
        .page(1)
        .pageSize(20)
        .orderBy("creationTime")
        .orderByType("desc")
        .filter("onlyFile")
        .sortType("union")
        .withInode(0)
        .withFavoriteStatus(0)
        .accessToken("your-access-token")
        .userId("xxx")
        .build();

    ApiResponse<Object> apiResponse = client.directory().listDirectoryByPageWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 200) {
        ListDirectoryByPage200Response result = (ListDirectoryByPage200Response) apiResponse.getData();
        System.out.println("File count: " + result.getFileCount());
        System.out.println("Sub-directory count: " + result.getSubDirCount());
        System.out.println("Total: " + result.getTotalNum());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}

import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.DirectoryApi;
import com.tencent.cloud.smh.model.InfoFileOrDirectory200Response;
import java.math.BigDecimal;

// 获取目录详情
try {
    DirectoryApi.APIInfoFileOrDirectoryRequest request = DirectoryApi.APIInfoFileOrDirectoryRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .filePath("/documents")
        .info(BigDecimal.ONE)
        .withInode(1)
        .withFavoriteStatus(1)
        .accessToken("your-access-token")
        .build();

    ApiResponse<Object> apiResponse = client.directory().infoFileOrDirectoryWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 200) {
        InfoFileOrDirectory200Response result = (InfoFileOrDirectory200Response) apiResponse.getData();
        System.out.println("Name: " + result.getName());
        System.out.println("Type: " + result.getType());
        System.out.println("Size: " + result.getSize());
        System.out.println("Inode: " + result.getInode());
        System.out.println("Is favorite: " + result.getIsFavorite());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}

import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.DirectoryApi;

try {
    DirectoryApi.APICheckDirectoryStatusRequest request = DirectoryApi.APICheckDirectoryStatusRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .filePath("/documents/critical")
        .accessToken("your-access-token")
        .userId("xxx")
        .build();

    ApiResponse<Object> apiResponse = client.directory().checkDirectoryStatusWithHttpInfo(request);
    System.out.println("Status code: " + apiResponse.getStatusCode());
    System.out.println("Directory status is OK");
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}

import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.DirectoryApi;
import com.tencent.cloud.smh.model.GetDirectoryStats200Response;

try {
    DirectoryApi.APIGetDirectoryStatsRequest request = DirectoryApi.APIGetDirectoryStatsRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .filePath("/documents")
        .stats(1)
        .statsType("normal")
        .accessToken("your-access-token")
        .userId("user-id")
        .build();

    ApiResponse<Object> apiResponse = client.directory().getDirectoryStatsWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 200) {
        GetDirectoryStats200Response result = (GetDirectoryStats200Response) apiResponse.getData();
        System.out.println("File count: " + result.getFileCount());
        System.out.println("Sub-directory count: " + result.getDirCount());
        System.out.println("Storage (bytes): " + result.getStorage());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}

{
  "userId": "user123",
  "statsType": "normal",
  "storage": 5558728615,
  "fileCount": 1024,
  "dirCount": 50
}

import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.DirectoryApi;
import com.tencent.cloud.smh.model.CalibrateDirectoryStats200Response;

try {
    DirectoryApi.APICalibrateDirectoryStatsRequest request = DirectoryApi.APICalibrateDirectoryStatsRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .filePath("/documents")
        .calibrate(1)
        .statsType("normal")
        .accessToken("your-access-token")
        .userId("user-id")
        .build();

    ApiResponse<Object> apiResponse = client.directory().calibrateDirectoryStatsWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();

    if (statusCode == 200) {
        CalibrateDirectoryStats200Response result = (CalibrateDirectoryStats200Response) apiResponse.getData();
        System.out.println("Calibrate task submitted, taskId: " + result.getTaskId());
        // 后续通过任务管理接口轮询任务执行结果
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}

import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.DirectoryApi;
import com.tencent.cloud.smh.model.CreateDirectory201Response;
import com.tencent.cloud.smh.model.CreateDirectoryRequest;

import java.time.OffsetDateTime;
import java.util.List;
import java.util.Map;

// 设置请求体
CreateDirectoryRequest createDirBody = new CreateDirectoryRequest();
createDirBody.setMetaData(Map.of("department", "engineering", "project", "sdk-v2"));
createDirBody.setLabels(List.of("重要", "项目文档"));
createDirBody.setLocalCreationTime(OffsetDateTime.now());
createDirBody.setLocalModificationTime(OffsetDateTime.now());

try {
    DirectoryApi.APICreateDirectoryRequest request = DirectoryApi.APICreateDirectoryRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .filePath("/project-docs")
        .conflictResolutionStrategy("rename")
        .accessToken("your-access-token")
        .withInode(1)
        .userId("xxx")
        .createDirectoryRequest(createDirBody)
        .build();

    ApiResponse<Object> apiResponse = client.directory().createDirectoryWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();
    System.out.println("Status code: " + statusCode);

    if (statusCode == 201) {
        CreateDirectory201Response result = (CreateDirectory201Response) apiResponse.getData();
        System.out.println("Directory created, path: " + result.getPath());
        System.out.println("Inode: " + result.getInode());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}