DescribeReservedInstances - - Alibaba Cloud Dokümantasyon Merkezi

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması için bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	DescribeReservedInstances	Gerçekleştirmek istediğiniz işlem. Değeri DescribeReservedInstances olarak belirtin.
RegionId	String	Evet	cn-hangzhou	Ayrılmış örneklerin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
PageNumber	Integer	Hayır	1	Sayfa numarası. Sayfalar 1'den başlar. Varsayılan değer: 1.
PageSize	Integer	Hayır	50	Sayfa başına kayıt sayısı. Maksimum değer: 100. Varsayılan değer: 10.
Tag.N.Key	String	Hayır	TestKey	Ayrılmış örneğin N. etiketinin anahtarı. N için geçerli değerler: 1 ile 20 arası. Etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir ve acs: veya aliyun ile başlayamaz. http:// veya https:// içermemelidir. Kaynakları sorgulamak için tek bir etiket belirtirseniz bu etiketin eklendiği en fazla 1.000 kaynak döndürülür. Kaynakları sorgulamak için birden çok etiket belirtirseniz belirtilen tüm etiketlerin eklendiği en fazla 1.000 kaynak döndürülür. Belirtilen etiketlerin eklendiği 1.000'den fazla kaynağı sorgulamak için ListTagResources işlemini çağırın.
Tag.N.Value	String	Hayır	TestValue	Ayrılmış örneğin N. etiketinin değeri. N için geçerli değerler: 1 ile 20 arası. Etiket değeri boş bir dize olabilir. Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve http:// veya https:// içermemelidir. Etiket değeri acs: ile başlayamaz.
ZoneId	String	Hayır	cn-hangzhou-z	Ayrılmış örneğin alan kimliği. Scope parametresi Zone olarak ayarlandığında bu parametre zorunludur. En güncel alan listesini sorgulamak için DescribeZones işlemini çağırabilirsiniz.
ReservedInstanceName	String	Hayır	testReservedInstanceName	Ayrılmış örneğin adı.
LockReason	String	Hayır	security	Ayrılmış örneğin kilitlenme nedeni. Geçerli değerler: financial: Hesapta geciken ödeme olması veya hizmetin süresinin dolması nedeniyle ayrılmış örnek kilitlenir. security: Güvenlik nedenleriyle ayrılmış örnek kilitlenir.
InstanceType	String	Hayır	ecs.g5.large	Ayrılmış örneğin örnek türü. Değerler hakkında bilgi için Örnek ailelerine genel bakış konusuna bakın.
InstanceTypeFamily	String	Hayır	ecs.g5	Ayrılmış örneğin örnek ailesi. Değerler hakkında bilgi için Örnek ailelerine genel bakış konusuna bakın.
Scope	String	Hayır	Region	Ayrılmış örneğin kapsamı. Geçerli değerler: Region Zone Varsayılan değer: Region.
OfferingType	String	Hayır	All Upfront	Ayrılmış örneğin faturalandırma yöntemi. Geçerli değerler: No Upfront Partial Upfront All Upfront
AllocationType	String	Hayır	Normal	Ayrılmış örneklerin tahsis türü. Geçerli değerler: Normal: Mevcut hesaba ait tüm ayrılmış örnekleri sorgular. Shared: Mevcut ana hesap ile bağlantılı hesaplar arasında paylaşılan ayrılmış örnekleri sorgular. Varsayılan değer: Normal.
ReservedInstanceId.N	String	Hayır	ri-bpzhex2ulpzf53****	N. ayrılmış örneğin kimliği. N için geçerli değerler: 1 ile 100 arası.
Status.N	String	Hayır	Active	N. ayrılmış örneğin durumu. N için geçerli değerler: 1 ile 100 arası. Geçerli değerler: Creating: Ayrılmış örnek oluşturuluyor. Active: Ayrılmış örnek etkin. Expired: Ayrılmış örneğin süresi doldu. Updating: Ayrılmış örneğin özellikleri değiştiriliyor.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
PageSize	Integer	1	Sayfa başına kayıt sayısı.
RequestId	String	E572643C-6A29-49D6-9D4E-6CFA4E063A3E	İsteğin kimliği.
PageNumber	Integer	1	Sayfa numarası.
TotalCount	Integer	1	Toplam ayrılmış örnek sayısı.
ReservedInstances	Array of ReservedInstance		Ayrılmış örneklerle ilgili ayrıntılar.
ReservedInstance
Status	String	Active	Ayrılmış örneğin durumu.
CreationTime	String	2018-12-10T12:07Z	Ayrılmış örneğin oluşturulma zamanı.
ReservedInstanceName	String	riZbpzhex2ulpzf53****	Ayrılmış örneğin adı.
ReservedInstanceId	String	ri-bpzhex2ulpzf53****	Ayrılmış örneğin kimliği.
InstanceType	String	ecs.g5.large	Her bir ayrılmış örnekle eşleşen kullandıkça öde örneklerinin örnek türü.
InstanceAmount	Integer	10	Ayrılmış örnekle aynı örnek türüne sahip ve ayrılmış örnekle eşleştirilebilen kullandıkça öde örneklerinin sayısı.
RegionId	String	cn-hangzhou	Ayrılmış örneğin bölge kimliği.
OfferingType	String	All Upfront	Ayrılmış örneğin faturalandırma yöntemi.
StartTime	String	2018-12-10T12:00Z	Ayrılmış örneklerin yürürlüğe girdiği zaman.
Description	String	testDescription	Ayrılmış örneğin açıklaması.
AllocationStatus	String	allocated	AllocationType parametresi Shared olarak ayarlandığında ayrılmış örneğin tahsis durumu. Geçerli değerler: allocated: Ayrılmış örnek başka bir hesaba tahsis edildi. beAllocated: Ayrılmış örnek başka bir hesap tarafından tahsis edildi.
ExpiredTime	String	2019-12-10T12:07Z	Ayrılmış örneğin sona erme zamanı.
ResourceGroupId	String	EcsDocTest	Kaynak grubunun kimliği.
ZoneId	String	cn-hangzhou-z	Alanın kimliği.
Platform	String	Linux	İşletim sistemi türü. Geçerli değerler: Windows Linux
Scope	String	region	Ayrılmış örneğin kapsamı.
OperationLocks	Array of OperationLock		Ayrılmış örneklerin kilit durumuyla ilgili ayrıntılar.
OperationLock
LockReason	String	security	Ayrılmış örneğin kilitlenme nedeni.
Tags	Array of Tag		Ayrılmış örneğin etiketleri.
Tag
TagValue	String	TestValue	Ayrılmış örneğin etiket değeri.
TagKey	String	TestKey	Ayrılmış örneğin etiket anahtarı.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=DescribeReservedInstances
&RegionId=cn-hangzhou
&Scope=Region
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<DescribeReservedInstancesResponse>
    <ReservedInstances>
        <ReservedInstance>
            <CreationTime>2018-12-10T12:07Z</CreationTime>
            <ExpiredTime>2019-12-10T16:00Z</ExpiredTime>
            <InstanceAmount>1</InstanceAmount>
            <ReservedInstanceId>ri-0xzhex2ulpzf53****</ReservedInstanceId>
            <InstanceType>ecs.g5.large</InstanceType>
            <OfferingType>All Upfront</OfferingType>
            <RegionId>cn-hangzhou-test-307</RegionId>
            <ReservedInstanceName>riZ0xzhex2ulpzf53****</ReservedInstanceName>
            <Scope>region</Scope>
            <StartTime>2018-12-10T12:00Z</StartTime>
            <Status>Active</Status>
            <Tags>
                <Tag>
                    <TagKey>TestKey</TagKey>
                    <TagValue>TestValue</TagValue>
                </Tag>
            </Tags>
        </ReservedInstance>
    </ReservedInstances>
    <RequestId>E572643C-6A29-49D6-9D4E-6CFA4E063A3E</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>50</PageSize>
    <Total>1</Total>
</DescribeReservedInstancesResponse>

JSON biçimi

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

{
  "ReservedInstances" : {
    "ReservedInstance" : [ {
      "CreationTime" : "2018-12-10T12:07Z",
      "ExpiredTime" : "2019-12-10T16:00Z",
      "InstanceAmount" : 1,
      "ReservedInstanceId" : "ri-0xzhex2ulpzf53****",
      "InstanceType" : "ecs.g5.large",
      "OfferingType" : "All Upfront",
      "RegionId" : "cn-hangzhou-test-307",
      "ReservedInstanceName" : "riZ0xzhex2ulpzf53****",
      "Scope" : "region",
      "StartTime" : "2018-12-10T12:00Z",
      "Status" : "Active",
      "Tags" : {
        "Tag" : [ {
          "TagKey" : "TestKey",
          "TagValue" : "TestValue"
        } ]
      }
    } ]
  },
  "RequestId" : "E572643C-6A29-49D6-9D4E-6CFA4E063A3E",
  "PageNumber" : 1,
  "PageSize" : 50,
  "Total" : 1
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata iletisi	Açıklama
400	MissingParamter.RegionId	The regionId should not be null.	RegionId gereklidir.
400	InvalidRegion.NotFound	The specified parameter RegionId is not valid.	Geçersiz RegionId değeri.
400	InvalidZone.NotFound	The specified parameter ZoneId is not valid.	Geçersiz ZoneId değeri.
400	InvalidEndTime.ValueNotSupported	The specified endTime is out of the permitted range.	Geçersiz EndTime değeri.
400	InvalidAllocationType.ValueNotSupported	The specified AllocationType is not supported.	Geçersiz AllocationType değeri.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.	RegionId değeri bulunamadı. Hizmetin belirtilen bölgede kullanılabilir olup olmadığını kontrol edin.

Hata kodlarının listesi için bkz. Hizmet hata kodları.