Perkirakan Biaya Template Sebelum Deployment melalui GetTemplateEstimateCost - ROS - Alibaba Cloud - Resource Orchestration Service

Membuat kueri perkiraan harga sumber daya dalam sebuah template.

Deskripsi operasi

Untuk informasi selengkapnya tentang sumber daya yang mendukung pertanyaan harga dalam template Resource Orchestration Service (ROS), lihat bagian "Tipe sumber daya yang mendukung pertanyaan harga" pada topik Memperkirakan harga sumber daya.
Untuk informasi selengkapnya tentang sumber daya yang mendukung pertanyaan harga dalam template Terraform, lihat bagian "Sumber daya ROS yang didukung oleh Terraform" pada topik Fitur dan sumber daya ROS yang didukung oleh Terraform.

Kode contoh berikut memberikan contoh tentang cara mengkueri perkiraan harga elastic IP address (EIP) yang ingin Anda buat berdasarkan sebuah template. Dalam contoh ini, template berikut digunakan:

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Isp": {
      "Type": "String",
      "Default": "BGP"
    },
    "Name": {
      "Type": "String",
      "Default": "test"
    },
    "Netmode": {
      "Type": "String",
      "Default": "public"
    },
    "Bandwidth": {
      "Type": "Number",
      "Default": 5
    }
  },
  "Resources": {
    "NewEip": {
      "Type": "ALIYUN::VPC::EIP",
      "Properties": {
        "InstanceChargeType": "Prepaid",
        "PricingCycle": "Month",
        "Isp": {
          "Ref": "Isp"
        },
        "Period": 1,
        "DeletionProtection": false,
        "AutoPay": false,
        "Name": {
          "Ref": "Name"
        },
        "InternetChargeType": "PayByTraffic",
        "Netmode": {
          "Ref": "Netmode"
        },
        "Bandwidth": {
          "Ref": "Bandwidth"
        }
      }
    }
  }
}

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ros:GetTemplateEstimateCost

get

Template

acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
TemplateURL	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan nilai tersebut, tetapi Anda harus memastikan bahwa nilainya unik di antara permintaan yang berbeda. Token dapat memiliki panjang hingga 64 karakter, dan dapat berisi huruf, digit, tanda hubung (-), dan garis bawah (_). Untuk informasi selengkapnya, lihat Memastikan idempotensi.	oss://ros-template/demo
RegionId	string	Yes	ID template. Parameter ini berlaku untuk template bersama dan template privat. Catatan Anda hanya boleh menentukan salah satu parameter berikut: TemplateBody, TemplateURL, TemplateId, dan TemplateScratchId.	cn-hangzhou
TemplateBody	string	No	Struktur yang berisi badan template. Badan template harus memiliki panjang 1 hingga 524.288 byte. Jika panjang badan template melebihi batas atas, kami menyarankan Anda menambahkan parameter ke badan permintaan HTTP POST untuk mencegah kegagalan permintaan yang disebabkan oleh URL yang terlalu panjang. Catatan Anda harus dan hanya dapat menentukan salah satu parameter berikut: TemplateBody, TemplateURL, TemplateId, dan TemplateScratchId.	ROSTemplateFormatVersion: '2015-09-01'\nResources:\n vpc:\n Type: ALIYUN::ECS::VPC
ClientToken	string	No	Nama parameter N. Jika Anda tidak menentukan nama dan nilai parameter, ROS menggunakan nama dan nilai default yang ditentukan dalam template. Nilai maksimum N: 200. Contoh: Parameters.1.ParameterKey: `Name` Parameters.2.ParameterKey: `Netmode` Catatan Parameter Parameters bersifat opsional. Jika Anda ingin menentukan Parameters, Anda harus menentukan Parameters.N.ParameterKey dan Parameters.N.ParameterValue.	123e4567-e89b-12d3-a456-42665544****
TemplateId	string	No	Nilai parameter N. Nilai maksimum N: 200. Contoh: Parameters.1.ParameterValue: `DemoEip` Parameters.2.ParameterValue: `public` Catatan Parameter Parameters bersifat opsional. Jika Anda ingin menentukan Parameters, Anda harus menentukan Parameters.N.ParameterKey dan Parameters.N.ParameterValue.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	No	ID skenario. Untuk informasi selengkapnya tentang cara mengkueri ID skenario, lihat ListTemplateScratches. Catatan Anda hanya boleh menentukan salah satu parameter berikut: TemplateBody, TemplateURL, TemplateId, dan TemplateScratchId.	v1
Parameters	array<object>	No	ID region skenario. Nilai default sama dengan nilai parameter RegionId. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar region terbaru.
	object	No	Daftar parameter.
ParameterKey	string	Yes	ID permintaan.	Name
ParameterValue	string	Yes	Detail sumber daya.	DemoEip
TemplateScratchId	string	No	ID skenario.	ts-aa9c62feab844a6b****
TemplateScratchRegionId	string	No	ID region skenario. Nilai default sama dengan nilai parameter RegionId. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar region terbaru.	cn-hangzhou
StackId	string	No	ID stack. Parameter ini digunakan untuk mengkueri perkiraan harga dalam skenario perubahan konfigurasi. Misalkan stack yang ditentukan hanya berisi satu instans Elastic Compute Service (ECS) dan tipe instansnya adalah ecs.s6-c1m2.large. Anda menurunkan tipe instans menjadi ecs.s6-c1m1.small dan menentukan instans ApsaraDB RDS baru dalam template yang digunakan untuk pertanyaan harga. Hasil yang dikueri adalah jumlah dari pengembalian dana penurunan tingkat instans ECS dan harga instans ApsaraDB RDS baru.	c754d2a4-28f1-46df-b557-9586173a****

Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Parameter umum.

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	6DEA36EF-C97D-5658-A4AC-4F5DB08D1A89
Resources	object	Detail sumber daya.	{ "NewEip": { "Type": "ALIYUN::VPC::EIP", "Success": true, "Result": { "Order": { "TaxAmount": 0.0, "Currency": "CNY", "RuleIds": [ "102204102264**" ], "TradeAmount": 87.5, "OriginalAmount": 125.0, "DiscountAmount": 37.5 }, "OrderSupplement": { "ChargeType": "PrePaid", "Period": 1, "Quantity": 1, "PriceType": "Total", "PeriodUnit": "Month" }, "InquiryType": "Buy", "Rules": { "Rule": [ { "RuleDescId": "102204102264**", "Name": "Contract_Discount_Full_Order_30%_Off" } ] } } } }

Tabel berikut menjelaskan parameter yang terdapat dalam Resources.

Parameter	Tipe	Contoh	Deskripsi
Order			Informasi tentang pesanan.
- Currency	String	CNY	Unit mata uang. Nilai yang valid:CNY: Nilai ini hanya tersedia di situs China (aliyun.com).USD: Nilai ini hanya tersedia di situs internasional (alibabacloud.com)
- OriginalAmount	Long	125	Harga asli.
- DiscountAmount	Long	15.63	Jumlah diskon.
- TradeAmount	Long	109.37	Harga transaksi, yang sama dengan harga asli dikurangi diskon.
- TaxAmount	Long	0	Jumlah pajak yang tersedia.
- Coupons	Array	{"Coupon": []}	Promosi yang tersedia.
- RuleIds	Array	[102204102264****]	ID aturan promosi.
InquiryType	String	Buy	Tipe pertanyaan harga. Nilai yang valid:Buy: pertanyaan harga untuk sumber daya baruModificationBuy: pertanyaan harga untuk perubahan konfigurasi sumber daya
Rules			Aturan promosi.
- Rule			Aturan promosi.
- - Name	String	Contract discount_order discount_8.750 discount	Nama aturan promosi.
- - RuleDescId	Long	102204102264****	ID aturan promosi.
OrderSupplement			Informasi tambahan tentang pesanan.
- AutoRenew	Boolean	false	Menentukan apakah akan mengaktifkan perpanjangan otomatis. Nilai yang valid:truefalse
- ChargeType	String	PrePaid	Metode penagihan.
- Period	Long	1	Durasi langganan.
- PeriodUnit	String	Month	Unit durasi langganan. Nilai yang valid:YearMonth
- PriceType	String	Total	Tipe harga.
- Quantity	Long	1	Kuantitas.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "6DEA36EF-C97D-5658-A4AC-4F5DB08D1A89",
  "Resources": {
    "test": "test",
    "test2": 1
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.