Object Storage Service (OSS) バケットのリファラーホワイトリストまたはブラックリストを設定します。 Refererフィールドが空のリクエストを許可するかどうか、およびURLのクエリ文字列を切り捨てるかどうかを指定できます。
使用上の注意
デフォルトでは、Alibaba Cloudアカウントには、OSSバケットのリファラーホワイトリストまたはブラックリストを設定する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してOSSバケットのリファラーホワイトリストまたはブラックリストを設定するには、oss:PutBucketReferer
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
コマンド構文
ossutil api put-bucket-referer --bucket value --referer-configuration value [flags]
パラメーター | データ型 | 説明 |
-- bucket | String | バケットの名前です。 |
-- referer-configuration | String | ホットリンク保護設定を格納するコンテナー。 |
説明
put-bucket-refererコマンドは、PutBucketReferer操作に対応します。 PutBucketReferer操作のパラメーターの詳細については、「PutBucketReferer」をご参照ください。
-- referer-configuration
-- referer-configurationオプションは、XML形式とJSON形式の両方をサポートします。 オプションの値にfile:// プレフィックスが含まれている場合、ossutilは構成ファイルから構成を読み取ります。
XML 形式:
<RefererConfiguration>
<TruncatePath>boolean</TruncatePath>
<RefererList>
<Referer>string</Referer>
</RefererList>
<RefererBlacklist>
<Referer>string</Referer>
</RefererBlacklist>
<AllowEmptyReferer>boolean</AllowEmptyReferer>
<AllowTruncateQueryString>boolean</AllowTruncateQueryString>
</RefererConfiguration>
JSON 形式:
{
"AllowEmptyReferer": boolean,
"AllowTruncateQueryString": boolean,
"TruncatePath": boolean,
"RefererList": {
"Referer": ["string", ...]
},
"RefererBlacklist": {
"Referer": ["string", ...]
}
}
例
次の例は、examplebucket
という名前のバケットにリファラーホワイトリストまたはブラックリストを設定する方法を示しています。
サンプルコマンド:
ossutil api put-bucket-referer --bucket examplebucket --referer-configuration file://referer-configuration.xml