Tüm Ürünler
Search
Belge Merkezi

:AttachInstanceRamRole

Son Güncelleme:Sep 29, 2026

Bir örnek RAM rolünü bir veya daha fazla ECS örneğine bağlamak için bu işlemi çağırabilirsiniz. Bir örnekte zaten bir örnek RAM rolü varsa, o örneğe başka bir örnek RAM rolü bağlamaya çalıştığınızda hata alırsınız.

Hata Ayıklama

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

İstek parametreleri

Parametre Tür Zorunlu Örnek Açıklama
Action String Evet AttachInstanceRamRole


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

InstanceIds String Evet ["i-bp14ss25xca5ex1u**", "i-bp154z5o1qjalfse", "i-bp10ws62o04ubhvi**"...]


Örnek RAM rolünü bağlamak istediğiniz örneklerin ID'leri. En fazla 100 örnek ID'sinden oluşan bir JSON dizisi olabilir. Birden fazla örnek ID'sini virgül (,) ile ayırın.

RamRoleName String Evet testRamRoleName


Örnek RAM rolünün adı. Oluşturduğunuz RAM rollerini sorgulamak için RAM tarafından sunulan ListRoles işlemini çağırabilirsiniz.

RegionId String Evet cn-hangzhou


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

Policy String Hayır {"Statement": [{"Action": [""],"Effect": "Allow","Resource": [""]}],"Version":"1"}


İzin ilkesi. İlke 1 ile 1.024 karakter uzunluğunda olmalıdır. Bir veya daha fazla örneğe RAM rolü bağlarken, RAM rolünün izinlerini daha da kısıtlamak amacıyla ek bir ilke belirtebilirsiniz. Daha fazla bilgi için bkz. İlkelere genel bakış.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
AttachInstanceRamRoleResults AttachInstanceRamRoleResult dizisi


Örnek RAM rolünün bağlanma sonuçlarıyla ilgili ayrıntılar.

AttachInstanceRamRoleResult
Code String 200


Örnek RAM rolünün bağlanıp bağlanmadığını gösterir. 200 döndürülürse RAM rolü bağlanmış demektir. Başka bir değer döndürülürse RAM rolü bağlanamamıştır. Daha fazla bilgi için bu konunun "Hata kodları" bölümüne bakın.

InstanceId String i-bp10ws62o04ubhvi****


Örneğin ID'si.

Message String success


Örnek RAM rolünün bağlanıp bağlanmadığını gösterir. success döndürülürse RAM rolü bağlanmış demektir. Başka bir değer döndürülürse RAM rolü bağlanamamıştır. Daha fazla bilgi için bu konunun "Hata kodları" bölümüne bakın.

Success Boolean true


RAM rolünün bağlanıp bağlanmadığını gösterir.

FailCount Integer 0


Bağlanamayan RAM rollerinin sayısı.

RamRoleName String testRamRoleName


Örnek RAM rolünün adı.

RequestId String D9553E4C-6C3A-4D66-AE79-9835AF705639


İsteğin ID'si.

TotalCount Integer 1


Örnek RAM rolünü eklemeyi denediğiniz toplam örnek sayısı.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=AttachInstanceRamRole
&InstanceIds=["i-bp10ws62o04ubhvi****"]
&RamRoleName=testRamRoleName
&RegionId=cn-hangzhou
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

<AttachInstanceRamRoleResponse>
      <RequestId>E6352369-5C2B-41CD-AB50-471550C8F674</RequestId>
      <AttachInstanceRamRoleResults>
            <AttachInstanceRamRoleResult>
                   <InstanceId>i-bp10ws62o04ubhvi****</InstanceId>
                   <Code>200</Code>
                   <Message>success</Message>
            </AttachInstanceRamRoleResult>
      </AttachInstanceRamRoleResults>
      <TotalCount>1</TotalCount>
      <FailCount>0</FailCount>
      <RamRoleName>testRamRoleName</RamRoleName>
</AttachInstanceRamRoleResponse>

JSON biçimi

{
    "RequestId": "D9553E4C-6C3A-4D66-AE79-9835AF705639",
    "AttachInstanceRamRoleResults": {
        "AttachInstanceRamRoleResult": [
            {
                "Message": "success",
                "InstanceId": "i-bp10ws62o04ubhvi****",
                "Code": "200"
            }
        ]
    },
    "TotalCount": 1,
    "FailCount": 0,
    "RamRoleName": "testRamRoleName"
}

Hata kodları

HTTP durum kodu Hata kodu Hata iletisi Açıklama
400 InvalidInstanceIds.Malformed The specified instanceIds are not valid. Belirtilen InstanceIds parametresi geçersiz olduğu için döndürülen hata iletisi.
404 InvalidInstanceId.NotFound The specified instanceId does not exist Belirtilen örnek mevcut olmadığı için döndürülen hata iletisi. Örnek ID'sinin doğru olup olmadığını kontrol edin.
403 InvalidNetworkType.MismatchRamRole Ram role cannot be applied to instances of Classic network type. Örnek RAM rolleri yalnızca VPC'lerdeki örnekler için kullanılabilir, klasik ağdaki örnekler için kullanılamaz. Bu nedenle döndürülen hata iletisi.
403 InvalidUser.PassRoleForbidden The RAM user does not have the privilege to pass a RAM role. RAM kullanıcısının RAM rolünü geçirme yetkisi olmadığı için döndürülen hata iletisi.
404 InvalidRamRole.NotFound The specified RAMRoleName does not exist. Belirtilen RamRoleName parametresi mevcut olmadığı için döndürülen hata iletisi.
404 InvalidRamRole.NotEcsRole The specified ram role is not authorized for ecs, please check your role policy. Belirtilen RAM rolü ECS kullanımı için yetkilendirilmemiş. Rol ilkenizi kontrol edin.

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.