Merge pull request #250324 from IngridAtMicrosoft/retire

AVI AMS retirement announcement

Author: v-dirichards

articles/azure-video-indexer/azure-video-indexer-azure-media-services-retirement-announcement.md

@@ -0,0 +1,100 @@
+---
+title: Azure AI Video Indexer (AVI) changes related to Azure Media Service (AMS) retirement  
+description: This article explains the upcoming changes to Azure AI Video Indexer (AVI) related to the retirement of Azure Media Services (AMS).
+ms.topic: conceptual
+ms.date: 09/05/2023
+ms.author: inhenkel
+author: IngridAtMicrosoft
+---
+
+# Changes related to Azure Media Service (AMS) retirement
+
+This article explains the upcoming changes to Azure AI Video Indexer (AVI) resulting from the [retirement of Azure Media Services (AMS)](/azure/media-services/latest/azure-media-services-retirement).
+
+Currently, AVI requires the creation of an AMS account. Additionally, AVI uses AMS for video encoding and streaming operations. The required changes will affect all AVI customers.
+
+To continue using AVI beyond June 30, 2024, all customers **must** make changes to their AVI accounts to remove the AMS dependency. Detailed guidance for converting AVI accounts will be provided in January 2024 when the new account type is released.
+
+## Pricing and billing
+
+Currently, AVI uses AMS for encoding and streaming for the AVI player. AMS charges you for both encoding and streaming. In the future, AVI will encode media and you'll be billed using the updated AVI accounts. Pricing details will be shared in January 2024. There will be no charge for the AVI video player.
+
+## AVI changes
+
+AVI will continue to offer the same insights, performance, and functionality. However, a few aspects of the service will change which fall under the following three categories:
+
+- Account changes
+- API changes
+- Product changes
+
+## Account changes
+
+AVI has three account types. All will be impacted by the AMS retirement. The account types are:
+
+- ARM-based accounts
+- Classic accounts
+- Trial accounts
+
+See [Azure AI Video Indexer account types](/azure/azure-video-indexer/accounts-overview) to understand more about AVI account types.
+
+### Azure Resource Manager (ARM)-based accounts
+
+**New accounts:** As of January 15, all newly created AVI accounts will be non-AMS dependent accounts. You'll no longer be able to create AMS-dependent accounts.
+
+**Existing accounts**: Existing accounts will continue to work through June 30, 2024. To continue using the account beyond June 30, customers must go through the process to convert their account to a non-AMS dependent account. If you don’t convert your account to a non-AMS dependent account, you won't be able to access the account or use it beyond June 30.
+
+### Classic accounts
+
+- **New accounts:** As of January 15, all newly created AVI accounts will be non-AMS dependent accounts. You'll no longer be able to create Classic accounts.
+- **Existing accounts:** Existing classic accounts will continue to work through June 30, 2024. AVI will release an updated API version for the non-AMS dependent accounts that doesn’t contain any AMS related parameters.
+
+To continue using the account beyond June 30, 2024, classic accounts will have to go through two steps:
+
+1. Connect the account as an ARM-based account. You can connect the accounts already. See [Azure AI Video Indexer accounts](accounts-overview.md) for instructions.
+1. Make the required changes to the AVI account to remove the AMS dependency. If this isn’t done, you won't be able to access the account or use it beyond June 30, 2024.
+
+### Existing trial accounts
+
+- As of January 15, 2024 Video Indexer trial accounts will continue to work as usual. However, when using them through the APIs, customers must use the updated APIs.
+- AVI supports [importing content](import-content-from-trial.md) from a trial AVI account to a paid AVI account. This import option will be supported only until **January 15th, 2024**.
+
+## API changes
+
+**Between January 15 to June 30, 2024**, AVI will support both existing data and control plane APIs as well as the updated APIs that exclude all AMS related parameters.
+
+New AVI accounts as well as existing AVI accounts that have completed the steps to remove all AMS dependencies will only use the updated APIs that will exclude all AMS related parameters.
+
+**On July 1, 2024**, code using APIs with AMS parameters will no longer be supported. This applies to both control plane and data plane operations.
+
+### Breaking API changes
+
+There will be breaking API changes. The following table describes the changes for your awareness, but actionable guidance will be provided when the changes have been released.
+
+| **Type** | **API Name** |  **Change** |
+|---|---|---|
+| **ARM** | Create<br/>Update<br/>Patch<br/>ListAccount | - The `mediaServices` Account property will be replaced with a `storageServices` Account property.<br/><br/> - The `Identity` property will change from an `Owner` managed identity to `Storage Blob Data Contributor` permissions on the storage resource. |
+| **ARM** | Get<br/>MoveAccount | The `mediaServices` Account property will be replaced with a `storageServices` Account property. |
+| **ARM** | GetClassicAccount<br/>ListClassicAccounts |  API will no longer be supported. |
+| **Classic** | CreatePaidAccountManually | API will no longer be supported. |
+| **Classic** | UpdateAccountMediaServicesAsync |  API will no longer be supported. |
+| **Data plane** | Upload | Upload will no longer accept the `assetId` parameter. |
+| **Data plane** | Upload<br/>ReIndex<br/>Redact | `AdaptiveBitrate` will no longer be supported for new uploads. |
+| **Data plane** | GetVideoIndex | `PublishedUrl` property will always be null. |
+| **Data plane** | GetVideoStreamingURL | The streaming URL will return references to AVI account endpoints rather than AMS account endpoints. |
+
+Full details of the API changes and alternatives will be provided when the updated APIs are released.
+
+## Product changes
+
+As of July 1, 2024, AVI won’t use AMS for encoding or streaming. As a result, it will no longer support the following:
+
+- Encoding with adaptive bitrate will no longer be supported. Only single bitrate will be supported for new indexing jobs. Videos already encoded with adaptive bitrate will be playable in the AVI player.
+- Video Indexer [dynamic encryption](/azure/media-services/latest/drm-content-protection-concept) of media files will no longer be supported.
+- Media files created by non-AMS dependent accounts won’t be playable by the [Azure Media Player](https://azure.microsoft.com/products/media-services/media-player).
+- Using a Cognitive Insights widget and playing the content with the Azure Media Player outlined [here](video-indexer-embed-widgets.md) will no longer be supported.
+
+## Timeline
+
+This graphic shows the timeline for the changes.
+
+:::image type="content" source="media/avi-ams-retirement-announcement/azure-video-indexer-azure-media-services-changes.png" lightbox="media/avi-ams-retirement-announcement/azure-video-indexer-azure-media-services-changes.png" alt-text="Diagram of AVI changes timeline that visually represents what has been discussed in the document.":::

articles/azure-video-indexer/media/avi-ams-retirement-announcement/azure-video-indexer-azure-media-services-changes.png

@@ -5,6 +5,8 @@
   - name: What is Azure AI Video Indexer?
     href: video-indexer-overview.md
     displayName: Azure AI services, service, flow, API, website, video, visual content moderation models, Azure AI services, Azure Media Services, Optical character recognition, Video/audio AI features, 30+ AI models, entertainment content owners, Account-based face identification, relevant video moments, social media content, Video models, visual objects, visual cues, video/audio files, Celebrity identification, video analysis, video library, audio models, news media, media files, relevant ads, Gate notice, cloud application, Azure AI Vision, many scenarios, news agencies, educational institutes, LOB apps, news clips, scenes markers, label appearances, creation process, different regions, different languages, multiple languages, ad revenue, additional signals, ad server, user engagement, additional metadata, various websites, specific account, frontal position, street signs, racy visuals, single event, consecutive shots, audio content, Content creation, inappropriate content, Deep search, search experience, Face detection, Video insights, relevant videos, spoken words, 1 million celebrities, world leaders, image asset, two people, rich insights, Person model, title, description, article, overview, regulation, part, Translator, Speech, illustration, background, Diagram, chart, azure-video-indexer, section, example, faces, broadcasters, enterprise, industry, users, trailers, highlight, reels, Keyframes, timestamps, disabilities, transcription, translation, Monetization, value, industries, textual, organization, Recommendations, needs, list, Detects, groups, actors, artists, athletes, researchers, business, globe, IMDB, Wikipedia, information, quality, size, OCR, images, pictures, products, adult, actions, series
+  - name: Changes related to Azure Media Service (AMS) retirement
+    href: azure-video-indexer-azure-media-services-retirement-announcement.md
   - name: Account types
     href: accounts-overview.md
     displayName: existing classic account, limited access features, account types, accounts description, accounts types, unlimited accounts, trial account, pricing, API, unlimited ARM based account, Azure Government limitations, Azure Government cloud, regular unlimited accounts, classic account type, classic account type, classic (paid) account, Azure Resource Manager, up to 600 minutes, up to 2400 minutes, regular paid account, Azure Monitor integration, ARM based accounts, ARM-based (paid) account, trial account option, accounts management plane, free trial minutes, unlimited) account, Classic accounts, Azure subscription, Azure portal, ARM-based account, trial accounts, indexing minutes, Account creation, other articles, free indexing, management capabilities, ARM templates, easy process, great way, developer portal, production workloads, many security, correct domain, Switch tenants, Next steps, API Management, minute cost, SLA limitations, website users, minute, support, title, overview, links, details, videoindexer, quick, No, content, mind, number, api-portal, azure-video-indexer, azure-government, based-access-control, deployment, Billing, preset, information, microsoft, account-portal, TIP, classic-account, difference, azure-resource, access-account-types