Uso de la API y la CLI de AMS - Guía de usuario avanzada de AMS
Puntos finales HTTP de la API AMS para llamadas RESTInstalación o actualización de la CLI de AMS

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 y la CLI de AMS

La API de AWS Managed Services (AMS) es similar a la APIs de otros AWS servicios. Puede obtener información sobre la API de AMS en la referencia de la API de AMS.

Puntos finales HTTP de la API AMS para llamadas REST

Además de los diversos SDKs, AMS proporciona una CLI; también puede invocar llamadas a la API REST en el punto final de AMS.

Hay dos AMS APIs (el punto final de ambos reside en us-east-1):

  • Administración de cambios: utilice esta API para solicitar el acceso a su infraestructura o realizar cambios en ella, incluida la creación y actualización RFCs, el despliegue de nuevas instancias, la actualización y eliminación de instancias, la obtención de información y la CTs creación. AMIs El punto final HTTP es:

    https://amscm.us-east-1.amazonaws.com

  • SKMS: utilice esta API para obtener información sobre su infraestructura, incluidas las pilas VPCs, las subredes y. AMIs El punto final HTTP es:

    https://amsskms.us-east-1.amazonaws.com

Instalación o actualización de la CLI de AMS

La CLI de AMS es una forma sencilla de interactuar con la API de AMS y se utiliza en los ejemplos de esta sección. Para conocer las convenciones de uso de la AWS CLI y la CLI de AMS, consulte Uso de la interfaz de línea de AWS comandos.

Para obtener información sobre la instalación de SAML, consulteRegla de notificación de AD FS y configuración de SAML.

Para instalar o actualizar la CLI de AMS, siga estas instrucciones:

nota

Debe tener credenciales de administrador para este procedimiento.

La AWS CLI es un requisito previo para utilizar AWS Managed Services (AMS) CLIs (Change Management y SKMS).

  1. Para instalar la CLI de AWS, consulte Instalación de la interfaz de línea de comandos de AWS y siga las instrucciones correspondientes. Tenga en cuenta que al final de esa página hay instrucciones para usar diferentes instaladores: Linux, MS Windows, macOS, Virtual Environment, Bundled Installer (Linux, macOS o Unix).

    Tras la instalación, ejecute aws help para verificar la instalación.

  2. Una vez instalada la CLI de AWS, para instalar o actualizar la CLI de AMS, descargue el archivo zip distribuible de la CLI de AMS o del SDK de AMS y descomprímalo. Puede acceder a los distribuibles de la CLI de AMS a través del enlace Recursos para desarrolladores en la barra de navegación izquierda de la consola AMS.

  3. El archivo README proporciona instrucciones para cualquier instalación.

    Abra una de las siguientes opciones:

    • CLI zip: proporciona únicamente la CLI de AMS.

    • SDK zip: proporciona todo el AMS APIs y la AMS CLI.

    Para Windows, ejecute el instalador adecuado (solo sistemas de 32 o 64 bits):

    • 32 bits: ManagedCloudAPI_x86.msi

    • 64 bits: ManagedCloudAPI_x64.msi

    Para Mac/Linux, ejecute el archivo denominado: AWSManagedServices_InstallCLI.sh ejecutando este comando:. sh AWSManagedServices_InstallCLI.sh Tenga en cuenta que los directorios amscm y amsskms y su contenido deben estar en el mismo directorio que el archivo.sh. AWSManagedServices_InstallCLI

  4. Si sus credenciales corporativas se utilizan mediante la federación con AWS (la configuración predeterminada de AMS), debe instalar una herramienta de administración de credenciales que pueda acceder a su servicio de federación. Por ejemplo, puede utilizar este blog de seguridad de AWS sobre cómo implementar el acceso federado a las API y CLI mediante SAML 2.0 y AD FS como ayuda para configurar sus herramientas de administración de credenciales.

  5. Tras la instalación, ejecute aws amscm help y consulte los comandos y aws amsskms help las opciones.

    nota

    La CLI de AMS debe estar instalada para que estos comandos funcionen. Para instalar la API o CLI de AMS, vaya a la página de recursos para desarrolladores de la consola AMS. Para obtener material de referencia sobre la API AMS CM o la API AMS SKMS, consulte la sección Recursos de información de AMS en la Guía del usuario. Puede que necesite añadir una --profile opción de autenticación; por ejemplo,aws amsskms ams-cli-command --profile SAML. Es posible que también tengas que añadir la --region opción, ya que todos los comandos de AMS se ejecutan desde us-east-1, por ejemplo. aws amscm ams-cli-command --region=us-east-1