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.
Llamar a la API mediante solicitudes de consulta HTTP
Esta sección contiene información general acerca del modo de utilizar la API de consulta de AWS Organizations. Para obtener más información acerca de las operaciones y los errores de la API, consulte la Referencia de API AWS Organizations.
nota
En lugar de realizar llamadas directas a la API de consultas de AWS Organizations, puede utilizar uno de los SDK de AWS. El SDK de AWS consta de bibliotecas y código de muestra para diversos lenguajes de programación y plataformas (Java, Ruby, .NET, iOS, Android, etc.). Los SDK proporcionan una forma cómoda de crear acceso mediante programación a AWS Organizations y AWS. Por ejemplo, los SDK se encargan de tareas como firmar solicitudes criptográficamente, gestionar los errores y reintentar las solicitudes de forma automática. Para obtener información sobre los SDK de AWS (por ejemplo, cómo descargarlos e instalarlos), consulte Herramientas para Amazon Web Services
La API de consultas de AWS Organizations le permite llamar a acciones del servicio. Las solicitudes de la API de consulta son solicitudes HTTPS que deben contener un parámetro Action que indique la operación que se va a realizar. AWS Organizations admite solicitudes GET y POST para todas las operaciones. Es decir, la API no requiere que use GET para algunas acciones y POST para otras. Sin embargo, las solicitudes GET están sujetas a las limitaciones de tamaño de una URL. Aunque este límite depende del navegador, suele ser de 2048 bytes. Por lo tanto, para las solicitudes de la API de consultas que requieran tamaños más grandes, debe utilizar una solicitud POST.
La respuesta es un documento XML. Para obtener más información acerca de la respuesta, consulte las páginas de cada acción en la Referencia de API AWS Organizations.
puntos de conexión
AWS Organizations tiene un único punto de enlace de API global alojado en la región EE. UU. Este (Norte de Virginia).
Para obtener más información acerca de los puntos de conexión y las regiones de AWS para todos los servicios, consulte Regional endpoints en la Referencia general de AWS.
HTTPS obligatorio
Dado que la API de consultas devuelve información confidencial como, por ejemplo, credenciales de seguridad, debe usar HTTPS para cifrar todas las solicitudes de la API.
Firma de solicitudes API de AWS Organizations
Las solicitudes deben firmarse con un ID de clave de acceso y una clave de acceso secreta. Se recomienda encarecidamente no utilizar las credenciales de Usuario raíz de la cuenta de AWS para el trabajo diario con AWS Organizations. Puede utilizar las credenciales de un usuario o rol.
Para firmar las solicitudes de la API, debe utilizar Signature Version 4 de AWS. Para obtener información sobre Signature Version 4, consulte Firma de solicitudes API de AWS en la Guía del usuario de IAM.
AWS Organizations no es compatible con versiones anteriores, como Signature Version 2.
Para obtener más información, consulte los siguientes temas:
-
Credenciales de seguridad de AWS: ofrece información general acerca de los tipos de credenciales que puede utilizar para acceder a AWS.
-
Prácticas de seguridad recomendadas en IAM: ofrece sugerencias acerca de cómo utilizar el servicio de IAM para ayudar a proteger sus recursos de AWS, incluidos los de AWS Organizations.
-
Credenciales temporales de seguridad en IAM: describe cómo crear y utilizar las credenciales temporales de seguridad.
