Modifies the configurations of an episode in a production studio.

使用状況ノート

You cannot change the episode type using this operation.

QPS制限

A single user can perform a maximum of 4 queries per second (QPS). 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 The throttling may affect your business. したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 ModifyCasterEpisode

実行したい操作。 値をModifyCasterEpisodeに設定します。

CasterId String 必須 9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****

制作スタジオのID。

CreateCaster インターフェイスを使用して制作スタジオを作成する場合は、レスポンスのCasterIdパラメーターの値を確認します。

ApsaraVideo Live Consoleを使用して制作スタジオを作成する場合は、コンソールにログインし、次のパスを使用して制作スタジオのIDを確認します。

Production Studios > Production Studio Management

注 CasterIdは、Production Studio Managementページの [名前] 列に反映されます。
EpisodeId String 必須 a2b8e671-2fe5-4642-a2ec-bf938623****

The ID of the episode. It is included in the response when you call the AddCasterEpisode operation.

RegionId String 任意 cn-shanghai

リージョンの ID
EpisodeName String 任意 episode_name_1

エピソードの名前。
ResourceId String 任意 16A96B9A-F203-4EC5-8E43-CB92E683 ****

ビデオリソースのID。 AddCasterVideoResource 操作を呼び出したときの応答に含まれます。

  • このパラメーターは有効で、EpisodeTypeがResourceに設定されている場合にのみ必要です。
  • EpisodeTypeパラメーターがComponentに設定されている場合、このパラメーターは無効です。
ComponentId.N RepeatList 任意 ["16A96B9A-F203-4EC5-8E43-CB92E68F ****"]

コンポーネントのID。 AddCasterComponent 操作を呼び出したときの応答に含まれます。

制作スタジオのコンポーネントは、配列の下から上にリストされます。 制作スタジオが別のビデオリソースに切り替えると、コンポーネントも切り替えられます。

  • このパラメーターは有効で、EpisodeTypeパラメーターがComponentに設定されている場合に必要です。
  • EpisodeTypeパラメーターがResourceに設定されている場合、このパラメーターはオプションです。 この場合、このパラメーターを指定すると、コンポーネントはビデオリソースとバインドされ、一緒に切り替えられます。
    注 変数Nは、コンポーネントのシーケンス番号を示す。 たとえば、ComponentId.1パラメーターは最初のコンポーネントのIDを指定します。 ComponentId.2パラメーターは、2番目のコンポーネントのIDを指定します。
StartTime String 任意 2016-06-29T09:00:00Z

エピソードが始まる時間。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

EndTime String 任意 2016-06-29T10:20:00Z

エピソードが終了する時間。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

SwitchType String 任意 TimeFirst

エピソードを切り替えるためのポリシー。 このパラメーターは、EpisodeTypeパラメーターがResourceに設定されている場合にのみ有効です。 有効値：

  • TimeFirst: エピソードは前のエピソードの終了時に開始し、次のエピソードの開始時に終了します。 次のエピソードが存在しない場合、新しいエピソードが追加されるか、制作スタジオが停止するまで、エピソードは繰り返し続けます。 ビデオリソースがライブストリームの場合、このパラメーターはTimeFirstに設定する必要があります。
  • ContentFirst: エピソードは予定通りに開始および終了します。

レスポンスパラメーター

パラメーター データ型 例 説明
CasterId String 9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****

制作スタジオのID。
EpisodeId String a2b8e671-2fe5-4642-a2ec-bf938623 ****

エピソードのID。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

リクエストの ID です。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=ModifyCasterEpisode
&CasterId=9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****
&EpisodeId=a2b8e671-2fe5-4642-a2ec-bf938623 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<ModifyCasterEpisodeResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
      <EpisodeId>a2b8e671-2fe5-4642-a2ec-bf938623 ****</EpisodeId>
      <CasterId>9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****</CasterId>
</ModifyCasterEpisodeResponse>

JSON 形式 

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    "EpisodeId": "a2b8e671-2fe5-4642-a2ec-bf938623 ****" 、
    "CasterId": "9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。