Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina ti guida nella procedura di configurazione per accedere alle API preaddestrate di Vertex AI all'interno dell'infrastruttura air-gap di Google Distributed Cloud (GDC), consentendoti di integrare le funzionalità di AI nella tua applicazione air-gap. Puoi trovare i dettagli sui prerequisiti e sui passaggi per attivare e disattivare le API Vertex AI tramite la console GDC.
Questa pagina è rivolta agli sviluppatori di applicazioni all'interno di gruppi di operatori di applicazioni responsabili dell'ottimizzazione di applicazioni air-gap con funzionalità di AI. Per saperne di più, consulta la documentazione relativa ai segmenti di pubblico per GDC air-gapped.
Vertex AI su Distributed Cloud include varie API che
devi abilitare dalla console GDC per consentire agli utenti della tua
organizzazione di interagire con modelli ML e funzionalità di AI. Per saperne di più su queste API, consulta la seguente documentazione:
Prima di iniziare, verifica di aver completato i seguenti passaggi preliminari:
Per configurare l'accesso alle API Vertex AI, devi disporre del ruolo AI Platform Admin (ai-platform-admin). Se non disponi già del ruolo, puoi contattare l'amministratore IAM dell'organizzazione o l'amministratore IAM del progetto per richiederlo. In alternativa, puoi chiedere all'amministratore di abilitare le API Vertex AI per tuo conto. Per informazioni su questo ruolo, consulta Preparare le autorizzazioni IAM.
Configura il Domain Name System (DNS) di GDC. Se non hai configurato il DNS, collabora con l'operatore dell'infrastruttura per completare questo prerequisito.
Se porti il tuo modello perché vuoi utilizzare
Online Prediction
o eseguire notebook di intelligenza artificiale (AI) e machine learning (ML) in un
ambiente GPU, assicurati di
allocare macchine GPU
per i tipi di cluster corretti.
Abilitare le API preaddestrate
Puoi abilitare le API e i modelli di servizio Vertex AI utilizzando la
console GDC.
L'avviso VAI-A0001 (Enabling State Time Limit Reached) viene attivato se
l'abilitazione dei servizi richiede molto tempo. In questo caso, il tuo IO deve esaminare il
runbook VAI-R0001 per i dettagli.
Disattivare le API preaddestrate
Puoi disattivare le API preaddestrate utilizzando la console GDC.
Nel menu di navigazione, fai clic su Vertex AI>API preaddestrate.
Nella pagina API pre-addestrate, fai clic su Disattiva in un servizio specifico per disattivare l'API.
Nella finestra di dialogo di conferma, inserisci disattiva nel campo di testo per confermare
che vuoi eseguire l'azione. Quindi, fai clic su Disattiva. Viene visualizzato un messaggio di avanzamento.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eThis page outlines how to provision GPU resources on a container for AI/ML workloads and enable Vertex AI pre-trained APIs on Google Distributed Cloud (GDC) air-gapped.\u003c/p\u003e\n"],["\u003cp\u003eAdministrator access is generally required to configure GPU resources and manage Vertex AI pre-trained APIs, so you may need to request these actions if lacking the necessary permissions.\u003c/p\u003e\n"],["\u003cp\u003eVertex AI on GDC offers pre-trained APIs for Optical Character Recognition (OCR), Speech-to-Text, and Translation, along with services like Online Prediction and Vertex AI Workbench.\u003c/p\u003e\n"],["\u003cp\u003eProvisioning GPUs involves setting up DNS, creating a GPU-supporting cluster, and configuring containers to utilize GPU resources.\u003c/p\u003e\n"],["\u003cp\u003eThe GDC console is used to enable, deactivate, and monitor the status of the OCR, Speech-to-Text, and Vertex AI Translation pre-trained APIs.\u003c/p\u003e\n"]]],[],null,["# Enable Vertex AI APIs\n\nThis page guides you through the setup process for accessing Vertex AI pre-trained APIs within the Google Distributed Cloud (GDC) air-gapped infrastructure, allowing you to integrate AI features into your air-gapped application. You can find details about the prerequisites and the steps for enabling and deactivating the Vertex AI APIs through the GDC console console.\n\nThis page is for application developers within application operator groups who are responsible for optimizing air-gapped applications with AI features. For more information, see [Audiences for GDC air-gapped documentation](/distributed-cloud/hosted/docs/latest/gdch/resources/audiences).\n\nVertex AI on Distributed Cloud includes various APIs that\nyou must enable from the GDC console to let users from your\norganization interact with ML models and AI capabilities. To learn more about\nthese APIs, see the following documentation:\n\n- **Generative AI** : [Learn about Generative AI capabilities and available models](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/genai/genai-overview).\n- **Online Prediction** : [Learn about online predictions](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-online-predictions).\n- **Optical Character Recognition (OCR)** : [Learn about character recognition features](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-ocr).\n- **Speech-to-Text** : [Learn about speech recognition features](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-stt).\n- **Vertex AI Translation** : [Learn about translation features](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-translation).\n- **Vertex AI Workbench** : [Learn about Vertex AI Workbench](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-workbench-intro).\n\nBefore you begin\n----------------\n\nBefore you begin, check that you've done the following prerequisite steps:\n\n1. You must have the AI Platform Admin (`ai-platform-admin`) role to set up access to the Vertex AI APIs. You can contact your Organization IAM Admin or Project IAM Admin to request the role if you don't already have it. Alternatively, you can ask your administrator to enable Vertex AI APIs on your behalf. For information about this role, see [Prepare IAM permissions](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-ao-permissions).\n2. Set up the GDC domain name system (DNS). If you haven't set up the DNS, work with your Infrastructure Operator (IO) to complete this prerequisite.\n3. [Set up a project to use Vertex AI](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-set-up-project).\n4. If you bring your own model because you want to use\n [Online Prediction](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-online-predictions)\n or run artificial intelligence (AI) and machine learning (ML) notebooks in a\n GPU environment, make sure to\n [allocate GPU machines](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/create-user-cluster#gpu)\n for the correct cluster types.\n\n | **Note:** Pre-trained APIs run on a shared service Kubernetes cluster managed by the infrastructure.\n\nEnable pre-trained APIs\n-----------------------\n\nYou can enable Vertex AI service APIs and models using the\nGDC console.\n\nAfter [meeting the prerequisites](#before-you-enable-apis), follow these steps\nto enable APIs:\n\n1. [Sign in to the GDC console](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/sign-in). If you can't sign in, see [Connect to an identity provider](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/connect-identity).\n2. In the navigation menu, click **Vertex AI** \\\u003e **Pre-trained APIs**.\n3. On the **Pre-trained APIs** page, click **Enable** on a specific service to\n enable that API.\n\n | **Note:** The GDC console doesn't display the buttons to enable the pre-trained APIs if you don't have the correct permissions.\n4. In the confirmation dialog, click **Enable**. A progress message displays.\n\nThe enablement duration varies. It might take between 15 and 45 minutes to\nfinish, depending on the state of the cluster.\n\nIf you want to view the status of the pre-trained APIs,\n[view the service status and endpoints](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-api-status).\n\nThe VAI-A0001 alert (`Enabling State Time Limit Reached`) triggers if the\nservices take a long time to be enabled. In this case, your IO must review the\nVAI-R0001 runbook for details.\n| **Note:** You can't enable an API while you wait for another API to finish deactivating.\n\nDeactivate pre-trained APIs\n---------------------------\n\nYou can deactivate pre-trained APIs using the GDC console.\n\nAfter [meeting the prerequisites](#before-you-enable-apis), follow these steps\nto deactivate APIs:\n\n1. [Sign in to the GDC console](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/iam/sign-in).\n2. In the navigation menu, click **Vertex AI** \\\u003e **Pre-trained APIs**.\n3. On the **Pre-trained APIs** page, click **Disable** on a specific service to\n deactivate that API.\n\n | **Note:** The GDC console doesn't display the buttons to deactivate the pre-trained APIs if you don't have the correct permissions.\n4. In the confirmation dialog, enter *disable* in the text field to confirm\n that you want to take that action. Then, click **Disable**. A progress\n message displays.\n\nIf you want to view the status of the pre-trained APIs,\n[view the service status and endpoints](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-api-status).\n| **Note:** You can't deactivate an API while you wait for another API to finish enabling."]]