DetachInstanceRamRole - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter

Type

Required

Example

Description

Action

String

Yes

DetachInstanceRamRole

L'opération à effectuer. Définissez la valeur sur DetachInstanceRamRole.

RegionId

String

Yes

cn-hangzhou

ID de la région. Appelez l'opération DescribeRegions pour obtenir la liste des régions.

RamRoleName

String

No

RamRoleTest

Nom du rôle RAM d'instance. Appelez l'opération ListRoles fournie par RAM pour consulter les rôles RAM d'instance créés.

InstanceIds

String

Yes

["i-bp67acfmxazb4p**", "i-bp67acfmxazb5p", "i-bp67acfmxazb6p**"…]

ID des instances. La valeur est un tableau JSON contenant jusqu'à 100 ID d'instance. Séparez les ID par des virgules (,).

Paramètres de réponse

Parameter

Type

Example

Description

RamRoleName

String

RamRoleTest

Nom du rôle RAM d'instance.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

TotalCount

Integer

1

Nombre total d'instances dont vous avez tenté de détacher les rôles RAM.

FailCount

Integer

0

Nombre d'instances pour lesquelles le détachement du rôle RAM a échoué.

DetachInstanceRamRoleResults

Array of DetachInstanceRamRoleResult

Résultats du détachement des rôles RAM des instances.

DetachInstanceRamRoleResult

Code

String

200

Indique si le rôle RAM d'instance a été détaché. Le code 200 signifie que la requête a abouti. Tout autre code indique un échec.

Message

String

Success

Indique si le rôle RAM d'instance a été détaché. La valeur Success signifie que la requête a abouti. Toute autre valeur indique un échec. Pour plus d'informations, consultez la section « Codes d'erreur » de cette rubrique.

InstanceId

String

i-bp67acfmxazb4p****

ID de l'instance dont vous avez tenté de détacher le rôle RAM.

Success

Boolean

true

Indique si le rôle RAM d'instance a été détaché.

InstanceRamRoleSets

Array of InstanceRamRoleSet

Rôles RAM des instances.

InstanceRamRoleSet

RamRoleName

String

RamRoleTest

Nom du rôle RAM d'instance.

InstanceId

String

i-bp67acfmxazb4p****

ID de l'instance.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=DetachInstanceRamRole
&InstanceIds=["i-bp67acfmxazb4p****", "i-bp67acfmxazb5p****", "i-bp67acfmxazb6p****"…]
&RegionId=cn-hangzhou
&RamRoleName=RamRoleTest
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<DetachInstanceRamRoleResponse>
    <TotalCount>1</TotalCount>
    <DetachInstanceRamRoleResults>
        <DetachInstanceRamRoleResult>
            <Message>success</Message>
            <InstanceId>i-bp16qng6jnvt6g7t****</InstanceId>
            <Code>200</Code>
            <InstanceRamRoleSets>
                <InstanceId>i-bp16qng6jnvt6g7t****</InstanceId>
                <RamRoleName>RamRoleTest</RamRoleName>
            </InstanceRamRoleSets>
        </DetachInstanceRamRoleResult>
    </DetachInstanceRamRoleResults>
    <RequestId>14D5B163-CE6C-4489-B979-DBE5D0495A63</RequestId>
    <RamRoleName/>
    <FailCount>0</FailCount>
</DetachInstanceRamRoleResponse>

Format JSON

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

{
  "TotalCount" : 1,
  "DetachInstanceRamRoleResults" : {
    "DetachInstanceRamRoleResult" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp16qng6jnvt6g7t****",
      "Code" : "200",
      "InstanceRamRoleSets" : {
        "InstanceId" : "i-bp16qng6jnvt6g7t****",
        "RamRoleName" : "RamRoleTest"
      }
    } ]
  },
  "RequestId" : "14D5B163-CE6C-4489-B979-DBE5D0495A63",
  "RamRoleName" : "",
  "FailCount" : 0
}

Codes d'erreur

HTTP status code

Error code

Error message

Description

400

InvalidInstanceIds.Malformed

The specified instanceIds are not valid.

Les ID d'instance spécifiés ne sont pas valides.

403

InvalidNetworkType.MismatchRamRole

Ram role cannot be applied to instances of Classic network type.

Les rôles RAM d'instance sont réservés aux instances de réseaux privés virtuels (VPC) et ne peuvent pas être utilisés avec le réseau classique.

403

InvalidUser.PassRoleForbidden

The RAM user does not have the privilege to pass a RAM role.

L'utilisateur RAM n'est pas autorisé à transmettre un rôle RAM.

404

InvalidInstanceId.NotFound

The specified instanceId does not exist.

L'ID d'instance spécifié est introuvable.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.