@azure/arm-reservations package

Interfaces

AppliedReservationList

Paginated list of applied reservations

AppliedReservations

The response for applied reservations api

AppliedReservationsProperties

Properties for applied reservations returned

AppliedScopeProperties

Properties specific to applied scope type. Not required if not applicable. Required and need to provide tenantId and managementGroupId if AppliedScopeType is ManagementGroup

AvailableScopeProperties

The response of available scope api containing scopes and their eligibilities.

AvailableScopeRequest

Available scope

AvailableScopeRequestProperties

Available scope request properties

AzureReservationAPIOptionalParams

Optional parameters for the client.

BillingInformation

billing information

CalculateExchangeOperationResultResponse

CalculateExchange operation result

CalculateExchangeOperations

Interface representing a CalculateExchange operations.

CalculateExchangePostOptionalParams

Optional parameters.

CalculateExchangeRequest

Calculate exchange request

CalculateExchangeRequestProperties

Calculate exchange request properties

CalculateExchangeResponseProperties

CalculateExchange response properties

CalculatePriceResponse

The response of calculate price for reservation.

CalculatePriceResponseProperties

Properties for calculate price response

CalculatePriceResponsePropertiesBillingCurrencyTotal

Currency and amount that customer will be charged in customer's local currency. Tax is not included.

CalculatePriceResponsePropertiesPricingCurrencyTotal

Amount that Microsoft uses for record. Used during refund for calculating refund limit. Tax is not included.

CalculateRefundOperations

Interface representing a CalculateRefund operations.

CalculateRefundPostOptionalParams

Optional parameters.

CalculateRefundRequest

Request containing information needed for calculating refund.

CalculateRefundRequestProperties

Properties needed for calculate refund including the scope and the reservation to be returned.

CalculateRefundResponse

The response of calculate refund containing refund information of reservation

Catalog

Product details of a type of resource.

CatalogMsrp

Pricing information about the sku

ChangeDirectoryRequest

Request body for change directory of a reservation.

ChangeDirectoryResponse

Change directory response

ChangeDirectoryResult

Change directory result for reservation order or reservation

Commitment

Commitment towards the benefit.

CurrentQuotaLimitBase

Quota properties.

ErrorDetails

The details of the error.

ErrorModel

Error information

ErrorResponse

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

ExceptionResponse

The API error.

ExchangeOperationResultResponse

Exchange operation result

ExchangeOperations

Interface representing a Exchange operations.

ExchangePolicyError

error details

ExchangePolicyErrors

Exchange policy errors

ExchangePostOptionalParams

Optional parameters.

ExchangeRequest

Exchange request

ExchangeRequestProperties

Exchange request properties

ExchangeResponseProperties

Exchange response properties

ExtendedErrorInfo

Extended error information including error code and error message

ExtendedStatusInfo

model interface ExtendedStatusInfo

GetAppliedReservationListOptionalParams

Optional parameters.

GetCatalogOptionalParams

Optional parameters.

MergeProperties

Properties for reservation merge

MergeRequest

The request for reservation merge

OperationDisplay

Information about an operation

OperationListOptionalParams

Optional parameters.

OperationOperations

Interface representing a Operation operations.

OperationResponse

The response containing operation information

OperationResultError

Required if status == failed or status == canceled.

PageSettings

Options for the byPage method

PagedAsyncIterableIterator

An interface that allows async iterable iteration both to completion and by page.

Patch

The request for reservation patch

PatchProperties

Properties for reservation patch

PatchPropertiesRenewProperties

model interface PatchPropertiesRenewProperties

PaymentDetail

Information about payment related to a reservation order.

Price

Pricing information containing the amount and the currency code

ProxyResource

The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location

PurchaseRequest

The request for reservation purchase

PurchaseRequestProperties

Properties of reservation purchase request

PurchaseRequestPropertiesReservedResourceProperties

Properties specific to each reserved resource type. Not required if not applicable.

QuotaCreateOrUpdateOptionalParams

Optional parameters.

QuotaGetOptionalParams

Optional parameters.

QuotaListOptionalParams

Optional parameters.

QuotaOperations

Interface representing a Quota operations.

QuotaProperties

Quota properties for the resource.

QuotaRequestDetails

Quota request details.

QuotaRequestProperties

The details of quota request.

QuotaRequestStatusGetOptionalParams

Optional parameters.

QuotaRequestStatusListOptionalParams

Optional parameters.

QuotaRequestStatusOperations

Interface representing a QuotaRequestStatus operations.

QuotaUpdateOptionalParams

Optional parameters.

RefundBillingInformation

billing information

RefundPolicyError

error details

RefundPolicyResult

Refund policy result

RefundPolicyResultProperty

Refund policy result property

RefundRequest

Request containing information needed for returning reservation.

RefundRequestProperties

Properties needed for refund request including the session id from calculate refund, the scope, the reservation to be returned and the return reason.

RefundResponseProperties

The refund properties of reservation

RenewPropertiesResponse

The renew properties for a reservation.

RenewPropertiesResponseBillingCurrencyTotal

Currency and amount that customer will be charged in customer's local currency for renewal purchase. Tax is not included.

RenewPropertiesResponsePricingCurrencyTotal

Amount that Microsoft uses for record. Used during refund for calculating refund limit. Tax is not included. This is locked price 30 days before expiry.

ReservationArchiveOptionalParams

Optional parameters.

ReservationAvailableScopesOptionalParams

Optional parameters.

ReservationGetOptionalParams

Optional parameters.

ReservationListAllOptionalParams

Optional parameters.

ReservationListOptionalParams

Optional parameters.

ReservationListRevisionsOptionalParams

Optional parameters.

ReservationMergeOptionalParams

Optional parameters.

ReservationMergeProperties

Properties of reservation merge

ReservationOperations

Interface representing a Reservation operations.

ReservationOrderBillingPlanInformation

Information describing the type of billing plan for this reservation.

ReservationOrderCalculateOptionalParams

Optional parameters.

ReservationOrderChangeDirectoryOptionalParams

Optional parameters.

ReservationOrderGetOptionalParams

Optional parameters.

ReservationOrderListOptionalParams

Optional parameters.

ReservationOrderOperations

Interface representing a ReservationOrder operations.

ReservationOrderProperties

Properties of a reservation order.

ReservationOrderPurchaseOptionalParams

Optional parameters.

ReservationOrderResponse

Details of a reservation order being returned.

ReservationResponse

The definition of the reservation.

ReservationSplitOptionalParams

Optional parameters.

ReservationSplitProperties

Properties of reservation split

ReservationSummary

The roll up count summary of reservations in each state

ReservationSwapProperties

Properties of reservation swap

ReservationToExchange

Reservation refund details

ReservationToPurchaseCalculateExchange

Reservation purchase details

ReservationToPurchaseExchange

Reservation purchase details

ReservationToReturn

Reservation to return

ReservationToReturnForExchange

Reservation refund details

ReservationUnarchiveOptionalParams

Optional parameters.

ReservationUpdateOptionalParams

Optional parameters.

ReservationUtilizationAggregates

The aggregate values of reservation utilization

ReservationsProperties

The properties of the reservations

ReservationsPropertiesUtilization

Reservation utilization

Resource

Common fields that are returned in the response for all Azure Resource Manager resources

ResourceName

Resource name provided by the resource provider. Use this property for quotaRequest parameter.

RestorePollerOptions
ReturnOperations

Interface representing a Return operations.

ReturnPostOptionalParams

Optional parameters.

SavingsPlanPurchaseRequest

Request body for savings plan purchase

SavingsPlanPurchaseRequestProperties

Properties of a savings plan purchase

SavingsPlanToPurchaseCalculateExchange

Savings plan purchase details

SavingsPlanToPurchaseExchange

Savings plan purchase details

ScopeProperties

The scope and whether it is valid.

ServiceError

The API error details.

ServiceErrorDetail

The error details.

SimplePollerLike

A simple poller that can be used to poll a long running operation.

SkuCapability

Capability of a sku.

SkuName

The name of sku

SkuProperty

Property of a sku.

SkuRestriction

Restriction of a sku.

SplitProperties

Properties for reservation split

SplitRequest

The request for reservation split

SubRequest

The sub-request submitted with the quota request.

SubscriptionScopeProperties

The scopes checked by the available scope api.

SystemData

Metadata pertaining to creation and last modification of the resource.

Type Aliases

AppliedScopeType

Type of the Applied Scope.
KnownAppliedScopeType can be used interchangeably with AppliedScopeType, this enum contains the known values that the service supports.

Known values supported by the service

Single: Single
Shared: Shared
ManagementGroup: ManagementGroup

AzureSupportedClouds

The supported values for cloud setting as a string literal type

BillingPlan

Represents the billing plan in ISO 8601 format. Required only for monthly billing plans.
KnownBillingPlan can be used interchangeably with BillingPlan, this enum contains the known values that the service supports.

Known values supported by the service

P1M: P1M

CalculateExchangeOperationResultStatus

Status of the operation.
KnownCalculateExchangeOperationResultStatus can be used interchangeably with CalculateExchangeOperationResultStatus, this enum contains the known values that the service supports.

Known values supported by the service

Succeeded: Succeeded
Failed: Failed
Cancelled: Cancelled
Pending: Pending

CommitmentGrain

Commitment grain.
KnownCommitmentGrain can be used interchangeably with CommitmentGrain, this enum contains the known values that the service supports.

Known values supported by the service

Hourly: Hourly

ContinuablePage

An interface that describes a page of results.

CreatedByType

The kind of entity that created the resource.
KnownCreatedByType can be used interchangeably with CreatedByType, this enum contains the known values that the service supports.

Known values supported by the service

User: The entity was created by a user.
Application: The entity was created by an application.
ManagedIdentity: The entity was created by a managed identity.
Key: The entity was created by a key.

ErrorResponseCode

Error code describing the reason that service is not able to process the incoming request
KnownErrorResponseCode can be used interchangeably with ErrorResponseCode, this enum contains the known values that the service supports.

Known values supported by the service

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

ExchangeOperationResultStatus

Status of the operation.
KnownExchangeOperationResultStatus can be used interchangeably with ExchangeOperationResultStatus, this enum contains the known values that the service supports.

Known values supported by the service

Succeeded: Succeeded
Failed: Failed
Cancelled: Cancelled
PendingRefunds: PendingRefunds
PendingPurchases: PendingPurchases

InstanceFlexibility

Turning this on will apply the reservation discount to other VMs in the same VM size group. Only specify for VirtualMachines reserved resource type.
KnownInstanceFlexibility can be used interchangeably with InstanceFlexibility, this enum contains the known values that the service supports.

Known values supported by the service

On: On
Off: Off

OperationStatus

Status of the individual operation.
KnownOperationStatus can be used interchangeably with OperationStatus, this enum contains the known values that the service supports.

Known values supported by the service

Succeeded: Succeeded
Failed: Failed
Cancelled: Cancelled
Pending: Pending

PaymentStatus

Describes whether the payment is completed, failed, cancelled or scheduled in the future.
KnownPaymentStatus can be used interchangeably with PaymentStatus, this enum contains the known values that the service supports.

Known values supported by the service

Succeeded: Succeeded
Failed: Failed
Scheduled: Scheduled
Cancelled: Cancelled

ProvisioningState

Represent the current state of the Reservation.
KnownProvisioningState can be used interchangeably with ProvisioningState, this enum contains the known values that the service supports.

Known values supported by the service

Creating: Creating
PendingResourceHold: PendingResourceHold
ConfirmedResourceHold: ConfirmedResourceHold
PendingBilling: PendingBilling
ConfirmedBilling: ConfirmedBilling
Created: Created
Succeeded: Succeeded
Cancelled: Cancelled
Expired: Expired
BillingFailed: BillingFailed
Failed: Failed
Split: Split
Merged: Merged

QuotaRequestState

The quota request status.
KnownQuotaRequestState can be used interchangeably with QuotaRequestState, this enum contains the known values that the service supports.

Known values supported by the service

Accepted: Accepted
Invalid: Invalid
Succeeded: Succeeded
Failed: Failed
InProgress: InProgress

ReservationBillingPlan

Represent the billing plans.
KnownReservationBillingPlan can be used interchangeably with ReservationBillingPlan, this enum contains the known values that the service supports.

Known values supported by the service

Upfront: Upfront
Monthly: Monthly

ReservationStatusCode

Type of ReservationStatusCode

ReservationTerm

Represent the term of reservation.
KnownReservationTerm can be used interchangeably with ReservationTerm, this enum contains the known values that the service supports.

Known values supported by the service

P1Y: P1Y
P3Y: P3Y
P5Y: P5Y

ReservedResourceType

The type of the resource that is being reserved. In addition to below types we have also added the following: OpenAIPTU, MDC, Sentinel.
KnownReservedResourceType can be used interchangeably with ReservedResourceType, this enum contains the known values that the service supports.

Known values supported by the service

VirtualMachines: VirtualMachines
SqlDatabases: SqlDatabases
SuseLinux: SuseLinux
CosmosDb: CosmosDb
RedHat: RedHat
SqlDataWarehouse: SqlDataWarehouse
VMwareCloudSimple: VMwareCloudSimple
RedHatOsa: RedHatOsa
Databricks: Databricks
AppService: AppService
ManagedDisk: ManagedDisk
BlockBlob: BlockBlob
RedisCache: RedisCache
AzureDataExplorer: AzureDataExplorer
MySql: MySql
MariaDb: MariaDb
PostgreSql: PostgreSql
DedicatedHost: DedicatedHost
SapHana: SapHana
SqlAzureHybridBenefit: SqlAzureHybridBenefit
AVS: AVS
DataFactory: DataFactory
NetAppStorage: NetAppStorage
AzureFiles: AzureFiles
SqlEdge: SqlEdge
VirtualMachineSoftware: VirtualMachineSoftware

ResourceType

The resource types.
KnownResourceType can be used interchangeably with ResourceType, this enum contains the known values that the service supports.

Known values supported by the service

standard: standard
dedicated: dedicated
lowPriority: lowPriority
shared: shared
serviceSpecific: serviceSpecific

SavingsPlanTerm

Represent savings plan term in ISO 8601 format.
KnownSavingsPlanTerm can be used interchangeably with SavingsPlanTerm, this enum contains the known values that the service supports.

Known values supported by the service

P1Y: P1Y
P3Y: P3Y

Enums

AzureClouds

An enum to describe Azure Cloud environments.

KnownAppliedScopeType

Type of the Applied Scope.

KnownBillingPlan

Represents the billing plan in ISO 8601 format. Required only for monthly billing plans.

KnownCalculateExchangeOperationResultStatus

Status of the operation.

KnownCommitmentGrain

Commitment grain.

KnownCreatedByType

The kind of entity that created the resource.

KnownErrorResponseCode

Error code describing the reason that service is not able to process the incoming request

KnownExchangeOperationResultStatus

Status of the operation.

KnownInstanceFlexibility

Turning this on will apply the reservation discount to other VMs in the same VM size group. Only specify for VirtualMachines reserved resource type.

KnownOperationStatus

Status of the individual operation.

KnownPaymentStatus

Describes whether the payment is completed, failed, cancelled or scheduled in the future.

KnownProvisioningState

Represent the current state of the Reservation.

KnownQuotaRequestState

The quota request status.

KnownReservationBillingPlan

Represent the billing plans.

KnownReservationStatusCode

Known values of ReservationStatusCode that the service accepts.

KnownReservationTerm

Represent the term of reservation.

KnownReservedResourceType

The type of the resource that is being reserved. In addition to below types we have also added the following: OpenAIPTU, MDC, Sentinel.

KnownResourceType

The resource types.

KnownSavingsPlanTerm

Represent savings plan term in ISO 8601 format.

Functions

isRestError(unknown)

Typeguard for RestError

restorePoller<TResponse, TResult>(AzureReservationAPI, string, (args: any[]) => PollerLike<OperationState<TResult>, TResult>, RestorePollerOptions<TResult, PathUncheckedResponse>)

Creates a poller from the serialized state of another poller. This can be useful when you want to create pollers on a different host or a poller needs to be constructed after the original one is not in scope.

Variables

RestError

A custom error type for failed pipeline requests.

Function Details

isRestError(unknown)

Typeguard for RestError

function isRestError(e: unknown): e

Parameters

e

unknown

Something caught by a catch clause.

Returns

e

restorePoller<TResponse, TResult>(AzureReservationAPI, string, (args: any[]) => PollerLike<OperationState<TResult>, TResult>, RestorePollerOptions<TResult, PathUncheckedResponse>)

Creates a poller from the serialized state of another poller. This can be useful when you want to create pollers on a different host or a poller needs to be constructed after the original one is not in scope.

function restorePoller<TResponse, TResult>(client: AzureReservationAPI, serializedState: string, sourceOperation: (args: any[]) => PollerLike<OperationState<TResult>, TResult>, options?: RestorePollerOptions<TResult, PathUncheckedResponse>): PollerLike<OperationState<TResult>, TResult>

Parameters

serializedState

string

sourceOperation

(args: any[]) => PollerLike<OperationState<TResult>, TResult>

Returns

PollerLike<OperationState<TResult>, TResult>

Variable Details

RestError

A custom error type for failed pipeline requests.

RestError: RestErrorConstructor

Type