Sdílet prostřednictvím


Savings Plan Order Alias - Create

Vytvořte plán úspor. Další informace o oprávněních potřebných v https://go.microsoft.com/fwlink/?linkid=2215851

PUT https://management.azure.com/providers/Microsoft.BillingBenefits/savingsPlanOrderAliases/{savingsPlanOrderAliasName}?api-version=2022-11-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
savingsPlanOrderAliasName
path True

string

pattern: ^[a-zA-Z0-9_\-\.]+$

Název aliasu objednávky plánu úspor

api-version
query True

string

Verze rozhraní API, kterou má služba používat

Text požadavku

Name Vyžadováno Typ Description
sku True

Sku

Skladová položka s plánem Úspory

kind

string

Druh poskytovatele prostředků

properties.appliedScopeProperties

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru Není vyžadováno, pokud není k dispozici.

properties.appliedScopeType

AppliedScopeType

Typ použitého oboru.

properties.billingPlan

BillingPlan

Představuje fakturační plán ve formátu ISO 8601. Vyžaduje se jenom pro měsíční fakturační plány.

properties.billingScopeId

string

Předplatné, které se bude účtovat za nákup výhody

properties.commitment

Commitment

Závazek k výhodě.

properties.displayName

string

Zobrazovaný název

properties.renew

boolean

Když tuto hodnotu nastavíte na true, automaticky se vykupí nová výhoda v době vypršení platnosti.

properties.term

Term

Představuje termín výhody ve formátu ISO 8601.

Odpovědi

Name Typ Description
200 OK

SavingsPlanOrderAliasModel

Prostředek byl vytvořen.

201 Created

SavingsPlanOrderAliasModel

Požadavek se zpracovává.

Hlavičky

  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

SavingsPlanOrderAliasCreate
SavingsPlanOrderAliasCreateSingleScope

SavingsPlanOrderAliasCreate

Ukázkový požadavek

PUT https://management.azure.com/providers/Microsoft.BillingBenefits/savingsPlanOrderAliases/spAlias123?api-version=2022-11-01

{
  "sku": {
    "name": "Compute_Savings_Plan"
  },
  "properties": {
    "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000",
    "term": "P3Y",
    "appliedScopeType": "Shared",
    "appliedScopeProperties": null,
    "displayName": "Compute_SavingsPlan_10-28-2022_16-38",
    "billingPlan": "P1M",
    "commitment": {
      "grain": "Hourly",
      "currencyCode": "USD",
      "amount": 0.001
    }
  }
}

Ukázková odpověď

Azure-AsyncOperation: https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2021-07-01-privatepreview
Retry-After: 5
{
  "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595",
  "name": "SavingsPlan_1667000324595",
  "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases",
  "kind": null,
  "sku": {
    "name": "Compute_Savings_Plan"
  },
  "properties": {
    "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023",
    "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000",
    "billingPlan": "P1M",
    "appliedScopeProperties": null,
    "commitment": {
      "grain": "Hourly",
      "currencyCode": "USD",
      "amount": 0.001
    },
    "appliedScopeType": "Shared",
    "displayName": "Compute_SavingsPlan_10-28-2022_16-38",
    "provisioningState": "Created",
    "term": "P3Y"
  }
}
{
  "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595",
  "name": "SavingsPlan_1667000324595",
  "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases",
  "kind": null,
  "sku": {
    "name": "Compute_Savings_Plan"
  },
  "properties": {
    "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023",
    "billingScopeId": "/subscriptions/30000000-0000-0000-0000-000000000000",
    "billingPlan": "P1M",
    "appliedScopeProperties": null,
    "commitment": {
      "grain": "Hourly",
      "currencyCode": "USD",
      "amount": 0.001
    },
    "appliedScopeType": "Shared",
    "displayName": "Compute_SavingsPlan_10-28-2022_16-38",
    "provisioningState": "Created",
    "term": "P3Y"
  }
}

SavingsPlanOrderAliasCreateSingleScope

Ukázkový požadavek

PUT https://management.azure.com/providers/Microsoft.BillingBenefits/savingsPlanOrderAliases/spAlias123?api-version=2022-11-01

{
  "sku": {
    "name": "Compute_Savings_Plan"
  },
  "properties": {
    "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000",
    "appliedScopeType": "Single",
    "appliedScopeProperties": {
      "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000"
    },
    "term": "P3Y",
    "displayName": "Compute_SavingsPlan_10-28-2022_16-38",
    "billingPlan": "P1M",
    "commitment": {
      "grain": "Hourly",
      "currencyCode": "USD",
      "amount": 0.001
    }
  }
}

Ukázková odpověď

Azure-AsyncOperation: https://management.azure.com/Microsoft.BillingBenefits/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2021-07-01-privatepreview
Retry-After: 5
{
  "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595",
  "name": "SavingsPlan_1667000324595",
  "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases",
  "kind": null,
  "sku": {
    "name": "Compute_Savings_Plan"
  },
  "properties": {
    "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023",
    "billingPlan": "P1M",
    "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000",
    "appliedScopeType": "Single",
    "appliedScopeProperties": {
      "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000"
    },
    "commitment": {
      "grain": "Hourly",
      "currencyCode": "USD",
      "amount": 0.001
    },
    "displayName": "Compute_SavingsPlan_10-28-2022_16-38",
    "provisioningState": "Created",
    "term": "P3Y"
  }
}
{
  "id": "/providers/microsoft.billingbenefits/savingsPlanOrderAliases/SavingsPlan_1667000324595",
  "name": "SavingsPlan_1667000324595",
  "type": "Microsoft.BillingBenefits/savingsPlanOrderAliases",
  "kind": null,
  "sku": {
    "name": "Compute_Savings_Plan"
  },
  "properties": {
    "savingsPlanOrderId": "/providers/Microsoft.BillingBenefits/savingsPlanOrders/30000000-0000-0000-0000-000000000023",
    "billingPlan": "P1M",
    "billingScopeId": "/providers/Microsoft.Billing/billingAccounts/1234567/billingSubscriptions/30000000-0000-0000-0000-000000000000",
    "appliedScopeType": "Single",
    "appliedScopeProperties": {
      "subscriptionId": "/subscriptions/30000000-0000-0000-0000-000000000000"
    },
    "commitment": {
      "grain": "Hourly",
      "currencyCode": "USD",
      "amount": 0.001
    },
    "displayName": "Compute_SavingsPlan_10-28-2022_16-38",
    "provisioningState": "Created",
    "term": "P3Y"
  }
}

Definice

Name Description
AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru Není vyžadováno, pokud není k dispozici.

AppliedScopeType

Typ použitého oboru.

BillingPlan

Představuje fakturační plán ve formátu ISO 8601. Vyžaduje se jenom pro měsíční fakturační plány.

Commitment

Závazek k výhodě.

CommitmentGrain

Agregační interval závazku.

createdByType

Typ identity, která prostředek vytvořila.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

ProvisioningState

Stav zřizování

SavingsPlanOrderAliasModel

Alias objednávky plánu úspor

Sku

Skladová položka, která se má použít pro tento prostředek

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Term

Představuje termín výhody ve formátu ISO 8601.

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru Není vyžadováno, pokud není k dispozici.

Name Typ Description
displayName

string

Zobrazovaný název

managementGroupId

string

Plně kvalifikovaný identifikátor skupiny pro správu, ve které je třeba použít výhodu.

resourceGroupId

string

Plně kvalifikovaný identifikátor skupiny prostředků.

subscriptionId

string

Plně kvalifikovaný identifikátor předplatného.

tenantId

string

ID tenanta, ve kterém se výhoda použije.

AppliedScopeType

Typ použitého oboru.

Hodnota Description
ManagementGroup
Shared
Single

BillingPlan

Představuje fakturační plán ve formátu ISO 8601. Vyžaduje se jenom pro měsíční fakturační plány.

Hodnota Description
P1M

Commitment

Závazek k výhodě.

Name Typ Description
amount

number (double)

currencyCode

string

Kód měny ISO 4217 3-letter pro měnu použitou tímto záznamem nákupu.

grain

CommitmentGrain

Agregační interval závazku.

CommitmentGrain

Agregační interval závazku.

Hodnota Description
Hourly

createdByType

Typ identity, která prostředek vytvořila.

Hodnota Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

ProvisioningState

Stav zřizování

Hodnota Description
Cancelled
ConfirmedBilling
Created
Creating
Expired
Failed
PendingBilling
Succeeded

SavingsPlanOrderAliasModel

Alias objednávky plánu úspor

Name Typ Default value Description
id

string

Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind

string

Druh poskytovatele prostředků

name

string

Název prostředku

properties.appliedScopeProperties

AppliedScopeProperties

Vlastnosti specifické pro použitý typ oboru Není vyžadováno, pokud není k dispozici.

properties.appliedScopeType

AppliedScopeType

Typ použitého oboru.

properties.billingPlan

BillingPlan

Představuje fakturační plán ve formátu ISO 8601. Vyžaduje se jenom pro měsíční fakturační plány.

properties.billingScopeId

string

Předplatné, které se bude účtovat za nákup výhody

properties.commitment

Commitment

Závazek k výhodě.

properties.displayName

string

Zobrazovaný název

properties.provisioningState

ProvisioningState

Stav zřizování

properties.renew

boolean

False

Když tuto hodnotu nastavíte na true, automaticky se vykupí nová výhoda v době vypršení platnosti.

properties.savingsPlanOrderId

string

Identifikátor vytvořeného plánu úspor

properties.term

Term

Představuje termín výhody ve formátu ISO 8601.

sku

Sku

Skladová položka s plánem Úspory

systemData

systemData

Metadata Azure Resource Manageru obsahující informace createdBy a modifiedBy

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

Sku

Skladová položka, která se má použít pro tento prostředek

Name Typ Description
name

string

Název skladové položky, která se má použít

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string (date-time)

Časové razítko vytvoření prostředku (UTC).

createdBy

string

Identita, která prostředek vytvořila.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string (date-time)

Časové razítko poslední změny zdroje (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.

Term

Představuje termín výhody ve formátu ISO 8601.

Hodnota Description
P1Y
P3Y
P5Y