Offers - List

Servizio:

Azure Stack Admin

Versione API:

2015-11-01

Ottenere l'elenco delle offerte in un gruppo di risorse.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Subscriptions.Admin/offers?api-version=2015-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Il gruppo di risorse in cui si trova la risorsa.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
api-version	query	True	string	Versione dell'API client.

Risposte

Nome	Tipo	Descrizione
200 OK	OfferList	OK
Other Status Codes	Error	Errore imprevisto

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get the list of offers under a resource group.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/RG1/providers/Microsoft.Subscriptions.Admin/offers?api-version=2015-11-01

Risposta di esempio

Codice di stato:

200

{
  "value": [
    {
      "id": "/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/RG1/providers/Microsoft.Subscriptions.Admin/offers/sampleoffer1",
      "name": "sampleoffer1",
      "type": "Microsoft.Subscriptions.Admin/offers",
      "location": "local",
      "properties": {
        "name": "sampleoffer1",
        "displayName": "SampleOffer1",
        "description": "",
        "externalReferenceId": "",
        "state": "Public",
        "subscriptionCount": 1,
        "maxSubscriptionsPerAccount": 0,
        "basePlanIds": [
          "/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/RG1/providers/Microsoft.Subscriptions.Admin/plans/sampleplan1"
        ]
      }
    },
    {
      "id": "/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/ascansubscrrg479/providers/Microsoft.Subscriptions.Admin/offers/sampleoffer2",
      "name": "sampleoffer2",
      "type": "Microsoft.Subscriptions.Admin/offers",
      "location": "local",
      "tags": {},
      "properties": {
        "name": "sampleoffer2",
        "displayName": "sampleoffer2",
        "state": "Public",
        "subscriptionCount": 0,
        "maxSubscriptionsPerAccount": 0,
        "basePlanIds": [
          "/subscriptions/0af9c33b-f7ac-4161-add5-17b2f0b6a669/resourceGroups/ascansubscrrg479/providers/Microsoft.Subscriptions.Admin/plans/sampleoffer2"
        ]
      }
    }
  ]
}

Definizioni

Nome	Descrizione
AccessibilityState	Rappresenta lo stato dell'offerta
AddonPlanDefinition	Contiene il nome del piano desiderato da collegare o scollegare da un'offerta.
Error	Risposta di errore.
ErrorDefinition	Definizione di errore.
Offer	Rappresenta un'offerta di servizi in base ai quali è possibile creare una sottoscrizione.
OfferList	Elenco delle offerte.

AccessibilityState

Enumerazione

Rappresenta lo stato dell'offerta

Valore	Descrizione
Private	L'offerta o il piano è privato. Solo un amministratore può visualizzarlo e gestirlo.
Public	L'offerta o il piano è pubblico. Gli utenti possono visualizzarlo e sottoscriverlo automaticamente.
Decommissioned	L'offerta o il piano viene rimosso. Le sottoscrizioni correnti possono comunque utilizzarlo, ma non è possibile usare nuove sottoscrizioni.

AddonPlanDefinition

Object

Contiene il nome del piano desiderato da collegare o scollegare da un'offerta.

Nome	Tipo	Descrizione
maxAcquisitionCount	integer (int32)	Numero massimo di istanze che possono essere acquisite da una singola sottoscrizione. Se non specificato, il valore assunto è 1.
planId	string	Identificatore del piano.

Error

Object

Risposta di errore.

Nome	Tipo	Descrizione
error	ErrorDefinition	Dettagli dell'errore.

ErrorDefinition

Object

Definizione di errore.

Nome	Tipo	Descrizione
code	string	Codice di errore specifico del servizio che funge da stato secondario per il codice di errore HTTP.
details	ErrorDefinition[]	Dettagli dell'errore interno.
message	string	Descrizione dell'errore.

Offer

Object

Rappresenta un'offerta di servizi in base ai quali è possibile creare una sottoscrizione.

Nome	Tipo	Descrizione
id	string	URI della risorsa.
location	string	Posizione della risorsa
name	string	Nome della risorsa.
properties.addonPlans	AddonPlanDefinition[]	Riferimenti ai piani aggiuntivi che un tenant può acquisire facoltativamente come parte dell'offerta.
properties.basePlanIds	string[]	Identificatori dei piani di base che diventano disponibili per il tenant immediatamente quando un tenant sottoscrive l'offerta.
properties.description	string	Descrizione dell'offerta.
properties.displayName	string	Nome visualizzato dell'offerta.
properties.externalReferenceId	string	Identificatore di riferimento esterno.
properties.maxSubscriptionsPerAccount	integer (int32)	Numero massimo di sottoscrizioni per account.
properties.name	string	Nome dell'offerta.
properties.state	AccessibilityState	Offrire lo stato di accessibilità.
properties.subscriptionCount	integer (int32)	Numero di sottoscrizioni corrente.
tags	object	Elenco di coppie chiave-valore.
type	string	Tipo di risorsa.

OfferList

Object

Elenco delle offerte.

Nome	Tipo	Descrizione
nextLink	string	URI alla pagina successiva.
value	Offer[]	Elenco delle offerte.