

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
<a name="understand-sent-api"></a>

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](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/index.html).

## Puntos finales HTTP de la API AMS para llamadas REST
<a name="sent-api-endpoints"></a>

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
<a name="install-sent-cli"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-using.html). 

Para obtener información sobre la instalación de SAML, consulte[Regla de notificación de AD FS y configuración de SAML](adfs-claim-rule-saml.md). 

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](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) y siga las instrucciones correspondientes. Tenga en cuenta que al final de esa página hay instrucciones para usar diferentes instaladores: [Linux](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-linux.html), [MS Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html), [macOS](https://docs.aws.amazon.com/cli/latest/userguide/cli-install-macos.html), [Virtual Environment](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-virtualenv.html), [Bundled Installer (Linux, macOS o Unix](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-bundle.html)).

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

1. 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 [https://console.aws.amazon.com/managedservices/developerResources](https://console.aws.amazon.com/managedservices/developerResources) en la barra de navegación izquierda de la consola AMS.

1. 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\$1x86.msi**
   + 64 bits: **ManagedCloudAPI\$1x64.msi**

   Para **Mac/Linux**, ejecute el archivo denominado: **AWSManagedServices\$1InstallCLI.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\$1InstallCLI**

1. 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](https://blogs.aws.amazon.com/security/post/Tx1LDN0UBGJJ26Q/How-to-Implement-Federated-API-and-CLI-Access-Using-SAML-2-0-and-AD-FS) ayuda para configurar sus herramientas de administración de credenciales.

1. 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`