AddCasterProgram による制作スタジオへのプログラムリスト追加 - LIVE - Alibaba Cloud - ApsaraVideo Live

プロダクションスタジオにプログラムリストを追加します。

操作説明

この操作を呼び出してプログラムリストを追加する前に、プロダクションスタジオを作成し、ビデオリソースを追加してください。現在、この操作はビデオソースとコンポーネントの 2 つのノードタイプのみをサポートしています。API オペレーションを使用してプロダクションスタジオを作成する方法については、「 CreateCaster 」をご参照ください。

QPS 制限

この操作の単一ユーザー QPS 制限は、1 秒あたり 10 回の呼び出しです。制限を超えると API 呼び出しがスロットリングされ、ビジネスに影響が出る可能性があります。この操作は適切に呼び出してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

live:AddCasterProgram

create

*Caster

acs:live:*:{#accountId}:caster/{#CasterId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	任意	リージョン ID。	cn-shanghai
Episode	array<object>	必須	プログラムリスト情報。
	object	任意	プログラムリスト情報。
ComponentId	array	任意	コンポーネントリスト。要素は下から上へ順番にセットされます。重要このパラメーターは、Episode.N.EpisodeType が Component に設定されている場合に有効かつ必須です。ノードタイプが Resource の場合、これはコンポーネントがビデオソースにバインドされており、同期的に切り替わることを示します。	[ "a2b8e671-2fe5-4642-a2ec-bf931826**", "a2b8e671-2fe5-4642-a2ec-28374657**"]
	string	任意	コンポーネント ID。	a2b8e671-2fe5-4642-a2ec-bf931826****
EndTime	string	任意	終了時刻。フォーマット: yyyy-MM-ddTHH:mm:ssZ (協定世界時 (UTC))。このパラメーターは必須です。指定しない場合、MissingParameter が返されます。	2016-06-29T10:02:00Z
EpisodeName	string	任意	プログラム名。	program_name_1
EpisodeType	string	任意	ノードタイプ。有効な値: Resource: ビデオソース。Resource を選択した場合、リクエストパラメーター Episode.N.ResourceId および Episode.N.SwitchType も設定する必要があります。 Component: コンポーネント。Component を選択した場合、リクエストパラメーター Episode.N.ComponentId.N も設定する必要があります。説明 Resource が選択され、参照されるリソースに VodUrl (ビデオオンデマンドファイル) が含まれている場合、EndTime - StartTime は VOD ファイルの実際の再生持続時間 (秒単位) を超えることはできません。超えた場合、InvalidParameter.EndTime が返されます。	Resource
ResourceId	string	任意	ビデオソース ID。重要このパラメーターは、Episode.N.EpisodeType が Resource に設定されている場合に有効かつ必須です。このパラメーターは、Episode.N.EpisodeType が Component に設定されている場合は該当なしです。 AddCasterVideoResource 操作を呼び出してビデオソースを追加した場合、AddCasterVideoResource 操作によって返された ResourceId の値を確認してください。	a2b8e671-2fe5-4642-a2ec-bf93880e****
StartTime	string	任意	開始時刻。フォーマット: yyyy-MM-ddTHH:mm:ssZ (協定世界時 (UTC))。このパラメーターは必須です。指定しない場合、MissingParameter が返されます。	2016-06-29T09:00:00Z
SwitchType	string	任意	切り替えポリシー。有効な値: 重要このパラメーターは、Episode.N.EpisodeType が Resource に設定されている場合にのみ有効です。 TimeFirst: 時間優先。ライブビデオソースでは時間優先ポリシーのみ使用できます。 ContentFirst: コンテンツ優先。	TimeFirst
CasterId	string	必須	プロダクションスタジオ ID。 CreateCaster 操作を呼び出してプロダクションスタジオを作成した場合、CreateCaster 操作によって返された CasterId の値を確認してください。 ApsaraVideo Live コンソールでプロダクションスタジオを作成した場合、ApsaraVideo Live コンソール > プロダクションスタジオ > クラウドプロダクションスタジオに移動して、プロダクションスタジオ名をビューできます。説明クラウドプロダクションスタジオページのプロダクションスタジオリストに表示されるプロダクションスタジオ名が、プロダクションスタジオ ID です。	LIVEPRODUCER_POST-cn-0pp1czt****

説明

リクエストパラメーターの N はシーケンス番号を示します。例:
Episode.N.EpisodeName は N 番目のプログラム名を示します。Episode.1.EpisodeName は 1 番目のプログラム名、Episode.2.EpisodeName は 2 番目のプログラム名を示します。

レスポンスフィールド

フィールド	型	説明	例
	object
EpisodeIds	object
EpisodeId	array<object>	プログラム ID のリスト。リスト内の要素の順序は、渡されたプログラムの注文と一致します。
	object
EpisodeId	string	プログラムグループ ID です。この ID をリクエストパラメーターとして使用して、プログラムリストの変更、プログラムリストのクエリ、プログラムの削除、またはプログラムの変更を行うことができます。	16A96B9A-F203-4EC5-8E43-CB92E68F****
RequestId	string	リクエスト ID。	16A96B9A-F203-4EC5-8E43-CB92E68F****

例

成功レスポンス

JSONJSON

{
  "EpisodeIds": {
    "EpisodeId": [
      {
        "EpisodeId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
      }
    ]
  },
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	MissingParameter	%s.	必須パラメーターが不足しています。
400	InvalidParameter.Malformed	There are invalid parameters: %s.	次のパラメーターが無効です: %s。
400	SwitchTypeInvalid.Malformed	%s, please check and try again later.	SwitchType パラメーターが無効です。確認して再試行してください。
400	IncorrectStartTime	%s, please check and try again later.	StartTime パラメーターが無効です。確認して再試行してください。
400	IncorrectEndTime	%s, please check and try again later.	EndTime パラメーターが無効です。確認して再試行してください。
400	EpisodeConflict.Malformed	%s, please check and try again later.	番組のスケジューリングに競合があります。確認して再試行してください。
400	InvalidCasterId.Malformed	%s, please check and try again later.	CasterId パラメーターが無効です。パラメーターを確認して再試行してください。
400	InvalidParameter.EndTime	%s, please check and try again later.	EndTime パラメーターが無効です。確認して再試行してください。
401	IllegalOperation	%s, please check and try again later.	操作が無効です。リクエストを確認して再試行してください。
500	InternalError	%s, please try again later.	内部エラーが発生しました。しばらくしてから再試行してください。
404	InvalidCaster.NotFound	%s, please check and try again later.	プロダクションスタジオが存在しません。構成を確認して再試行してください。
404	InvalidResource.NotFound	%s, please check and try again later.	リソースが存在しません。確認して再試行してください。
404	InvalidComponent.NotFound	%s, please check and try again later.	操作対象のコンポーネントが存在しません。確認して再試行してください。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。