DescribeResourcesModification - - Alibaba Cloud Documentation Center

Kueri sumber daya yang tersedia di zona tertentu saat Anda melakukan peningkatan dan penurunan tipe instans atau mengganti disk sistem.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter Permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeResourcesModification	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeResourcesModification.
RegionId	String	Yes	cn-hangzhou	ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
ResourceId	String	Yes	i-bp67acfmxazb4p****	ID resource. Misalnya, ketika DestinationResource diatur ke InstanceType, parameter ini dapat diartikan sebagai InstanceId.
MigrateAcrossZone	Boolean	No	true	Menentukan apakah peningkatan tipe instans lintas kluster didukung. Nilai yang valid: true false Nilai default: false. Ketika MigrateAcrossZone diatur ke true dan Anda meningkatkan tipe instans Elastic Compute Service (ECS) berdasarkan informasi yang dikembalikan, perhatikan hal-hal berikut: Instans yang berada di jaringan klasik: Untuk jenis instans yang telah ditarik, ketika instans non-I/O-optimized ditingkatkan menjadi instans I/O-optimized, Alamat IP pribadi, Nama perangkat disk, dan kode otorisasi perangkat lunak instans akan berubah. Untuk instans Linux, disk dasar (cloud) diidentifikasi sebagai xvd* seperti xvda dan xvdb, sedangkan disk ultra (cloud_efficiency) dan SSD standar (cloud_ssd) diidentifikasi sebagai vd* seperti vda dan vdb. Untuk keluarga instans yang tersedia untuk pembelian, ketika tipe instans diubah, Alamat IP pribadi instans akan berubah. Instans yang berada di virtual private cloud (VPC): Untuk jenis instans yang telah ditarik, ketika instans non-I/O-optimized ditingkatkan menjadi instans I/O-optimized, Nama perangkat disk dan kode otorisasi perangkat lunak instans akan berubah. Untuk instans Linux, disk dasar (cloud) diidentifikasi sebagai xvd* seperti xvda dan xvdb, sedangkan disk ultra (cloud_efficiency) dan SSD standar (cloud_ssd) diidentifikasi sebagai vd* seperti vda dan vdb.
DestinationResource	String	Yes	InstanceType	Tipe resource target. Nilai yang valid: InstanceType SystemDisk
OperationType	String	No	Upgrade	Operasi perubahan konfigurasi resource. Nilai yang valid untuk resource subscription: Upgrade: meningkatkan resource. Downgrade: menurunkan spesifikasi resource. RenewDowngrade: memperpanjang dan menurunkan spesifikasi resource. RenewModify: memperpanjang instans yang kedaluwarsa dan mengubah konfigurasinya. Tetapkan nilainya ke Upgrade untuk resource pay-as-you-go. Nilai default: Upgrade.
InstanceType	String	No	ecs.g5.large	Tipe ENI N. Nilai yang valid untuk N: 1 dan 2. Jika nilai N adalah 1, ENI primer atau secondary dapat dikonfigurasi. Jika nilai N adalah 2, ENI primer dan ENI secondary harus dikonfigurasi. Nilai yang valid: Primary dan Secondary. Nilai default: Secondary. Untuk informasi lebih lanjut, lihat Ikhtisar keluarga instans atau panggil operasi DescribeInstanceTypes untuk mengkueri daftar tipe instans terbaru. Parameter ini wajib ditentukan ketika DestinationResource diatur ke SystemDisk.
Cores	Integer	No	2	Jumlah vCPU dari tipe instans. Informasi mengenai nilai-nilainya dapat dilihat di Ikhtisar keluarga instans. Parameter ini hanya berlaku ketika DestinationResource diatur ke InstanceType.
Memory	Float	Not supported	8.0	Ukuran memori dari tipe instans. Satuan: GiB. Informasi mengenai nilai-nilainya dapat dilihat di Ikhtisar keluarga instans. Parameter ini hanya berlaku ketika DestinationResource diatur ke InstanceType.
ZoneId	String	No	cn-hangzhou-e	ID zona.
Conditions.N	String	No	DiskCategory	Kondisi. Jika Anda menentukan parameter ini, sistem akan mengkueri tipe resource yang dapat diubah oleh resource setelah memenuhi kondisi yang ditentukan. Tetapkan nilainya ke DiskCategory, yang menunjukkan perubahan kategori disk. Ketika Anda mengatur parameter ini ke DiskCategory, sistem akan mengkueri tipe instans yang dapat diubah oleh instans setelah perubahan kategori disk.

Parameter Respons

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
AvailableZones	Array of AvailableZone		Informasi mengenai zona yang dikueri.
AvailableZone
ZoneId	String	cn-hangzhou-e	ID zona.
Status	String	Available	Status resource. Nilai yang valid: Available SoldOut
StatusCategory	String	WithStock	Kategori resource berdasarkan status stok. Nilai yang valid: WithStock: resource yang stoknya mencukupi ClosedWithStock: resource yang stoknya tidak mencukupi WithoutStock: resource yang habis stoknya
RegionId	String	cn-hangzhou	ID wilayah.
AvailableResources	Array of AvailableResource		Resource yang tersedia di zona tersebut.
AvailableResource
Type	String	InstanceType	Tipe resource. Nilai yang valid: Zone IoOptimized InstanceType SystemDisk DataDisk Network
SupportedResources	Array of SupportedResource		Informasi mengenai resource.
SupportedResource
Status	String	Available	Status resource. Nilai yang valid: Available SoldOut
Value	String	ecs.g5.large	Tipe resource.
Max	Integer	2048	Kapasitas disk maksimum. Parameter ini hanya berlaku ketika parameter permintaan DestinationResource diatur ke SystemDisk.
Unit	String	GiB	Satuan kapasitas disk. Parameter ini hanya berlaku ketika parameter permintaan DestinationResource diatur ke SystemDisk.
StatusCategory	String	WithStock	Kategori resource berdasarkan status stok. Nilai yang valid: WithStock: resource yang stoknya mencukupi ClosedWithStock: resource yang stoknya tidak mencukupi WithoutStock: resource yang habis stoknya
Min	Integer	20	Kapasitas disk minimum. Parameter ini hanya berlaku ketika parameter permintaan DestinationResource diatur ke SystemDisk.
ConditionSupportedResources	Array of ConditionSupportedResource		Tipe resource yang dapat diubah oleh resource setelah memenuhi kondisi tertentu. Jika kondisi terpenuhi, Anda dapat mengubah resource saat ini menjadi resource dalam daftar ini.
ConditionSupportedResource
Conditions	Array of Condition		Kondisi.
Condition
Key	String	DiskCategory	Nama kondisi. Nilai yang valid: DiskCategory, yang menunjukkan perubahan kategori disk.
Status	String	Available	Status stok resource. Nilai yang valid: Available SoldOut
Value	String	ecs.g5.large	Tipe resource.
Max	Integer	2048	Kapasitas disk maksimum. Parameter ini hanya berlaku ketika parameter permintaan DestinationResource diatur ke SystemDisk.
Unit	String	GiB	Satuan kapasitas disk. Parameter ini hanya berlaku ketika parameter permintaan DestinationResource diatur ke SystemDisk.
StatusCategory	String	WithStock	Kategori resource berdasarkan status stok. Nilai yang valid: WithStock: resource yang stoknya mencukupi ClosedWithStock: resource yang stoknya tidak mencukupi WithoutStock: resource yang habis stoknya
Min	Integer	20	Kapasitas disk minimum. Parameter ini hanya berlaku ketika parameter permintaan DestinationResource diatur ke SystemDisk.

Contoh

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&DestinationResource=InstanceType
&RegionId=cn-hangzhou
&ResourceId=i-bp67acfmxazb4p****
&MigrateAcrossZone=true
&OperationType=Upgrade
&InstanceType=ecs.g5.large
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeResourcesModificationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <AvailableZones>
        <ZoneId>cn-hangzhou-e</ZoneId>
        <Status>Available</Status>
        <StatusCategory>WithStock</StatusCategory>
        <RegionId>cn-hangzhou</RegionId>
        <AvailableResources>
            <Type>InstanceType</Type>
            <SupportedResources>
                <Status>Available</Status>
                <Value>ecs.g5.large</Value>
                <StatusCategory>WithStock</StatusCategory>
            </SupportedResources>
            <ConditionSupportedResources>
                <Conditions>
                    <Key>DiskCategory</Key>
                </Conditions>
                <Status>Available</Status>
                <Value>ecs.g5.large</Value>
                <StatusCategory>WithStock</StatusCategory>
            </ConditionSupportedResources>
        </AvailableResources>
    </AvailableZones>
</DescribeResourcesModificationResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AvailableZones" : [ {
    "ZoneId" : "cn-hangzhou-e",
    "Status" : "Available",
    "StatusCategory" : "WithStock",
    "RegionId" : "cn-hangzhou",
    "AvailableResources" : [ {
      "Type" : "InstanceType",
      "SupportedResources" : [ {
        "Status" : "Available",
        "Value" : "ecs.g5.large",
        "StatusCategory" : "WithStock"
      } ],
      "ConditionSupportedResources" : [ {
        "Conditions" : [ {
          "Key" : "DiskCategory"
        } ],
        "Status" : "Available",
        "Value" : "ecs.g5.large",
        "StatusCategory" : "WithStock"
      } ]
    } ]
  } ]
}

Kode Kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	Invalid.OperationType	The specified operationType is not valid.	Nilai OperationType tidak valid.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	Nilai DestinationResource tidak valid.
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	Nilai InstanceChargeType tidak valid.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist in our records.	Host khusus yang ditentukan tidak ada di wilayah saat ini.
404	Invalid.RegionId	The specified RegionId does not exist.	Nilai RegionId tidak valid.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	Nilai ResourceType tidak valid.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	Nilai DestinationResource tidak valid.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	Nilai IoOptimized tidak valid.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	Nilai NetworkCategory tidak valid.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	Nilai SpotStrategy tidak valid.
404	Invalid.ResourceId	The specified ResourceId is not valid.	Nilai ResourceId tidak valid.
404	Invalid.InstancePayType	The specified InstancePayType is not valid.	Nilai InstanceChargeType tidak valid.
404	OperationDenied	The specified operation is denied as this instanceType is not support.	Tipe instans tidak mendukung operasi ini.
404	InvalidInstanceId.NotFound	The specified InstanceId provided does not exist in our records.	ID instans yang ditentukan tidak ada. Periksa apakah ID instans sudah benar.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.	Parameter ResourceId yang ditentukan tidak ada. Periksa apakah ID resource sudah benar.

Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.