Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples de License Manager utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with License Manager.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `create-license-configuration`
L'exemple de code suivant montre comment utiliser`create-license-configuration`.
**AWS CLI**
**Exemple 1 : pour créer une configuration de licence**
L’exemple `create-license-configuration` suivant crée une configuration de licence avec une limite stricte de 10 cœurs.
```
aws license-manager create-license-configuration --name my-license-configuration \
--license-counting-type Core \
--license-count 10 \
--license-count-hard-limit
```
Sortie :
```
{
"LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111"
}
```
**Exemple 2 : pour créer une configuration de licence**
L'`create-license-configuration`exemple suivant crée une configuration de licence avec une limite souple de 100 CPUs v. Il utilise une règle pour activer l'optimisation des vCPU.
```
aws license-manager create-license-configuration --name my-license-configuration
--license-counting-type vCPU \
--license-count 100 \
--license-rules "#honorVcpuOptimization=true"
```
Sortie :
```
{
"LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE2222"
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/create-license-configuration.html)à la section *Référence des AWS CLI commandes*.
### `delete-license-configuration`
L'exemple de code suivant montre comment utiliser`delete-license-configuration`.
**AWS CLI**
**Pour supprimer une configuration de licence**
L’exemple `delete-license-configuration` suivant supprime la configuration de licence spécifiée.
```
aws license-manager delete-license-configuration \
--license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/delete-license-configuration.html)à la section *Référence des AWS CLI commandes*.
### `get-license-configuration`
L'exemple de code suivant montre comment utiliser`get-license-configuration`.
**AWS CLI**
**Pour obtenir les informations sur la configuration de licence**
L’exemple `get-license-configuration` suivant affiche les détails de la configuration de licence spécifiée.
```
aws license-manager get-license-configuration \
--license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Sortie :
```
{
"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
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-license-configuration.html)à la section *Référence des AWS CLI commandes*.
### `get-service-settings`
L'exemple de code suivant montre comment utiliser`get-service-settings`.
**AWS CLI**
**Pour obtenir les paramètres de License Manager**
L’exemple `get-service-settings` suivant affiche les paramètres de service pour License Manager dans la région actuelle.
```
aws license-manager get-service-settings
```
Voici un exemple de sortie si la détection des ressources inter-comptes est désactivée.
```
{
"OrganizationConfiguration": {
"EnableIntegration": false
},
"EnableCrossAccountsDiscovery": false
}
```
Voici un exemple de sortie si la détection des ressources inter-comptes est activée.
```
{
"S3BucketArn": "arn:aws:s3:::aws-license-manager-service-c22d6279-35c4-47c4-bb",
"OrganizationConfiguration": {
"EnableIntegration": true
},
"EnableCrossAccountsDiscovery": true
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-service-settings.html)à la section *Référence des AWS CLI commandes*.
### `list-associations-for-license-configuration`
L'exemple de code suivant montre comment utiliser`list-associations-for-license-configuration`.
**AWS CLI**
**Pour obtenir des associations pour une configuration de licence**
L’exemple `list-associations-for-license-configuration` suivant affiche les informations détaillées sur les associations de la configuration de licence spécifiée.
```
aws license-manager list-associations-for-license-configuration \
--license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Sortie :
```
{
"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
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListAssociationsForLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-associations-for-license-configuration.html)à la section *Référence des AWS CLI commandes*.
### `list-license-configurations`
L'exemple de code suivant montre comment utiliser`list-license-configurations`.
**AWS CLI**
**Exemple 1 : pour répertorier toutes vos configurations de licence**
L’exemple `list-license-configurations` suivant répertorie toutes vos configurations de licence.
```
aws license-manager list-license-configurations
```
Sortie :
```
{
"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
}
]
},
{
...
}
]
}
```
**Exemple 2 : pour répertorier une configuration de licence spécifique**
L’exemple `list-license-configurations` suivant répertorie uniquement la configuration de licence spécifiée.
```
aws license-manager list-license-configurations \
--license-configuration-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [ListLicenseConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-configurations.html)à la section *Référence des AWS CLI commandes*.
### `list-license-specifications-for-resource`
L'exemple de code suivant montre comment utiliser`list-license-specifications-for-resource`.
**AWS CLI**
**Pour répertorier les configurations de licence pour une ressource**
L’exemple `list-license-specifications-for-resource` suivant répertorie les configurations de licence de l’Amazon Machine Image (AMI) spécifiée.
```
aws license-manager list-license-specifications-for-resource \
--resource-arn arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0
```
Sortie :
```
{
"LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE"
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListLicenseSpecificationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-specifications-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `list-resource-inventory`
L'exemple de code suivant montre comment utiliser`list-resource-inventory`.
**AWS CLI**
**Pour répertorier les ressources dans l’inventaire des ressources**
L’exemple `list-resource-inventory` suivant répertorie les ressources gérées à l’aide de l’inventaire de Systems Manager.
```
aws license-manager list-resource-inventory
```
Sortie :
```
{
"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"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListResourceInventory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-resource-inventory.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour répertorier les balises d’une configuration de licence**
L’exemple `list-tags-for-resource` suivant répertorie les balises de la configuration de licence spécifiée.
```
aws license-manager list-tags-for-resource \
--resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Sortie :
```
{
"Tags": [
{
"Key": "project",
"Value": "lima"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `list-usage-for-license-configuration`
L'exemple de code suivant montre comment utiliser`list-usage-for-license-configuration`.
**AWS CLI**
**Pour répertorier les licences utilisées pour une configuration de licence**
L’exemple `list-usage-for-license-configuration` suivant répertorie les informations relatives aux ressources utilisant des licences pour la configuration de licence spécifiée. Par exemple, si le type de licence est vCPU, toutes les instances consomment une licence par vCPU.
```
aws license-manager list-usage-for-license-configuration \
--license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Sortie :
```
{
"LicenseConfigurationUsageList": [
{
"ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-04a636d18e83cfacb",
"ResourceType": "EC2_INSTANCE",
"ResourceStatus": "running",
"ResourceOwnerId": "123456789012",
"AssociationTime": 1570892850.519,
"ConsumedLicenses": 2
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListUsageForLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-usage-for-license-configuration.html)à la section *Référence des AWS CLI commandes*.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**Pour ajouter une balise à une configuration de licence**
L’exemple `tag-resource` suivant ajoute la balise spécifiée (nom de clé et valeur) à la configuration de licence spécifiée.
```
aws license-manager tag-resource \
--tags Key=project,Value=lima \
--resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**Pour supprimer des balises d’une configuration de licence**
L’exemple `untag-resource` suivant supprime la balise spécifiée (nom de clé et ressource) de la configuration de licence spécifiée.
```
aws license-manager untag-resource \
--tag-keys project \
--resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-license-configuration`
L'exemple de code suivant montre comment utiliser`update-license-configuration`.
**AWS CLI**
**Pour mettre à jour une configuration de licence**
L’exemple `update-license-configuration` suivant met à jour la configuration de licence spécifiée pour supprimer la limite stricte.
```
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
```
Cette commande ne produit aucune sortie.
L’exemple `update-license-configuration` suivant met à jour la configuration de licence spécifiée pour changer son statut en `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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [UpdateLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-configuration.html)à la section *Référence des AWS CLI commandes*.
### `update-license-specifications-for-resource`
L'exemple de code suivant montre comment utiliser`update-license-specifications-for-resource`.
**AWS CLI**
**Pour mettre à jour les configurations de licence pour une ressource**
L’exemple `update-license-specifications-for-resource` suivant remplace la configuration de licence associée à l’Amazon Machine Image (AMI) spécifiée en supprimant une configuration de licence et en ajoutant une autre.
```
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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [UpdateLicenseSpecificationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-specifications-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-service-settings`
L'exemple de code suivant montre comment utiliser`update-service-settings`.
**AWS CLI**
**Pour mettre à jour les paramètres de License Manager**
L'`update-service-settings`exemple suivant permet la découverte de ressources entre comptes pour License Manager dans la AWS région actuelle. Le compartiment Amazon S3 est la synchronisation de données de ressources requise pour l’inventaire 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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [UpdateServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-service-settings.html)à la section *Référence des AWS CLI commandes*.