Guida introduttiva: Creare e gestire le risorse di Servizi di comunicazione
Per iniziare a usare Servizi di comunicazione di Azure, effettuare il provisioning della prima risorsa di Servizi di comunicazione. È possibile effettuare il provisioning delle risorse di Servizi di comunicazione tramite il portale di Azure o tramite .NET Management SDK. L'SDK di gestione e il portale di Azure consentono di creare, configurare, aggiornare ed eliminare le risorse e l'interfaccia usando il nuovo servizio di distribuzione e gestione: Azure Resource Manager. Tutte le funzioni disponibili negli SDK sono disponibili nella portale di Azure.
Avviso
Si noti che non è possibile creare un gruppo di risorse contemporaneamente a una risorsa per Servizi di comunicazione di Azure. Prima di creare una risorsa, è necessario creare un gruppo di risorse.
Prerequisiti
- Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
Se si prevede di usare i numeri di telefono, non è possibile usare l'account di valutazione gratuita. Verificare che la sottoscrizione soddisfi tutti i requisiti se si prevede di acquistare numeri di telefono prima di creare la risorsa.
Creare una risorsa di Servizi di comunicazione di Azure
Per creare una risorsa di Servizi di comunicazione di Azure, accedere innanzitutto al portale di Azure. Nell'angolo superiore sinistro della pagina selezionare + Crea una risorsa.
Immettere Comunicazione in Cerca nel Marketplace o nella barra di ricerca nella parte superiore del portale.
Selezionare Servizi di comunicazione nei risultati, quindi selezionare Crea.
È ora possibile configurare la risorsa di Servizi di comunicazione. Nella prima pagina del processo di creazione è necessario specificare:
- La sottoscrizione
- Gruppo di risorse (è possibile crearne uno nuovo o scegliere un gruppo di risorse esistente)
- Il nome della risorsa di Servizi di comunicazione
- Area geografica associata alla risorsa
Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare i tag per organizzare le risorse di Azure. Per altre informazioni sui tag, vedere Usare i tag per organizzare le risorse di Azure e la gerarchia di gestione.
Infine, è possibile esaminare la configurazione e creare la risorsa. Il completamento della distribuzione richiede alcuni minuti.
Gestire la risorsa di Servizi di comunicazione
Per gestire la risorsa di Servizi di comunicazione, accedere al portale di Azure e cercare e selezionare Servizi di comunicazione di Azure.
Nella pagina Servizi di comunicazione selezionare il nome della risorsa.
La pagina Panoramica per la risorsa contiene le opzioni per la gestione di base, ad esempio Sfoglia, Arresta, Avvia, Riavvia ed Elimina. Per altre opzioni di configurazione, vedere il menu a sinistra della pagina della risorsa.
Prerequisiti
- Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
- Installare l' interfaccia della riga di comando di Azure
Se si prevede di usare i numeri di telefono, non è possibile usare l'account di valutazione gratuita. Verificare che la sottoscrizione soddisfi tutti i requisiti se si prevede di acquistare numeri di telefono prima di creare la risorsa.
Creare una risorsa di Servizi di comunicazione di Azure
Per creare una risorsa Servizi di comunicazione di Azure, accedere all'interfaccia della riga di comando di Azure. È possibile accedere eseguendo il az login comando dal terminale e specificare le credenziali. Eseguire il comando seguente per creare la risorsa:
az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>"
Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.
az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup> --subscription "<subscriptionId>"
È possibile configurare la risorsa di Servizi di comunicazione con le opzioni seguenti:
- Gruppo di risorse
- Il nome della risorsa di Servizi di comunicazione
- Area geografica associata alla risorsa
Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare i tag per organizzare le risorse di Azure. Per altre informazioni sui tag, vedere Usare i tag per organizzare le risorse di Azure e la gerarchia di gestione.
Gestire la risorsa di Servizi di comunicazione
Per aggiungere tag alla risorsa di Servizi di comunicazione, eseguire i comandi seguenti. È anche possibile specificare come destinazione una sottoscrizione specifica.
az communication update --name "<communicationName>" --tags newTag="newVal1" --resource-group "<resourceGroup>"
az communication update --name "<communicationName>" --tags newTag="newVal2" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"
az communication show --name "<communicationName>" --resource-group "<resourceGroup>"
az communication show --name "<communicationName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"
Per informazioni su altri comandi, vedere Interfaccia della riga di comando di comunicazione di Azure.
Prerequisiti
- Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
- Versione più recente di .NET Core SDK per il sistema operativo.
- Ottenere la versione più recente di .NET Identity SDK.
- Ottenere la versione più recente di .NET Management SDK.
Se si prevede di usare i numeri di telefono, non è possibile usare l'account di valutazione gratuita. Verificare che la sottoscrizione soddisfi tutti i requisiti se si prevede di acquistare numeri di telefono prima di creare la risorsa.
Installazione dell'SDK
In primo luogo, includere Communication Services Management SDK nel progetto C#:
using Azure.ResourceManager.Communication;
ID sottoscrizione
È necessario conoscere l'ID della sottoscrizione di Azure. Queste informazioni possono essere acquisite dal portale:
- Accedere al proprio account nel portale di Azure.
- Nella barra laterale sinistra selezionare Sottoscrizioni.
- selezionare la sottoscrizione da usare.
- Fare clic su Panoramica.
- Selezionare l'ID sottoscrizione.
Per il funzionamento degli esempi in questa guida introduttiva, è necessario archiviare l'ID sottoscrizione in una variabile di ambiente denominata AZURE_SUBSCRIPTION_ID.
Autenticazione
Per comunicare con Servizi di comunicazione di Azure, è prima necessario eseguire l'autenticazione in Azure. Questa operazione viene in genere eseguita usando un'identità dell'entità servizio.
Opzione 1: Identità gestita
Se il codice è in esecuzione come servizio in Azure, il modo più semplice per eseguire l'autenticazione consiste nell'acquisire un'identità gestita da Azure. Per altre informazioni, vedi:
Identità gestita assegnata dal sistema
using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var acsClient = new CommunicationManagementClient(subscriptionId, new ManagedIdentityCredential());
Identità gestita assegnata dall'utente
Il parametro ClientID dell'identità gestita creata devono essere passato a ManagedIdentityCredential in modo esplicito.
using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var managedIdentityCredential = new ManagedIdentityCredential("AZURE_CLIENT_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, managedIdentityCredential);
Opzione 2: Entità servizio
Invece di usare un'identità gestita, è possibile eseguire l'autenticazione in Azure usando un'entità servizio gestita in prima persona. Per altre informazioni, vedere Creazione e gestione di un'entità servizio in Microsoft Entra ID.
Dopo aver creato l'entità servizio, è necessario raccogliere le informazioni seguenti dal portale di Azure:
- ID client
- Segreto client
- ID tenant
Archiviare questi valori come variabili di ambiente denominate AZURE_CLIENT_IDrispettivamente , AZURE_CLIENT_SECRETe AZURE_TENANT_ID. È quindi possibile creare un client di gestione di Servizi di comunicazione nel modo seguente:
using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, new EnvironmentCredential());
Opzione 3: Identità utente
Se si vuole chiamare Azure per conto di un utente interattivo invece di usare un'identità del servizio, è possibile usare il codice seguente per creare un client di gestione di Servizi di comunicazione di Azure. Verrà visualizzata una finestra del browser per richiedere all'utente le credenziali msa o Microsoft Entra.
using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var communicationServiceClient = new CommunicationManagementClient(subscriptionId, new InteractiveBrowserCredential());
Gestione delle risorse di Servizi di comunicazione
Interazione con le risorse di Azure
Dopo che è stata eseguita l'autenticazione, è possibile usare il client di gestione per effettuare chiamate API.
Per ognuno degli esempi seguenti, le risorse di Servizi di comunicazione vengono assegnate a un gruppo di risorse esistente.
Se è necessario creare un gruppo di risorse, è possibile farlo usando il portale di Azure o Azure Resource Manager SDK.
Creare e gestire una risorsa di Servizi di comunicazione
È possibile usare l'istanza del client Communication Services Management SDK (Azure.ResourceManager.Communication.CommunicationManagementClient) per eseguire operazioni sulle risorse di Servizi di comunicazione.
Creare una risorsa di Servizi di comunicazione
Quando si crea una risorsa di Servizi di comunicazione, specificare il nome del gruppo di risorse e il nome della risorsa. La Location proprietà è sempre globale durante l'anteprima pubblica il DataLocation valore deve essere UnitedStates.
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates" };
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();
Aggiornare una risorsa di Servizi di comunicazione
...
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates" };
resource.Tags.Add("environment","test");
resource.Tags.Add("department","tech");
// Use existing resource name and new resource object
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();
Elencare tutte le risorse di Servizi di comunicazione
var resources = acsClient.CommunicationService.ListBySubscription();
foreach (var resource in resources)
{
Console.WriteLine(resource.Name);
}
Eliminare una risorsa di Servizi di comunicazione
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
await acsClient.CommunicationService.StartDeleteAsync(resourceGroupName, resourceName);
Gestione delle chiavi e delle stringhe di connessione
Ogni risorsa di Servizi di comunicazione ha una coppia di chiavi di accesso e le corrispondenti stringhe di connessione. È possibile accedere a queste chiavi usando Management SDK e renderle disponibili ad altri SDK di Servizi di comunicazione per l'autenticazione a Servizi di comunicazione di Azure.
Ottenere le chiavi di accesso per una risorsa di Servizi di comunicazione
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keys = await acsClient.CommunicationService.ListKeysAsync(resourceGroupName, resourceName);
Console.WriteLine(keys.Value.PrimaryConnectionString);
Console.WriteLine(keys.Value.SecondaryConnectionString);
Rigenerare una chiave di accesso per una risorsa di Servizi di comunicazione
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keyParams = new RegenerateKeyParameters { KeyType = KeyType.Primary };
var keys = await acsClient.CommunicationService.RegenerateKeyAsync(resourceGroupName, resourceName, keyParams);
Console.WriteLine(keys.Value.PrimaryKey);
Prerequisiti
- Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
- Installare il modulo Azure Az PowerShell
Se si prevede di usare i numeri di telefono, non è possibile usare l'account di valutazione gratuita. Verificare che la sottoscrizione soddisfi tutti i requisiti se si prevede di acquistare numeri di telefono prima di creare la risorsa.
Creare una risorsa di Servizi di comunicazione di Azure
Per creare una risorsa Servizi di comunicazione di Azure, accedere all'interfaccia della riga di comando di Azure. È possibile creare una risorsa tramite il terminale usando il Connect-AzAccount comando e specificando le credenziali.
Installare prima di tutto il modulo Az.Communication Servizi di comunicazione di Azure usando il comando seguente.
PS C:\> Install-Module Az.Communication
Eseguire il comando seguente per creare la risorsa:
PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global
Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.
PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global -SubscriptionId SubscriptionID
È possibile configurare la risorsa di Servizi di comunicazione con le opzioni seguenti:
- Gruppo di risorse
- Il nome della risorsa di Servizi di comunicazione
- Area geografica da associare alla risorsa
Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare i tag per organizzare le risorse di Azure. Per altre informazioni, vedere Usare i tag per organizzare le risorse di Azure e la gerarchia di gestione.
Gestire la risorsa di Servizi di comunicazione
Per aggiungere tag alla risorsa di Servizi di comunicazione, eseguire i comandi seguenti. È anche possibile specificare come destinazione una sottoscrizione specifica.
PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}
PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID
Per elencare tutte le risorse Servizi di comunicazione di Azure per una determinata sottoscrizione, usare il comando seguente:
PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID
Per elencare tutte le informazioni su una determinata risorsa, usare il comando seguente:
PS C:\> Get-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1
Accedere alle stringhe di connessione e agli endpoint di servizio
Connessione stringhe consentono agli SDK di Servizi di comunicazione di connettersi ed eseguire l'autenticazione in Azure. È possibile accedere alle stringhe di connessione e agli endpoint di servizio di Servizi di comunicazione dal portale di Azure o a livello di codice con le API di Azure Resource Manager.
Dopo aver eseguito il passaggio alla risorsa di Servizi di comunicazione, selezionare Chiavi dal menu di spostamento e copiare la stringa di Connessione ion o i valori endpoint per l'utilizzo da parte degli SDK di Servizi di comunicazione. È possibile accedere alle chiavi primarie e secondarie. Ciò può essere utile quando si vuole fornire l'accesso temporaneo alle risorse di Servizi di comunicazione a un ambiente di terze parti o di gestione temporanea.
Accedere ai stringa di connessione e agli endpoint di servizio usando l'interfaccia della riga di comando di Azure
È anche possibile accedere alle informazioni sulla chiave usando l'interfaccia della riga di comando di Azure, ad esempio il gruppo di risorse o le chiavi per una risorsa specifica.
Installare l'interfaccia della riga di comando di Azure e usare il comando seguente per accedere. È necessario fornire le credenziali per connettersi con l'account Azure.
az login
È ora possibile accedere a informazioni importanti sulle risorse.
az communication list --resource-group "<resourceGroup>"
az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>"
Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.
az communication list --resource-group "<resourceGroup>" --subscription "<subscriptionId>"
az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"
Archiviare la stringa di connessione
Gli SDK di Servizi di comunicazione usano stringa di connessione per autorizzare le richieste effettuate a Servizi di comunicazione. Sono disponibili diverse opzioni per l'archiviazione della stringa di connessione:
- Un'applicazione in esecuzione sul desktop o in un dispositivo può archiviare la stringa di connessione in un file app.config o in un file web.config. Aggiungere la stringa di connessione alla sezione AppSettings in tali file.
- Un'applicazione in esecuzione in un'istanza di Servizio app di Azure può archiviare la stringa di connessione nelle impostazioni dell'applicazione di Servizio app. Aggiungere la stringa di connessione alla sezione Stringhe di connessione della scheda Impostazioni applicazione nel portale.
- È possibile archiviare la stringa di connessione in Azure Key Vault.
- Se l'applicazione viene eseguita localmente, potrebbe essere opportuno archiviare la stringa di connessione in una variabile di ambiente.
Archiviare la stringa di connessione in una variabile di ambiente
Per configurare una variabile di ambiente, aprire una finestra della console e selezionare il sistema operativo nelle schede seguenti. Sostituire <yourconnectionstring> con la stringa di connessione effettiva.
Aprire una finestra della console e immettere il comando seguente:
setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourConnectionString>"
Dopo aver aggiunto la variabile di ambiente, potrebbe essere necessario riavviare tutti i programmi in esecuzione che leggono la variabile di ambiente, inclusa la finestra della console. Se ad esempio si usa Visual Studio come editor, riavviare Visual Studio prima di eseguire l'esempio.
Pulire le risorse
Se si vuole pulire e rimuovere una sottoscrizione a Servizi di comunicazione, è possibile eliminare la risorsa o il gruppo di risorse. Per eliminare la risorsa di comunicazione, eseguire il comando seguente.
az communication delete --name "acsResourceName" --resource-group "resourceGroup"
L'eliminazione del gruppo di risorse elimina anche tutte le altre risorse associate.
Se si dispone di numeri di telefono assegnati alla risorsa al momento dell'eliminazione della risorsa, i numeri di telefono vengono rilasciati automaticamente dalla risorsa contemporaneamente.
Nota
L'eliminazione delle risorse è permanente e non è possibile recuperare dati, inclusi filtri griglia di eventi, numeri di telefono o altri dati associati alla risorsa, se si elimina la risorsa.
Passaggi successivi
In questo argomento di avvio rapido si è appreso come:
- Creare una risorsa di Servizi di comunicazione
- Configurare l'area geografica della risorsa e i tag
- Accedere alle chiavi per la risorsa
- Eliminare la risorsa
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per