Registrare un abbonamento

Articolo
01/11/2024

Registrare una sottoscrizione esistente in modo che sia abilitata per l'ordinamento delle prenotazioni di Azure.

Per acquistare una prenotazione di Azure, è necessario avere almeno una sottoscrizione di Azure CSP esistente. Questo metodo consente di registrare la sottoscrizione di Azure CSP esistente, abilitandola per l'acquisto di prenotazioni di Azure.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
ID sottoscrizione.

C#

Per registrare la sottoscrizione di un cliente, recuperare un'interfaccia per le operazioni di sottoscrizione chiamando il metodo IAggregatePartner.Customers.ById con l'ID cliente per identificare il cliente. Chiamare quindi il metodo Subscription.ById() con l'ID sottoscrizione per identificare la sottoscrizione che si registra.

Chiamare infine il metodo Registration.Register() per registrare la sottoscrizione e recuperare un URI che può essere usato per ottenere lo stato di registrazione della sottoscrizione. Per altre informazioni, vedere Ottenere lo stato di registrazione della sottoscrizione.

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve the subscription registration details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).Registration.Register();

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
POST	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrations HTTP/1.1

Parametri URI

Usare i parametri di percorso seguenti per identificare il cliente e la sottoscrizione.

Nome	Digita	Obbligatorio	Descrizione
customer-id	string	Sì	Stringa con formato GUID che identifica il cliente.
subscription-id	string	Sì	Stringa con formattazione GUID che identifica la sottoscrizione. I partner devono usare l'ID piano di Azure per i nuovi casi commerciali.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrations HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

Risposta REST

In caso di esito positivo, la risposta contiene un'intestazione Location con un URI che può essere usato per recuperare lo stato di registrazione della sottoscrizione. Salvare questo URI per l'uso con altre API REST correlate. Per un esempio di come recuperare lo stato, vedere Ottenere lo stato di registrazione della sottoscrizione.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

HTTP/1.1 202 Accepted
Content-Length: 0
Location: /customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525

Condividi tramite