TagStream - Amazon Kinesis Video Streams

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

TagStream

1 つまたは複数のタグをストリームに追加します。タグはキーと値のペア (値はオプション) で、 AWS 定義してリソースに割り当てることができます。すでに存在するタグを指定すると、タグの値はこのリクエストで指定した値に置き換えられます。詳細については、『 AWS Billing and Cost Management and Cost Management ユーザーガイド』の「コスト配分タグの使用」を参照してください。

StreamName または StreamARN を指定する必要があります。

この操作には KinesisVideo:TagStream アクションに対するアクセス許可が必要です。

Kinesis ビデオストリームは最大 50 個のタグをサポートできます。

リクエストの構文

POST /tagStream HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string", "Tags": { "string" : "string" } }

URI リクエストパラメータ

リクエストでは URI パラメータを使用しません。

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

StreamARN

1 つまたは複数のタグを追加するリソースの Amazon リソースネーム (ARN) です。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 1,024 です。

パターン: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

必須: いいえ

StreamName

1 つまたは複数のタグを追加するストリームの名前。

型: 文字列

長さの制限:最小長は 1 です。最大長は 256 です。

パターン:[a-zA-Z0-9_.-]+

必須: いいえ

Tags

指定されたストリームに関連付けるタグのリスト。各タグはキーと値のペアです (値はオプションです)。

型: 文字列間のマッピング

マップエントリ: 項目の最大数は 50 です。

キーの長さ制限: 最小長さは 1 です。最大長は 128 です。

キーパターン: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

値の長さの制限: 最小長は 0 です。最大長は 256 です。

値のパターン: [\p{L}\p{Z}\p{N}_.:/=+\-@]*

必須: はい

レスポンスの構文

HTTP/1.1 200

レスポンス要素

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

ClientLimitExceededException

Kinesis Video Streams は、許可されたクライアントコールの制限を超えているため、リクエストをスロットリングしました。後で呼び出しを試みてください。

HTTP ステータスコード:400

InvalidArgumentException

この入力パラメータの値は無効です。

HTTP ステータスコード:400

InvalidResourceFormatException

StreamARN の形式が無効です。

HTTP ステータスコード:400

NotAuthorizedException

呼び出し元には、この操作を実行するための権限がありません。

HTTP ステータスコード: 401

ResourceNotFoundException

Amazon Kinesis Video Streams は、指定したストリームを見つけることができません。

HTTP ステータスコード: 404

TagsPerResourceExceededLimitException

リソースに関連付けることができるタグの上限を超えています。Kinesis ビデオストリームは最大 50 個のタグをサポートできます。

HTTP ステータスコード:400

その他の参照資料

言語固有の AWS SDK の 1 つでこの API を使用する方法の詳細については、以下を参照してください。