Gestione diretta Gestione API API REST

  • Articolo

Azure Gestione API offre un'API REST di gestione diretta per l'esecuzione di operazioni su entità selezionate, ad esempio utenti, gruppi, prodotti e sottoscrizioni. L'API di gestione diretta può ignorare determinati limiti dell'API basata su Resource Manager di Azure, ad esempio la limitazione delle richieste.

Importante

Questa sezione descrive come accedere alla gestione diretta Gestione API'API REST. Questa API ha un meccanismo di autenticazione diverso da Quello di Azure Resource Manager e usa un URL di base diverso.

Abilitare l'accesso all'API REST di gestione diretta

È necessario concedere l'accesso alla gestione diretta Gestione API'API REST prima che le chiamate possano essere eseguite correttamente.

  1. Passare all'istanza di Azure Gestione API nel portale di Azure.

  2. Selezionare API di gestione nella sezione Distribuzione e infrastruttura del menu a sinistra.

    Selezionare API di gestione nel portale di Azure

  3. In Abilita api REST Gestione API selezionare Sì.

    Importante

    Se l'opzione Abilita Gestione API'API REST non è selezionata, le chiamate effettuate all'API REST per tale istanza del servizio avranno esito negativo.

    Abilitare l'API di Gestione API nel portale di Azure

Tipo di supporto predefinito

Il tipo di supporto predefinito per le richieste e le risposte è application/json. Dove indicato, alcune operazioni supportano altri tipi di contenuto. Se non sono segnalati tipi aggiuntivi di contenuto per un'operazione specifica, il tipo di supporto sarà application/json.

Authentication

Ogni richiesta all'API REST Gestione API deve essere accompagnata da un'intestazione Authorization contenente un token di accesso condiviso valido, come illustrato nell'esempio seguente.

Authorization: SharedAccessSignature uid=53dd860e1b72ff0467030003&ex=2014-08-04T22:03:00.0000000Z&sn=ItH6scUyCazNKHULKA0Yv6T+Skk4bdVmLqcPPPdWoxl2n1+rVbhKlplFrqjkoUFRr0og4wjeDz4yfThC82OjfQ==

Questo token di accesso può essere generato a livello di codice o dall'interno del portale di pubblicazione di Gestione API. Per istruzioni sulla generazione e il recupero del token di accesso, vedere Per creare manualmente un token di accesso e Per creare un token di accesso a livello di codice.

URL di base

L'URL di base della gestione diretta Gestione API'API REST è conforme al modello seguente.

https://{servicename}.management.azure-api.net

Il modello include il seguente parametro.

  • {serviceName} è il nome di servizio specificato durante la creazione del servizio, ad esempio https://contosoapi.management.azure-api.net.

Tutti gli URL restituiti dall'API REST Gestione API sono relativi a questo URL di base e tutte le richieste all'API REST devono usare questo modello di URL di base.

Parametro di query Version

Tutte le operazioni prevedono un parametro di query api-version con un valore in formato YYYY-MM-DD, ad esempio 2021-08-01.

Nota

Durante un periodo di anteprima per un'API REST di Gestione API, -preview viene aggiunto al parametro di query della versione, ad esempio 2021-04-01-preview.

Se questo parametro di query non viene passato nella stringa di query di una richiesta, il server restituirà un codice di stato di 400 Bad Request. Per un elenco delle versioni supportate, vedere Gestione API informazioni di riferimento sulle API REST.

Passaggi successivi