ModifyInstanceAttribute - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bir örneğin bilgilerini sorguladığınızda yanıt {"OperationLocks": {"LockReason" : "security"}} değerini içeriyorsa örnek güvenlik nedeniyle kilitlenmiştir. Örnek üzerinde hiçbir işlem yapamazsınız.

Aşağıdaki hususlara dikkat edin:

Ana bilgisayar adını (HostName) değiştirin: Ana bilgisayar adını değiştirdikten sonra yeni ana bilgisayar adının etkili olması için örneği ECS konsolunda yeniden başlatın veya RebootInstance işlemini çağırın. ECS konsolunda bir örneği nasıl yeniden başlatacağınız hakkında bilgi için Restart instances konusuna bakın. Örneği işletim sistemi içinden yeniden başlatırsanız yeni ana bilgisayar adı etkili olmaz.
Parolayı (Password) sıfırlayın:
- Örnek Başlatılıyor (Starting) durumunda olamaz.
- Parolayı sıfırladıktan sonra yeni parolanın etkili olması için örneği ECS konsolunda yeniden başlatın veya RebootInstance işlemini çağırın. ECS konsolunda bir örneği nasıl yeniden başlatacağınız hakkında bilgi için Restart instances konusuna bakın. Örneği işletim sistemi içinden yeniden başlatırsanız yeni parola etkili olmaz.
Kullanıcı verilerini (UserData) değiştirin:
- Örnek Durduruldu (Stopped) durumunda olmalıdır.
- Örnek, kullanıcı verileri için belirlenen sınırları karşılamalıdır. Daha fazla bilgi için Prepare user data konusuna bakın.
  
  Not
  Örneği yeniden başlattıktan sonra yeni kullanıcı verileri görüntülenir ancak betik olarak çalıştırılmaz.
Güvenlik gruplarını (SecurityGroupIds.N) değiştirin:
- Bir örneği farklı türdeki bir güvenlik grubuna taşıyabilirsiniz.
  
  Bir örneği farklı türdeki bir güvenlik grubuna taşımak istiyorsanız örnek ağı üzerindeki etkileri önlemek için iki güvenlik grubu türünün kural yapılandırmaları arasındaki farkları iyi anlamanız gerekir.
- Klasik ağdaki örneklerin güvenlik grupları değiştirilemez.
  
  Daha fazla bilgi için SecurityGroupIds.N açıklamasına bakın.
Birincil esnek ağ arabiriminin (ENI) desteklediği kuyruk sayısını (NetworkInterfaceQueueNumber) değiştirin:
- Örnek Durduruldu (Stopped) durumunda olmalıdır.
- Bu parametrenin değeri ENI başına izin verilen maksimum kuyruk sayısını aşamaz.
- Örnekteki tüm ENI'ler için toplam kuyruk sayısı, örnek türü için belirlenen kuyruk kotasını aşamaz. ENI başına maksimum kuyruk sayısını ve örnek türü için kuyruk kotasını öğrenmek için MaximumQueueNumberPerEni ve TotalEniQueueQuantity değerlerini sorgulamak üzere DescribeInstanceTypes işlemini çağırabilirsiniz.
- Bu parametreyi -1 olarak ayarlarsanız değer örnek türü için varsayılan değere sıfırlanır. Bir örnek türü için birincil ENI tarafından desteklenen varsayılan kuyruk sayısını öğrenmek için PrimaryEniQueueNumber değerini sorgulamak üzere DescribeInstanceTypes işlemini çağırabilirsiniz.
Jumbo Frames özelliğini etkinleştirin veya devre dışı bırakın (EnableJumboFrame): Daha fazla bilgi için MTUs konusuna bakın.
- Örnek Çalışıyor (Running) veya Durduruldu (Stopped) durumunda olmalıdır.
- Örnek bir sanal özel cloud (VPC) içinde bulunmalıdır.
- Jumbo Frames özelliği etkinleştirildiğinde örneğin MTU değeri 8500 olarak ayarlanır. Jumbo Frames özelliği devre dışı bırakıldığında örneğin MTU değeri 1500 olarak ayarlanır.

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer'da ç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	ModifyInstanceAttribute	Gerçekleştirmek istediğiniz işlem. Değeri ModifyInstanceAttribute olarak ayarlayın.
InstanceId	String	Evet	i-bp67acfmxazb4ph****	Örneğin ID'si.
Password	String	Hayır	Test123456	Örneğin parolası. Parola 8 ila 30 karakter uzunluğunda olmalı ve aşağıdaki karakter türlerinden en az üçünü içermelidir: büyük harfler, küçük harfler, rakamlar ve özel karakterler. Özel karakterler şunlardır: ( ) ` ~ ! @ # $ % ^ & * - _ + = \| { } [ ] : ; ' < > , . ? / Windows örnekleri için parolalar eğik çizgi (/) ile başlayamaz. Not Güvenlik nedenleriyle, `Password` belirtilmişse istekleri HTTPS üzerinden göndermenizi öneririz.
HostName	String	Hayır	testHostName	Örneğin ana bilgisayar adı. Aşağıdaki hususlara dikkat edin: Örneğin ana bilgisayar adını değiştirirken örnek Oluşturuluyor (`Pending`) veya Başlatılıyor (`Starting`) durumunda olamaz. Aksi takdirde yeni ana bilgisayar adı ve `/etc/hosts` dosyasındaki yapılandırmalar etkili olmayabilir. Örneğin durumunu sorgulamak için DescribeInstances işlemini çağırabilirsiniz. Ana bilgisayar adını değiştirdikten sonra yeni ana bilgisayar adının etkili olması için RebootInstance işlemini çağırmanız gerekir. Farklı işletim sistemlerini çalıştıran örneklerin ana bilgisayar adları için aşağıdaki sınırlar geçerlidir: Windows Server için ana bilgisayar adı 2 ila 15 karakter uzunluğunda olmalı ve harf, rakam ile tire (-) içerebilir. Ana bilgisayar adı tire (-) ile başlayamaz veya bitemez, ardışık tire (-) içeremez ve yalnızca rakamlardan oluşamaz. Linux gibi diğer işletim sistemleri için ana bilgisayar adı 2 ila 64 karakter uzunluğunda olmalıdır. Ana bilgisayar adını birden çok bölüme ayırmak için nokta (.) kullanabilirsiniz. Her bölüm harf, rakam ve tire (-) içerebilir. Ana bilgisayar adı ardışık nokta (.) veya tire (-) içeremez. Ana bilgisayar adı nokta (.) veya tire (-) ile başlayamaz veya bitemez.
InstanceName	String	Hayır	testInstanceName	Örneğin adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır. Ad bir harfle başlamalı ve `http://` veya `https://` ile başlayamaz. Ad harf, rakam, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir.
Description	String	Hayır	testInstanceDescription	Örneğin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve `http://` veya `https://` ile başlayamaz.
UserData	String	Hayır	ZWNobyBoZWxsbyBlY3Mh	Örneğin kullanıcı verileri. Kullanıcı verileri Base64 ile kodlanmış olmalıdır. Kullanıcı verilerinin boyutu Base64 ile kodlanmadan önce 16 KB'yi aşamaz. Parolalar ve özel anahtarlar gibi gizli bilgileri düz metin olarak geçirmemenizi öneririz. Gizli bilgi geçirmeniz gerekiyorsa bilgileri geçirmeden önce şifrelemenizi ve Base64 ile kodlamanızı öneririz. Ardından bilgileri örnek içinde aynı şekilde çözebilir ve şifresini çözebilirsiniz.
Recyclable	Boolean	Hayır	hide	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
CreditSpecification	String	Hayır	Standard	Burstable örneğin performans modu. Geçerli değerler: Standard Unlimited Burstable örneklerin performans modları hakkında daha fazla bilgi için Overview konusuna bakın.
DeletionProtection	Boolean	Hayır	false	Örneğin silme koruma niteliği. Bu parametre, örneği ECS konsolunu kullanarak veya DeleteInstance işlemini çağırarak serbest bırakıp bırakamayacağınızı belirtir. Not Bu parametre yalnızca kullandıkça öde örnekler için geçerlidir. Silme koruma niteliği örnekleri manuel serbest bırakmalara karşı korur ancak otomatik serbest bırakmalara karşı korumaz.
NetworkInterfaceQueueNumber	Integer	Hayır	8	Birincil ENI tarafından desteklenen kuyruk sayısı.
SecurityGroupIds.N	String	Hayır	sg-bp15ed6xe1yxeycg7o****	Değiştirilecek güvenlik gruplarının ID'leri. Güvenlik grubu ID'si benzersiz olmalıdır. Örnek mevcut güvenlik gruplarından değiştirilecek güvenlik gruplarına taşınır. Örneğin mevcut güvenlik gruplarında kalmasını istiyorsanız mevcut güvenlik gruplarının ID'lerini listeye ekleyin. Örneği farklı türdeki güvenlik gruplarına taşıyabilirsiniz. Ancak liste hem temel hem de gelişmiş güvenlik grubu ID'lerini içeremez. Belirtilen güvenlik grubu ve örnek aynı VPC'ye ait olmalıdır. N için geçerli değerler, örneğin ait olabileceği maksimum güvenlik grubu sayısına bağlıdır. Daha fazla bilgi için Limits konusuna bakın. Yeni güvenlik grupları kısa bir gecikme süresinin ardından örnek için geçerli hale gelir.
RemoteConnectionOptions.Password	String	Hayır	hide	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
RemoteConnectionOptions.Type	String	Hayır	hide	Not Bu parametre davetli ön izleme aşamasındadır ve genel kullanıma sunulmamıştır.
EnableJumboFrame	Boolean	Hayır	false	Örnek için Jumbo Frames özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true false Jumbo Frames özelliğini yalnızca belirli örnek türleri için etkinleştirebilirsiniz. Daha fazla bilgi için MTUs konusuna bakın.
CpuOptions.TopologyType	String	Hayır	DiscreteCoreToHTMapping	Örneğin CPU topoloji türü. Geçerli değerler: ContinuousCoreToHTMapping: Hyper-Threading (HT) teknolojisi, örneğin CPU topolojisinde sürekli iş parçacıklarının aynı çekirdek üzerinde çalışmasına olanak tanır. DiscreteCoreToHTMapping: HT teknolojisi, örneğin CPU topolojisinde ayrık iş parçacıklarının aynı çekirdek üzerinde çalışmasına olanak tanır. Bu parametre varsayılan olarak boştur. Not Bu parametre yalnızca belirli örnek aileleri tarafından desteklenir. Desteklenen örnek aileleri hakkında daha fazla bilgi için View and modify the CPU topology konusuna bakın. Bu parametreyi belirtmeden önce örneğin Durduruldu (`Stopped`) durumunda olduğundan emin olun.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	İsteğin ID'si.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=ModifyInstanceAttribute
&InstanceId=i-bp67acfmxazb4ph****
&Action=ModifyInstanceAttribute
&CreditSpecification=Standard
&DeletionProtection=false
&Description=testInstanceDescription
&HostName=testHostName
&InstanceName=testInstanceName
&Password=Test123456
&SecurityGroupIds.1=sg-bp15ed6xe1yxeycg7o****
&SecurityGroupIds.2=sg-bp15ed6xe1yxeycg7p****
&SecurityGroupIds.3=sg-bp15ed6xe1yxeycg7q****
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<ModifyInstanceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>

JSON biçimi

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	InvalidInstanceName.Malformed	The specified parameter "InstanceName" is not valid.	Geçersiz InstanceName değeri.
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	Geçersiz Description biçimi. Ad 2 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.
400	ImageNotSupportCloudInit	The specified image does not support cloud-init.	Belirtilen görüntü cloud-init'i desteklemiyor.
400	ChargeTypeViolation	Pay-As-You-Go instances do not support this operation.	İşlem kullandıkça öde örneklerde gerçekleştirilemez. Örneğin faturalama yöntemini kontrol edin.
400	InvalidParameter.RecycleBin	You do not have permission to set recyclable properties.	İşlemi gerçekleştirmek için yetkiniz yok.
400	InvalidParameter.CreditSpecification	The specified CreditSpecification is not supported in this region.	Belirtilen kredi teknik özellikleri bu bölgede desteklenmiyor.
400	InvalidInstanceStatus.CreditSpecRestricted	The current status of the resource does not support this operation.	Kaynak mevcut durumda bu işlem gerçekleştirilemez.
400	InvalidInstanceStatus.NotRunning	The current status of the resource is invalid, you can only do this operation when instance is running.	Örnek mevcut durumda bu işlem gerçekleştirilemez. Örnek Çalışıyor durumundayken tekrar deneyin.
400	JoinedGroupLimitExceed	%s	Belirtilen kaynağın atanabileceği maksimum güvenlik grubu sayısı aşıldı. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.
400	InvalidParameter	The specified parameter is not valid.	Belirtilen bir parametre geçersiz.
400	InvalidOperation.InvalidEcsState	%s	Örnek mevcut durumda bu işlem gerçekleştirilemez.
400	InvalidOperation.InstanceStatusUnsupported	The specified instance status does not support modification of cpu topology type.	Örnek mevcut durumda CPU topolojisi değiştirilemez.
400	InvalidParameter.CpuOptionsTopologyType	The specified parameter CpuOptions.TopologyType: %s is not valid.	Geçerli CPU topoloji türünün numaralandırma değeri geçersiz.
400	InvalidInstanceType.NotSupportCpuOptionsTopologyType	The specified instance type does not support CpuOptions.TopologyType: %s.	Örnek türü belirtilen CPU topolojisini desteklemiyor.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Kaynak mevcut durumda bu işlem gerçekleştirilemez.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Örnek güvenlik nedeniyle kilitlendi.
403	OperationDenied	The instance amount in the specified SecurityGroup reach its limit.	Belirtilen güvenlik grubundaki maksimum örnek sayısı aşıldı.
403	OperationDenied	The current status of the resource does not support this operation.	Kaynak mevcut durumda bu işlem gerçekleştirilemez.
403	InvalidUserData.Base64FormatInvalid	The specified UserData is not valid	Geçersiz UserData değeri.
403	InvalidChargeType.ValueNotSupported	Deletion protection is only valid for postPaid instance, not for prePaid or spot instance.	Silme koruma özelliği yalnızca kullandıkça öde kaynaklarda kullanılabilir.
403	InvalidUser.Unauthorized	The user is not authorized	Bu işlemi gerçekleştirmek için yetkiniz yok.
403	EnterpriseGroupLimited.MutliGroupType	The specified instance can not join multi SecurityGroup types.	Belirtilen örnek hem temel hem de gelişmiş bir güvenlik grubuna ait olamaz. Belirli bir güvenlik grubunun türünü sorgulamak için DescribeSecurityGroups işlemini çağırabilirsiniz.
403	SecurityGroupInstanceLimitExceed	%s	Belirtilen güvenlik grubundaki maksimum örnek sayısı aşıldı.
403	InstanceNotInSecurityGroup	The instance not in the group.	Belirtilen örnek güvenlik grubuna ait değil.
403	InvalidOperation.InvalidRegion	%s	Geçersiz RegionId değeri.
403	OperationDenied	The specified Image is disabled or is deleted.	Belirtilen görüntü devre dışı veya silinmiş.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Cloud hizmetleri tarafından yönetilen güvenlik gruplarını değiştiremezsiniz.
403	InvalidParameter.InvalidEniQueueNumber	%s	Geçersiz QueueNumber değeri. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	ENI başına maksimum kuyruk sayısı aşıldı. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Bir örnekteki tüm ENI'ler için maksimum kuyruk sayısı aşıldı. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	Belirtilen güvenlik grubu bu hesapta bulunamadı. Güvenlik grubu ID'sinin doğru olup olmadığını kontrol edin.
404	Credit.NotFound	The specified credit information does not exist.	Belirtilen kredi bilgisi mevcut değil.
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.	Yinelenen güvenlik grubu ID'leri bulundu. SecurityGroupIds.N değerinin geçerli olup olmadığını kontrol edin.
404	InvalidSecurityGroupType.NotSupportClassic	The specified SecurityGroupIds have classic group type.	Belirtilen güvenlik grubu klasik ağda bulunuyor. SecurityGroupId.N değerinin geçerli olup olmadığını kontrol edin.
404	InvalidSecurityGroupVpc.NotBelongToOneVpc	The specified SecurityGroupIds are belong to different vpc.	Belirtilen güvenlik grupları farklı VPC'lere ait. SecurityGroupIds.N değerinin geçerli olup olmadığını kontrol edin. Güvenlik gruplarının ait olduğu VPC'leri sorgulamak için DescribeSecurityGroups işlemini çağırabilirsiniz.
500	InternalError	The request processing has failed due to some unknown error.	Dahili bir hata oluştu. Daha sonra tekrar deneyin.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Dahili bir hata oluştu. Daha sonra tekrar deneyin.

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