AttachInstanceRamRole - - 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. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	AttachInstanceRamRole	L'action à effectuer. Définissez la valeur sur AttachInstanceRamRole.
InstanceIds	String	Oui	["i-bp14ss25xca5ex1u", "i-bp154z5o1qjalfse", "i-bp10ws62o04ubhvi"...]	Les ID des instances auxquelles vous souhaitez associer le rôle RAM d'instance. Il peut s'agir d'un tableau JSON contenant jusqu'à 100 ID d'instance. Séparez les différents ID par des virgules (,).
RamRoleName	String	Oui	testRamRoleName	Le nom du rôle RAM d'instance. Appelez l'opération ListRoles fournie par RAM pour consulter les rôles RAM que vous avez créés.
RegionId	String	Oui	cn-hangzhou	L'ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
Policy	String	Non	{"Statement": [{"Action": [""],"Effect": "Allow","Resource": [""]}],"Version":"1"}	La politique d'autorisations. La stratégie doit comporter entre 1 et 1 024 caractères. Lorsque vous associez un rôle RAM à une ou plusieurs instances, vous pouvez spécifier une stratégie supplémentaire afin de restreindre davantage les autorisations du rôle RAM. Pour plus d'informations, consultez la section Présentation des stratégies.

Paramètres de réponse

Paramètre	Type	Exemple	Description
AttachInstanceRamRoleResults	Tableau de AttachInstanceRamRoleResult		Détails des résultats de l'association du rôle RAM d'instance.
AttachInstanceRamRoleResult
Code	String	200	Indique si le rôle RAM d'instance a été associé. La valeur 200 signifie que l'association a réussi. Toute autre valeur indique un échec. Pour plus d'informations, consultez la section « Codes d'erreur » de cette rubrique.
InstanceId	String	i-bp10ws62o04ubhvi****	L'ID de l'instance.
Message	String	success	Indique si le rôle RAM d'instance a été associé. La valeur « success » signifie que l'association a réussi. Toute autre valeur indique un échec. Pour plus d'informations, consultez la section « Codes d'erreur » de cette rubrique.
Success	Boolean	true	Indique si le rôle RAM a été associé.
FailCount	Integer	0	Le nombre de rôles RAM dont l'association a échoué.
RamRoleName	String	testRamRoleName	Le nom du rôle RAM d'instance.
RequestId	String	D9553E4C-6C3A-4D66-AE79-9835AF705639	L'ID de la requête.
TotalCount	Integer	1	Le nombre total d'instances auxquelles vous avez tenté d'associer le rôle RAM d'instance.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format XML

<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>

Format JSON

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

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidInstanceIds.Malformed	The specified instanceIds are not valid.	Le paramètre InstanceIds spécifié n'est pas valide.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist	L'instance spécifiée n'existe pas. Vérifiez que l'ID de l'instance est correct.
403	InvalidNetworkType.MismatchRamRole	Ram role cannot be applied to instances of Classic network type.	Un rôle RAM d'instance ne peut être utilisé que pour les instances situées dans un VPC, et non pour celles du 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 le rôle RAM.
404	InvalidRamRole.NotFound	The specified RAMRoleName does not exist.	Le paramètre RamRoleName spécifié n'existe pas.
404	InvalidRamRole.NotEcsRole	The specified ram role is not authorized for ecs, please check your role policy.	Le rôle RAM spécifié n'est pas autorisé à utiliser ECS. Vérifiez la stratégie de votre rôle.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.