Offers - List

Usługa:

Azure Stack Admin

Wersja interfejsu API:

2015-11-01

Pobierz listę ofert w grupie zasobów.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Grupa zasobów, w ramach których znajduje się zasób.
subscriptionId	path	True	string	Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	OfferList	OK
Other Status Codes	Error	Nieoczekiwany błąd

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Get the list of offers under a resource group.

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
AccessibilityState	Reprezentuje stan oferty
AddonPlanDefinition	Zawiera nazwę żądanego planu, który ma być połączony lub odłączony od oferty.
Error	Odpowiedź na błąd.
ErrorDefinition	Definicja błędu.
Offer	Reprezentuje ofertę usług, dla których można utworzyć subskrypcję.
OfferList	Lista ofert.

AccessibilityState

Wyliczanie

Reprezentuje stan oferty

Wartość	Opis
Private	Oferta lub plan jest prywatna. Tylko administrator może go wyświetlać i zarządzać.
Public	Oferta lub plan jest publiczna. Użytkownicy mogą je wyświetlać i subskrybować samodzielnie.
Decommissioned	Oferta lub plan zostanie zlikwidowana. Bieżące subskrypcje nadal mogą z niej korzystać, ale nie mogą być używane nowe subskrypcje.

AddonPlanDefinition

Objekt

Zawiera nazwę żądanego planu, który ma być połączony lub odłączony od oferty.

Nazwa	Typ	Opis
maxAcquisitionCount	integer (int32)	Maksymalna liczba wystąpień, które można uzyskać w ramach pojedynczej subskrypcji. Jeśli nie zostanie określona, zakładana wartość to 1.
planId	string	Identyfikator planu.

Error

Objekt

Odpowiedź na błąd.

Nazwa	Typ	Opis
error	ErrorDefinition	Szczegóły błędu.

ErrorDefinition

Objekt

Definicja błędu.

Nazwa	Typ	Opis
code	string	Kod błędu specyficzny dla usługi, który służy jako podstatu kodu błędu HTTP.
details	ErrorDefinition[]	Szczegóły błędu wewnętrznego.
message	string	Opis błędu.

Offer

Objekt

Reprezentuje ofertę usług, dla których można utworzyć subskrypcję.

Nazwa	Typ	Opis
id	string	Identyfikator URI zasobu.
location	string	Lokalizacja zasobu
name	string	Nazwa zasobu.
properties.addonPlans	AddonPlanDefinition[]	Odwołania do planów dodatków, które dzierżawa może opcjonalnie uzyskać w ramach oferty.
properties.basePlanIds	string[]	Identyfikatory planów podstawowych, które stają się dostępne dla dzierżawy natychmiast po zasubskrybowaniu oferty przez dzierżawę.
properties.description	string	Opis oferty.
properties.displayName	string	Nazwa wyświetlana oferty.
properties.externalReferenceId	string	Identyfikator odwołania zewnętrznego.
properties.maxSubscriptionsPerAccount	integer (int32)	Maksymalna liczba subskrypcji na konto.
properties.name	string	Nazwa oferty.
properties.state	AccessibilityState	Stan ułatwień dostępu.
properties.subscriptionCount	integer (int32)	Bieżąca liczba subskrypcji.
tags	object	Lista par klucz-wartość.
type	string	Typ zasobu.

OfferList

Objekt

Lista ofert.

Nazwa	Typ	Opis
nextLink	string	Identyfikator URI do następnej strony.
value	Offer[]	Lista ofert.