Associates a resource with the feed. The resource provides the input that Elemental Inference needs in order to perform an Elemental Inference feature, such as cropping video. You always provide the resource by associating it with a feed. You can associate only one resource with each feed. With an association, a specific source media is claiming ownership of the feed.
AssociateFeed is a PATCH operation, which means that you can include only parameters that you want to change. Parameters that you don't include will not be affected by the operation.
Specifically:
You can add more outputs to the existing outputs. New outputs will be appended.
You can't modify an existing output (for example to change its name). Instead, use UpdateFeed.
You can't delete an existing output. Instead, use UpdateFeed.
Also note that you can't change the feed name with AssociateFeed. Instead, use UpdateFeed.
", "idempotent":true }, "CreateDictionary":{ "name":"CreateDictionary", "http":{ "method":"POST", "requestUri":"/v1/dictionary", "responseCode":202 }, "input":{"shape":"CreateDictionaryRequest"}, "output":{"shape":"CreateDictionaryResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"}, {"shape":"ServiceQuotaExceededException"} ], "documentation":"Creates a custom dictionary for improving transcription accuracy. A dictionary contains custom words and phrases that the ASR engine might not recognize, such as brand names, technical terms, or proper nouns. You can reference a dictionary when configuring a smart subtitles output.
", "idempotent":true }, "CreateFeed":{ "name":"CreateFeed", "http":{ "method":"POST", "requestUri":"/v1/feed", "responseCode":202 }, "input":{"shape":"CreateFeedRequest"}, "output":{"shape":"CreateFeedResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"}, {"shape":"ServiceQuotaExceededException"} ], "documentation":"Creates a feed. The feed is the target for the live media stream that is being sent by the calling application. An example of a calling application is AWS Elemental MediaLive.
The key contents of the feed is an array of outputs. Each output represents an Elemental Inference feature. After you create the feed, you must associate a resource with the feed. At that point, you will have a useable feed: resource - feed - output or outputs.
", "idempotent":true }, "DeleteDictionary":{ "name":"DeleteDictionary", "http":{ "method":"DELETE", "requestUri":"/v1/dictionary/{id}", "responseCode":202 }, "input":{"shape":"DeleteDictionaryRequest"}, "output":{"shape":"DeleteDictionaryResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"} ], "documentation":"Deletes the specified dictionary. You cannot delete a dictionary that is referenced by a feed. You must first remove the dictionary reference from the feed's subtitling configuration.
", "idempotent":true }, "DeleteFeed":{ "name":"DeleteFeed", "http":{ "method":"DELETE", "requestUri":"/v1/feed/{id}", "responseCode":202 }, "input":{"shape":"DeleteFeedRequest"}, "output":{"shape":"DeleteFeedResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"} ], "documentation":"Deletes the specified feed. You can delete the feed at any time. Elemental Inference doesn't block you from deleting a feed when the calling application is calling PutMedia or GetMetadata on that feed, although both these calls will start to fail. For more information about managing inactive feeds, see the Elemental Inference User Guide.
", "idempotent":true }, "DisassociateFeed":{ "name":"DisassociateFeed", "http":{ "method":"POST", "requestUri":"/v1/feed/{id}/disassociate", "responseCode":200 }, "input":{"shape":"DisassociateFeedRequest"}, "output":{"shape":"DisassociateFeedResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"} ], "documentation":"Releases the resource (the source media) that is associated with this feed. The outputs in the feed become DISABLED.
", "idempotent":true }, "ExportDictionaryEntries":{ "name":"ExportDictionaryEntries", "http":{ "method":"GET", "requestUri":"/v1/dictionary/{id}/entries/export", "responseCode":200 }, "input":{"shape":"ExportDictionaryEntriesRequest"}, "output":{"shape":"ExportDictionaryEntriesResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"} ], "documentation":"Exports the entries from the specified dictionary.
", "readonly":true }, "GetDictionary":{ "name":"GetDictionary", "http":{ "method":"GET", "requestUri":"/v1/dictionary/{id}", "responseCode":200 }, "input":{"shape":"GetDictionaryRequest"}, "output":{"shape":"GetDictionaryResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"} ], "documentation":"Retrieves information about the specified dictionary.
", "readonly":true }, "GetFeed":{ "name":"GetFeed", "http":{ "method":"GET", "requestUri":"/v1/feed/{id}", "responseCode":200 }, "input":{"shape":"GetFeedRequest"}, "output":{"shape":"GetFeedResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"} ], "documentation":"Retrieves information about the specified feed.
", "readonly":true }, "ListDictionaries":{ "name":"ListDictionaries", "http":{ "method":"GET", "requestUri":"/v1/dictionaries", "responseCode":200 }, "input":{"shape":"ListDictionariesRequest"}, "output":{"shape":"ListDictionariesResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"} ], "documentation":"Lists the dictionaries in your account.
", "readonly":true }, "ListFeeds":{ "name":"ListFeeds", "http":{ "method":"GET", "requestUri":"/v1/feeds", "responseCode":200 }, "input":{"shape":"ListFeedsRequest"}, "output":{"shape":"ListFeedsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"} ], "documentation":"Displays a list of feeds that belong to this AWS account.
", "readonly":true }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"GET", "requestUri":"/v1/tags/{resourceArn}", "responseCode":200 }, "input":{"shape":"ListTagsForResourceRequest"}, "output":{"shape":"ListTagsForResourceResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"} ], "documentation":"List all tags that are on an Elemental Inference resource in the current region.
", "readonly":true }, "SearchFixtures":{ "name":"SearchFixtures", "http":{ "method":"POST", "requestUri":"/v1/fixtures", "responseCode":200 }, "input":{"shape":"SearchFixturesRequest"}, "output":{"shape":"SearchFixturesResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"ServiceUnavailableException"}, {"shape":"TooManyRequestException"}, {"shape":"GatewayTimedOutException"} ], "documentation":"Searches for the fixtures (sports events, such as a specific basketball game) that are available for a sport in a date window. Each fixture in the response includes a fixtureId that you specify in the clipping output of a feed, so that Elemental Inference maps the event data for that fixture onto the clipping metadata. This operation is paginated: if there are more fixtures than fit in one page, the response includes a nextToken that you pass in a subsequent request.
", "readonly":true }, "TagResource":{ "name":"TagResource", "http":{ "method":"POST", "requestUri":"/v1/tags/{resourceArn}", "responseCode":204 }, "input":{"shape":"TagResourceRequest"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"} ], "documentation":"Associates the specified tags to the resource identified by the specified resourceArn in the current region. If existing tags on a resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags associated with that resource are also deleted.
", "idempotent":true }, "UntagResource":{ "name":"UntagResource", "http":{ "method":"DELETE", "requestUri":"/v1/tags/{resourceArn}", "responseCode":204 }, "input":{"shape":"UntagResourceRequest"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"} ], "documentation":"Deletes specified tags from the specified resource in the current region.
", "idempotent":true }, "UpdateDictionary":{ "name":"UpdateDictionary", "http":{ "method":"PATCH", "requestUri":"/v1/dictionary/{id}", "responseCode":200 }, "input":{"shape":"UpdateDictionaryRequest"}, "output":{"shape":"UpdateDictionaryResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"} ], "documentation":"Updates the specified dictionary.
" }, "UpdateFeed":{ "name":"UpdateFeed", "http":{ "method":"PUT", "requestUri":"/v1/feed/{id}", "responseCode":200 }, "input":{"shape":"UpdateFeedRequest"}, "output":{"shape":"UpdateFeedResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InternalServerErrorException"}, {"shape":"AccessDeniedException"}, {"shape":"TooManyRequestException"}, {"shape":"ConflictException"}, {"shape":"ServiceQuotaExceededException"} ], "documentation":"Updates the name and/or outputs in a feed.
UpdateFeed is a PUT operation, which means that the payload that you specify completely overwrites the existing payload.
This means that if you want to touch the array of outputs, you must pass in the full new list. So you must omit outputs you want to delete, and include outputs you want to add or modify.
If you want to patch the array of outputs to make selective additions, use AssociateFeed.
", "idempotent":true } }, "shapes":{ "AccessDeniedException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"You do not have sufficient access to perform this action.
", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "AspectRatio":{ "type":"structure", "required":[ "width", "height" ], "members":{ "width":{ "shape":"Integer", "documentation":"The width component of the aspect ratio (for example, 16 in a 16:9 ratio).
" }, "height":{ "shape":"Integer", "documentation":"The height component of the aspect ratio (for example, 9 in a 16:9 ratio).
" } }, "documentation":"The width and height of the output video. Used in SubtitlingConfig to determine subtitle layout.
" }, "AssociateFeedRequest":{ "type":"structure", "required":[ "id", "associatedResourceName", "outputs" ], "members":{ "id":{ "shape":"FeedId", "documentation":"The ID of the feed.
", "location":"uri", "locationName":"id" }, "associatedResourceName":{ "shape":"AssociatedResourceName", "documentation":"An identifier for the resource. This name must not resemble an ARN.
The resource is the source media that the feed will process. The name you assign should help you to later identify the source media that belongs to the feed. In this way, you will know which source media to push to the feed (using PutMedia).
", "idempotencyToken":true }, "outputs":{ "shape":"CreateOutputList", "documentation":"An array of one or more outputs that you want to add to this feed now, to supplement any outputs that you specified when you created or updated the feed.
" }, "dryRun":{ "shape":"Boolean", "documentation":"Set to true if you want to do a dry run of the associate action.
Elemental Inference will validate that the real request would succeed without actually making any changes. A dry run catches errors such as missing IAM permissions, quota limits exceeded, conflicting outputs, and so on. If the dry run fails, the action returns a 4xx error code. After you've fixed the errors, resubmit the request.
" } } }, "AssociateFeedResponse":{ "type":"structure", "required":[ "arn", "id" ], "members":{ "arn":{ "shape":"FeedArn", "documentation":"The ARN of the feed.
" }, "id":{ "shape":"FeedId", "documentation":"The ID of the feed.
" } } }, "AssociatedResourceName":{ "type":"string", "max":2048, "min":1, "pattern":"[\\w \\-\\.',@:;/]*" }, "Boolean":{ "type":"boolean", "box":true }, "ClippingConfig":{ "type":"structure", "members":{ "callbackMetadata":{ "shape":"ResourceDescription", "documentation":"A string that you want Elemental Inference to always include in the event clipping metadata for this output. The string might identify the sports event in the source media, for example.
" }, "dataSourceConfiguration":{ "shape":"DataSourceConfiguration", "documentation":"The data source to map onto this clipping output. This parameter is optional. When you include this parameter, Elemental Inference reads the event data for the fixture that you specify, and includes that data in the event clipping metadata for this output.
If you omit this parameter, Elemental Inference doesn't map a data source onto this output.
" } }, "documentation":"A type of OutputConfig, used when the output in a feed is for the clip feature.
" }, "Competitor":{ "type":"structure", "members":{ "name":{ "shape":"String", "documentation":"The name of the competitor, as provided by the data source.
" }, "isHome":{ "shape":"Boolean", "documentation":"Specifies whether this competitor is the home side in the fixture. If true, this competitor is the home side. If false, this competitor is the away side.
" } }, "documentation":"Contains information about one competitor in a fixture. It is used in the FixtureSummary that is in the SearchFixtures response.
" }, "CompetitorList":{ "type":"list", "member":{"shape":"Competitor"}, "max":30, "min":0 }, "ConflictException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The request could not be completed due to a conflict.
", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true, "retryable":{"throttling":false} }, "CreateDictionaryRequest":{ "type":"structure", "required":[ "name", "language" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"A user-friendly name for this dictionary.
" }, "language":{ "shape":"DictionaryLanguage", "documentation":"The language of the dictionary entries. Specify the language using an ISO 639-2/T three-letter code. Supported values: eng, fra, ita, deu, spa, por.
" }, "entries":{ "shape":"DictionaryEntriesPayload", "documentation":"The dictionary entries payload. Contains the custom words and phrases for the dictionary. Maximum size is 40,960 characters.
" }, "tags":{ "shape":"TagMap", "documentation":"Optional tags to associate with the dictionary.
" } } }, "CreateDictionaryResponse":{ "type":"structure", "required":[ "name", "arn", "id", "language", "status" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"The name that you specified in the request.
" }, "arn":{ "shape":"DictionaryArn", "documentation":"The ARN of the dictionary.
" }, "id":{ "shape":"DictionaryId", "documentation":"A unique ID that Elemental Inference assigns to the dictionary.
" }, "language":{ "shape":"DictionaryLanguage", "documentation":"The language of the dictionary.
" }, "status":{ "shape":"DictionaryStatus", "documentation":"The current status of the dictionary. After creation succeeds, the status will be AVAILABLE.
" }, "references":{ "shape":"FeedReferences", "documentation":"A list of feed IDs that reference this dictionary.
" }, "tags":{ "shape":"TagMap", "documentation":"Any tags that you included when you created the dictionary.
" } } }, "CreateFeedRequest":{ "type":"structure", "required":[ "name", "outputs" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"A user-friendly name for this feed.
" }, "accessRoleArn":{ "shape":"IamRoleArn", "documentation":"The ARN of an IAM role that Elemental Inference assumes to access resources in your account on your behalf. For example, the smart crop feature uses this role to read graphics-compositing templates from your Amazon S3 bucket. You specify one access role for each feed.
" }, "outputs":{ "shape":"CreateOutputList", "documentation":"An array of outputs for this feed. Each output represents a specific Elemental Inference feature. For example, there is one output type for the smart crop feature. You must specify at least one output, but you can later add outputs using AssociateFeed, or add, modify, and delete outputs using UpdateFeed.
" }, "tags":{ "shape":"TagMap", "documentation":"Optional tags. You can also add tags later, using TagResource.
" } } }, "CreateFeedResponse":{ "type":"structure", "required":[ "arn", "name", "id", "dataEndpoints", "outputs", "status" ], "members":{ "arn":{ "shape":"FeedArn", "documentation":"A unique ARN that Elemental Inference assigns to the feed.
" }, "name":{ "shape":"ResourceName", "documentation":"The name that you specified in the request.
" }, "id":{ "shape":"FeedId", "documentation":"A unique ID that Elemental Inference assigns to the feed.
" }, "dataEndpoints":{ "shape":"StringList", "documentation":"An array of endpoints for the feed. Typically, there is only one endpoint. The feed receives source media at this endpoint (when the calling application calls PutMedia) and returns the resulting metadata to this endpoint (when the calling application calls GetMetadata).
" }, "outputs":{ "shape":"GetOutputList", "documentation":"Repeats the outputs that you specified in the request.
" }, "status":{ "shape":"FeedStatus", "documentation":"The current status of the feed. After creation of the feed has succeeded, the status will be AVAILABLE.
" }, "association":{ "shape":"FeedAssociation", "documentation":"The association for this feed. When you create the feed, this property is empty. You must associate a resource with the feed using AssociateFeed or UpdateFeed.
" }, "tags":{ "shape":"TagMap", "documentation":"Any tags that you included when you created the feed.
" } } }, "CreateOutput":{ "type":"structure", "required":[ "name", "outputConfig", "status" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"A name for the output.
" }, "outputConfig":{ "shape":"OutputConfig", "documentation":"A typed property for an output in a feed. It identifies the action for Elemental Inference to perform. It also provides a repository for the results of that action. For example, CroppingConfig output will contain the metadata for the crop feature.
" }, "status":{ "shape":"OutputStatus", "documentation":"The status to assign to the output.
" }, "description":{ "shape":"ResourceDescription", "documentation":"A description for the output.
" } }, "documentation":"Contains configuration information about one output in a feed. It is used in the AssociateFeed and the CreateFeed actions.
" }, "CreateOutputList":{ "type":"list", "member":{"shape":"CreateOutput"} }, "CroppingConfig":{ "type":"structure", "members":{ "templateGroups":{ "shape":"TemplateGroupList", "documentation":"An array of template groups for the crop output. Each template group provides the graphics-compositing templates that Elemental Inference applies to the cropped video. You can specify from 1 to 4 template groups.
" } }, "documentation":"A type of OutputConfig, used when the output in a feed is for the crop feature.
" }, "DataSourceConfiguration":{ "type":"structure", "required":["fixtureId"], "members":{ "fixtureId":{ "shape":"FixtureId", "documentation":"The ID of the fixture whose event data you want Elemental Inference to map onto this clipping output. The fixture should be the sports event in the source media that the feed is processing.
To obtain this ID, use the SearchFixtures operation to find the fixture, then use the fixtureId from the matching FixtureSummary.
" } }, "documentation":"Contains the data source configuration for a clipping output. It identifies the fixture whose event data Elemental Inference maps onto the clipping metadata. It is used in the dataSourceConfiguration property of a ClippingConfig.
" }, "DataSourceSport":{ "type":"string", "enum":[ "basketball", "american-football" ] }, "DeleteDictionaryRequest":{ "type":"structure", "required":["id"], "members":{ "id":{ "shape":"DictionaryId", "documentation":"The ID of the dictionary to delete.
", "location":"uri", "locationName":"id" } } }, "DeleteDictionaryResponse":{ "type":"structure", "required":[ "arn", "id", "status" ], "members":{ "arn":{ "shape":"DictionaryArn", "documentation":"The ARN of the deleted dictionary.
" }, "id":{ "shape":"DictionaryId", "documentation":"The ID of the deleted dictionary.
" }, "status":{ "shape":"DictionaryStatus", "documentation":"The status of the dictionary after deletion.
" } } }, "DeleteFeedRequest":{ "type":"structure", "required":["id"], "members":{ "id":{ "shape":"FeedId", "documentation":"The ID of the feed.
", "location":"uri", "locationName":"id" } } }, "DeleteFeedResponse":{ "type":"structure", "required":[ "arn", "id", "status" ], "members":{ "arn":{ "shape":"FeedArn", "documentation":"The ARN of the deleted feed.
" }, "id":{ "shape":"FeedId", "documentation":"The ID of the deleted feed.
" }, "status":{ "shape":"FeedStatus", "documentation":"The current status of the feed. When deletion of the feed has succeeded, the status will be DELETED.
" } } }, "DictionaryArn":{"type":"string"}, "DictionaryEntriesPayload":{ "type":"string", "max":40960, "min":0 }, "DictionaryId":{ "type":"string", "max":19, "min":1, "pattern":"[a-zA-Z0-9]+" }, "DictionaryLanguage":{ "type":"string", "enum":[ "eng", "fra", "ita", "deu", "spa", "por" ] }, "DictionaryStatus":{ "type":"string", "enum":[ "CREATING", "AVAILABLE", "REFERENCED", "DELETING", "DELETED" ] }, "DictionarySummary":{ "type":"structure", "required":[ "arn", "id", "name", "language", "status" ], "members":{ "arn":{ "shape":"DictionaryArn", "documentation":"The ARN of the dictionary.
" }, "id":{ "shape":"DictionaryId", "documentation":"The ID of the dictionary.
" }, "name":{ "shape":"ResourceName", "documentation":"The name of the dictionary.
" }, "language":{ "shape":"DictionaryLanguage", "documentation":"The language of the dictionary.
" }, "status":{ "shape":"DictionaryStatus", "documentation":"The status of the dictionary.
" } }, "documentation":"Contains summary information about a dictionary. Used in the ListDictionaries response.
" }, "DictionarySummaryList":{ "type":"list", "member":{"shape":"DictionarySummary"} }, "DisassociateFeedRequest":{ "type":"structure", "required":[ "id", "associatedResourceName" ], "members":{ "id":{ "shape":"FeedId", "documentation":"The ID of the feed where you want to release the resource.
", "location":"uri", "locationName":"id" }, "associatedResourceName":{ "shape":"AssociatedResourceName", "documentation":"The name of the resource currently associated with the feed.
", "idempotencyToken":true }, "dryRun":{ "shape":"Boolean", "documentation":"Set to true if you want to do a dry run of the disassociate action.
Elemental Inference will validate that the real request would succeed without actually making any changes. A dry run catches errors such as missing IAM permissions. If the dry run fails, the action returns a 4xx error code.
" } } }, "DisassociateFeedResponse":{ "type":"structure", "required":[ "arn", "id" ], "members":{ "arn":{ "shape":"FeedArn", "documentation":"The ARN of the feed.
" }, "id":{ "shape":"FeedId", "documentation":"The ID of the feed.
" } } }, "ExportDictionaryEntriesRequest":{ "type":"structure", "required":["id"], "members":{ "id":{ "shape":"DictionaryId", "documentation":"The ID of the dictionary whose entries you want to export.
", "location":"uri", "locationName":"id" } } }, "ExportDictionaryEntriesResponse":{ "type":"structure", "members":{ "entries":{ "shape":"DictionaryEntriesPayload", "documentation":"The dictionary entries payload.
" } } }, "FeedArn":{"type":"string"}, "FeedAssociation":{ "type":"structure", "required":["associatedResourceName"], "members":{ "associatedResourceName":{ "shape":"AssociatedResourceName", "documentation":"The name of the associated resource.
" } }, "documentation":"Contains information about the resource that is associated with a feed. It is used in the FeedSummary that is used in the response of a ListFeeds action.
" }, "FeedId":{ "type":"string", "pattern":"[a-z0-9]{19}" }, "FeedReferences":{ "type":"list", "member":{"shape":"FeedId"} }, "FeedStatus":{ "type":"string", "enum":[ "CREATING", "AVAILABLE", "ACTIVE", "UPDATING", "DELETING", "DELETED", "ARCHIVED" ] }, "FeedSummary":{ "type":"structure", "required":[ "arn", "id", "name", "status" ], "members":{ "arn":{ "shape":"FeedArn", "documentation":"The ARN of the feed.
" }, "id":{ "shape":"FeedId", "documentation":"The ID of the feed.
" }, "name":{ "shape":"ResourceName", "documentation":"The name of the feed
" }, "association":{ "shape":"FeedAssociation", "documentation":"The resource, if any, associated with the feed.
" }, "status":{ "shape":"FeedStatus", "documentation":"The status of the feed.
" } }, "documentation":"Contains configuration information about a feed. It is used in the ListFeeds response.
" }, "FeedSummaryList":{ "type":"list", "member":{"shape":"FeedSummary"} }, "FilterName":{ "type":"string", "enum":["COMPETITOR"] }, "FilterValue":{ "type":"string", "max":256, "min":1 }, "FilterValueList":{ "type":"list", "member":{"shape":"FilterValue"}, "max":10, "min":0 }, "FixtureDate":{ "type":"string", "pattern":"\\d{4}-\\d{2}-\\d{2}" }, "FixtureId":{ "type":"string", "max":128, "min":1 }, "FixtureSummary":{ "type":"structure", "required":[ "fixtureId", "name", "status", "competitors" ], "members":{ "fixtureId":{ "shape":"FixtureId", "documentation":"The ID of the fixture. Specify this ID in the clipping output of a feed, to identify the fixture whose event data you want Elemental Inference to map onto the clipping metadata.
" }, "name":{ "shape":"String", "documentation":"The name of the fixture, as provided by the data source. For example, the names of the two competing teams.
" }, "fixtureGroup":{ "shape":"String", "documentation":"The group that the fixture belongs to, such as the competition, league, or tournament. The data source doesn't provide this information for every fixture.
" }, "scheduledStart":{ "shape":"SyntheticTimestamp_date_time", "documentation":"The scheduled start time of the fixture, as provided by the data source. The actual start time might differ.
" }, "status":{ "shape":"String", "documentation":"The status of the fixture in its lifecycle, as provided by the data source. For example, Scheduled or Completed.
" }, "competitors":{ "shape":"CompetitorList", "documentation":"An array of the competitors (the teams or individuals) in the fixture.
" } }, "documentation":"Contains information about one fixture. It is used in the SearchFixtures response.
Elemental Inference relays the information in this structure from the data source, so that you can identify the fixture that matches your source media.
" }, "FixtureSummaryList":{ "type":"list", "member":{"shape":"FixtureSummary"} }, "GatewayTimedOutException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The request timed out before the service returned a response. This is a temporary condition. Retry the request. If the problem persists, contact AWS Support.
", "error":{"httpStatusCode":504}, "exception":true, "fault":true, "retryable":{"throttling":false} }, "GetDictionaryRequest":{ "type":"structure", "required":["id"], "members":{ "id":{ "shape":"DictionaryId", "documentation":"The ID of the dictionary to retrieve.
", "location":"uri", "locationName":"id" } } }, "GetDictionaryResponse":{ "type":"structure", "required":[ "name", "arn", "id", "language", "status" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"The name of the dictionary.
" }, "arn":{ "shape":"DictionaryArn", "documentation":"The ARN of the dictionary.
" }, "id":{ "shape":"DictionaryId", "documentation":"The ID of the dictionary.
" }, "language":{ "shape":"DictionaryLanguage", "documentation":"The language of the dictionary.
" }, "status":{ "shape":"DictionaryStatus", "documentation":"The current status of the dictionary.
" }, "references":{ "shape":"FeedReferences", "documentation":"A list of feed IDs that reference this dictionary.
" }, "tags":{ "shape":"TagMap", "documentation":"The tags associated with the dictionary.
" } } }, "GetFeedRequest":{ "type":"structure", "required":["id"], "members":{ "id":{ "shape":"FeedId", "documentation":"The ID of the feed to query.
", "location":"uri", "locationName":"id" } } }, "GetFeedResponse":{ "type":"structure", "required":[ "arn", "name", "id", "dataEndpoints", "outputs", "status" ], "members":{ "arn":{ "shape":"FeedArn", "documentation":"The ARN of the feed.
" }, "name":{ "shape":"ResourceName", "documentation":"The name of the feed.
" }, "id":{ "shape":"FeedId", "documentation":"The ID of the feed.
" }, "dataEndpoints":{ "shape":"StringList", "documentation":"The dataEndpoints of the feed.
" }, "outputs":{ "shape":"GetOutputList", "documentation":"An array of the outputs in the feed.
" }, "status":{ "shape":"FeedStatus", "documentation":"The status of the feed.
" }, "association":{ "shape":"FeedAssociation", "documentation":"Information about the resource that is associated with the feed. It's possible that there is no associated resource. This is not an error.
" }, "tags":{ "shape":"TagMap", "documentation":"A list of the tags, if any, for the feed.
" } } }, "GetOutput":{ "type":"structure", "required":[ "name", "outputConfig", "status" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"The name of the output.
" }, "outputConfig":{ "shape":"OutputConfig", "documentation":"A typed property for an output in a feed. It identifies the action for Elemental Inference to perform. It also provides a repository for the results of that action. For example, CroppingConfig output will contain the metadata for the crop feature.
" }, "status":{ "shape":"OutputStatus", "documentation":"The status of the output.
" }, "description":{ "shape":"ResourceDescription", "documentation":"The description of the output.
" }, "fromAssociation":{ "shape":"Boolean", "documentation":"True means that the output was originally created in the feed using AssociateFeed. False means it was created using CreateFeed or UpdateFeed.
You will need this value if you use UpdateFeed to modify the list of outputs in the feed.
" } }, "documentation":"Contains configuration information about one output in a feed. It is used in the GetFeed response.
" }, "GetOutputList":{ "type":"list", "member":{"shape":"GetOutput"} }, "IamRoleArn":{ "type":"string", "max":255, "min":32, "pattern":"arn:aws[a-z\\-]*:iam::[0-9]{12}:role/.+" }, "Integer":{ "type":"integer", "box":true }, "InternalServerErrorException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"An internal server error occurred. This is a temporary condition and the request can be retried. If the problem persists, contact AWS Support.
", "error":{"httpStatusCode":500}, "exception":true, "fault":true, "retryable":{"throttling":false} }, "ListDictionariesRequest":{ "type":"structure", "members":{ "maxResults":{ "shape":"ListDictionariesRequestMaxResultsInteger", "documentation":"The maximum number of results to return per API request. Valid range: 1 to 100.
", "location":"querystring", "locationName":"maxResults" }, "nextToken":{ "shape":"String", "documentation":"The token that identifies the next batch of results to return.
", "location":"querystring", "locationName":"nextToken" } } }, "ListDictionariesRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListDictionariesResponse":{ "type":"structure", "required":["dictionaries"], "members":{ "dictionaries":{ "shape":"DictionarySummaryList", "documentation":"A list of DictionarySummary objects.
" }, "nextToken":{ "shape":"String", "documentation":"The token to use to retrieve the next batch of results.
" } } }, "ListFeedsRequest":{ "type":"structure", "members":{ "maxResults":{ "shape":"ListFeedsRequestMaxResultsInteger", "documentation":"The maximum number of results to return per API request.
For example, you submit a list request with MaxResults set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a NextToken value that you can use to fetch the next batch of results.)
The service might return fewer results than the MaxResults value. If MaxResults is not included in the request, the service defaults to pagination with a maximum of 10 results per page.
Valid Range: Minimum value of 1. Maximum value of 1000.
", "location":"querystring", "locationName":"maxResults" }, "nextToken":{ "shape":"String", "documentation":"The token that identifies the batch of results that you want to see.
For example, you submit a ListFeeds request with MaxResults set at 5. The service returns the first batch of results (up to 5) and a NextToken value. To see the next batch of results, you can submit the ListFeeds request a second time and specify the NextToken value.
", "location":"querystring", "locationName":"nextToken" } } }, "ListFeedsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListFeedsResponse":{ "type":"structure", "required":["feeds"], "members":{ "feeds":{ "shape":"FeedSummaryList", "documentation":"A list of FeedSummary objects.
" }, "nextToken":{ "shape":"String", "documentation":"The token that identifies the batch of results that you want to see. For example, you submit a list request with MaxResults set at 5. The service returns the first batch of results (up to 5) and a NextToken value. To see the next batch of results, you can submit the list request a second time and specify the NextToken value.
" } } }, "ListTagsForResourceRequest":{ "type":"structure", "required":["resourceArn"], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"The ARN of the resource whose tags you want to query.
", "location":"uri", "locationName":"resourceArn" } } }, "ListTagsForResourceResponse":{ "type":"structure", "members":{ "tags":{ "shape":"TagMap", "documentation":"A list of the tags that belong to this resource.
" } } }, "OutputConfig":{ "type":"structure", "members":{ "cropping":{ "shape":"CroppingConfig", "documentation":"The output config type that applies to the cropping feature.
" }, "clipping":{ "shape":"ClippingConfig", "documentation":"The output config type that applies to the clipping feature.
" }, "subtitling":{ "shape":"SubtitlingConfig", "documentation":"The output config type that applies to the smart subtitling feature.
" } }, "documentation":"Contains one typed output. It is used in the CreateOutput, GetOutput, and Update Output structures.
", "union":true }, "OutputStatus":{ "type":"string", "enum":[ "ENABLED", "DISABLED" ] }, "ProfanityFilterMode":{ "type":"string", "enum":[ "DISABLED", "CENSOR", "DROP" ] }, "ResourceArn":{ "type":"string", "pattern":"arn:aws[a-z\\-]*:elemental-inference[a-z\\-]*:[a-z0-9\\-]+:[0-9]{12}:(feed|dictionary)/[a-zA-Z0-9]{1,19}" }, "ResourceDescription":{ "type":"string", "max":1024, "min":0, "pattern":"[\\w \\-\\.',@:;]*" }, "ResourceName":{ "type":"string", "pattern":"[a-zA-Z0-9]([a-zA-Z0-9-_]{0,126}[a-zA-Z0-9])?" }, "ResourceNotFoundException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The resource specified in the action doesn't exist.
", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "S3Uri":{ "type":"string", "max":255, "min":10, "pattern":"s3://[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]/.+" }, "SearchFilter":{ "type":"structure", "required":[ "name", "values" ], "members":{ "name":{ "shape":"FilterName", "documentation":"The dimension of the fixture to filter on. Valid values: COMPETITOR.
" }, "values":{ "shape":"FilterValueList", "documentation":"An array of values to match in the dimension that you specified in name. You can specify up to 10 values. A fixture appears in the results if it matches at least one of these values.
" } }, "documentation":"A filter for a fixture search. It is used in the filters array of a SearchFixtures request.
" }, "SearchFilterList":{ "type":"list", "member":{"shape":"SearchFilter"}, "max":10, "min":0 }, "SearchFixturesRequest":{ "type":"structure", "required":[ "sport", "startDate" ], "members":{ "sport":{ "shape":"DataSourceSport", "documentation":"The sport to search for fixtures. Valid values: basketball (search for basketball fixtures), american-football (search for american-football fixtures).
" }, "startDate":{ "shape":"FixtureDate", "documentation":"The first day of the search window, in UTC. The search includes fixtures that are scheduled on this day.
Specify the date in ISO 8601 format, as YYYY-MM-DD. For example, 2026-03-14.
The last day of the search window, in UTC. The search includes fixtures that are scheduled on this day. Specify the date in ISO 8601 format, as YYYY-MM-DD.
If you omit this parameter, Elemental Inference searches only the day that you specified in startDate. The window from startDate through endDate must not exceed seven days.
" }, "filters":{ "shape":"SearchFilterList", "documentation":"An array of filters that narrow the results. Each filter applies to one dimension of a fixture, such as the competitor. You can specify up to 10 filters.
A fixture must satisfy every filter in the array in order to appear in the results. Within one filter, a fixture must match at least one of the values.
" }, "maxResults":{ "shape":"SearchFixturesRequestMaxResultsInteger", "documentation":"The maximum number of fixtures to return for each API request.
The service might return fewer fixtures than the maxResults value. When more fixtures match the search, the response also includes a nextToken value that you can use to fetch the next batch of results.
" }, "nextToken":{ "shape":"String", "documentation":"The token that identifies the batch of results that you want to see.
For example, you submit a SearchFixtures request with maxResults set at 5. The service returns the first batch of results (up to 5) and a nextToken value. To see the next batch of results, you submit the SearchFixtures request a second time, with the same search criteria, and specify the nextToken value.
" } } }, "SearchFixturesRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "SearchFixturesResponse":{ "type":"structure", "required":["fixtures"], "members":{ "fixtures":{ "shape":"FixtureSummaryList", "documentation":"An array of FixtureSummary objects, one for each fixture that matches the search. The array is empty if no fixtures match.
" }, "nextToken":{ "shape":"String", "documentation":"The token that identifies the next batch of results. To see the next batch, submit the SearchFixtures request again, with the same search criteria, and specify this value in nextToken.
This parameter is absent when there are no more results to return.
" } } }, "ServiceQuotaExceededException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The request was rejected because it would exceed one or more service quotas for your account. Review your service quotas and either delete unused resources or request a quota increase.
", "error":{ "httpStatusCode":402, "senderFault":true }, "exception":true }, "ServiceUnavailableException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The service is temporarily unable to handle the request. Retry the request. If the problem persists, contact AWS Support.
", "error":{"httpStatusCode":503}, "exception":true, "fault":true, "retryable":{"throttling":false} }, "String":{"type":"string"}, "StringList":{ "type":"list", "member":{"shape":"String"} }, "SubtitlingConfig":{ "type":"structure", "required":["language"], "members":{ "language":{ "shape":"TranscriptionLanguage", "documentation":"The language of the audio in the source media. Elemental Inference uses this setting to optimize transcription accuracy. Specify the language using an ISO 639-2/T three-letter code, optionally with a region subtag. Supported values: eng, eng-au, eng-gb, eng-us, fra, ita, deu, spa, por.
" }, "aspectRatio":{ "shape":"AspectRatio", "documentation":"The aspect ratio of the output video, specified as width and height integer values. Elemental Inference uses the aspect ratio to determine subtitle layout and line lengths.
" }, "dictionary":{ "shape":"DictionaryId", "documentation":"The ID of a custom dictionary to improve transcription accuracy for domain-specific terminology. Use the CreateDictionary operation to create a dictionary.
" }, "profanityFilter":{ "shape":"ProfanityFilterMode", "documentation":"Controls how profanity is handled in the generated subtitles. Valid values: DISABLED (no filtering, default), CENSOR (replace profanity with asterisks), DROP (remove profanity from the transcript).
" } }, "documentation":"A type of OutputConfig, used when the output in a feed is for the smart subtitling feature. smart subtitling uses automatic speech recognition (ASR) to generate live TTML subtitles from the audio in your source media.
" }, "SyntheticTimestamp_date_time":{ "type":"timestamp", "timestampFormat":"iso8601" }, "TagKey":{ "type":"string", "max":128, "min":1 }, "TagKeyList":{ "type":"list", "member":{"shape":"TagKey"} }, "TagMap":{ "type":"map", "key":{"shape":"TagKey"}, "value":{"shape":"TagValue"} }, "TagResourceRequest":{ "type":"structure", "required":[ "resourceArn", "tags" ], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"The ARN of the resource where you want to add tags.
", "location":"uri", "locationName":"resourceArn" }, "tags":{ "shape":"TagMap", "documentation":"A list of tags to add to the resource.
" } } }, "TagValue":{ "type":"string", "max":256, "min":0 }, "TemplateGroup":{ "type":"structure", "required":[ "name", "templateUris" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"A name for the template group.
" }, "templateUris":{ "shape":"TemplateUriList", "documentation":"An array of Amazon S3 URIs that point to the graphics-compositing templates for this group. You can specify 1 or 2 URIs. Each URI must be in the form s3://bucket-name/key. Elemental Inference reads these templates using the IAM role that you specify in accessRoleArn.
A named set of graphics-compositing templates used by the crop feature, specified in the templateGroups array of a CroppingConfig.
" }, "TemplateGroupList":{ "type":"list", "member":{"shape":"TemplateGroup"}, "max":4, "min":1 }, "TemplateUriList":{ "type":"list", "member":{"shape":"S3Uri"}, "max":2, "min":1 }, "TooManyRequestException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The request was denied due to request throttling. Too many requests have been made within a given time period. Reduce the frequency of requests and use exponential backoff when retrying.
", "error":{ "httpStatusCode":429, "senderFault":true }, "exception":true, "retryable":{"throttling":false} }, "TranscriptionLanguage":{ "type":"string", "enum":[ "eng", "eng-au", "eng-gb", "eng-us", "fra", "ita", "deu", "spa", "por" ] }, "UntagResourceRequest":{ "type":"structure", "required":[ "resourceArn", "tagKeys" ], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"The ARN of the resource where you want to delete one or more tags.
", "location":"uri", "locationName":"resourceArn" }, "tagKeys":{ "shape":"TagKeyList", "documentation":"The keys of the tags to delete.
", "location":"querystring", "locationName":"tagKeys" } } }, "UpdateDictionaryRequest":{ "type":"structure", "required":["id"], "members":{ "id":{ "shape":"DictionaryId", "documentation":"The ID of the dictionary to update.
", "location":"uri", "locationName":"id" }, "name":{ "shape":"ResourceName", "documentation":"A new name for the dictionary. If not specified, the name is not changed.
" }, "language":{ "shape":"DictionaryLanguage", "documentation":"A new language for the dictionary. If not specified, the language is not changed.
" }, "entries":{ "shape":"DictionaryEntriesPayload", "documentation":"New dictionary entries. If not specified, the entries are not changed.
" } } }, "UpdateDictionaryResponse":{ "type":"structure", "required":[ "name", "arn", "id", "language", "status" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"The updated or original name of the dictionary.
" }, "arn":{ "shape":"DictionaryArn", "documentation":"The ARN of the dictionary.
" }, "id":{ "shape":"DictionaryId", "documentation":"The ID of the dictionary.
" }, "language":{ "shape":"DictionaryLanguage", "documentation":"The updated or original language of the dictionary.
" }, "status":{ "shape":"DictionaryStatus", "documentation":"The current status of the dictionary.
" }, "references":{ "shape":"FeedReferences", "documentation":"A list of feed IDs that reference this dictionary.
" }, "tags":{ "shape":"TagMap", "documentation":"Any tags associated with the dictionary.
" } } }, "UpdateFeedRequest":{ "type":"structure", "required":[ "name", "id", "outputs" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"Required. You can specify the existing name (to leave it unchanged) or a new name.
" }, "accessRoleArn":{ "shape":"IamRoleArn", "documentation":"The ARN of an IAM role that Elemental Inference assumes to access resources in your account on your behalf. You can specify the existing role (to leave it unchanged) or a new role. You specify one access role for each feed.
" }, "id":{ "shape":"FeedId", "documentation":"The ID of the feed to update.
", "location":"uri", "locationName":"id" }, "outputs":{ "shape":"UpdateOutputList", "documentation":"Required. You can specify the existing array of outputs (to leave outputs unchanged) or you can specify a new array.
" } } }, "UpdateFeedResponse":{ "type":"structure", "required":[ "arn", "name", "id", "dataEndpoints", "outputs", "status" ], "members":{ "arn":{ "shape":"FeedArn", "documentation":"The ARN of the feed.
" }, "name":{ "shape":"ResourceName", "documentation":"The updated or original name of the feed.
" }, "id":{ "shape":"FeedId", "documentation":"The ID of the feed.
" }, "dataEndpoints":{ "shape":"StringList", "documentation":"The data endpoints of the feed.
" }, "outputs":{ "shape":"GetOutputList", "documentation":"The array of outputs in the feed. You might have left this array unchanged, or you might have changed it.
" }, "status":{ "shape":"FeedStatus", "documentation":"The status of the feed.
" }, "association":{ "shape":"FeedAssociation", "documentation":"Information about the resource that is associated with the feed, if any.
" }, "tags":{ "shape":"TagMap", "documentation":"The tags associated with the feed.
" } } }, "UpdateOutput":{ "type":"structure", "required":[ "name", "outputConfig", "status" ], "members":{ "name":{ "shape":"ResourceName", "documentation":"The name of the output.
" }, "outputConfig":{ "shape":"OutputConfig", "documentation":"A typed property for an output in a feed. It identifies the action for Elemental Inference to perform. It also provides a repository for the results of that action. For example, CroppingConfig output will contain the metadata for the crop feature.
" }, "status":{ "shape":"OutputStatus", "documentation":"The status of the output.
" }, "description":{ "shape":"ResourceDescription", "documentation":"A description of the output.
" }, "fromAssociation":{ "shape":"Boolean", "documentation":"Elemental Inference originally sets this parameter to True if this output was created by AssociateFeed or to False if this output was created by CreateFeed or UpdateFeed.
You must not change this value. Therefore, use GetFeed to determine the current value. Then in the UpdateFeed request, if the current value is True, include this parameter with a value of True. If it's False, omit the parameter.
" } }, "documentation":"Contains configuration information about one output in a feed. It is used in the UpdateFeed action.
" }, "UpdateOutputList":{ "type":"list", "member":{"shape":"UpdateOutput"} }, "ValidationException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"The input fails to satisfy the constraints specified by the service. Check the error message for details about which parameter or field is invalid and correct the request before retrying.
", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true } }, "documentation":"This is the AWS Elemental Inference REST API Reference. It provides information on the URL, request contents, and response contents of each AWS Elemental Inference REST operation.
We assume that you have the IAM permissions that you need to use AWS Elemental Inference via the REST API. We also assume that you are familiar with the features and operations of AWS Elemental Inference as described in AWS Elemental Inference User Guide.
" }