Alla scoperta dei parametri pubblici in Parameter Store - AWS Systems Manager

Alla scoperta dei parametri pubblici in Parameter Store

È possibile ricercare parametri pubblici utilizzando la console Parameter Store o la AWS Command Line Interface.

Un nome di parametro pubblico inizia con aws/service/list. La parte successiva del nome corrisponde al servizio che possiede quel parametro.

Di seguito viene riportato un elenco di alcuni servizi che forniscono parametri pubblici:

  • ami-amazon-linux-latest

  • ami-windows-latest

  • ec2-macos

  • appmesh

  • aws-for-fluent-bit

  • bottlerocket

  • canonical

  • cloud9

  • datasync

  • debian

  • ecs

  • eks

  • freebsd

  • global-infrastructure

  • marketplace

  • storagegateway

Non tutti i parametri pubblici vengono pubblicati in tutte le Regione AWS.

Risultato dei parametri pubblici tramite la console Parameter Store

È necessario che sia presente almeno un parametro nel Account AWS e Regione AWS prima di poter cercare parametri pubblici tramite la console.

Identificare parametri pubblici tramite la console
  1. Aprire la console AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, scegli Parameter Store.

  3. Seleziona la scheda Public parameters (Parametri pubblici).

  4. Seleziona il menu a discesa Select a service (Seleziona un servizio). Scegliere il servizio di cui si desidera utilizzare i parametri.

  5. (Facoltativo) Filtrare i parametri di proprietà del servizio selezionato inserendo ulteriori informazioni nella barra di ricerca.

  6. Scegliere il parametro pubblico che si desidera utilizzare.

Risultato dei parametri pubblici tramite AWS CLI

Utilizza describe-parameters per la scoperta di parametri pubblici.

Utilizza get-parameters-by-path per ottenere il percorso effettivo per un servizio elencato in /aws/service/list. Per ottenere il percorso del servizio, rimuovere /list dal percorso. Ad esempio /aws/service/list/ecs diventa /aws/service/ecs.

Per recuperare un elenco di parametri pubblici di proprietà di diversi servizi in Parameter Store, eseguire il comando riportato di seguito.

aws ssm get-parameters-by-path --path /aws/service/list

Il comando restituisce informazioni simili alle seguenti. Questo esempio è stato troncato per motivi di spazio.

{
    "Parameters": [
        {
            "Name": "/aws/service/list/ami-al-latest",
            "Type": "String",
            "Value": "/aws/service/ami-al-latest/",
            "Version": 1,
            "LastModifiedDate": "2021-01-29T10:25:10.902000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/list/ami-al-latest",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/list/ami-windows-latest",
            "Type": "String",
            "Value": "/aws/service/ami-windows-latest/",
            "Version": 1,
            "LastModifiedDate": "2021-01-29T10:25:12.567000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/list/ami-windows-latest",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/list/aws-storage-gateway-latest",
            "Type": "String",
            "Value": "/aws/service/aws-storage-gateway-latest/",
            "Version": 1,
            "LastModifiedDate": "2021-01-29T10:25:09.903000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/list/aws-storage-gateway-latest",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/list/global-infrastructure",
            "Type": "String",
            "Value": "/aws/service/global-infrastructure/",
            "Version": 1,
            "LastModifiedDate": "2021-01-29T10:25:11.901000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/list/global-infrastructure",
            "DataType": "text"
        }
    ]
}

Se si desidera visualizzare i parametri di proprietà di un servizio specifico, scegliere il servizio dall'elenco prodotto dopo l'esecuzione del comando precedente. Quindi, effettua una chiamata get-parameters-by-path utilizzando il nome del servizio desiderato.

Ad esempio /aws/service/global-infrastructure. Il percorso potrebbe essere a un livello (chiama solo parametri che corrispondono ai valori esatti forniti) o ricorsivo (contiene elementi nel percorso oltre a quello fornito).

Nota

Il percorso /aws/service/global-infrastructure non è supportato per le query in tutte le Regioni. Per informazioni, consultare Chiamata di parametri pubblici per i Servizi AWS, Regioni, endpoint, zone di disponibilità, aree locali e Zone Wavelength in Parameter Store.

Se per il servizio specificato non si ottiene alcun risultato, aggiungere il flag --recursive ed eseguire nuovamente il comando.

aws ssm get-parameters-by-path --path /aws/service/global-infrastructure

Questo restituisce tutti i parametri di proprietà di global-infrastructure. Di seguito è riportato un esempio.

{
    "Parameters": [
        {
            "Name": "/aws/service/global-infrastructure/current-region",
            "Type": "String",
            "LastModifiedDate": "2019-06-21T05:15:34.252000-07:00",
            "Version": 1,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/version",
            "Type": "String",
            "LastModifiedDate": "2019-02-04T06:59:32.875000-08:00",
            "Version": 1,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        }
    ]
}

È inoltre possibile visualizzare i parametri di proprietà di un servizio specifico utilizzando il filtro Option:BeginsWith.

aws ssm describe-parameters --parameter-filters "Key=Name, Option=BeginsWith, Values=/aws/service/ami-amazon-linux-latest"

Il comando restituisce informazioni simili alle seguenti. L'output di questo esempio è stato troncato per motivi di spazio.

{
    "Parameters": [
        {
            "Name": "/aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-ebs",
            "Type": "String",
            "LastModifiedDate": "2021-01-26T13:39:40.686000-08:00",
            "Version": 25,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        },
        {
            "Name": "/aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-gp2",
            "Type": "String",
            "LastModifiedDate": "2021-01-26T13:39:40.807000-08:00",
            "Version": 25,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        },
        {
            "Name": "/aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-s3",
            "Type": "String",
            "LastModifiedDate": "2021-01-26T13:39:40.920000-08:00",
            "Version": 25,
            "Tier": "Standard",
            "Policies": [],
            "DataType": "text"
        }
    ]
}
Nota

I parametri restituiti potrebbero essere diversi quando si utilizza Option=BeginsWith perché utilizza un modello di ricerca diverso.