---
title: "配送リンク"
slug: "delivery-links"
abstract: "メディア配信サービスおよび配信リンクの利用方法に関連する事前認証済みURL、監査ログ、リクエストURLの概要。"
---
# 配送リンク

アセットを検索すると、実際の画像、動画、その他のダウンロード可能なメディアは、ページに使われているものとは異なるホストから配信されます。メディア配信サービス(MDS)は、配信リンク(レンディションとも呼ばれる)を通じてそれらを提供します。

## 事前認証済みのURL

他のドメインのコンテンツを保護するにはクッキーを使用することはできません。事前認証されたURLを使用することで、配信ホストはクライアントにリソースの取得を許可し、Content Hubポータルに連絡せずに許可できます。

## 監査ログ

デリバリーホストは、ポータルホスト外のすべてのダウンロードイベントを集約し、分析や監査を行うために*Download event*メッセージをキューに投稿できます。デリバリーホストはリクエストごとのウォーターマークを追加できます。

> !注専用の衛星ノードに加え、ポータルは衛星ノードとしても機能します。

## リクエストURL

リクエストURLの形式は以下の通りです:

https://<HOST>/api/delivery/<API\_VERSION>/<TENANT\_ID>/<KEY>{?expires,entityid,userid,rendition,watermark,signature}

> !重要リクエストを直接MDSに送る必要はありません。リクエストURLはContent Hubを使う際に透過的に構築されます。

以下の表はリクエストURLのパラメータを示しています。

パラメータ

概要

必須

apiVersion

APIバージョン。将来の潜在的な壊れやすい変更に備えて互換性のために使われています。

はい

tenantId

申請をした入居者を識別するIDです。

はい

key

ファイルプロバイダー内のバイナリ大型オブジェクト(BLOB)を識別するキーです。

はい

signature

URLを検証する署名です。

はい

entityid

ダウンロードイベントの記録に使われます。

いいえ

userid

ダウンロードイベントの記録に使われます。

いいえ

rendition

ダウンロードイベントの記録に使用されます。レンディションがなければリソースは *インライン*で返され、そうでなければ *添付*ファイルとして返され、場合によってはバックエンドストアへのリダイレクトが行われます。

いいえ

intent

リンクの目的は download または streamingで、リソースを *インライン* で使用するか、 *アタッチメント*として使用するかを示すことです。 noneに設定されている場合、ダウンロードは [報告ログ](https://doc.sitecore.com/ch/en/users/content-hub/reporting-logs.html)に記録されません。

いいえ

watermark

画像に適用できる透かしです。

いいえ

expires

リンクが期限切れになりURLが無効になる日時(ISO8601年)。存在しなければ有効期限はありません。

いいえ

filename

ファイル名。

いいえ

> !注これらのパラメータは*AssetExtensionDataMessageHandler*実装によって自動的に生成されます。