Tüm Ürünler
Search
Belge Merkezi

:DescribeInstanceMaintenanceAttributes

Son Güncelleme:Sep 29, 2026

Örneklerin bakım niteliklerini sorgular.

Kullanım notları

Bu işlemi çağırarak bir örneğin belirtilen bakım ilkesini sorgulayabilirsiniz. İlke aşağıdaki ana bakım niteliklerini içerir:

  • Bakım penceresi: Bakım için belirttiğiniz zaman aralığı.

  • Bakım eylemi: Örnek kapatma yanıtı olarak belirttiğiniz eylem.

Hata ayıklama

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

İstek parametreleri

Parameter

Type

Required

Example

Description

Action String Yes DescribeInstanceMaintenanceAttributes

Gerçekleştirmek istediğiniz işlem. Değeri DescribeInstanceMaintenanceAttributes olarak belirtin.

RegionId String Yes cn-hangzhou

Örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

PageNumber Long No 1

Sayfa numarası.

Sayfalar 1'den başlar.

Varsayılan değer: 1.

PageSize Long No 10

Sayfa başına kayıt sayısı. Geçerli değerler: 1 ile 100 arasında.

Varsayılan değer: 10.

InstanceId.N String No i-bp67acfmxazb4p****

N. örneğin kimliği.

Yanıt parametreleri

Parameter

Type

Example

Description

PageSize Integer 10

Sayfa başına kayıt sayısı.

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

İsteğin kimliği.

PageNumber Integer 1

Sayfa numarası.

TotalCount Integer 100

Sorgulanan toplam bakım niteliği sayısı.

MaintenanceAttributes Array of MaintenanceAttribute

Bakım nitelikleri.

MaintenanceAttribute
NotifyOnMaintenance Boolean false

Bakım öncesinde bir olay bildirimi gönderilip gönderilmediğini gösterir.

InstanceId String i-bp67acfmxazb4p****

Örneğin kimliği.

MaintenanceWindows Array of MaintenanceWindow

Bakım pencereleri.

MaintenanceWindow
EndTime String 18:00:00

Bakım penceresinin bitiş saati.

StartTime String 02:00:00

Bakım penceresinin başlangıç saati.

ActionOnMaintenance Object

Örneğin bakım eyleminin nitelikleri.

DefaultValue String AutoRecover

Varsayılan bakım eylemi.

Value String Stop

Geçerli bakım eylemi. Geçerli değerler:

  • Stop: Örneği durdurur.
  • AutoRecover: Örneği kurtarır.
  • AutoRedeploy: Örnekte yük devretme gerçekleştirir; bu durum, örnekteki veri disklerinde hasara neden olabilir.
SupportedValues Array of String Stop

Desteklenen bakım eylemi.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com?Action=DescribeInstanceMaintenanceAttributes
&InstanceId.1=i-bp67acfmxazb4p****
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<DescribeInstanceMaintenanceAttributesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <TotalCount>100</TotalCount>
    <InstanceMaintenanceAttributes>
        <InstanceMaintenanceAttribute>
            <InstanceId>i-bp67acfmxazb4ph***</InstanceId>
            <NotifyOnMaintenance>false</NotifyOnMaintenance>
            <MaintenanceWindows >
                <MaintenanceWindow>
                    <StartTime>02:00:00</StartTime>
                    <EndTime>18:00:00</EndTime>
                </MaintenanceWindow>
            </MaintenanceWindows >
            <ActionOnMaintenance>
                <Value>Stop</Value>
                <DefaultValue>AutoRecover</DefaultValue>
                <SupportedValues>
                    <SupportedValue>Stop</SupportedValue>
                    <SupportedValue>AutoRecover</SupportedValue>
                </SupportedValues>
            </ActionOnMaintenance>
        </InstanceMaintenanceAttribute>
    </InstanceMaintenanceAttributes>
</DescribeInstanceMaintenanceAttributesResponse>

JSON biçimi

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber" : 1,
  "PageSize" : 10,
  "TotalCount" : 100,
  "InstanceMaintenanceAttributes" : {
    "InstanceMaintenanceAttribute" : [ {
      "InstanceId" : "i-bp67acfmxazb4ph***",
      "NotifyOnMaintenance" : false,
      "MaintenanceWindows " : {
        "MaintenanceWindow" : [ {
          "StartTime" : "02:00:00",
          "EndTime" : "18:00:00"
        } ]
      },
      "ActionOnMaintenance" : {
        "Value" : "Stop",
        "DefaultValue" : "AutoRecover",
        "SupportedValues" : {
          "SupportedValue" : [ "Stop", "AutoRecover" ]
        }
      }
    } ]
  }
}

Hata kodları


HTTP status code


Error code


Error message


Description

400 MissingParameter %s Gerekli bir parametre belirtilmemiş.
403 InvalidParameter %s Geçersiz parametre değeri.
403 InstanceIdLimitExceeded %s 100'den fazla örnek kimliği belirtilmiş.
403 OperationDenied.NotInWhiteList %s Bu işlemi gerçekleştirmek için yetkiniz yok. Yetkilendirildikten sonra tekrar deneyin.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. Örnek bulunamadı. Belirtilen örnek kimliğinin geçerli olup olmadığını kontrol edin.

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