Azure 认知服务容器常见问题解答 (FAQ)Azure Cognitive Services containers frequently asked questions (FAQ)

一般问题General questions

问:认知服务容器提供哪些功能?Q: What is available?

答: Azure 认知服务容器可让开发人员使用 Azure 中提供的相同智能 API,但除此之外,还提供容器化的 优势A: Azure Cognitive Services containers allow developers to use the same intelligent APIs that are available in Azure, but with the benefits of containerization. 某些容器以封闭预览版的形式提供,可能需要通过应用程序进行访问。Some containers are available as a gated preview which may require an application to access. 其他容器公开以非封闭预览版或正式版的形式发布。Other containers are publicly available as an ungated preview, or are generally available. 可在 Azure 认知服务中的容器支持一文中找到容器及其可用性的完整列表。You can find a full list of containers and their availability in the Container support in Azure Cognitive Services article. 还可以在 Docker Hub 中查看容器。You can also view the containers in the Docker Hub.

问:认知服务云与容器之间是否有任何差异?Q: Is there any difference between the Cognitive Services cloud and the containers?

答: 认知服务容器是认知服务云的替代方案。A: Cognitive Services containers are an alternative to the Cognitive Services cloud. 容器提供的功能与相应的云服务相同。Containers offer the same capabilities as the corresponding cloud services. 客户可在本地或 Azure 中部署容器。Customers can deploy the containers on-premises or in Azure. 容器与相应云服务的核心 AI 技术、定价层、API 密钥和 API 签名是相同的。The core AI technology, pricing tiers, API keys, and API signature are the same between the container and the corresponding cloud services. 容器的这些功能和优势使得它们比其对应的云服务更受欢迎。Here are the features and benefits for choosing containers over their cloud service equivalent.

问:如何访问和使用门控式预览版容器?Q: How do I access and use a gated preview container?

答: 以前,门控式预览版容器托管在 containerpreview.azurecr.io 存储库中。A: Previously, gated preview containers were hosted on the containerpreview.azurecr.io repository. 从 2020 年 9 月 22 日开始,这些容器托管在 Microsoft 容器注册表中,下载它们不需要使用 docker login 命令。Starting September 22nd 2020, these containers are hosted on the Microsoft Container Registry, and downloading them doesn't require you to use the docker login command. 如果 Azure 资源是使用已批准的 Azure 订阅 ID 创建的,你将能够运行门控式预览版容器。You'll be able to run a gated preview container if your Azure resource was created with the approved Azure subscription ID. 如果 Azure 订阅在你完成请求表单后尚未获得批准,你将无法运行该容器。You won't be able to run the container if your Azure subscription has not been approved after completing the request form.

问:容器是否适用于所有认知服务,接下来期待会推出哪一套容器?Q: Will containers be available for all Cognitive Services and what are the next set of containers we should expect?

答: 我们希望以容器产品/服务的形式推出更多的认知服务。A: We would like to make more Cognitive Services available as container offerings. 请与当地的 Microsoft 客户经理联系,以获取有关新容器版本和其他认知服务公告的更新。Contact to your local Microsoft account manager to get updates on new container releases and other Cognitive Services announcements.

问:认知服务容器的服务级别协议 (SLA) 是什么?Q: What will the Service-Level Agreement (SLA) be for Cognitive Services containers?

答: 认知服务容器不附带 SLA。A: Cognitive Services containers do not have an SLA.

认知服务容器的资源配置由客户控制,因此 Microsoft 不会为正式版 (GA) 提供 SLA。Cognitive Services container configurations of resources are controlled by customers, so Microsoft will not offer an SLA for general availability (GA). 客户可以在本地自由部署容器,因此宿主环境由他们定义。Customers are free to deploy containers on-premises, thus they define the host environments.

重要

若要详细了解认知服务服务级别协议,请访问我们的 SLA 页To learn more about Cognitive Services Service-Level Agreements, visit our SLA page.

版本控制Versioning

问:如何将容器更新到最新版本?Q: How are containers updated to the latest version?

答: 客户可以选择何时更新已部署的容器。A: Customers can choose when to update the containers they have deployed. 容器将标有标准的 Docker 标记(例如 latest),表示使用的是最新版本。Containers will be marked with standard Docker tags such as latest to indicate the most recent version. 我们建议客户下载发布的最新版本的容器。有关在映像更新后如何接收通知的详细信息,请查看 Azure 容器注册表 WebhookWe encourage customers to pull the latest version of containers as they are released, checkout Azure Container Registry webhooks for details on how to get notified when an image is updated.

问:支持哪些版本?Q: What versions will be supported?

答: 支持容器的当前版本和最新主要版本。A: The current and last major version of the container will be supported. 但是,我们建议客户保持使用最新技术。However, we encourage customers to stay current to get the latest technology.

问:如何对更新进行版本控制?Q: How are updates versioned?

答: 主要版本变更表示 API 签名发生了中断性变更。A: Major version changes indicate that there is a breaking change to the API signature. 我们预计,这种变更往往与相应认知服务云产品/服务的主要版本变更相一致。We anticipate that this will generally coincide with major version changes to the corresponding Cognitive Service cloud offering. 次要版本变更表示发生了 bug 修复、模型更新或推出了新的功能,但 API 签名未发生中断性变更。Minor version changes indicate bug fixes, model updates, or new features that do not make a breaking change to the API signature.

技术问题Technical questions

问:如何在 IoT 设备上运行认知服务容器?Q: How should I run the Cognitive Services containers on IoT devices?

答: 你没有可靠的 Internet 连接,或者想要节省带宽成本。A: Whether you don't have a reliable internet connection, or want to save on bandwidth cost. 或者,如果具有低延迟要求,或者正在处理需要在现场进行分析的敏感数据,Azure IoT Edge 与认知服务容器能提供与云的一致性。Or if have low-latency requirements, or are dealing with sensitive data that needs to be analyzed on-site, Azure IoT Edge with the Cognitive Services containers gives you consistency with the cloud.

问:这些容器是否与 OpenShift 兼容?Q: Are these containers compatible with OpenShift?

我们不会通过 OpenShift 测试容器,但通常情况下,认知服务容器应可在支持 Docker 映像的任何平台上运行。We don't test containers with OpenShift, but generally, Cognitive Services containers should run on any platform that support Docker images. 如果你使用 OpenShift,建议以 root-user 身份运行容器。If you're using OpenShift, we recommend running the containers as root-user.

问:如何提供产品反馈和功能建议?Q: How do I provide product feedback and feature recommendations?

答: 我们鼓励客户公开 表达其关注的问题,并在可能有问题重叠时投票赞同其他人提出的问题。A: Customers are encouraged to voice their concerns publicly, and up-vote others who have done the same where potential issues overlap. 用户语音工具可用于产品反馈和功能建议。The user voice tool can be used for both product feedback and feature recommendations.

问:认知服务容器返回了哪些状态消息和错误?Q: What status messages and errors are returned by Cognitive Services containers?

答: 有关状态消息和错误的列表,请参阅下表。A: See the following table for a list of status messages and errors.

状态Status 说明Description
Valid API 密钥有效,无需执行任何操作。Your API key is valid, no action is needed.
Invalid API 密钥无效。Your API key is invalid. 必须提供有效的 API 密钥才能运行容器。You must provide an valid API key to run the container. 在 Azure 门户的 Azure 认知服务资源的“密钥和终结点”部分找到你的 API 密钥和服务区域。Find your API key and service region in the Keys and Endpoint section for your Azure Cognitive Services resource, in the Azure portal.
Mismatch 你已为不同种类的认知服务资源提供了 API 密钥或终结点。You have provided an API Key or endpoint for a different kind of cognitive services resource. 在 Azure 认知服务资源的“密钥和终结点”部分找到你的 API 密钥和服务区域。Find your API key and service region in the Keys and Endpoint section for your Azure Cognitive Services resource.
CouldNotConnect 容器无法连接到计费终结点。The container couldn't connect to the billing endpoint. 请检查 Retry-After 值并等待此时间段结束,然后再发出其他请求。Check the Retry-After value and wait for this period to end before making additional requests.
OutOfQuota API 密钥超出配额。The API key is out of quota. 可以升级定价层,或者等待其他配额可用。You can either upgrade your pricing tier, or wait for additional quota to be made available. 在 Azure 门户的 Azure 认知服务资源的“定价层”部分找到你的层级。Find your tier in the Pricing Tier section of your Azure Cognitive Service resource, in the Azure portal.
BillingEndpointBusy 计费终结点当前正忙。The billing endpoint is currently busy. 请检查 Retry-After 值并等待此时间段结束,然后再发出其他请求。Check the Retry-After value and wait for this period to end before making additional requests.
ContainerUseUnauthorized 提供的 API 密钥无权用于此容器。The API key provided is not authorized for use with this container. 你可能使用的是门控式容器,因此请确保 Azure 订阅 ID 已在你提交在线请求后获得批准。You are likely using a gated container, so make sure your Azure Subscription ID is approved by submitting an online request.
Unknown 服务器当前无法处理帐单请求。The server is currently unable to process billing requests.

问:如何联系支持人员?Q: Who do I contact for support?

答: 客户支持渠道与认知服务云产品/服务相同。A: Customer support channels are the same as the Cognitive Services cloud offering. 所有认知服务容器包括日志记录功能,可帮助我们和社区为客户提供支持。All Cognitive Services containers include logging features that will help us and the community support customers. 如需其他支持,请查看以下选项。For additional support, see the following options.

客户支持计划Customer support plan

客户应参考其 Azure 支持计划来确定要向谁请求支持。Customers should refer to their Azure support plan to see who to contact for support.

Azure 知识中心Azure knowledge center

客户可以任意浏览 Azure 知识中心以解答问题和帮助解决问题。Customer are free to explore the Azure knowledge center to answer questions and support issues.

Stack OverflowStack Overflow

Stack Overflow 是面向专业和发烧级程序员的问答站点。Stack Overflow is a question and answer site for professional and enthusiast programmers.

如果遇到潜在问题并想要获得满意的解答,请浏览以下标记。Explore the following tags for potential questions and answers that align with your needs.

问:如何计费?Q: How does billing work?

答: 类似于认知服务云,客户按消耗量付费。A: Customers are charged based on consumption, similar to the Cognitive Services cloud. 容器需配置为向 Azure 发送计量数据,因此会相应地收取事务费。The containers need to be configured to send metering data to Azure, and transactions will be billed accordingly. 跨托管服务和本地服务使用的资源将按分层定价计入到单个配额,并且会同时计入到这两个服务的用量。Resources used across the hosted and on-premises services will add to single quota with tiered pricing, counting against both usages. 有关更多详细信息,请参阅相应产品/服务的定价页。For more detail, refer to pricing page of the corresponding offering.

重要

如果未连接到 Azure 进行计量,则无法授权并运行认知服务容器。Cognitive Services containers are not licensed to run without being connected to Azure for metering. 客户需要始终让容器向计量服务传送账单信息。Customers need to enable the containers to communicate billing information with the metering service at all times. 认知服务容器不会将客户数据发送给 Microsoft。Cognitive Services containers do not send customer data to Microsoft.

问:容器的当前支持担保是什么?Q: What is the current support warranty for containers?

答: 预览版不提供任何担证。A: There is no warranty for previews. 在正式宣布推出容器的正式版 (GA) 后,将实施 Microsoft 面向企业软件的标准担保。Microsoft's standard warranty for enterprise software will apply when containers are formally announced as general availability (GA).

问:断开 Internet 连接时,认知服务容器会发生什么情况?Q: What happens to Cognitive Services containers when internet connectivity is lost?

答: 如果未连接到 Azure 进行计量,则无法授权并运行认知服务容器。A: Cognitive Services containers are not licensed to run without being connected to Azure for metering. 客户需使容器始终能够与计量服务通信。Customers need to enable the containers to communicate with the metering service at all times.

问:在未连接到 Azure 的情况下,容器可以运行多长时间?Q: How long can the container operate without being connected to Azure?

答: 如果未连接到 Azure 进行计量,则无法授权并运行认知服务容器。A: Cognitive Services containers are not licensed to run without being connected to Azure for metering. 客户需使容器始终能够与计量服务通信。Customers need to enable the containers to communicate with the metering service at all times.

问:当前需要哪些硬件才能运行这些容器?Q: What is current hardware required to run these containers?

答: 认知服务容器是基于 x64 的容器,可运行任何兼容的 Linux 节点、VM,以及支持 x64 Linux Docker 容器的边缘设备。A: Cognitive Services containers are x64 based containers that can run any compatible Linux node, VM, and edge device that supports x64 Linux Docker Containers. 这些设备都需要 CPU 处理器。They all require CPU processors. 下面提供了每个容器产品/服务的最低和推荐配置:The minimum and recommended configurations for each container offering are available below:

问:Windows 当前是否支持这些容器?Q: Are these containers currently supported on Windows?

答: 认知服务容器属于 Linux 容器,但 Windows 对 Linux 容器提供一定的支持。A: The Cognitive Services containers are Linux containers, however there is some support for Linux containers on Windows. 有关 Windows 上的 Linux 容器的详细信息,请参阅 Docker 文档For more information about Linux containers on Windows, see Docker documentation.

问:如何发现容器?Q: How do I discover the containers?

答: 认知服务容器在各个位置均可用,例如 Azure 门户、Docker Hub 和 Azure 容器注册表。A: Cognitive Services containers are available in various locations, such as the Azure portal, Docker hub, and Azure container registries. 有关最新的容器位置,请参阅容器映像For the most recent container locations, refer to container images.

问:认知服务容器与 AWS 和 Google 产品/服务有何不同?Q: How does Cognitive Services containers compare to AWS and Google offerings?

答: Microsoft 是第一家将预先训练的 AI 模型移入容器并采用简单的按事务计费的云提供商,在体验中客户如同使用云服务一样。A: Microsoft is first cloud provider to move their pre-trained AI models in containers with simple billing per transaction as though customers are using a cloud service. Microsoft 相信混合云能够为客户提供更多的选择。Microsoft believes a hybrid cloud gives customers more choice.

问:容器已获得哪些合规认证?Q: What compliance certifications do containers have?

答: 认知服务容器未获得任何合规认证A: Cognitive services containers do not have any compliance certifications

问:可在哪些区域使用认知服务容器?Q: What regions are Cognitive Services containers available in?

答: 可在任何区域的任何位置运行容器,但是,容器需要一个密钥,并需要接回 Azure 以进行计量。A: Containers can be run anywhere in any region however they need a key and to call back to Azure for metering. 云服务支持的所有区域也受访问计量的容器的支持。All supported regions for the Cloud Service are supported for the containers metering call.

后续步骤Next steps

让我们继续使用 Azure 认知服务容器。Let's continue working with Azure Cognitive Services containers.

使用更多认知服务容器Use more Cognitive Services Containers