Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Uso de la API para Amazon EC2
importante
A partir del 14 de octubre de 2022, las respuestas HTTP de las API de Amazon EC2 ya no incluyen un elemento de frase explicativa. Según lo recomendado en la RFC7230
Proporcionamos la API de consultas para Amazon EC2, así como kits de desarrollo de software (SDK) para AWS que pueda acceder a Amazon EC2 desde el lenguaje de programación que prefiera. Para obtener más información, consulte la Guía para desarrolladores de Amazon EC2.
Contenido
Conocimientos necesarios
Si tiene previsto acceder a Amazon EC2 a través de una API, debe estar familiarizado con lo siguiente:
-
XML
-
Servicios web
-
Solicitudes HTTP
-
Uno o más lenguajes de programación, como Java, PHP, Perl, Python, Ruby, C# o C++.
API disponibles para Amazon EC2
La API de consultas de Amazon EC2 proporciona solicitudes HTTP o HTTPS que utilizan el verbo HTTP GET o POST y un parámetro de consulta denominado. Action
AWS ofrece bibliotecas, códigos de muestra, tutoriales y otros recursos para los desarrolladores de software que prefieren crear aplicaciones con API específicas de cada idioma en lugar de enviar una solicitud a través de HTTP o HTTPS. Estas bibliotecas proporcionan funciones básicas que se encargan automáticamente de tareas como la firma criptográfica de las solicitudes, el reintento de las solicitudes y la gestión de las respuestas a los errores, de modo que le resulte más fácil empezar.
Para obtener más información, consulte Crear recursos de Amazon EC2 mediante un AWS SDK en la Guía para desarrolladores de Amazon EC2.
Parámetros de consulta comunes
La mayoría de las acciones de la API de Amazon EC2 admiten los parámetros que se describen en las tablas siguientes. Los parámetros comunes varían en función de si utiliza la versión de firma 2 o la versión de firma 4 para firmar las solicitudes. Para obtener más información, consulte Firmar solicitudes de AWS API en la Guía del usuario de IAM.
Parámetros para la versión 4 de Signature
| Name | Description (Descripción) | Obligatorio |
|---|---|---|
|
|
La acción que se va a realizar. Ejemplo: |
Sí |
|
|
Versión de la API de que se va a utilizar. |
Sí |
|
|
El algoritmo de hash que se utiliza para crear la firma de la solicitud. Ejemplo: |
Sí |
|
|
El alcance de la credencial de la solicitud, en el formato Ejemplo: |
Sí |
|
|
La fecha y la hora en que se firma la solicitud, en el formato yyyymmddthhmmssz. La fecha debe coincidir con la fecha incluida en el alcance de la credencial del Ejemplo: |
Sí |
X-Amz-SignedHeaders |
Los encabezados que vas a incluir como parte de la solicitud. Como mínimo, debes incluir el Ejemplo: |
Sí |
|
|
Una firma derivada de tu clave de acceso secreta. Ejemplo: |
Sí |
|
|
El token de seguridad temporal obtenido mediante una llamada a AWS Security Token Service. Ejemplo: |
No |
|
|
Comprueba si tienes los permisos necesarios para la acción, sin necesidad de realizar la solicitud. Si tienes los permisos necesarios, la solicitud se devuelve |
No |
Los X-Amz-Signature parámetros X-Amz-AlgorithmX-Amz-Credential,X-Amz-SignedHeaders, y se pueden especificar como parámetros independientes en la cadena de consulta o sus valores se pueden incluir en un único Authorization encabezado. Para obtener más información, consulte Firmar solicitudes de AWS API en la Guía del usuario de IAM.
Parámetros para la versión 2 de Signature
| Name | Description (Descripción) | Obligatorio |
|---|---|---|
|
|
La acción que se va a realizar. Ejemplo: |
Sí |
|
|
Versión de la API de que se va a utilizar. |
Sí |
|
|
El ID de la clave de acceso del remitente de la solicitud. Esto identifica la cuenta a la que se cobrará por el uso del servicio. La cuenta asociada al ID de la clave de acceso debe estar registrada en Amazon EC2 o la solicitud no se aceptará. Ejemplo: |
Sí |
|
|
La fecha y la hora en las que caduca la firma incluida en la solicitud, en el formato YYYY-MM-DDThh:mm:ssZ. Para obtener más información, consulte ISO 8601 Ejemplo: |
Condicional. Las solicitudes deben incluir Timestamp una oExpires, pero no ambas. |
|
|
La fecha y la hora en que se firma la solicitud, en el formato YYYY-MM-DDThh:mm:ssZ. Para obtener más información, consulte ISO 8601 Ejemplo: |
Condicional. Las solicitudes deben incluir uno Timestamp oExpires, pero no ambos. |
|
|
La firma de la solicitud. Ejemplo: |
Sí |
|
|
El algoritmo de hash que utilizas para crear la firma de la solicitud. Valores válidos: Ejemplo: |
Sí |
|
|
La versión de la firma que utilizó para firmar la solicitud. Ajuste este valor en Ejemplo: |
Sí |
|
|
Comprueba si tienes los permisos necesarios para la acción, sin realizar realmente la solicitud. Si tienes los permisos necesarios, la solicitud se devuelve |
No |
|
|
El token de seguridad temporal obtenido mediante una llamada a AWS Security Token Service. Ejemplo: |
No |
Los valores de los parámetros deben ser URL-encoded. Esto es válido para cualquier parámetro de consulta que se pase a Amazon EC2 y, por lo general, es necesario en el Signature parámetro. Algunos clientes lo hacen automáticamente, pero no es la norma.
