ストリーム取り込みの無効化に関するFAQ - ApsaraVideo Live

ストリーム取り込みを無効にする必要があるのはいつですか?

取り込みURLが漏洩した場合、URLを使用してストリームを取り込むと、悪意のある攻撃のリスクが高まる可能性があります。この場合、取り込みURLを無効にする必要があります。 ApsaraVideo Liveでは、ビジネス要件を満たすためにストリーム取り込みを無効にできます。

ストリーム取り込みを無効にするにはどうすればよいですか?

ApsaraVideo Liveコンソールを使用したストリーム取り込みの無効化
- アクティブストリームを照会し、ストリーム取り込みを無効にする
  ストリームが取り込まれると、次の手順を実行してストリームを照会し、ストリーム取り込みを無効にできます。ApsaraVideo Liveコンソールにログインし、左側のナビゲーションウィンドウで アップストリーミング をクリックします。表示されるページで、ドメイン名を選択し、検索をクリックしてアクティブなストリームを照会します。無効にするストリームを見つけて、[操作] 列の ブロック をクリックします。
- 履歴ストリームを照会し、ストリーム取り込みを無効にする
  ストリームの取り込み後、次の手順を実行してストリームを照会し、ストリームの取り込みを無効にできます。ApsaraVideo Liveコンソールにログインし、左側のナビゲーションウィンドウで アップストリーミング をクリックします。表示されるページで、ログタブをクリックしてドメイン名を選択し、検索をクリックしてストリームを照会します。無効にするストリームを見つけて、[操作] 列の ブロック をクリックします。
SDKを使用したストリーム取り込みの無効化
ApsaraVideo Liveは、Alibaba CloudのOpenAPI Explorerに基づくAPI操作を提供します。 ApsaraVideo LiveのAPI操作は、さまざまなSDKに統合されています。ビジネス要件に基づいてサーバーSDKをダウンロードします。詳細については、「サーバーSDK」をご参照ください。サーバーSDKの使用方法については、「サーバーSDK For Javaの使用」をご参照ください。
次のサンプルコードは、Java用サーバーSDKを使用してストリーム取り込みを無効にする方法を示しています。 Java用サーバーSDKを使用するには、次のMaven依存関係をpom.xmlファイルに追加します。
```
<dependencies>
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-live</artifactId>
        <version>3.9.0</version>
    </dependency>
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-core</artifactId>
        <optional>true</optional>
        <version>2.3.8</version>
    </dependency>
</dependencies>
                    
```
説明
上記のサンプルコードでは、SDKのバージョンは参照専用です。 SDKの最新バージョンを取得する方法については、サーバーSDKをご参照ください。
aliyun-java-sdk-core依存関係は、Alibaba Cloud APIをカプセル化するコアモジュールであり、さまざまなAlibaba Cloud sdk for Javaに必要です。 aliyun-java-sdk-cdnの依存関係には、ApsaraVideo LiveのRequestクラスとResponseクラスが含まれます。次のサンプルコードに示すように、ストリーム取り込みブラックリストを照会するためのRequestクラスはDescribeLiveStreamsBlockListRequestで、対応するResponseクラスはDescribeLiveStreamsBlockListResponseです。
```
@Test
public void testDescribeLiveStreamsBlockList() throws Exception {
    DescribeLiveStreamsBlockListResponse res = DescribeLiveStreamsBlockListR();
    System.out.println(res.getStreamUrls());
}

private DescribeLiveStreamsBlockListResponse DescribeLiveStreamsBlockListR() {
    DescribeLiveStreamsBlockListRequest request = new DescribeLiveStreamsBlockListRequest();
    request.setDomainName("<DomainName>");
    DescribeLiveStreamsBlockListResponse response=null;
    try {
        response = client.getAcsResponse(request);
    } catch (ServerException e) {
        e.printStackTrace();
    } catch (ClientException e) {
        e.printStackTrace();
    } 
    return response;
}
```
サンプルコードのロジック
1. Javaクライアントを初期化します。
  SDKはIAcsClientを使用してAPI操作を呼び出します。 IAcsClientを初期化するときは、IClientProfileオブジェクトに基づいて、リージョン、AccessKeyId、およびAccessKeySecretパラメーターを設定します。 regionパラメーターは、APIサーバーが存在するリージョンを指定します。このパラメーターをcn-hangzhouに設定します。 AccessKeyIdおよびAccessKeySecretパラメーターは、ユーザー認証に使用されます。 Alibaba CloudアカウントのAccessKey IDとAccessKey secretを使用できます。 Resource Access Management (RAM) ユーザーのAccessKey IDとAccessKeyシークレットを使用する場合は、RAMユーザーにApsaraVideo Liveの権限が付与されていることを確認してください。
2. Requestクラスを初期化します。
  SDKは、各操作の要求クラスと応答クラスを提供します。ストリーム取り込みを無効にするためのリクエストパラメーターの詳細については、「ForbidLiveStream」をご参照ください。
3. リクエストを開始し、レスポンスを取得します。
  IAcsClientのgetAcsResponseメソッドを呼び出して要求を開始し、返された逆シリアル化された結果をResponseクラスのパラメーターにインスタンス化します。このメソッドは、ServerExceptionクラスとClientExceptionクラスもサポートしています。
  - 3xxまたは4xxのHTTPステータスコードが返された場合、SDKはクライアントエラーを示すClientExceptionをスローします。
  - 5xxのHTTPステータスコードが返された場合、SDKはサーバーエラーを示すServerExceptionをスローします。
  - SDKが例外をスローしない場合、操作は正常に呼び出されます。

ストリーム取り込みブラックリストを照会するにはどうすればよいですか?

ApsaraVideo Liveコンソールを使用してブラックリストを照会
ライブストリームのストリーム取り込みを無効にした後、次の手順を実行してストリーム取り込みブラックリストを照会できます。ApsaraVideo liveコンソールにログインし、左側のナビゲーションウィンドウで アップストリーミング をクリックします。表示されるページで、ドメイン名を選択し、ブロック済み タブをクリックし、検索をクリックしてブラックリストを照会します。
SDKを使用してブラックリストを照会
ApsaraVideo Liveは、Alibaba CloudのOpenAPI Explorerに基づくAPI操作を提供します。 ApsaraVideo LiveのAPI操作は、さまざまなSDKに統合されています。ビジネス要件に基づいてサーバーSDKをダウンロードします。詳細については、「サーバーSDK」をご参照ください。サーバーSDKの使用方法については、「サーバーSDK For Javaの使用」をご参照ください。
```
<dependencies>
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-live</artifactId>
        <version>3.9.0</version>
    </dependency>
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-core</artifactId>
        <optional>true</optional>
        <version>2.3.8</version>
    </dependency>
</dependencies>
```
説明
上記のサンプルコードでは、SDKのバージョンは参照専用です。 SDKの最新バージョンを取得する方法については、サーバーSDKをご参照ください。
aliyun-java-sdk-core依存関係は、Alibaba Cloud APIをカプセル化するコアモジュールであり、さまざまなAlibaba Cloud sdk for Javaに必要です。 aliyun-java-sdk-cdnの依存関係には、ApsaraVideo LiveのRequestクラスとResponseクラスが含まれます。次のサンプルコードに示すように、ストリーム取り込みブラックリストを照会するためのRequestクラスはDescribeLiveStreamsBlockListRequestで、対応するResponseクラスはDescribeLiveStreamsBlockListResponseです。
```
@Test
public void testDescribeLiveStreamsBlockList() throws Exception {
    DescribeLiveStreamsBlockListResponse res=DescribeLiveStreamsBlockListR();
    System.out.println(res.getStreamUrls());
}
DescribeLiveStreamsBlockListResponse DescribeLiveStreamsBlockListR() {
    DescribeLiveStreamsBlockListRequest request =new DescribeLiveStreamsBlockListRequest();
    request.setDomainName("<DomainName>");
    DescribeLiveStreamsBlockListResponse response=null;
    try {
        response = client.getAcsResponse(request);
    } catch (ServerException e) {
        e.printStackTrace();
    } catch (ClientException e) {
        e.printStackTrace();
    } 
    return response;
}
```
サンプルコードのロジック
1. Javaクライアントを初期化します。
  SDKはIAcsClientを使用してAPI操作を呼び出します。 IAcsClientを初期化するときは、IClientProfileオブジェクトに基づいて、リージョン、AccessKeyId、およびAccessKeySecretパラメーターを設定します。 regionパラメーターは、APIサーバーが存在するリージョンを指定します。このパラメーターをcn-hangzhouに設定します。 AccessKeyIdおよびAccessKeySecretパラメーターは、ユーザー認証に使用されます。 Alibaba CloudアカウントのAccessKey IDとAccessKey secretを使用できます。 RAMユーザーのAccessKey IDとAccessKeyシークレットを使用する場合は、RAMユーザーにApsaraVideo Liveの権限が付与されていることを確認してください。
2. Requestクラスを初期化します。
  SDKは、各操作の要求クラスと応答クラスを提供します。ストリーム取り込みブラックリストを照会するためのリクエストパラメーターの詳細については、「DescribeLiveStreamsBlockList」をご参照ください。
3. リクエストを開始し、レスポンスを取得します。
  IAcsClientのgetAcsResponseメソッドを呼び出して要求を開始し、返された逆シリアル化された結果をResponseクラスのパラメーターにインスタンス化します。このメソッドは、ServerExceptionクラスとClientExceptionクラスもサポートしています。
  - 3xxまたは4xxのHTTPステータスコードが返された場合、SDKはクライアントエラーを示すClientExceptionをスローします。
  - 5xxのHTTPステータスコードが返された場合、SDKはサーバーエラーを示すServerExceptionをスローします。
  - SDKが例外をスローしない場合、操作は正常に呼び出されます。

ストリーム取り込みブラックリストからストリームを削除するにはどうすればよいですか?

ApsaraVideo Liveコンソールを使用してブラックリストからストリームを削除
ライブストリームのストリーム取り込みを無効にした後、次の手順を実行してブラックリストからストリームを削除できます。ApsaraVideo liveコンソールにログインし、左側のナビゲーションウィンドウで アップストリーミング をクリックします。表示されるページで、ドメイン名を選択し、ブロック済み タブをクリックします。ストリームを検索し、[操作] 列の再開をクリックします。
SDKを使用してブラックリストからストリームを削除する
ApsaraVideo Liveは、Alibaba CloudのOpenAPI Explorerに基づくAPI操作を提供します。 ApsaraVideo LiveのAPI操作は、さまざまなSDKに統合されています。ビジネス要件に基づいてサーバーSDKをダウンロードします。詳細については、「サーバーSDK」をご参照ください。サーバーSDKの使用方法については、「サーバーSDK For Javaの使用」をご参照ください。
次のサンプルコードは、Java用サーバーSDKを使用してブラックリストからストリームを削除する方法を示しています。 Java用サーバーSDKを使用するには、次のMaven依存関係をpom.xmlファイルに追加します。
```
<dependencies>
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-live</artifactId>
        <version>3.9.0</version>
    </dependency>
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>aliyun-java-sdk-core</artifactId>
        <optional>true</optional>
        <version>2.3.8</version>
    </dependency>
</dependencies>
```
説明
上記のサンプルコードでは、SDKのバージョンは参照専用です。 SDKの最新バージョンを取得する方法については、サーバーSDKをご参照ください。
aliyun-java-sdk-core依存関係は、Alibaba Cloud APIをカプセル化するコアモジュールであり、さまざまなAlibaba Cloud sdk for Javaに必要です。 aliyun-java-sdk-cdnの依存関係には、ApsaraVideo LiveのRequestクラスとResponseクラスが含まれます。次のサンプルコードに示すように、ストリーム取り込みブラックリストを照会するためのRequestクラスはDescribeLiveStreamsBlockListRequestで、対応するResponseクラスはDescribeLiveStreamsBlockListResponseです。
```
@Test
public void testDescribeLiveStreamsBlockList() throws Exception {
    DescribeLiveStreamsBlockListResponse res=DescribeLiveStreamsBlockListR();
    System.out.println(res.getStreamUrls());
}
static DescribeLiveStreamsBlockListResponse DescribeLiveStreamsBlockListR() {
    DescribeLiveStreamsBlockListRequest request =new DescribeLiveStreamsBlockListRequest();
    request.setDomainName("<DomainName>");
    DescribeLiveStreamsBlockListResponse response=null;
    try {
        response = client.getAcsResponse(request);
    } catch (ServerException e) {
        e.printStackTrace();
    } catch (ClientException e) {
        e.printStackTrace();
    } 
    return response;
}
```
サンプルコードのロジック
1. Javaクライアントを初期化します。
  SDKはIAcsClientを使用してAPI操作を呼び出します。 IAcsClientを初期化するときは、IClientProfileオブジェクトに基づいて、リージョン、AccessKeyId、およびAccessKeySecretパラメーターを設定します。 regionパラメーターは、APIサーバーが存在するリージョンを指定します。このパラメーターをcn-hangzhouに設定します。 AccessKeyIdおよびAccessKeySecretパラメーターは、ユーザー認証に使用されます。 Alibaba CloudアカウントのAccessKey IDとAccessKey secretを使用できます。 RAMユーザーのAccessKey IDとAccessKeyシークレットを使用する場合は、RAMユーザーにApsaraVideo Liveの権限が付与されていることを確認してください。
2. Requestクラスを初期化します。
  SDKは、各操作の要求クラスと応答クラスを提供します。ストリーム取り込みブラックリストからストリームを削除するためのリクエストパラメーターの詳細については、「ResumeLiveStream」をご参照ください。
3. リクエストを開始し、レスポンスを取得します。
  IAcsClientのgetAcsResponseメソッドを呼び出して要求を開始し、返された逆シリアル化された結果をResponseクラスのパラメーターにインスタンス化します。このメソッドは、ServerExceptionクラスとClientExceptionクラスもサポートしています。
  - 3xxまたは4xxのHTTPステータスコードが返された場合、SDKはクライアントエラーを示すClientExceptionをスローします。
  - 5xxのHTTPステータスコードが返された場合、SDKはサーバーエラーを示すServerExceptionをスローします。
  - SDKが例外をスローしない場合、操作は正常に呼び出されます。