요청 엔드포인트

JSON API

Cloud Storage에 직접 JSON API 요청을 수행할 때는 다음 엔드포인트를 사용합니다.

• 객체 업로드를 제외한 일반적인 JSON API 요청의 경우, 다음 엔드포인트를 사용합니다. 여기에서 PATH_TO_RESOURCE를 적절한 값으로 바꿉니다.

  https://storage.googleapis.com/storage/v1/PATH_TO_RESOURCE

• JSON API 객체 업로드에는 다음 엔드포인트를 사용합니다. 여기에서 BUCKET_NAME를 적절한 값으로 바꿉니다.

  https://storage.googleapis.com/upload/storage/v1/b/BUCKET_NAME/o

• 일괄 요청의 경우, 다음 엔드포인트를 사용하고 PATH_TO_RESOURCE를 적절한 값으로 바꿉니다.

  https://storage.googleapis.com/batch/storage/v1/PATH_TO_RESOURCE

• JSON API 객체 다운로드의 경우 필요에 따라 다음 엔드포인트를 사용할 수 있습니다. 여기에서 BUCKET_NAME 및 OBJECT_NAME은 적절한 값으로 바꿉니다.

  https://storage.googleapis.com/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media

JSON API 엔드포인트는 HTTPS 요청만 수용합니다.

XML API

Cloud Storage에 직접 XML API 요청을 수행할 때는 가상 호스팅 스타일 또는 경로 스타일의 엔드포인트를 사용하면서 BUCKET_NAME 및 OBJECT_NAME을 적절한 값으로 바꿉니다.

• 가상 호스팅 스타일 엔드포인트:

  https://BUCKET_NAME.storage.googleapis.com/OBJECT_NAME

• 경로 스타일 엔드포인트:

  https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME

XML API 엔드포인트는 보안 소켓 레이어(SSL) 암호화를 지원하므로 HTTP 또는 HTTPS를 사용할 수 있습니다. 특히 OAuth 2.0을 사용하여 Cloud Storage에 인증한다면 HTTPS를 사용하는 것이 좋습니다.

gRPC

gRPC( Google에서 개발한 고성능 오픈소스 범용 RPC 프레임워크)를 사용하여 Cloud Storage와 상호작용할 수 있습니다. gRPC 클라이언트는 서비스 엔드포인트에 연결됩니다. Cloud Storage와 같은Google Cloud 서비스의 경우 일반적으로 googleapis.com 도메인(예: storage.googleapis.com)의 DNS 주소이며 443과 같은 표준 보안 포트를 사용합니다. gRPC를 사용하면 성능이 향상되고 효율적인 스트리밍 기능을 제공할 수 있습니다.

gRPC를 사용하여 Cloud Storage와 상호작용하려면 Cloud 클라이언트 라이브러리에서 gRPC를 사용 설정해야 합니다.

지원되는 다음 언어 중 하나를 사용하여 클라이언트 라이브러리에서 gRPC를 사용 설정합니다.

• C++ 클라이언트 라이브러리

• 자바 클라이언트 라이브러리

• Go 클라이언트 라이브러리