Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisation de l'API pour Amazon EC2
Important
Depuis le 14 octobre 2022, les réponses HTTP des API Amazon EC2 n'incluent plus d'élément de phrase de raison. Comme le recommande la RFC7230
Nous fournissons l'API Query pour Amazon EC2, ainsi que des kits de développement logiciel (SDK) AWS qui vous permettent d'accéder à Amazon EC2 depuis votre langage de programmation préféré. Pour plus d'informations, consultez le guide du développeur Amazon EC2.
Table des matières
Connaissances requises
Si vous envisagez d'accéder à Amazon EC2 via une API, vous devez connaître les éléments suivants :
-
xml
-
Services Web
-
Requêtes HTTP
-
Un ou plusieurs langages de programmation, tels que Java, PHP, Perl, Python, Ruby, C# ou C++.
API disponibles pour Amazon EC2
L'API Amazon EC2 Query fournit des requêtes HTTP ou HTTPS qui utilisent le verbe HTTP GET ou POST et un paramètre de requête nomméAction.
AWS fournit des bibliothèques, des exemples de code, des didacticiels et d'autres ressources aux développeurs de logiciels qui préfèrent créer des applications à l'aide d'API spécifiques à un langage plutôt que de soumettre une demande via HTTP ou HTTPS. Ces bibliothèques fournissent des fonctions de base qui prennent automatiquement en charge des tâches telles que la signature cryptographique de vos demandes, les nouvelles tentatives et la gestion des réponses aux erreurs, afin de vous permettre de démarrer plus facilement.
Pour plus d'informations, consultez la section Création de ressources Amazon EC2 à l'aide d'un AWS SDK dans le Guide du développeur Amazon EC2.
Paramètres de requête courants
La plupart des actions d'API Amazon EC2 prennent en charge les paramètres décrits dans les tableaux suivants. Les paramètres courants varient selon que vous utilisez Signature Version 2 ou Signature Version 4 pour signer vos demandes. Pour plus d'informations, consultez la section Signer des demandes d' AWS API dans le guide de l'utilisateur IAM.
Table des matières
Paramètres pour la version 4 de Signature
| Nom | Description | Obligatoire |
|---|---|---|
|
|
L'action à effectuer. Exemple : |
Oui |
|
|
Version de l'API à utiliser. |
Oui |
|
|
Algorithme de hachage que vous utilisez pour créer la signature de la demande. Exemple : |
Oui |
|
|
L'étendue des informations d'identification pour la demande, au format Exemple : |
Oui |
|
|
Date et heure auxquelles la demande est signée, au format YYYymmddThhmmssz. La date doit correspondre à la date incluse dans la portée des informations d'identification pour le Exemple : |
Oui |
X-Amz-SignedHeaders |
Les en-têtes que vous incluez dans la demande. Au minimum, vous devez inclure l' Exemple : |
Oui |
|
|
Signature dérivée de votre clé d'accès secrète. Exemple : |
Oui |
|
|
Le jeton de sécurité temporaire obtenu lors d'un appel à AWS Security Token Service. Exemple : |
Non |
|
|
Vérifie si vous disposez des autorisations requises pour l'action, sans effectuer de demande. Si vous disposez des autorisations requises, la demande est renvoyée |
Non |
Les X-Amz-Signature paramètres X-Amz-AlgorithmX-Amz-Credential,X-Amz-SignedHeaders, et peuvent être spécifiés en tant que paramètres distincts dans la chaîne de requête ou leurs valeurs peuvent être incluses dans un seul Authorization en-tête. Pour plus d'informations, consultez la section Signer des demandes d' AWS API dans le guide de l'utilisateur IAM.
Paramètres pour la version 2 de Signature
| Nom | Description | Obligatoire |
|---|---|---|
|
|
L'action à effectuer. Exemple : |
Oui |
|
|
Version de l'API à utiliser. |
Oui |
|
|
ID de clé d'accès pour l'expéditeur de la demande. Cela permet d'identifier le compte qui sera facturé pour l'utilisation du service. Le compte associé à l'ID de clé d'accès doit être inscrit à Amazon EC2, sinon la demande n'est pas acceptée. Exemple : |
Oui |
|
|
Date et heure d'expiration de la signature incluse dans la demande, au format YYYY-MM-DDThh:mm:ssZ. Pour plus d'informations, consultez ISO 8601 Exemple : |
Conditionnelle. Les demandes doivent inclure l'un Timestamp ou l'autreExpires, mais ne peuvent pas contenir les deux. |
|
|
Date et heure de signature de la demande, au format YYYY-MM-DDThh:mm:ssZ. Pour plus d'informations, consultez ISO 8601 Exemple : |
Conditionnelle. Les demandes doivent inclure l'un Timestamp ou l'autreExpires, mais ne peuvent pas contenir les deux. |
|
|
La signature de la demande. Exemple : |
Oui |
|
|
Algorithme de hachage que vous utilisez pour créer la signature de la demande. Valeurs valides : Exemple : |
Oui |
|
|
Version de signature que vous utilisez pour signer la demande. Définissez cette valeur à Exemple : |
Oui |
|
|
Vérifie si vous disposez des autorisations requises pour l'action, sans effectuer de demande. Si vous disposez des autorisations requises, la demande est renvoyée |
Non |
|
|
Le jeton de sécurité temporaire obtenu lors d'un appel à AWS Security Token Service. Exemple : |
Non |
Les valeurs des paramètres doivent être URL-encoded. Cela est vrai pour tout paramètre de requête transmis à Amazon EC2 et est généralement nécessaire dans le Signature paramètre. Certains clients le font automatiquement, mais ce n'est pas la norme.
