Utilizzo dell'API e della CLI AMS - Guida per l'utente avanzato di AMS
Endpoint HTTP dell'API AMS per chiamate RESTInstallazione o aggiornamento della CLI AMS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo dell'API e della CLI AMS

L'API AWS Managed Services (AMS) è simile a quella APIs per altri AWS servizi. Puoi leggere informazioni sull'API AMS nell'AMS API Reference.

Endpoint HTTP dell'API AMS per chiamate REST

Oltre alle varie opzioni SDKs, AMS fornisce una CLI; puoi anche richiamare chiamate API REST sull'endpoint AMS.

Esistono due AMS APIs (l'endpoint per entrambi risiede in us-east-1):

  • Gestione delle modifiche: utilizza questa API per richiedere l'accesso o le modifiche all'infrastruttura, tra cui la creazione e l'aggiornamento, la distribuzione di nuove istanze RFCs, l'aggiornamento e l'eliminazione di istanze, l'acquisizione di informazioni e la creazione. CTs AMIs L'endpoint HTTP è:

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

  • SKMS: utilizza questa API per ottenere informazioni sulla tua infrastruttura, tra cui stack VPCs, sottoreti e. AMIs L'endpoint HTTP è:

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

Installazione o aggiornamento della CLI AMS

L'AMS CLI è un modo semplice per interagire con l'API AMS e viene utilizzata negli esempi di questa sezione. Per le convenzioni di utilizzo per AWS CLI e AMS CLI, vedere Uso AWS dell'interfaccia a riga di comando.

Per informazioni sull'installazione di SAML, consulta. Regola di attestazione AD FS e impostazioni SAML

Per installare o aggiornare l'AMS CLI, segui queste istruzioni:

Nota

È necessario disporre delle credenziali di amministratore per questa procedura.

L'AWS CLI è un prerequisito per l'utilizzo di AWS Managed Services (AMS) CLIs (Change Management and SKMS).

  1. Per installare l'AWS CLI, consulta Installazione dell'interfaccia a riga di comando AWS e segui le istruzioni appropriate. Nota che nella parte inferiore di quella pagina ci sono istruzioni per l'uso di diversi programmi di installazione, Linux, MS Windows, macOS, Virtual Environment, Bundled Installer (Linux, macOS o Unix).

    Dopo l'installazione, esegui per verificare l'installazione. aws help

  2. Una volta installata la CLI di AWS, per installare o aggiornare la CLI di AMS, scarica il file zip distribuibile AMS AMS CLI o AMS SDK distribuibile e decomprimilo. Puoi accedere ai file distribuibili della CLI AMS tramite il link Risorse per sviluppatori nel menu di navigazione a sinistra della console AMS.

  3. Il file README fornisce istruzioni per qualsiasi installazione.

    Apri uno dei due:

    • CLI zip: fornisce solo la CLI AMS.

    • SDK zip: fornisce tutto l'AMS APIs e la CLI AMS.

    Per Windows, esegui il programma di installazione appropriato (solo sistemi a 32 o 64 bit):

    • 32 bit: API_x86.msi ManagedCloud

    • 64 bit: API_x64.msi ManagedCloud

    Per Mac/Linux, esegui il file denominato: AWSManagedServices_InstallCLI.sh eseguendo questo comando:. sh AWSManagedServices_InstallCLI.sh Nota che le directory amscm e amsskms e il loro contenuto devono trovarsi nella stessa directory del file.sh. AWSManagedServices_InstallCLI

  4. Se le credenziali aziendali vengono utilizzate tramite la federazione con AWS (la configurazione predefinita di AMS), è necessario installare uno strumento di gestione delle credenziali in grado di accedere al servizio di federazione. Ad esempio, puoi utilizzare questo AWS Security Blog How to Implementation Federated API and CLI Access Using SAML 2.0 e AD FS per aiutarti a configurare i tuoi strumenti di gestione delle credenziali.

  5. Dopo l'installazione, esegui e visualizza i comandi aws amscm help e le opzioniaws amsskms help.

    Nota

    Affinché questi comandi funzionino, è necessario installare l'AMS CLI. Per installare l'API o la CLI AMS, vai alla pagina Risorse per gli sviluppatori della console AMS. Per il materiale di riferimento sull'API AMS CM o sull'API AMS SKMS, consulta la sezione AMS Information Resources nella Guida per l'utente. Potrebbe essere necessario aggiungere un'--profileopzione per l'autenticazione, aws amsskms ams-cli-command --profile SAML ad esempio. Potrebbe essere necessario aggiungere l'--regionopzione anche perché tutti i comandi AMS non utilizzano us-east-1, ad esempio. aws amscm ams-cli-command --region=us-east-1