StartInstances - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bu işlemi çağırırken aşağıdaki hususlara dikkat edin:

Başlatmak istediğiniz örnekler Durdurulmuş(Stopped) durumunda olmalıdır.
Örnek bilgilerini sorguladığınızda yanıt {"OperationLocks": {"LockReason" : "security"}} içeriyorsa, örnek güvenlik nedenleriyle kilitlenmiş demektir ve bu örnek üzerinde tüm işlemler yasaklanır.
Toplu işlemler desteklenir. Toplu işlem modunu belirtmek için BatchOptimization parametresini kullanabilirsiniz.

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

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	StartInstances	Gerçekleştirmek istediğiniz işlem. Değeri StartInstances olarak ayarlayın.
DryRun	Boolean	Hayır	false	Deneme çalıştırması (dry run) yapılıp yapılmayacağını belirtir. Geçerli değerler: true: Deneme çalıştırması gerçekleştirir. Sistem gerekli parametreleri, istek sözdizimini ve örnek durumunu kontrol eder. İstek deneme çalıştırmasından başarısız olursa bir hata mesajı döndürülür. İstek deneme çalıştırmasını geçerse `DRYRUN.SUCCESS` döndürülür. Not `BatchOptimization` parametresini `SuccessFirst` ve `DryRun` parametresini true olarak ayarlarsanız, isteğin deneme çalıştırmasını geçip geçmediğinden bağımsız olarak yalnızca `DRYRUN.SUCCESS` döndürülür. false: Deneme çalıştırması gerçekleştirir ve isteği gönderir. İstek deneme çalıştırmasını geçerse işlem yürütülür. Varsayılan değer: false.
RegionId	String	Evet	cn-hangzhou	Örneğin bölge kimliği (ID). En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
BatchOptimization	String	Hayır	AllTogether	Toplu işlem modu. Geçerli değerler: AllTogether: Bu modda, belirtilen tüm örnekler başarıyla başlatılırsa bir başarı mesajı döndürülür. DryRun parametresi false olarak ayarlandığında belirtilen örneklerden biri veya birkaçı kontrolü geçemezse, belirtilen örneklerin hiçbiri başlatılamaz ve bir hata mesajı döndürülür. SuccessFirst: Bu modda her örnek ayrı ayrı başlatılır. Yanıt, her örnek için işlem sonuçlarını içerir. Varsayılan değer: AllTogether.
InstanceId.N	String	Evet	i-bp67acfmxazb4p****	N numaralı örneğin kimliği (ID). N için geçerli değer aralığı: 1 ila 100.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	İsteğin kimliği (ID).
InstanceResponses	InstanceResponse dizisi		Her örneğin işlem öncesi ve sonrası durumunu ile işlem sonuçlarını içeren, örneğe özel yanıt ayrıntıları.
InstanceResponse
Code	String	200	Örnek için döndürülen hata kodu. 200 değeri başarıyı gösterir. Daha fazla bilgi için bu konudaki "Hata kodları" bölümüne bakın.
Message	String	success	Örnek için döndürülen hata mesajı. success değeri işlemin başarılı olduğunu gösterir. Daha fazla bilgi için bu konudaki "Hata kodları" bölümüne bakın.
InstanceId	String	i-bp67acfmxazb4p****	Örneğin kimliği (ID).
CurrentStatus	String	Starting	Örneğin mevcut durumu.
PreviousStatus	String	Stopped	İşlem çağrılmadan önceki örnek durumu.

Örnekler

Örnek istekler

http(s)://ecs.aliyuncs.com/?Action=StartInstances
&RegionId=cn-hangzhou
&BatchOptimization=AllTogether
&InstanceId=["i-bp67acfmxazb4p****"]
&Common request parameters

Örnek başarılı yanıt

XML biçimi

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

<StartInstancesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <InstanceResponses>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Stopped</PreviousStatus>
            <CurrentStatus>Starting</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Stopped</PreviousStatus>
            <CurrentStatus>Starting</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>The specified InstanceId does not exist.</Message>
            <InstanceId>i-TestID</InstanceId>
            <PreviousStatus/>
            <CurrentStatus/>
            <Code>InvalidInstanceId.NotFound</Code>
        </InstanceResponse>
    </InstanceResponses>
</StartInstancesResponse>

JSON biçimi

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceResponses" : {
    "InstanceResponse" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Stopped",
      "CurrentStatus" : "Starting",
      "Code" : "200"
    }, {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Stopped",
      "CurrentStatus" : "Starting",
      "Code" : "200"
    }, {
      "Message" : "The specified InstanceId does not exist.",
      "InstanceId" : "i-TestID",
      "PreviousStatus" : "",
      "CurrentStatus" : "",
      "Code" : "InvalidInstanceId.NotFound"
    } ]
  }
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Bir disk için KMS anahtar kimliği (ID) belirtildiğinde müşteri ana yönetici anahtarının (CMK) etkinleştirilmemiş olması nedeniyle döndürülen hata mesajı. Belirtilen CMK hakkındaki bilgileri sorgulamak için KMS DescribeKey işlemini çağırabilirsiniz.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	Deneme çalıştırması yapıldığı ve isteğin deneme çalıştırmasını geçtiği için döndürülen hata mesajı.
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	Belirtilen InstanceId.N parametresi geçersiz olduğu için döndürülen hata mesajı.
403	IncorrectInstanceStatus	%s	Örnek mevcut durumda iken işlem desteklenmediği için döndürülen hata mesajı.
403	InvalidInstance.NotFoundSystemDisk	%s	Belirtilen örnekte sistem diski bulunmadığı ve başlatılamadığı için döndürülen hata mesajı. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın. Belirtilen örneğe bir sistem diski eklemek için AttachDisk işlemini çağırmanız gerekir.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	İstenen kaynaklar belirtilen alanda kullanılamadığı için döndürülen hata mesajı. Farklı bir örnek türü veya alan deneyin. Kullanılabilir kaynakları sorgulamak için DescribeZones işlemini çağırabilirsiniz.
403	OperationDenied.SpotPriceLowerThanPublicPrice	The spot instance price is lower than public price.	Ön satın almalı örneğin kullanıcı tanımlı maksimum saatlik fiyatı güncel piyasa fiyatından düşük olduğu için döndürülen hata mesajı.
403	InsufficientBalance	Your account does not have enough balance.	Hesap bakiyeniz yetersiz olduğu için döndürülen hata mesajı. Hesabınıza fon ekleyin ve tekrar deneyin.
403	InstanceNotReady	The specified instance is not ready for use.	Kaynak mevcut durumda iken işlem desteklenmediği için döndürülen hata mesajı. Daha sonra tekrar deneyin.
404	InvalidInstanceId.NotFound	%s	Belirtilen örnek bulunamadığı için döndürülen hata mesajı. Belirtilen örnek kimliğinin (ID) geçerli olup olmadığını kontrol edin.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	Belirtilen örnek bulunamadığı için döndürülen hata mesajı. Belirtilen örnek kimliğinin (ID) geçerli olup olmadığını kontrol edin. Belirli örneklerin durumunu sorgulamak için DescribeInstances işlemini çağırabilirsiniz.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Belirtilen örnek bulunamadığı için döndürülen hata mesajı. Belirtilen örnek kimliğinin (ID) geçerli olup olmadığını kontrol edin.
500	InternalError	The request processing has failed due to some unknown error.	Dahili bir hata oluştuğu için döndürülen hata mesajı. Daha sonra tekrar deneyin.

Hata kodlarının listesi için Servis hata kodları sayfasına bakın.