Offers - List

Dienst:

Azure Stack Admin

API-Version:

2015-11-01

Dient zum Abrufen der Liste der Angebote unter einer Ressourcengruppe.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Die Ressourcengruppe, unter der sich die Ressource befindet.
subscriptionId	path	True	string	Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	OfferList	OKAY
Other Status Codes	Error	Unerwarteter Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Get the list of offers under a resource group.

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

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"
        ]
      }
    }
  ]
}

Definitionen

Name	Beschreibung
AccessibilityState	Stellt den Status des Angebots dar.
AddonPlanDefinition	Enthält den Namen des gewünschten Plans, der mit einem Angebot verknüpft oder nicht verknüpft werden soll.
Error	Fehlerantwort.
ErrorDefinition	Fehlerdefinition.
Offer	Stellt ein Angebot von Diensten dar, mit denen ein Abonnement erstellt werden kann.
OfferList	Liste der Angebote.

AccessibilityState

Enumeration

Stellt den Status des Angebots dar.

Wert	Beschreibung
Private	Das Angebot oder der Plan ist privat. Nur ein Administrator kann ihn anzeigen und verwalten.
Public	Das Angebot oder der Plan ist öffentlich. Benutzer können es sehen und selbst abonnieren.
Decommissioned	Das Angebot oder der Plan wird außer Betrieb genommen. Aktuelle Abonnements können sie weiterhin nutzen, aber neue Abonnements können nicht verwendet werden.

AddonPlanDefinition

Objekt

Enthält den Namen des gewünschten Plans, der mit einem Angebot verknüpft oder nicht verknüpft werden soll.

Name	Typ	Beschreibung
maxAcquisitionCount	integer (int32)	Maximale Anzahl von Instanzen, die von einem einzelnen Abonnement erworben werden können. Wenn nicht angegeben, ist der angenommene Wert 1.
planId	string	Planbezeichner.

Error

Objekt

Fehlerantwort.

Name	Typ	Beschreibung
error	ErrorDefinition	Die Fehlerdetails.

ErrorDefinition

Objekt

Fehlerdefinition.

Name	Typ	Beschreibung
code	string	Dienstspezifischer Fehlercode, der als Unterstatus für den HTTP-Fehlercode dient.
details	ErrorDefinition[]	Interne Fehlerdetails.
message	string	Beschreibung des Fehlers.

Offer

Objekt

Stellt ein Angebot von Diensten dar, mit denen ein Abonnement erstellt werden kann.

Name	Typ	Beschreibung
id	string	URI der Ressource.
location	string	Speicherort der Ressource
name	string	Name der Ressource.
properties.addonPlans	AddonPlanDefinition[]	Verweise auf Add-On-Pläne, die ein Mandant optional als Teil des Angebots erwerben kann.
properties.basePlanIds	string[]	Bezeichner der Basispläne, die dem Mandanten sofort zur Verfügung stehen, wenn ein Mandant das Angebot abonniert.
properties.description	string	Beschreibung des Angebots.
properties.displayName	string	Anzeigename des Angebots.
properties.externalReferenceId	string	Externer Verweisbezeichner.
properties.maxSubscriptionsPerAccount	integer (int32)	Maximale Anzahl von Abonnements pro Konto.
properties.name	string	Name des Angebots.
properties.state	AccessibilityState	Bieten Sie den Zustand der Barrierefreiheit an.
properties.subscriptionCount	integer (int32)	Aktuelle Abonnementanzahl.
tags	object	Liste der Schlüsselwertpaare.
type	string	Typ der Ressource.

OfferList

Objekt

Liste der Angebote.

Name	Typ	Beschreibung
nextLink	string	URI zur nächsten Seite.
value	Offer[]	Liste der Angebote.