ストリームレベルのリージョンブロッキングを設定します。
使用上の注意
ドメイン名に対して、最大200のストリームレベルのリージョンブロックルールを設定できます。 同じアプリケーション名と同じストリーム名が指定されているルールがある場合は、最後に更新されたルールが有効になります。
QPS制限
この操作は、アカウントごとに1秒あたり最大50回呼び出すことができます。 この制限を超えるリクエストは削除され、サービスが中断されます。 この操作を呼び出す際は、この制限にご注意ください。 詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
リクエストパラメーター
パラメーター | データ型 | 必須 | 説明 |
Action | String | 課金されます | 実行する操作です。 値をSetLiveStreamBlockに設定します。 |
DomainName | String | 課金されます | ストリーミングドメイン。 |
AppName | String | 課金されます | ライブストリームが属するアプリケーションの名前。 |
StreamName | String | 課金されます | ライブストリームの名前。 |
BlockType | String | 課金されます | ブロッキングタイプ。 有効な値: blacklistおよびwhitelist。 |
LocationList | String | 課金されます | ブロックされたリージョン。 CNやasなど複数のリージョンを指定する場合は、コンマ (,) で区切ります。 |
ReleaseTime | String | 課金されません | ブロッキングが終了する時間。 時刻は UTC である必要があります。 このパラメーターを指定しない場合、ブロックはデフォルトで7日間有効です。 |
レスポンスパラメーター
パラメーター | データ型 | 説明 |
RequestId | String | リクエスト ID。 |
Status | String | ステータス okの値は、リクエストが成功したことを示します。 failの値は、リクエストが失敗したことを示します。 |
説明 | String | リクエストに関する説明。 リクエストが成功した場合、okが返されます。 リクエストが失敗した場合、失敗の詳細が返されます。 |
特殊エラーコード
エラーコード | エラーメッセージ | HTTPステータスコード | 説明 |
内部エラー | 不明なエラーにより、リクエスト処理が失敗しました。 | 500 | 不明なエラーが発生した場合に返されるエラーメッセージ。 |
InvalidDomain.NotFound | The domain provided does not exist in our records. | 404 | Alibaba Cloudアカウント内にドメイン名が見つからない場合に返されるエラーメッセージ。 |
InvalidParam | パラメーターが無効です。 | 400 | 1つ以上のパラメーターが無効な場合に返されるエラーメッセージ。 |
例
リクエストの例
https://live.aliyuncs.com?Action=SetLiveStreamBlock&DomainName=example.com&AppName=test&StreamName=test&LocationList=CN,AS&BlockType=whitelist&<Common request parameters>レスポンスの例
{
"RequestId": "0D70427D-91E4-4349-AAD3-5511A5BB823B",
"Status": "ok",
"Description": "ok"
}