4 mins read
AICC03 – Identify endpoints and keys
When you provision an Azure AI services service resource in your Azure subscription, you are defining an endpoint through which the service can be consumed by an application.
Khi bạn cung cấp (provision) một tài nguyên dịch vụ AI của Azure (an Azure AI services service resource) trong đăng ký Azure của mình (your Azure subscription), bạn đang xác định một điểm cuối (are defining an endpoint) mà thông qua đó dịch vụ có thể được sử dụng bởi một ứng dụng (can be consumed by an application).
To consume the service through the endpoint, applications require the following information:
- The endpoint URI. This is the HTTP address at which the REST interface for the service can be accessed. Most AI services software development kits (SDKs) use the endpoint URI to initiate a connection to the endpoint.
- A subscription key. Access to the endpoint is restricted based on a subscription key. Client applications must provide a valid key to consume the service. When you provision an AI services resource, two keys are created – applications can use either key. You can also regenerate the keys as required to control access to your resource.
- The resource location. When you provision a resource in Azure, you generally assign it to a location, which determines the Azure data center in which the resource is defined. While most SDKs use the endpoint URI to connect to the service, some require the location.
Để sử dụng dịch vụ (consume the service) thông qua điểm cuối, các ứng dụng cần thông tin sau:
- Địa chỉ URI của điểm cuối (The endpoint URI): Đây là địa chỉ HTTP (the HTTP address) mà giao diện REST (the REST interface) của dịch vụ có thể được truy cập (can be accessed). Hầu hết các bộ phát triển phần mềm (AI services software development kits)(SDK) của dịch vụ AI đều sử dụng URI của điểm cuối (the endpoint URI) để khởi tạo kết nối đến (to initiate a connection to) điểm cuối (the endpoint).
- Khóa đăng ký (A subscription key): Truy cập vào điểm cuối được hạn chế dựa trên (is restricted based on) một khóa đăng ký (a subscription key). Các ứng dụng khách (Client applications) phải cung cấp một khóa hợp lệ (must provide a valid key) để sử dụng dịch vụ (to consume the service). Khi bạn cung cấp một tài nguyên dịch vụ AI (provision an AI services resource), hai khóa (two keys ) được tạo ra – các ứng dụng có thể sử dụng bất kỳ khóa nào trong hai khóa này (can use either key). Bạn cũng có thể tạo lại các khóa (regenerate the keys) khi cần (as required) để kiểm soát truy cập vào tài nguyên của mình (to control access to your resource).
- Vị trí của tài nguyên (The resource location): Khi bạn cung cấp một tài nguyên (provision a resource) trong Azure, bạn thường gán nó vào một vị trí (generally assign it to a location), vị trí này xác định trung tâm dữ liệu Azure (determines the Azure data center) nơi tài nguyên được xác định (the resource is defined). Mặc dù hầu hết các SDK sử dụng URI của điểm cuối để kết nối đến dịch vụ (use the endpoint URI to connect to the service), một số SDK yêu cầu vị trí (some require the location).