StopInstances - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bir örnek hakkında bilgi sorguladığınızda yanıtta {"OperationLocks": {"LockReason" : "security"}} ifadesi yer alıyorsa bu örnek güvenlik gerekçesiyle kilitlenmiş demektir ve üzerinde hiçbir işlem yapamazsınız.
Kullandıkça öde örnekler için ekonomik mod etkinleştirildiyse StoppedMode parametresini KeepCharging olarak ayarlayarak örnekler için standart modu etkinleştirebilirsiniz. Örnekler standart modda durdurulduğunda ücretlendirmeye devam edilir; örnek türü kaynakları ve genel IP adresleri korunur.
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

Parameter	Type	Required	Example	Description
Action	String	Yes	StopInstances	Gerçekleştirmek istediğiniz işlem. Değeri StopInstances olarak ayarlayın.
DryRun	Boolean	No	false	Deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler: true: Deneme çalıştırması yapılır. Sistem gerekli parametreleri, istek sözdizimini ve örnek durumunu kontrol eder. İstek deneme çalıştırmasından geçemezse bir hata iletisi döndürülür. İstek deneme çalıştırmasından geçerse `DRYRUN.SUCCESS` döndürülür. Not `BatchOptimization` değerini `SuccessFirst` ve `DryRun` değerini true olarak ayarlarsanız istek deneme çalıştırmasından geçip geçmediğine bakılmaksızın yalnızca `DRYRUN.SUCCESS` döndürülür. false: Deneme çalıştırması yapılır ve istek gönderilir. İstek deneme çalıştırmasından geçerse işlem gerçekleştirilir. Varsayılan değer: false.
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.
ForceStop	Boolean	No	false	Örneğin zorla durdurulup durdurulmayacağını belirtir. Geçerli değerler: true: Örneği zorla durdurur. Bu işlem, yaygın senaryolardaki güç kapatma işlemine eşdeğerdir. Örnekteki depolama aygıtlarına yazılmamış önbellek verileri kaybolur. false: Örneği normal şekilde durdurur. Varsayılan değer: false.
StoppedMode	String	No	KeepCharging	Kullandıkça öde örneğinin durdurma modu. Geçerli değerler: StopCharging: Ekonomik mod. `StopCharging` seçeneğinin geçerli olma koşulları hakkında bilgi için Ekonomik mod bölümündeki "Ekonomik modun etkinleştirilme koşulları" kısmına bakın. KeepCharging: Standart mod. Örnek standart modda durdurulduktan sonra ücretlendirmeye devam edilir. Varsayılan değer: Ekonomik modu etkinleştirme koşulları karşılanıyorsa ve bu modu ECS konsolunda etkinleştirdiyseniz varsayılan değer StopCharging olur. Daha fazla bilgi için `Economical mode` konusundaki "Ekonomik modu etkinleştir" bölümüne bakın. Aksi takdirde varsayılan değer `KeepCharging` olur.
BatchOptimization	String	No	AllTogether	Toplu işlem modu. Geçerli değerler: AllTogether: Bu modda belirtilen tüm örnekler durdurulursa başarı iletisi döndürülür. DryRun parametresini false olarak ayarladığınızda belirtilen örneklerden biri veya birkaçı kontrolden geçemezse belirtilen örneklerin hiçbiri durdurulamaz ve bir hata iletisi döndürülür. SuccessFirst: Bu modda her örnek ayrı ayrı durdurulur. Yanıt, her örnek için işlem sonuçlarını içerir. Varsayılan değer: AllTogether.
InstanceId.N	String	Yes	i-bp67acfmxazb4p****	N. örneğin kimliği. N için geçerli değerler: 1 ile 100.

Yanıt parametreleri

Parameter	Type	Example	Description
RequestId	String	1C488B66-B819-4D14-8711-C4EAAA13AC01	İsteğin kimliği.
InstanceResponses	Array of InstanceResponse		Her örneğin işlem çağrılmadan önceki ve sonraki durumunu ile işlemin sonuçlarını içeren, örnek bazlı yanıt ayrıntıları.
InstanceResponse
Code	String	200	Örnek için döndürülen hata kodu. 200 dönüş 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 iletisi. Success dönüş 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.
CurrentStatus	String	Stopping	Örneğin mevcut durumu.
PreviousStatus	String	Running	İşlem çağrılmadan önceki örnek durumu.

Örnekler

Örnek istekler

http(s)://ecs.aliyuncs.com/?Action=StopInstances
&InstanceId.1=i-bp67acfmxazb4p****
&InstanceId.2=i-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&ForceStop=false
&StoppedMode=KeepCharging
$BatchOptimization=SuccessFirst
&Common request parameters

Örnek başarılı yanıt

XML biçimi

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

<StopInstancesResponse>
    <RequestId>FF53E96D-3F1A-42F0-8373-1C2B39D72D44</RequestId>
    <InstanceResponses>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Running</PreviousStatus>
            <CurrentStatus>Stopping</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Running</PreviousStatus>
            <CurrentStatus>Stopping</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>
</StopInstancesResponse>

JSON biçimi

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

{
  "RequestId" : "FF53E96D-3F1A-42F0-8373-1C2B39D72D44",
  "InstanceResponses" : {
    "InstanceResponse" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Running",
      "CurrentStatus" : "Stopping",
      "Code" : "200"
    }, {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Running",
      "CurrentStatus" : "Stopping",
      "Code" : "200"
    }, {
      "Message" : "The specified InstanceId does not exist.",
      "InstanceId" : "i-TestID",
      "PreviousStatus" : "",
      "CurrentStatus" : "",
      "Code" : "InvalidInstanceId.NotFound"
    } ]
  }
}

Hata kodları

HTTP status code	Error code	Error message	Description
400	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Bir disk için KMS anahtar kimliği belirtildiğinde müşteri ana şifreleme anahtarı (CMK) etkinleştirilmemişse döndürülen hata iletisi. 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ığında ve istek deneme çalıştırmasından geçtiğinde döndürülen hata iletisi.
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	Belirtilen InstanceId.N parametresi geçersiz olduğunda döndürülen hata iletisi.
403	IncorrectInstanceStatus	%s	Örnek mevcut durumdayken işlem desteklenmediği için döndürülen hata iletisi.
403	InsufficientBalance	Your account does not have enough balance.	Hesap bakiyeniz yetersiz olduğu için döndürülen hata iletisi. Hesabınıza bakiye ekleyip tekrar deneyin.
403	InstanceNotReady	The specified instance is not ready for use.	Kaynak mevcut durumdayken işlem desteklenmediği için döndürülen hata iletisi. Daha sonra tekrar deneyin.
404	InvalidInstanceId.NotFound	%s	Belirtilen örnek bulunamadığı için döndürülen hata iletisi. Belirtilen örnek kimliğinin geçerli olup olmadığını kontrol edin.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	Belirtilen örnek kimliği bulunamadığı için döndürülen hata iletisi. Belirtilen örnek kimliğinin 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 iletisi. Belirtilen örnek kimliğinin 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 iletisi. Daha sonra tekrar deneyin.

Hata kodlarının listesi için Service error codes sayfasına bakın.