---
title: "署名付きURLの取得"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/stratus/get-presigned-url/
description: "このAPIは、署名付きURLを取得できるようにします。このURLを他のユーザーと共有すると、安全にダウンロードおよびアップロード操作を実行できます。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

# 署名付きURLの取得

### 説明

このAPIは、署名付きURLを取得できるようにします。署名付きURLは、認証済みユーザーが非認証ユーザーと共有できるセキュアなURLです。このURLにより、非認証ユーザーにオブジェクトへの一時的なアクセス権限が付与されます。リンクの有効期限が切れた場合、このAPIを使用して必要なURLに再度署名する必要があります。

> **注意:** アップロード操作とダウンロード操作では異なるリクエストメソッドがあります。

### リクエスト詳細

#### アップロード操作のリクエストURL

`PUT` {api-domain}/baas/v1/project/{project_id}/bucket/object/signed-url

#### ダウンロード操作のリクエストURL

`GET` {api-domain}/baas/v1/project/{project_id}/bucket/object/signed-url

- **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

#### クエリパラメータ

- **bucket_name** (Alphanumeric, mandatory): [バケットの名前](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)

- **object_key** (String, mandatory): 必要なオブジェクトの完全な名前を含みます。

- **expiry_in_seconds** (Number, optional): 秒単位の有効期限を含みます。この制限に達すると、署名付きURLは使用できなくなります。デフォルト値は`3600`です。

- **active_from** (Timestamp, optional): 署名付きURLがいつからアクティブになるかのタイムスタンプを含みます。

- **version_id** (String, optional): このパラメータは`GET`リクエストURLでのみ使用できます。[バージョンID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)を含みます。

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**オプションヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### ダウンロードのスコープ

ZohoCatalyst.buckets.objects.READ

#### アップロードのスコープ

ZohoCatalyst.buckets.objects.CREATE

### レスポンス詳細

正常に実行されると、レスポンスには署名付きURLが含まれます。

**ダウンロード操作のリクエスト例**

```bash

curl -X GET https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket/object/signed-url?bucket_name=myBucketName&object_key=object.pdf&expiry_in_seconds=3600&active_from=1716382375000&version_id=bs22sb2923ey2hds929/
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**アップロード操作のリクエスト例**

```bash

curl -X PUT https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket/object/signed-url?bucket_name=myBucketName&object_key=object.pdf&expiry_in_seconds=3600&active_from=1716382375000/
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**レスポンス例**

```json

    {
    "status": "success",
    "data": {
        "signature": "https://mybucket.nimbuspop.com/folder1/folder2/image.jpeg?expires=1642915027000&signature=MEYCIQCcJDTsmZQhfuvFu3l3tsVL02uVwIMhLdlSg~ARI3E1aAIhAJ-rzzjn2gPH9pB3EoU3X~v~qvg5Rdt9OBoldBpVz6xt&key-id=vMUWDURn5DGtokPG",
        "expires_in_seconds": 300,
        "active_from": 1716382487000
    }
    }

```

### SDK Documentation

* [Generate Presigned URL - Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/pre-signed-urls/)
* [Generate Presigned URL - Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/pre-signed-urls/)
* [Generate Presigned URL - Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/pre-signed-urls/)
* [Stratus - Web SDK](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/overview/)
* [Stratus - iOS SDK](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/stratus/overview/)
* [Stratus - Android SDK](https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/stratus/overview/)
* [Stratus - Flutter SDK](https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/cloud-scale/stratus/overview/)