Condividi tramite


Documentazione di riferimento per gli sviluppatori di API di Learn Platform

Questo articolo fornisce informazioni per sviluppatori e integratori che implementano l'API della piattaforma Microsoft Learn. È anche consigliabile consultare gli articoli Panoramica dell'API Learn Platform, note sulla versione e domande frequenti per supportare il percorso di sviluppo.

Endpoint API

Gli endpoint del catalogo API della piattaforma Microsoft Learn sono un set di API Web basate su REST autenticate che restituiscono una risposta con codifica JSON.

Gli endpoint sono accessibili all'indirizzo:

https://learn.microsoft.com/api/v1

Annotazioni

Se si usa un endpoint diverso e meno recente, funzionerà comunque come previsto fino a giugno 2026, a quel punto l'API catalogo non autenticata precedente inizierà la deprecazione. Per altre domande, contattare LearnPlatformAPIMigration@microsoft.com.

Casi d'uso

Authentication

Le API REST della piattaforma Learn usano l'ID Entra Microsoft per l'autenticazione. Prima di effettuare chiamate API, è necessario scegliere un metodo di accesso e l'applicazione client deve eseguire l'autenticazione con credenziali valide.

Accesso solo tramite app

Quando l'app accede direttamente a Learn, l'accesso non è associato a un singolo utente. L'app utilizza le API direttamente usando la propria identità; questo scenario è l'accesso esclusivamente per app. Altre informazioni su Microsoft Identity Platform.

Per iniziare, è necessaria un'identità valida in Microsoft Identity Platform, che può essere una registrazione dell'app o un'identità gestita. Idealmente, ogni partner deve avere una singola identità per semplificare la gestione delle quote e dei partner. L'uso di un'identità gestita assegnata dall'utente consente di unificare le identità gestite tra servizi diversi.

Dopo aver configurato l'identità dell'ID Entra, ottenere un token di accesso dall'ID Entra con ambito impostato su https://learn.microsoft.com/.default come prova dell'autenticazione. Includere il token di accesso nell'intestazione autorizzazione HTTP quando si effettuano richieste API REST a Learn.

Accesso delegato

Quando un utente accede all'app e lo usa per accedere a Learn, l'app dovrà prima chiedere l'autorizzazione per accedere a questa risorsa per conto dell'utente. Questo scenario è denominato accesso delegato. Altre informazioni su Microsoft Identity Platform.

Per iniziare, è necessario registrare una registrazione dell'app. Dopo aver configurato la registrazione dell'app, l'app deve chiedere all'utente di concedere un ambito specifico o di un set di ambiti per accedere a Learn per conto dell'utente. Learn fornisce un elenco di ambiti per l'accesso alle risorse con granularità fine. L'elenco di scopi include:

  • https://learn.microsoft.com/PublicContent.Read.All: questo ambito consente agli utenti di accedere al contenuto pubblico su Learn impersonando l'utente connesso.

Parametri di query

Di seguito sono riportati i parametri di query che la richiesta può includere. È necessaria solo la versione api e la versione corrente è 2023-11-01-preview. È necessario codificare i valori dei parametri di query nel formato URL. È possibile usare l'endpoint con uno, alcuni o tutti questi parametri.

Importante

Se si usa più di un elemento, la query viene valutata usando l'operatore AND, mentre i valori delimitati da virgole in un filtro sono combinati in base all'operatore OR.

Nome Value TIPO Obbligatorio Example
api-version La versione dell'API viene specificata come parametro di query api-version e usa aaaa-MM-gg per le versioni stabili e aaaa-MM-dd-preview per le versioni di anteprima. Il parametro di query api-version è obbligatorio per ogni richiesta API. string Yes ?api-version=2023-11-01-preview
locale Singolo codice delle impostazioni locali valido dall'elenco di impostazioni locali supportate. I metadati restituiti saranno nelle impostazioni locali richieste, se disponibili. Se questo parametro non viene specificato, la en-us risposta verrà restituita. string NO ?locale=en-us
id Elenco delimitato da virgole di uno o più ID di contenuto (uid) univoci validi derivanti dai tipi di contenuto disponibili. Nota: gli UID fanno distinzione tra maiuscole e minuscole. string NO ?uid=learn.azure.intro-to-azure-fundamentals
updatedAt.gt Operatore e datetime per filtrare in base all'ultima data di modifica degli oggetti. L'operatore include gt (maggiore di), gte (maggiore o uguale a). Quando si usa questo parametro, se non diversamente specificato, verrà usato l'operatore predefinito gt. string NO ?updatedAt.gt=2022-01-01
levels Elenco delimitato da virgole di uno o più livelli attualmente disponibili (l'elenco completo è incluso nell'oggetto livelli della risposta API). string NO ?levels=beginner
roles Elenco delimitato da virgole di uno o più ruoli attualmente disponibili (l'elenco completo è incluso nell'oggetto ruoli della risposta api). string NO ?roles=developer
products Elenco delimitato da virgole di uno o più ruoli attualmente disponibili (l'elenco completo è incluso nell'oggetto products della risposta API). L'API non supporta la gerarchia dei prodotti, quindi aggiungere ogni prodotto all'elenco che si vuole includere nella query. string NO ?products=azure
subjects Elenco delimitato da virgole di uno o più ruoli attualmente disponibili (l'elenco completo è incluso nell'oggetto oggetto della risposta API). L'API non supporta la gerarchia dei soggetti, quindi aggiungere ogni oggetto all'elenco da includere nella query. string NO ?subjects=cloud-computing
maxpagesize Numero massimo di risorse da includere in una singola risposta. Il valore predefinito è 30. Il valore massimo consentito è 100. string NO ?maxpagesize=50

Risposta dell'API

Il servizio può restituire i codici di stato HTTP seguenti.

Codice di stato Description
200 Successo. Il corpo della risposta include i dati con codifica JSON.
400 Uno dei parametri di query manca o non è valido.
401 Query non autorizzata.
404 L'URL non è stato trovato nel server.
429 La richiesta ha subito una limitazione di frequenza.
500 Errore server imprevisto.
503 Il servizio è temporaneamente non disponibile.

Una risposta con esito positivo includerà i dettagli per ogni endpoint, come illustrato di seguito.

Corpo della risposta

Risposta del modulo

Record del modulo

Ogni record di modulo avrà il formato seguente:

{
  "type": "module",
  "id": "learn.wwl.fundamentals-generative-ai",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/",
  "locale": "en-us",
  "title": "Introduction to generative AI and agents",
  "durationInMinutes": 37,
  "summary": "Ever wondered how AI can create content, answer questions, and assist with tasks? This module introduces you to the world of generative AI and agents.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/fundamentals-generative-ai.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "units": [
    {
      "id": "learn.wwl.fundamentals-generative-ai.introduction"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.language-models"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.writing-prompts"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.agents"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.exercise-ai-agent"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.knowledge-check"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai.summary"
    }
  ],
  "updatedAt": "2025-12-23T00:20:00.0000000Z"
}

Dettagli proprietà

Proprietà TIPO Obbligatorio Description
type enum Yes Discriminatore di tipo. Consentito: module.
id string Yes Identificatore di modulo univoco globale.
url uri Yes URL completo del modulo nella localizzazione richiesta.
locale string Yes Impostazioni locali del contenuto del modulo. L'impostazione predefinita è en-us se le impostazioni locali richieste non sono disponibili.
title string Yes Titolo del modulo localizzato.
durationInMinutes integer Yes Tempo medio di completamento del modulo in minuti.
summary string Yes Breve descrizione del modulo.
iconUrl uri Yes URL di un'icona modulo SVG 100×100 trasparente.
levels Level[] Yes Livelli di esperienza associati a questo modulo.
roles Role[] Yes Ruoli pertinenti.
products Product[] Yes Classificazioni di prodotti pertinenti.
subjects Subject[] Yes Classificazioni dei soggetti pertinenti.
units UnitReference[] Yes Unità di apprendimento associate.
updatedAt date-time Yes Timestamp dell'ultimo aggiornamento (potrebbe non cambiare nelle modifiche secondarie).

Registri delle unità

Ogni record di unità avrà il formato seguente:

{ 
"type": "unit",
  "id": "learn.wwl.fundamentals-generative-ai.agents",
  "url": "https://learn.microsoft.com/training/modules/fundamentals-generative-ai/7-agents/",
  "locale": "en-us",
  "title": "AI agents",
  "durationInMinutes": 5,
  "updatedAt": "2025-10-06T17:09:00.0000000Z"
},

Dettagli proprietà

Proprietà TIPO Obbligatorio Description
type enum Yes Discriminatore di tipo. Consentito: unit.
id string Yes Identificatore univoco per questa unità in Microsoft Learn.
url uri Yes URL completo dell'unità nelle impostazioni locali richieste.
locale string Yes Impostazioni locali dell'unità; esegue il fallback a en-us se le impostazioni locali richieste non sono disponibili.
title string Yes Titolo unità localizzata (lingua predefinita: inglese USA).
durationInMinutes integer Yes Tempo medio di completamento in minuti.
updatedAt date-time Yes Timestamp ultimo aggiornamento; può rimanere invariato per modifiche secondarie.

Record del percorso di apprendimento

Ogni record del percorso di apprendimento avrà il formato seguente:

{
  "type": "learningPath",
  "id": "learn.introduction-ai-azure",
  "url": "https://learn.microsoft.com/training/paths/introduction-to-ai-on-azure/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "durationInMinutes": 669,
  "summary": "This course introduces core concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions, focusing on Microsoft Foundry.",
  "iconUrl": "https://learn.microsoft.com/training/achievements/document-intelligence-knowledge-mining.svg",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "solution-architect",
      "name": "Solution Architect"
    },
    {
      "id": "student",
      "name": "Student"
    }
  ],
  "products": [
    {
      "id": "azure-ai-foundry",
      "name": "Azure AI Foundry"
    }
  ],
  "subjects": [
    {
      "id": "artificial-intelligence",
      "name": "Artificial intelligence"
    }
  ],
  "modules": [
    {
      "id": "learn.wwl.get-started-ai-fundamentals"
    },
    {
      "id": "learn.wwl.get-started-ai-in-foundry"
    },
    {
      "id": "learn.wwl.fundamentals-machine-learning"
    },
    {
      "id": "learn.wwl.design-machine-learning-model-training-solution"
    },
    {
      "id": "learn.wwl.fundamentals-generative-ai"
    },
    {
      "id": "learn.wwl.get-started-generative-ai-azure"
    },
    {
      "id": "learn.wwl.introduction-language"
    },
    {
      "id": "learn.wwl.get-started-language-azure"
    },
    {
      "id": "learn.wwl.introduction-ai-speech"
    },
    {
      "id": "learn.wwl.recognize-synthesize-speech"
    },
    {
      "id": "learn.wwl.introduction-computer-vision"
    },
    {
      "id": "learn.wwl.get-started-computer-vision"
    },
    {
      "id": "learn.wwl.introduction-information-extraction"
    },
    {
      "id": "learn.wwl.ai-information-extraction"
    }
  ],
  "updatedAt": "2025-12-12T00:08:00.0000000Z"
}

Dettagli proprietà

Proprietà TIPO Obbligatorio Description
type enum Yes Discriminatore di tipo. Consentito: learningPath.
id string Yes Identificatore univoco per questo percorso di apprendimento in Microsoft Learn.
url uri Yes URL completo per il modulo di apprendimento nelle impostazioni locali richieste.
locale string Yes Il percorso di apprendimento è scritto nelle impostazioni locali; torna a en-us se le impostazioni locali richieste non sono disponibili.
title string Yes Titolo del percorso di apprendimento localizzato.
durationInMinutes integer Yes Tempo medio di completamento per il percorso di apprendimento in minuti.
summary string Yes Breve descrizione del percorso di apprendimento.
iconUrl uri Yes URL di un'icona SVG 100×100 che rappresenta il percorso di apprendimento.
levels Level[] Yes Livelli di esperienza associati al percorso di apprendimento.
roles Role[] Yes Ruoli pertinenti.
products Product[] Yes Classificazioni di prodotti pertinenti.
subjects Subject[] Yes Classificazioni dei soggetti pertinenti.
modules ModuleReference[] Yes Riferimenti ai moduli associati.
updatedAt date-time Yes Timestamp ultimo aggiornamento; può rimanere invariato per modifiche secondarie.

Registrazioni delle competenze applicate

Ogni record Di competenze applicate avrà il formato seguente:

{
  "type": "appliedSkills",
  "id": "applied-skill.deploy-and-configure-azure-monitor",
  "locale": "en-us",
  "title": "Microsoft Applied Skills: Deploy and configure Azure Monitor",
  "summary": "<p>To earn this Microsoft Applied Skills credential, learners demonstrate the ability to deploy and configure monitoring for Azure infrastructure.</p>\n<p>Candidates for this assessment lab should be familiar with operating systems, networking, servers, and virtualization.</p>\n",
  "iconUrl": "https://learn.microsoft.com/",
  "url": "https://learn.microsoft.com/credentials/applied-skills/deploy-and-configure-azure-monitor/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "administrator",
      "name": "Administrator"
    }
  ],
  "products": [
    {
      "id": "azure-monitor",
      "name": "Azure Monitor"
    },
    {
      "id": "azure-virtual-machines",
      "name": "Azure Virtual Machines"
    },
    {
      "id": "azure-virtual-network",
      "name": "Azure Virtual Network"
    },
    {
      "id": "windows-server",
      "name": "Windows Server"
    }
  ],
  "subjects": [
    {
      "id": "it-management-monitoring",
      "name": "IT management and monitoring"
    }
  ],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

Dettagli proprietà

Proprietà TIPO Obbligatorio Description
type enum Yes Discriminatore di tipo. Consentito: appliedSkills.
id string Yes Identificatore univoco per questa competenza applicata in Microsoft Learn.
locale string Yes Impostazioni locali in cui è scritta la competenza applicata; si utilizza en-us se le impostazioni locali richieste non sono disponibili.
title string Yes Titolo della competenza applicata localizzato.
summary string Yes Breve descrizione della competenza applicata.
iconUrl uri Yes URL di un'icona SVG 100×100 che rappresenta la competenza applicata.
url uri Yes URL completo della competenza applicata nelle impostazioni locali richieste.
levels Level[] Yes Livelli di esperienza associati a questa competenza applicata.
roles Role[] Yes Ruoli pertinenti.
products Product[] Yes Classificazioni di prodotti pertinenti.
subjects Subject[] Yes Classificazioni dei soggetti pertinenti.
updatedAt date-time Yes Timestamp ultimo aggiornamento; può rimanere invariato per gli aggiornamenti secondari.

Record di certificazione

Ogni record di certificazione avrà il formato seguente:

{
  "type": "certification",
  "id": "certification.d365-functional-consultant-customer-service",
  "locale": "en-us",
  "title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate (Legacy with Power Platform)",
  "subtitle": "<p>If you’re a functional consultant responsible for configuring and implementing Dynamics 365 solutions for customers, you can use this certification to shine a light on your skills and to help advance your career. A Dynamics 365 Customer Service functional consultant implements omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction. As a functional consultant, you know how to work with project managers, developers, and solution architects. You need a minimum of one to three years of experience as a functional consultant implementing Dynamics 365.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Work as a Dynamics 365 functional consultant on one or more projects.</li>\n<li>Work on a Dynamics 365 Customer Service implementation.</li>\n<li>Join the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>.</li>\n<li>Take available learning paths on <a href=\"/training/browse/?expanded=dynamics-365&amp;products=dynamics-customer-service&amp;roles=functional-consultant&amp;resource_type=learning%20path\">Microsoft Learn</a>.</li>\n<li>Complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course.</li>\n</ul>\n<div class=\"WARNING\">\n<p>Warning</p>\n<p>This version of the certification is no longer available. <a href=\"https://techcommunity.microsoft.com/t5/microsoft-learn-blog/new-exam-structure-for-dynamics-365-certifications-for-customer/ba-p/3500861\">Read this blog post for more information about this change</a>.</p>\n</div>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/d365-functional-consultant-customer-service-legacy-with-power-platform/",
  "levels": [
    {
      "id": "intermediate",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-analyst",
      "name": "Business Analyst"
    },
    {
      "id": "developer",
      "name": "Developer"
    },
    {
      "id": "functional-consultant",
      "name": "Functional Consultant"
    }
  ],
  "products": [
    {
      "id": "power-apps",
      "name": "Power Apps"
    },
    {
      "id": "power-bi",
      "name": "Power BI"
    },
    {
      "id": "power-automate",
      "name": "Power Automate"
    },
    {
      "id": "dataverse",
      "name": "Microsoft Dataverse"
    },
    {
      "id": "ai-builder",
      "name": "AI Builder"
    },
    {
      "id": "power-platform",
      "name": "Microsoft Power Platform"
    },
    {
      "id": "office-teams",
      "name": "Microsoft Teams"
    },
    {
      "id": "microsoft-copilot-studio",
      "name": "Microsoft Copilot Studio"
    },
    {
      "id": "dynamics-365",
      "name": "Dynamics 365"
    },
    {
      "id": "dynamics-customer-service",
      "name": "Customer Service"
    }
  ],
  "subjects": [],
  "certificationType": {
    "id": "role-based",
    "name": "role-based"
  },
  "renewalFrequencyInDays": 0,
  "prerequisites": [],
  "exams": [
    {
      "id": "exam.mb-230"
    }
  ],
  "updatedAt": "2024-10-08T15:40:00.0000000Z"
}

Dettagli proprietà

Proprietà TIPO Obbligatorio Description
type enum Yes Discriminatore di tipo. Consentito: certification.
id string Yes Identificatore univoco per questa certificazione in Microsoft Learn.
locale string Yes Impostazioni locali in cui è scritta la certificazione; si utilizza en-us se le impostazioni locali richieste non sono disponibili.
title string Yes Titolo della certificazione localizzata.
subtitle string Yes Sottotitolo della certificazione localizzata.
iconUrl uri Yes URL di un'icona SVG 100×100 che rappresenta la certificazione.
url uri Yes URL completo della certificazione nel locale richiesto.
levels Level[] Yes Livelli di esperienza associati a questa certificazione.
roles Role[] Yes Ruoli pertinenti.
products Product[] Yes Classificazioni di prodotti pertinenti.
subjects Subject[] Yes Classificazioni dei soggetti pertinenti.
certificationType Taxonomy Yes Classificazione che rappresenta il tipo di certificazione.
renewalFrequencyInDays integer Yes Numero di giorni prima della scadenza della certificazione; 0 significa che non scade.
prerequisites string[] Yes Elenco dei prerequisiti consigliati per ottenere questa certificazione.
exams ExamReference[] Yes Esami associati necessari per questa certificazione.
updatedAt date-time Yes Timestamp dell'ultimo aggiornamento; può rimanere invariato per modifiche secondarie.

Registri degli esami

Ogni record di esame avrà il formato seguente:

{
  "type": "exam",
  "id": "exam.77-881",
  "locale": "en-us",
  "title": "Word 2010",
  "subtitle": "The core-level Microsoft Office Word 2010 user should be able to navigate Microsoft Office Word 2010 software at the feature and functional level. They should be familiar with and know how to use at least 80 percent of the features and capabilities of Microsoft Office Word 2010. The core-level user should be able to use Microsoft Office Word 2010 to create and edit professional-looking documents for a variety of purposes and situations. Users would include people from a wide variety of job roles from almost all areas of professional, student, and personal life.",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
  "url": "https://learn.microsoft.com/credentials/certifications/exams/77-881/",
  "levels": [
    {
      "id": "beginner",
      "name": ""
    }
  ],
  "roles": [
    {
      "id": "business-user",
      "name": "Business User"
    }
  ],
  "products": [
    {
      "id": "office-word",
      "name": "Word"
    }
  ],
  "locales": [],
  "examNumber": "77-881",
  "pdfUrl": "https://learn.microsoft.comhttps//query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
  "practiceAssessmentUrl": "https://learn.microsoft.com/",
  "providers": [],
  "courses": [],
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
}

Dettagli proprietà

Proprietà TIPO Obbligatorio Description
type enum Yes Discriminatore di tipo. Consentito: exam.
id string Yes Identificatore univoco per questo esame in Microsoft Learn.
locale string Yes Impostazioni locali utilizzate per l'esame; si utilizza en-us se le impostazioni locali richieste non sono disponibili.
title string Yes Titolo dell'esame localizzato.
subtitle string Yes Sottotitolo dell'esame localizzato.
iconUrl uri Yes URL di un'icona SVG 100×100 che rappresenta l'esame.
url uri Yes URL completamente qualificato per l'esame nella località richiesta.
levels Level[] Yes Livelli di esperienza associati a questo esame.
roles Role[] Yes Ruoli pertinenti.
products Product[] Yes Classificazioni di prodotti pertinenti.
locales Locale[] Yes Lingue in cui viene ufficialmente offerto l'esame.
examNumber string Yes Identificatore del numero di esame.
pdfUrl uri NO URL del PDF "Skills Measured" per questo esame.
practiceAssessmentUrl uri NO URL di una valutazione pratica gratuita per l'esame.
providers Provider[] NO I fornitori che offrono questo esame.
courses Course[] NO Corsi con docente associati a questo esame.
studyGuide StudyGuideRef[] NO Contenuto della guida di studio associata (riferimenti polimorfici).
updatedAt date-time Yes Timestamp ultimo aggiornamento; può rimanere invariato per modifiche secondarie.

Record dei corsi con docente

Ogni record di corso avrà il formato seguente:

{
  "type": "course",
  "id": "course.ai-900t00",
  "url": "https://learn.microsoft.com/training/courses/ai-900t00/",
  "locale": "en-us",
  "title": "Introduction to AI in Azure",
  "summary": "<p>This course introduces fundamentals concepts related to artificial intelligence (AI), and the services in Microsoft Azure that can be used to create AI solutions. The course is not designed to teach students to become professional data scientists or software developers, but rather to build awareness of common AI workloads and the ability to identify Azure services to support them. The course is designed as a blended learning experience that combines instructor-led training with online materials on the Microsoft Learn platform (<a href=\"https://azure.com/learn\">https://azure.com/learn</a>). The hands-on exercises in the course are based on Learn modules, and students are encouraged to use the content on Learn as reference materials to reinforce what they learn in the class and to explore topics in more depth.</p>\n<h4 id=\"audience-profile\">Audience Profile</h4>\n<p>The Introduction to AI in Azure course is designed for anyone interested in learning about the types of solution artificial intelligence (AI) makes possible, and the services on Microsoft Azure that you can use to create them. You don’t need to have any experience of using Microsoft Azure before taking this course, but a basic level of familiarity with computer technology and the Internet is assumed. Some of the concepts covered in the course require a basic understanding of mathematics, such as the ability to interpret charts. The course includes hands-on activities that involve working with data and running code, so a knowledge of fundamental programming principles will be helpful.</p>\n",
  "iconUrl": "https://learn.microsoft.com/media/learn/certification/course.svg",
  "courseNumber": "AI-900T00",
  "durationInHours": 24,
  "locales": [
    {
      "id": "en",
      "name": "en"
    },
    {
      "id": "ar",
      "name": "ar"
    },
    {
      "id": "zh-cn",
      "name": "zh-cn"
    },
    {
      "id": "zh-tw",
      "name": "zh-tw"
    },
    {
      "id": "fr",
      "name": "fr"
    },
    {
      "id": "de",
      "name": "de"
    },
    {
      "id": "id",
      "name": "id"
    },
    {
      "id": "it",
      "name": "it"
    },
    {
      "id": "ja",
      "name": "ja"
    },
    {
      "id": "ko",
      "name": "ko"
    },
    {
      "id": "pt-br",
      "name": "pt-br"
    },
    {
      "id": "ru",
      "name": "ru"
    },
    {
      "id": "es",
      "name": "es"
    }
  ],
  "levels": [],
  "roles": [
    {
      "id": "ai-engineer",
      "name": "AI Engineer"
    }
  ],
  "products": [
    {
      "id": "azure",
      "name": "Azure"
    }
  ],
  "certification": {
    "id": "certification.azure-ai-fundamentals"
  },
  "studyGuide": [],
  "updatedAt": "2026-02-06T00:10:57.0000000Z"
},

Dettagli proprietà

Proprietà TIPO Obbligatorio Description
type enum Yes Discriminatore di tipo. Consentito: course.
id string Yes Identificatore univoco per questo corso in Microsoft Learn.
url uri Yes URL completo del corso nella lingua locale richiesta.
locale string Yes Impostazioni locali utilizzate per il corso; si utilizza en-us se le impostazioni locali richieste non sono disponibili.
title string Yes Titolo del corso localizzato.
summary string Yes Breve descrizione del corso.
iconUrl uri Yes URL di un'icona SVG 100×100 che rappresenta il corso.
courseNumber string Yes Numero di corso tenuto da istruttore.
durationInHours integer Yes Tempo medio per completare il corso (in ore).
locales Locale[] Yes Lingue in cui il corso è ufficialmente offerto; altri linguaggi possono essere supportati dai partner.
levels Level[] Yes Livelli di esperienza associati a questo corso.
roles Role[] Yes Ruoli pertinenti.
products Product[] Yes Classificazioni di prodotti pertinenti.
exam ExamRef NO Esame associato per questo corso.
certification CertRef NO Certificazione associata per questo corso.
studyGuide StudyGuideRef[] NO Materiali di studio correlati (riferimenti polimorfici).
updatedAt date-time Yes Timestamp ultimo aggiornamento; può rimanere invariato per gli aggiornamenti secondari.

Record di livelli, prodotti, ruoli e soggetti

Le levelsraccolte , products, rolese subjects forniscono nomi descrittivi per i valori usati nei dati del modulo e del percorso di apprendimento. Tutte e quattro le raccolte hanno la stessa forma:

{ 
    "id": "unique-id",
    "name": "name-of-item",
    "children": [
        { "id": "unique-id", "name": "name-of-item" },
        { "id": "unique-id", "name": "name-of-item" },
           ...
    ]
}

I valori del id corrisponderanno ai livelli, prodotti, ruoli e soggetti inclusi negli altri elementi del catalogo. Il valore name associato fornisce un nome appropriato in inglese per la voce. L'array children è facoltativo e abilita la gerarchia per i valori che hanno relazioni di tipo figlio, come i prodotti.

Di seguito è riportato un esempio di un set di ruoli possibili:

{
    ...
    "roles": [ 
        {
            "id": "administrator",
            "name": "Administrator"
        },
        {
            "id": "ai-engineer",
            "name": "AI Engineer"
        },
        {
            "id": "business-analyst",
            "name": "Business Analyst"
        },
        {
            "id": "developer",
            "name": "Developer"
        },
        ...
    ]
}

Ecco un set di prodotti di esempio, con elementi figlio inclusi per offrire una categoria di prodotti più specifica.

{ 
    ...
    "products": [
        {
            "id": "dotnet",
            "name": ".NET",
            "children": [
                { "id": "dotnet-core", "name": ".NET Core" },
                { "id": "dotnet-standard", "name": ".NET Standard" },
                { "id": "aspnet-core", "name": "ASP.NET Core" },
                { "id": "ef-core", "name": "Entity Framework Core" }
            ]
        },
        {
            "id": "ms-graph",
            "name": "Microsoft Graph"
        },
        {
            "id": "office",
            "name": "Office",
            "children": [
                { "id": "office-365", "name": "Office 365" },
                { "id": "office-add-ins", "name": "Office Add-ins" },
                { "id": "office-teams", "name": "Teams" }
            ]
        },
        {
            "id": "sql-server",
            "name": "SQL Server"
        },
        ...
    ]
}

Passaggi successivi

Esaminare le risorse seguenti per facilitare il percorso di sviluppo: