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à.
# Esempi di License Manager che utilizzano AWS CLI
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with License Manager.
Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
**Topics**
+ [Azioni](#actions)
## Azioni
### `create-license-configuration`
Il seguente esempio di codice mostra come utilizzare`create-license-configuration`.
**AWS CLI**
**Esempio 1: come creare una configurazione di licenza**
L’esempio `create-license-configuration` seguente crea una configurazione di licenza con un limite rigido di 10 core.
```
aws license-manager create-license-configuration --name my-license-configuration \
--license-counting-type Core \
--license-count 10 \
--license-count-hard-limit
```
Output:
```
{
"LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111"
}
```
**Esempio 2: come creare una configurazione di licenza**
L'`create-license-configuration`esempio seguente crea una configurazione di licenza con un limite flessibile di 100 vCPUs. Utilizza una regola per abilitare l'ottimizzazione della vCPU.
```
aws license-manager create-license-configuration --name my-license-configuration
--license-counting-type vCPU \
--license-count 100 \
--license-rules "#honorVcpuOptimization=true"
```
Output:
```
{
"LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE2222"
}
```
+ Per i dettagli sull'API, consulta [CreateLicenseConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/create-license-configuration.html)*Command Reference.*
### `delete-license-configuration`
Il seguente esempio di codice mostra come utilizzare`delete-license-configuration`.
**AWS CLI**
**Come eliminare una configurazione della licenza**
L’esempio `delete-license-configuration` seguente elimina la configurazione di licenza specificata.
```
aws license-manager delete-license-configuration \
--license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [DeleteLicenseConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/delete-license-configuration.html)*Command Reference*.
### `get-license-configuration`
Il seguente esempio di codice mostra come utilizzare`get-license-configuration`.
**AWS CLI**
**Come ottenere informazioni sulla configurazione della licenza**
L’esempio `get-license-configuration` seguente mostra i dettagli della configurazione di licenza specificata.
```
aws license-manager get-license-configuration \
--license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Output:
```
{
"LicenseConfigurationId": "lic-38b658717b87478aaa7c00883EXAMPLE",
"LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE",
"Name": "my-license-configuration",
"LicenseCountingType": "vCPU",
"LicenseRules": [],
"LicenseCountHardLimit": false,
"ConsumedLicenses": 0,
"Status": "AVAILABLE",
"OwnerAccountId": "123456789012",
"ConsumedLicenseSummaryList": [
{
"ResourceType": "EC2_INSTANCE",
"ConsumedLicenses": 0
},
{
"ResourceType": "EC2_HOST",
"ConsumedLicenses": 0
},
{
"ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE",
"ConsumedLicenses": 0
}
],
"ManagedResourceSummaryList": [
{
"ResourceType": "EC2_INSTANCE",
"AssociationCount": 0
},
{
"ResourceType": "EC2_HOST",
"AssociationCount": 0
},
{
"ResourceType": "EC2_AMI",
"AssociationCount": 2
},
{
"ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE",
"AssociationCount": 0
}
]
}
```
+ Per i dettagli sull'API, consulta [GetLicenseConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-license-configuration.html)*Command Reference*.
### `get-service-settings`
Il seguente esempio di codice mostra come utilizzare`get-service-settings`.
**AWS CLI**
**Come ottenere le impostazioni dello Strumento di gestione delle licenze**
L’esempio `get-service-settings` seguente visualizza le impostazioni del servizio per lo Strumento di gestione delle licenze nella Regione corrente.
```
aws license-manager get-service-settings
```
Di seguito viene illustrato un esempio di output se il rilevamento di risorse tra account è disabilitato.
```
{
"OrganizationConfiguration": {
"EnableIntegration": false
},
"EnableCrossAccountsDiscovery": false
}
```
Di seguito viene mostrato un esempio di output se il rilevamento di risorse tra account è abilitato.
```
{
"S3BucketArn": "arn:aws:s3:::aws-license-manager-service-c22d6279-35c4-47c4-bb",
"OrganizationConfiguration": {
"EnableIntegration": true
},
"EnableCrossAccountsDiscovery": true
}
```
+ Per i dettagli sull'API, consulta [GetServiceSettings AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-service-settings.html)*Command Reference*.
### `list-associations-for-license-configuration`
Il seguente esempio di codice mostra come utilizzare`list-associations-for-license-configuration`.
**AWS CLI**
**Come ottenere le associazioni per la configurazione di una licenza**
L’esempio `list-associations-for-license-configuration` seguente visualizza informazioni dettagliate per le associazioni della configurazione di licenza specificata.
```
aws license-manager list-associations-for-license-configuration \
--license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Output:
```
{
"LicenseConfigurationAssociations": [
{
"ResourceArn": "arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0",
"ResourceType": "EC2_AMI",
"ResourceOwnerId": "123456789012",
"AssociationTime": 1568825118.617
},
{
"ResourceArn": "arn:aws:ec2:us-west-2::image/ami-0abcdef1234567890",
"ResourceType": "EC2_AMI",
"ResourceOwnerId": "123456789012",
"AssociationTime": 1568825118.946
}
]
}
```
+ Per i dettagli sull'API, consulta [ListAssociationsForLicenseConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-associations-for-license-configuration.html)*Command Reference*.
### `list-license-configurations`
Il seguente esempio di codice mostra come utilizzare`list-license-configurations`.
**AWS CLI**
**Esempio 1: come elencare tutte le configurazioni delle licenze**
L’esempio `list-license-configurations` seguente elenca tutte le configurazioni di licenza.
```
aws license-manager list-license-configurations
```
Output:
```
{
"LicenseConfigurations": [
{
"LicenseConfigurationId": "lic-6eb6586f508a786a2ba4f56c1EXAMPLE",
"LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE",
"Name": "my-license-configuration",
"LicenseCountingType": "Core",
"LicenseRules": [],
"LicenseCount": 10,
"LicenseCountHardLimit": true,
"ConsumedLicenses": 0,
"Status": "AVAILABLE",
"OwnerAccountId": "123456789012",
"ConsumedLicenseSummaryList": [
{
"ResourceType": "EC2_INSTANCE",
"ConsumedLicenses": 0
},
{
"ResourceType": "EC2_HOST",
"ConsumedLicenses": 0
},
{
"ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE",
"ConsumedLicenses": 0
}
],
"ManagedResourceSummaryList": [
{
"ResourceType": "EC2_INSTANCE",
"AssociationCount": 0
},
{
"ResourceType": "EC2_HOST",
"AssociationCount": 0
},
{
"ResourceType": "EC2_AMI",
"AssociationCount": 0
},
{
"ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE",
"AssociationCount": 0
}
]
},
{
...
}
]
}
```
**Esempio 2: come elencare una configurazione della licenza specifica**
L’esempio `list-license-configurations` seguente elenca solo la configurazione di licenza specificata.
```
aws license-manager list-license-configurations \
--license-configuration-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
+ Per i dettagli sull'API, consulta [ListLicenseConfigurations AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-configurations.html)*Command Reference*.
### `list-license-specifications-for-resource`
Il seguente esempio di codice mostra come utilizzare`list-license-specifications-for-resource`.
**AWS CLI**
**Come elencare le configurazioni delle licenze per una risorsa**
L’esempio `list-license-specifications-for-resource` seguente elenca le configurazioni di licenza associate all’Amazon Machine Image (AMI) specificata.
```
aws license-manager list-license-specifications-for-resource \
--resource-arn arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0
```
Output:
```
{
"LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE"
}
```
+ Per i dettagli sull'API, consulta [ListLicenseSpecificationsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-specifications-for-resource.html)*Command Reference*.
### `list-resource-inventory`
Il seguente esempio di codice mostra come utilizzare`list-resource-inventory`.
**AWS CLI**
**Come elencare le risorse nell’inventario delle risorse**
L’esempio `list-resource-inventory` seguente elenca le risorse gestite utilizzando l’inventario di Systems Manager.
```
aws license-manager list-resource-inventory
```
Output:
```
{
"ResourceInventoryList": [
{
"Platform": "Red Hat Enterprise Linux Server",
"ResourceType": "EC2Instance",
"PlatformVersion": "7.4",
"ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-05d3cdfb05bd36376",
"ResourceId": "i-05d3cdfb05bd36376",
"ResourceOwningAccountId": "1234567890129"
},
{
"Platform": "Amazon Linux",
"ResourceType": "EC2Instance",
"PlatformVersion": "2",
"ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-0b1d036cfd4594808",
"ResourceId": "i-0b1d036cfd4594808",
"ResourceOwningAccountId": "1234567890129"
},
{
"Platform": "Microsoft Windows Server 2019 Datacenter",
"ResourceType": "EC2Instance",
"PlatformVersion": "10.0.17763",
"ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-0cdb3b54a2a8246ad",
"ResourceId": "i-0cdb3b54a2a8246ad",
"ResourceOwningAccountId": "1234567890129"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListResourceInventory AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-resource-inventory.html)*Command Reference*.
### `list-tags-for-resource`
Il seguente esempio di codice mostra come utilizzare`list-tags-for-resource`.
**AWS CLI**
**Come elencare i tag per una configurazione della licenza**
L’esempio `list-tags-for-resource` seguente elenca i tag per la configurazione di licenza specificata.
```
aws license-manager list-tags-for-resource \
--resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Output:
```
{
"Tags": [
{
"Key": "project",
"Value": "lima"
}
]
}
```
+ Per i dettagli sull'API, consulta [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-tags-for-resource.html)*Command Reference*.
### `list-usage-for-license-configuration`
Il seguente esempio di codice mostra come utilizzare`list-usage-for-license-configuration`.
**AWS CLI**
**Come elencare le licenze in uso per una configurazione della licenza**
L’esempio `list-usage-for-license-configuration` seguente elenca le informazioni sulle risorse che utilizzano le licenze per la configurazione di licenza specificata. Ad esempio, se il tipo di licenza è vCPU, tutte le istanze impiegano una licenza per vCPU.
```
aws license-manager list-usage-for-license-configuration \
--license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Output:
```
{
"LicenseConfigurationUsageList": [
{
"ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-04a636d18e83cfacb",
"ResourceType": "EC2_INSTANCE",
"ResourceStatus": "running",
"ResourceOwnerId": "123456789012",
"AssociationTime": 1570892850.519,
"ConsumedLicenses": 2
}
]
}
```
+ Per i dettagli sull'API, consulta [ListUsageForLicenseConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-usage-for-license-configuration.html)*Command Reference*.
### `tag-resource`
Il seguente esempio di codice mostra come utilizzare`tag-resource`.
**AWS CLI**
**Come aggiungere un tag a una configurazione della licenza**
L’esempio `tag-resource` seguente aggiunge il tag specificato (nome e valore di chiave) alla configurazione di licenza specificata.
```
aws license-manager tag-resource \
--tags Key=project,Value=lima \
--resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/tag-resource.html)*Command Reference*.
### `untag-resource`
Il seguente esempio di codice mostra come utilizzare`untag-resource`.
**AWS CLI**
**Come rimuovere i tag da una configurazione della licenza**
L’esempio `untag-resource` seguente rimuove il tag specificato (nome di chiave e risorsa) dalla configurazione di licenza specificata.
```
aws license-manager untag-resource \
--tag-keys project \
--resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [UntagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/untag-resource.html)*Command Reference*.
### `update-license-configuration`
Il seguente esempio di codice mostra come utilizzare`update-license-configuration`.
**AWS CLI**
**Come aggiornare una configurazione della licenza**
L’esempio `update-license-configuration` seguente aggiorna la configurazione di licenza specificata per rimuovere il limite rigido.
```
aws license-manager update-license-configuration \
--no-license-count-hard-limit \
--license-configuration-arn arn:aws:license-manager:us-west-2:880185128111:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Questo comando non produce alcun output.
L’esempio `update-license-configuration` seguente aggiorna la configurazione di licenza specificata per modificarne lo stato in `DISABLED`.
```
aws license-manager update-license-configuration \
--license-configuration-status DISABLED
--license-configuration-arn arn:aws:license-manager:us-west-2:880185128111:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [UpdateLicenseConfiguration AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-configuration.html)*Command Reference*.
### `update-license-specifications-for-resource`
Il seguente esempio di codice mostra come utilizzare`update-license-specifications-for-resource`.
**AWS CLI**
**Come aggiornare le configurazioni delle licenze per una risorsa**
L’esempio `update-license-specifications-for-resource` seguente sostituisce la configurazione di licenza associata all’Amazon Machine Image (AMI) specificata rimuovendo una configurazione di licenza e aggiungendone un’altra.
```
aws license-manager update-license-specifications-for-resource \
--resource-arn arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0 \
--remove-license-specifications LicenseConfigurationArn=arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE \
--add-license-specifications LicenseConfigurationArn=arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-42b6deb06e5399a980d555927EXAMPLE
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, consulta [UpdateLicenseSpecificationsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-specifications-for-resource.html)*Command Reference*.
### `update-service-settings`
Il seguente esempio di codice mostra come utilizzare`update-service-settings`.
**AWS CLI**
**Come aggiornare le impostazioni dello Strumento di gestione delle licenze**
L'`update-service-settings`esempio seguente abilita l'individuazione delle risorse tra account per License Manager nella AWS regione corrente. Il bucket Amazon S3 è lo strumento di sincronizzazione dei dati della risorsa necessario per l’inventario di Systems Manager.
```
aws license-manager update-service-settings \
--organization-configuration EnableIntegration=true \
--enable-cross-accounts-discovery \
--s3-bucket-arn arn:aws:s3:::aws-license-manager-service-abcd1234EXAMPLE
```
Questo comando non produce alcun output.
+ Per i dettagli sull'API, vedere [UpdateServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-service-settings.html)in *AWS CLI Command Reference.*