# IVS チャネルを作成するための CLI の手順
AWS CLI を使用してチャネルを作成することは詳細オプションであり、最初に CLI をダウンロードしてマシンに設定する必要があります。詳細については、[AWS コマンドラインインターフェイスのユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)を参照してください。
チャネル作成時に録画を有効／無効にするかどうかに応じて、次の 2 つの手順のいずれかに従います。
## 録画せずにチャネルを作成する
1. `create-channel`コマンドを実行し、オプション名を渡します:
```
aws ivs create-channel --name test-channel
```
1. これにより、新しいチャネルが返されます。
```
{
"channel": {
"arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"authorized": false,
"ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
"insecureIngest": false,
"latencyMode": "LOW",
"name": "channel-live",
"playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/abcdABCDefgh",
"playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
"recordingConfigurationArn": "none",
"srt": {
"endpoint": "a1b2c3d4e5f6.srt.live-video.net",
"passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
},
"tags": {},
"type": "STANDARD"
},
"streamKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
"channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"tags": {},
"value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
}
}
```
1. **重要**: `ingestEndpoint`、`streamKey value`、および `playbackUrl` の点に注意してください。これらを使用して、ストリーミングと再生を設定します。
## 録画付きチャネルの作成
**前提条件** この手順を開始する前に Amazon S3 バケットを作成し、その ARN を書き留めます。[Amazon S3 の開始方法](https://docs.aws.amazon.com//AmazonS3/latest/userguide/GetStartedWithS3.html)を参照してください。S3 バケットは、録画設定を作成する同じリージョンに作成する必要があります。以下のステップ 1 の既知の問題を参照してください。
次に、以下のステップに従ってチャネルを作成します。
1. `create-recording-configuration`コマンドを実行して、既存の Amazon S3 バケットの ARN を渡します。
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket}
```
オプションで、`thumbnail-configuration` パラメータを渡してサムネイルの記録モードとサムネイル間隔を手動で設定します。
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=s3_bucket_name} --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=60
```
必要に応じて `recording-reconnect-window-seconds` パラメータを渡して、断片化されたストリームの結合の機能を有効にします。
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket} --recording-reconnect-window-seconds 60
```
**既知の問題:** us-east-1 リージョンでは、AWS CLI を使用して録画設定を作成すると、S3 バケットが別のリージョンにある場合でも成功が返されます。この場合、録画設定の`state`は、(`ACTIVE`の代わりに) `CREATE_FAILED`となります。(他のリージョンでは、バケットが別のリージョンにある場合、CLI は正しく失敗を返します)。
**回避方法:** S3 バケットが録画設定と同じリージョンにあることを確認してください。S3 バケットとして別のリージョンに録画設定を作成する場合は、その録画設定を削除し、正しいリージョンから S3 バケットで新しい録画設定を作成します。
1. これにより、一意の ARN を持つ新しい録画設定が返されます。録画設定の状態が`CREATING`の場合は、作成中であることを示しています。
```
{
"recordingConfiguration": {
"arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"name": "configuration-1",
"destinationConfiguration": {
"s3": {
"bucketName": "s3_bucket_name"
}
},
"recordingReconnectWindowSeconds": 60,
"state": "CREATING",
"tags": {},
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"targetIntervalSeconds": 60
}
}
}
```
1. 通常、録画設定の作成は数秒ですが、最大で 20 秒かかることがあります。録画設定が作成されたことを確認するには、`get-recording-configuration`コマンドを実行します。
```
aws ivs get-recording-configuration --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
1. これにより、録画設定が作成されたことを示すレスポンスが返されます (`state`は`ACTIVE`)。
```
{
"recordingConfiguration": {
"arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"name": "configuration-1",
"destinationConfiguration": {
"s3": {
"bucketName": "s3_bucket_name"
}
},
"recordingReconnectWindowSeconds": 60,
"state": "ACTIVE",
"tags": {},
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"targetIntervalSeconds": 60
}
}
}
```
1. チャネルを作成し、そのチャネルでの録画を有効にするには、`create-channel`コマンドを実行し、録画設定の ARN を渡します。
```
aws ivs create-channel --name channel-live --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
または、既存のチャネルでの録画を有効にするために、`update-channel`コマンドを実行し、録画設定の ARN を渡します。
```
aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
1. これにより、録画が有効であることを示す、`recordingConfigurationArn` の「none」以外の値を持つチャネルオブジェクトが返されます。(以下の応答は`create-channel`からのものです。`update-channel`レスポンスには`streamKey`オブジェクトは含まれません)。
```
{
"channel": {
"arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"authorized": false,
"ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
"insecureIngest": false,
"latencyMode": "LOW",
"name": "channel-live",
"playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
"recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"srt": {
"endpoint": "a1b2c3d4e5f6.srt.live-video.net",
"passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
},
"tags": {},
"type": "STANDARD"
},
"streamKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
"channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"tags": {},
"value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
}
}
```
1. **重要**: `ingestEndpoint`、`streamKey value`、および `playbackUrl` の点に注意してください。これらを使用して、ストリーミングと再生を設定します。