Avvio rapido: Creare e gestire le risorse di Servizi di comunicazione

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.

Se si prevede di usare i numeri di telefono, non è possibile usare la versione 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
• Il gruppo di risorse (è possibile creare un nuovo gruppo di risorse o sceglierne uno esistente)
• Il nome della risorsa di Servizi di comunicazione
• I dati geografici associati alla risorsa

Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare 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.

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, usare 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 la versione 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 all'interfaccia della riga di comando di Azure. È possibile accedere eseguendo il comando az login dal terminale e specificando 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, è possibile specificare anche il flag --subscription e fornire l'ID della 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:

• Il gruppo di risorse
• Il nome della risorsa di Servizi di comunicazione
• I dati geografici associati alla risorsa

Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare 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.

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.
• La versione più recente di .NET Core SDK per il sistema operativo.
• Ottenere la versione più recente dell’SDK di identità per .NET.
• Ottenere la versione più recente dell’SDK di gestione per .NET.

Se si prevede di usare i numeri di telefono, non è possibile usare la versione 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

Includere prima di tutto l’SDK di gestione di Servizi di comunicazione nel progetto C#:

using Azure.ResourceManager.Communication;

ID sottoscrizione

È necessario conoscere l'ID della sottoscrizione di Azure. Queste informazioni possono essere acquisite dal portale:

1. Accedere all'account nel portale di Azure.
2. Dalla barra laterale sinistra, selezionare Sottoscrizioni.
3. selezionare la sottoscrizione da usare.
4. Fare clic su Panoramica.
5. 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:

• Panoramica delle identità gestite

• Servizi di Azure che supportano le identità gestite

• Come usare le identità gestite nel servizio app e in Funzioni di Azure

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 dal portale di Azure le informazioni seguenti relative all'entità:

• ID client
• Segreto client
• ID tenant

Archiviare questi valori rispettivamente come variabili di ambiente denominate AZURE_CLIENT_ID, AZURE_CLIENT_SECRET e 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. Viene aperta 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, vengono assegnate risorse di Servizi di comunicazione a un gruppo di risorse esistente.

Se è necessario creare un gruppo di risorse, è possibile farlo usando il portale di Azure o l’SDK di Azure Resource Manager.

Creare e gestire una risorsa di Servizi di comunicazione

È possibile usare l'istanza del client SDK di gestione di Servizi di comunicazione (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 proprietà Location è sempre global e durante l'anteprima pubblica il valore di DataLocation 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 l’SDK di gestione e, quindi, renderle disponibili ad altri SDK di Servizi di comunicazione per autenticarsi in 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 Az PowerShell di Azure

Se si prevede di usare i numeri di telefono, non è possibile usare la versione 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 all'interfaccia della riga di comando di Azure. È possibile creare una risorsa tramite il terminale usando il comando Connect-AzAccount 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, è possibile specificare anche il flag --subscription e fornire l'ID della 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:

• Il gruppo di risorse
• Il nome della risorsa di Servizi di comunicazione
• I dati geografici da associare alla risorsa

Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare 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 di 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