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 motivacional. Según lo recomendado en el RFC7230
Proporcionamos la API Query para Amazon EC2, así como kits de desarrollo de software (SDK) AWS que le permiten acceder a Amazon EC2 desde su lenguaje de programación preferido. Para obtener más información, consulte la Guía para desarrolladores de Amazon EC2.
Contenido
Conocimientos necesarios
Si planea 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 proporciona bibliotecas, códigos de muestra, tutoriales y otros recursos para los desarrolladores de software que prefieren crear aplicaciones con API específicas del 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 forma que le resulte más fácil empezar.
Para obtener más información, consulte Creación de 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 descritos en las tablas siguientes. Los parámetros habituales varían en función de si utiliza Signature Version 2 o Signature Version 4 para firmar sus solicitudes. Para obtener más información, consulte Firmar las solicitudes de AWS API en la Guía del usuario de IAM.
Parámetros de la versión 4 de Signature
| Name | Description (Descripción) | Obligatorio |
|---|---|---|
|
|
La acción a realizar. Ejemplo: |
Sí |
|
|
Versión de la API de que se va a utilizar. |
Sí |
|
|
El algoritmo hash que se utiliza para crear la firma de la solicitud. Ejemplo: |
Sí |
|
|
El alcance de las credenciales 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 que se incluye en el ámbito de las credenciales del Ejemplo: |
Sí |
X-Amz-SignedHeaders |
Los encabezados que incluyes 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 realmente la solicitud. Si tiene los permisos necesarios, se devuelve la solicitud |
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 las solicitudes de AWS API en la Guía del usuario de IAM.
Parámetros de 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 identificador de clave de acceso del remitente de la solicitud. Identifica la cuenta a la que se le cobrará por el uso del servicio. La cuenta asociada al identificador de clave de acceso debe estar registrada en Amazon EC2 o no se aceptará la solicitud. Ejemplo: |
Sí |
|
|
La fecha y la hora en las que vence 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 una Timestamp o ambasExpires, pero no pueden contener 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 una Timestamp o Expires varias, pero no pueden contener ambas. |
|
|
La firma de la solicitud. Ejemplo: |
Sí |
|
|
El algoritmo hash que se utiliza 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 necesidad de realizar realmente la solicitud. Si tiene los permisos necesarios, se devuelve la solicitud |
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.
