tencent cloud

Cloud Object Storage

사전 서명된 URL 가져오기 - signurl

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-03-17 10:21:56
signurl 명령어는 익명으로 객체에 액세스할 수 있는 객체의 사전 서명된 URL을 얻는 데 사용됩니다.

명령어 형식

./coscli signurl cos://<bucket-name>/<key> [flag]
signurl 명령어에는 다음과 같은 매개변수 옵션이 포함됩니다.
매개변수 형식
매개변수 용도
예시
cos://<bucket-name>/<key>
접근하려는 버킷 지정. 매개변수 설정의 버킷 별칭이나 버킷 이름을 사용할 수 있습니다. 버킷 이름으로 접근하는 경우, endpoint flag를 추가로 지정해야 합니다.
버킷 별칭으로 접근: cos://example-alias/test.txt
버킷 이름으로 접근: cos://examplebucket-1250000000/test.txt
signurl 명령어에는 다음과 같은 flag 옵션이 포함됩니다.
flag 약칭
flag 전체 명칭
flag 용도
-h
--help
명령어 구체 사용법 확인
-t
--time
URL 만료 시간 설정(기본 값 1000초)
없음
--simple-output
간단한 출력 모드를 활성화합니다. 기본값은 false입니다. true로 설정하면 서명 URL만 출력하여 반환 결과를 간소화합니다.
설명:
이 명령의 다른 범용 옵션(예시: 버킷 전환, 사용자 계정 전환 등)은 범용 옵션 문서를 참고하십시오.

작업 예시

bucket1에 있는 picture.jpg의 사전 서명된 URL을 가져옵니다.

./coscli signurl cos://bucket1/picture.jpg
반환된 결과 예시는 다음과 같습니다:
INFO[2026-02-04 11:36:10] Signed URL:
INFO[2026-02-04 11:36:10] https://bucket1-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176170%3B1770186170&q-key-time=1770176170%3B1770186170&q-header-list=host&q-url-param-list=&q-signature=****************************************

사전 서명된 picture.jpg URL을 bucket2에서 가져와 URL의 만료 시간을 1314초로 설정합니다.

./coscli signurl cos://bucket2/picture.jpg --time 1314
반환된 결과 예시는 다음과 같습니다:
INFO[2026-02-04 11:36:10] Signed URL:
INFO[2026-02-04 11:36:10] https://bucket2-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176170%3B1770186170&q-key-time=1770176170%3B1770186170&q-header-list=host&q-url-param-list=&q-signature=****************************************

bucket3 버킷 내 picture.jpg 객체의 사전 서명된 URL을 가져오고 간단한 출력 모드를 사용합니다

./coscli signurl cos://bucket3/picture.jpg --simple-output
반환된 결과 예시는 다음과 같습니다:
https://bucket3-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176267%3B1770186267&q-key-time=1770176267%3B1770186267&q-header-list=host&q-url-param-list=&q-signature=****************************************

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백