Megosztás a következőn keresztül:

Get Catalog - Get Catalog

  • Referencia
Szolgáltatás:
Reserved VM Instances
API-verzió:
2022-11-01

Szerezze be azokat a régiókat és termékváltozatokat, amelyek a megadott Azure-előfizetéshez való RI-vásárláshoz érhetők el.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/catalogs?api-version=2022-11-01
Opcionális paraméterekkel: 
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/catalogs?api-version=2022-11-01&reservedResourceType={reservedResourceType}&location={location}&publisherId={publisherId}&offerId={offerId}&planId={planId}&$filter={$filter}&$skip={$skip}&$take={$take}

URI-paraméterek

Name In Kötelező Típus Description
subscriptionId
 path True

string

Az előfizetés azonosítója
api-version
 query True

string

Támogatott verzió.
$filter
 query

string

Használható katalógustulajdonságok szerinti szűrésre. A szűrő támogatja az "eq", az "or" és az "and" elemet.
$skip
 query

number

A listából az eredmények visszaadása előtt kihagyandó foglalások száma
$take
 query

number

A visszaadandó foglalások száma
location
 query

string

Szűri a termékváltozatot a paraméterben megadott hely alapján. Ez lehet Azure-régió vagy globális
offerId
 query

string

A harmadik féltől származó termékek lekéréséhez használt ajánlatazonosító
planId
 query

string

A harmadik féltől származó termékek lekéréséhez használt csomagazonosító
publisherId
 query

string

Külső gyártók termékeinek lekéréséhez használt közzétevő azonosítója
reservedResourceType
 query

string

Annak az erőforrásnak a típusa, amelyhez a termékváltozatot meg kell adni.

Válaszok

Name Típus Description
200 OK

CatalogsResult

OKÉ. A kérés sikeres volt.
Other Status Codes

Error

Váratlan hiba

Példák

Catalog

Mintakérelem

GET https://management.azure.com/subscriptions/23bc208b-083f-4901-ae85-4f98c0c3b4b6/providers/Microsoft.Capacity/catalogs?api-version=2022-11-01&reservedResourceType=VirtualMachines&location=eastus

Mintaválasz

Állapotkód:
200 
{
  "value": [
    {
      "resourceType": "VirtualMachines",
      "name": "Standard_DS5_v2",
      "terms": [
        "P1Y",
        "P3Y"
      ],
      "billingPlans": {
        "P1Y": [
          "Upfront",
          "Monthly"
        ],
        "P3Y": [
          "Upfront",
          "Monthly"
        ]
      },
      "locations": [
        "eastus"
      ],
      "skuProperties": [
        {
          "name": "Cores",
          "value": "16"
        },
        {
          "name": "ProductTitle",
          "value": "DSv2 Series, DS5"
        },
        {
          "name": "ProductShortName",
          "value": "DSv2 Series"
        },
        {
          "name": "SKUName",
          "value": "DS5 v2"
        },
        {
          "name": "MeterId",
          "value": "12bc208b-083f-4901-ae85-4f98c0c3b4b8"
        }
      ],
      "restrictions": []
    },
    {
      "resourceType": "VirtualMachines",
      "name": "Standard_D1",
      "terms": [
        "P1Y",
        "P3Y"
      ],
      "billingPlans": {
        "P1Y": [
          "Upfront",
          "Monthly"
        ],
        "P3Y": [
          "Upfront",
          "Monthly"
        ]
      },
      "locations": [
        "eastus"
      ],
      "skuProperties": [
        {
          "name": "Cores",
          "value": "1"
        },
        {
          "name": "ProductTitle",
          "value": "D Series, D1"
        },
        {
          "name": "ProductShortName",
          "value": "D Series"
        },
        {
          "name": "SKUName",
          "value": "D1"
        },
        {
          "name": "MeterId",
          "value": "12bc208b-083f-4901-ae85-4f98c0c3b4b8"
        }
      ],
      "restrictions": [
        {
          "type": "Term",
          "values": [
            "P1Y"
          ],
          "reasonCode": "NotAvailableForSubscription"
        },
        {
          "type": "Term",
          "values": [
            "P3Y"
          ],
          "reasonCode": "NotAvailableForSubscription"
        }
      ]
    },
    {
      "resourceType": "VirtualMachines",
      "name": "Standard_F2",
      "terms": [
        "P1Y",
        "P3Y"
      ],
      "billingPlans": {
        "P1Y": [
          "Upfront",
          "Monthly"
        ],
        "P3Y": [
          "Upfront",
          "Monthly"
        ]
      },
      "locations": [
        "eastus"
      ],
      "skuProperties": [
        {
          "name": "Cores",
          "value": "2"
        },
        {
          "name": "ProductTitle",
          "value": "F Series, F2"
        },
        {
          "name": "ProductShortName",
          "value": "F Series"
        },
        {
          "name": "SKUName",
          "value": "F2"
        },
        {
          "name": "MeterId",
          "value": "12bc208b-083f-4901-ae85-4f98c0c3b4b8"
        }
      ],
      "restrictions": [
        {
          "type": "Location",
          "values": [
            "eastus"
          ],
          "reasonCode": "NotAvailableForSubscription"
        }
      ]
    }
  ],
  "nextLink": "https://management.azure.com/providers/Microsoft.Capacity/reservationOrders?api-version=2022-11-01&$filter=(term eq 'P1Y')&$take=50&$skip=50",
  "totalItems": 1000
}

Definíciók

Name Description
Catalog

Egy erőforrástípus termékadatai.
CatalogsResult

A katalógusok és a lapozási információk listája.
Error

Hibainformációk
ErrorResponseCode

Hibakód, amely leírja, hogy a szolgáltatás miért nem tudja feldolgozni a bejövő kérést
ExtendedErrorInfo

Kiterjesztett hibainformációk, beleértve a hibakódot és a hibaüzenetet
Msrp

Díjszabási információk a termékváltozatról
Price

Az összeget és a pénznemkódot tartalmazó díjszabási információk
ReservationTerm

A foglalás időtartamát jelöli.
SkuCapability

Termékváltozat képessége.
SkuProperty

Termékváltozat tulajdonsága.
SkuRestriction

Termékváltozat korlátozása.

Catalog

Objektum

Egy erőforrástípus termékadatai.

Name Típus Description
billingPlans

object

A termékváltozathoz elérhető számlázási csomagbeállítások.
capabilities

SkuCapability[]

Termékváltozat képessége.
locations

string[]

A termékváltozat által elérhető helyek készlete. Ha nincs megadva, a termékváltozat minden helyen elérhető.
msrp

Msrp

Díjszabási információk a termékváltozatról
name

string

A termékváltozat neve
resourceType

string

Az erőforrás típusa, amelyre a termékváltozat vonatkozik.
restrictions

SkuRestriction[]

Termékváltozat korlátozása.
size

string

A termékváltozat mérete
skuProperties

SkuProperty[]

Termékváltozat tulajdonsága.
terms

ReservationTerm[]

Az erőforrás elérhető foglalási feltételei
tier

string

A termékváltozat szintje

CatalogsResult

Objektum

A katalógusok és a lapozási információk listája.

Name Típus Description
nextLink

string

Az eredmények következő oldalára mutató hivatkozás (URL- cím).
totalItems

integer (int64)

A katalóguselemek teljes mennyisége.
value

Catalog[]

A katalógusok listája.

Error

Objektum

Hibainformációk

Name Típus Description
error

ExtendedErrorInfo

Kiterjesztett hibainformációk, beleértve a hibakódot és a hibaüzenetet

ErrorResponseCode

Enumerálás

Hibakód, amely leírja, hogy a szolgáltatás miért nem tudja feldolgozni a bejövő kérést

Érték Description
ActivateQuoteFailed
AppliedScopesNotAssociatedWithCommerceAccount
AppliedScopesSameAsExisting
AuthorizationFailed
BadRequest
BillingCustomerInputError
BillingError
BillingPaymentInstrumentHardError
BillingPaymentInstrumentSoftError
BillingScopeIdCannotBeChanged
BillingTransientError
CalculatePriceFailed
CapacityUpdateScopesFailed
ClientCertificateThumbprintNotSet
CreateQuoteFailed
Forbidden
FulfillmentConfigurationError
FulfillmentError
FulfillmentOutOfStockError
FulfillmentTransientError
HttpMethodNotSupported
InternalServerError
InvalidAccessToken
InvalidFulfillmentRequestParameters
InvalidHealthCheckType
InvalidLocationId
InvalidRefundQuantity
InvalidRequestContent
InvalidRequestUri
InvalidReservationId
InvalidReservationOrderId
InvalidSingleAppliedScopesCount
InvalidSubscriptionId
InvalidTenantId
MissingAppliedScopesForSingle
MissingTenantId
NoValidReservationsToReRate
NonsupportedAccountId
NotSpecified
NotSupportedCountry
OperationCannotBePerformedInCurrentState
OperationFailed
PatchValuesSameAsExisting
PaymentInstrumentNotFound
PurchaseError
ReRateOnlyAllowedForEA
RefundLimitExceeded
ReservationIdNotInReservationOrder
ReservationOrderCreationFailed
ReservationOrderIdAlreadyExists
ReservationOrderNotEnabled
ReservationOrderNotFound
RiskCheckFailed
RoleAssignmentCreationFailed
SelfServiceRefundNotSupported
ServerTimeout
UnauthenticatedRequestsThrottled
UnsupportedReservationTerm

ExtendedErrorInfo

Objektum

Kiterjesztett hibainformációk, beleértve a hibakódot és a hibaüzenetet

Name Típus Description
code

ErrorResponseCode

Hibakód, amely leírja, hogy a szolgáltatás miért nem tudja feldolgozni a bejövő kérést
message

string

Msrp

Objektum

Díjszabási információk a termékváltozatról

Name Típus Description
p1Y

Price

Összeg a díjszabás pénznemében. Az adót nem tartalmazza.
p3Y

Price

Összeg a díjszabás pénznemében. Az adót nem tartalmazza.
p5Y

Price

Összeg a díjszabás pénznemében. Az adót nem tartalmazza.

Price

Objektum

Az összeget és a pénznemkódot tartalmazó díjszabási információk

Name Típus Description
amount

number (double)

currencyCode

string

A vásárlási rekord által használt pénznem ISO 4217 3 betűs pénznemkódja.

ReservationTerm

Enumerálás

A foglalás időtartamát jelöli.

Érték Description
P1Y
P3Y
P5Y

SkuCapability

Objektum

Termékváltozat képessége.

Name Típus Description
name

string

A funkció leírására használható invariáns.
value

string

Invariáns, ha a funkciót mennyiség alapján mérik.

SkuProperty

Objektum

Termékváltozat tulajdonsága.

Name Típus Description
name

string

A funkció leírására használható invariáns.
value

string

Invariáns, ha a funkciót mennyiség alapján mérik.

SkuRestriction

Objektum

Termékváltozat korlátozása.

Name Típus Description
reasonCode

string

A korlátozás oka.
type

string

A korlátozások típusa.
values

string[]

A korlátozások értéke. Ha a korlátozás típusa helyre van állítva. Ez különböző helyeken korlátozva van a termékváltozat.