Dela via


Savings Plan Order Alias - Create

Skapa en sparplan. Läs mer om behörigheter som krävs på https://go.microsoft.com/fwlink/?linkid=2215851

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

URI-parametrar

Name I Obligatorisk Typ Description
savingsPlanOrderAliasName
path True

string

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

Namn på orderaliaset för sparplanen

api-version
query True

string

Api-versionen som ska användas av tjänsten

Begärandetext

Name Obligatorisk Typ Description
sku True

Sku

SKU för sparplan

kind

string

Typ av resursprovider

properties.appliedScopeProperties

AppliedScopeProperties

Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt.

properties.appliedScopeType

AppliedScopeType

Typ av tillämpat omfång.

properties.billingPlan

BillingPlan

Representerar faktureringsplanen i ISO 8601-format. Krävs endast för månatliga faktureringsplaner.

properties.billingScopeId

string

Prenumeration som debiteras för att köpa förmånen

properties.commitment

Commitment

Engagemang för förmånen.

properties.displayName

string

Visningsnamn

properties.renew

boolean

Om du anger värdet true köps automatiskt en ny förmån på förfallodatumtiden.

properties.term

Term

Representera förmånstermen i ISO 8601-format.

Svar

Name Typ Description
200 OK

SavingsPlanOrderAliasModel

Resursen har skapats.

201 Created

SavingsPlanOrderAliasModel

Begäran bearbetas.

Sidhuvuden

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

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

SavingsPlanOrderAliasCreate
SavingsPlanOrderAliasCreateSingleScope

SavingsPlanOrderAliasCreate

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
AppliedScopeProperties

Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt.

AppliedScopeType

Typ av tillämpat omfång.

BillingPlan

Representerar faktureringsplanen i ISO 8601-format. Krävs endast för månatliga faktureringsplaner.

Commitment

Engagemang för förmånen.

CommitmentGrain

Åtagandeintervall.

createdByType

Den typ av identitet som skapade resursen.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

ProvisioningState

Etableringstillstånd

SavingsPlanOrderAliasModel

Orderalias för sparplan

Sku

Den SKU som ska användas för den här resursen

systemData

Metadata som rör skapande och senaste ändring av resursen.

Term

Representera förmånstermen i ISO 8601-format.

AppliedScopeProperties

Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt.

Name Typ Description
displayName

string

Visningsnamn

managementGroupId

string

Fullständigt kvalificerad identifierare för den hanteringsgrupp där förmånen måste tillämpas.

resourceGroupId

string

Fullständigt kvalificerad identifierare för resursgruppen.

subscriptionId

string

Fullständigt kvalificerad identifierare för prenumerationen.

tenantId

string

Klientorganisations-ID där förmånen tillämpas.

AppliedScopeType

Typ av tillämpat omfång.

Värde Description
ManagementGroup
Shared
Single

BillingPlan

Representerar faktureringsplanen i ISO 8601-format. Krävs endast för månatliga faktureringsplaner.

Värde Description
P1M

Commitment

Engagemang för förmånen.

Name Typ Description
amount

number (double)

currencyCode

string

ISO 4217 3-bokstavs valutakod för den valuta som används av den här inköpsposten.

grain

CommitmentGrain

Åtagandeintervall.

CommitmentGrain

Åtagandeintervall.

Värde Description
Hourly

createdByType

Den typ av identitet som skapade resursen.

Värde Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ProvisioningState

Etableringstillstånd

Värde Description
Cancelled
ConfirmedBilling
Created
Creating
Expired
Failed
PendingBilling
Succeeded

SavingsPlanOrderAliasModel

Orderalias för sparplan

Name Typ Standardvärde Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

kind

string

Typ av resursprovider

name

string

Namnet på resursen

properties.appliedScopeProperties

AppliedScopeProperties

Egenskaper som är specifika för tillämpad omfångstyp. Krävs inte om det inte är tillämpligt.

properties.appliedScopeType

AppliedScopeType

Typ av tillämpat omfång.

properties.billingPlan

BillingPlan

Representerar faktureringsplanen i ISO 8601-format. Krävs endast för månatliga faktureringsplaner.

properties.billingScopeId

string

Prenumeration som debiteras för att köpa förmånen

properties.commitment

Commitment

Engagemang för förmånen.

properties.displayName

string

Visningsnamn

properties.provisioningState

ProvisioningState

Etableringstillstånd

properties.renew

boolean

False

Om du anger värdet true köps automatiskt en ny förmån på förfallodatumtiden.

properties.savingsPlanOrderId

string

Identifierare för den sparplan som skapats

properties.term

Term

Representera förmånstermen i ISO 8601-format.

sku

Sku

SKU för sparplan

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

Sku

Den SKU som ska användas för den här resursen

Name Typ Description
name

string

Namnet på den SKU som ska tillämpas

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string (date-time)

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.

Term

Representera förmånstermen i ISO 8601-format.

Värde Description
P1Y
P3Y
P5Y