# Exemplos do License Manager usando a AWS CLI
<a name="cli_license-manager_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a AWS Command Line Interface com o License Manager.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `create-license-configuration`
<a name="license-manager_CreateLicenseConfiguration_cli_topic"></a>

O código de exemplo a seguir mostra como usar `create-license-configuration`.

**AWS CLI**  
**Exemplo 1: criar uma configuração de licença**  
O exemplo `create-license-configuration` a seguir cria uma configuração de licença com um limite fixo de 10 núcleos.  

```
aws license-manager create-license-configuration --name my-license-configuration \
    --license-counting-type Core \
    --license-count 10 \
    --license-count-hard-limit
```
Resultado:  

```
{
  "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111"
}
```
**Exemplo 2: criar uma configuração de licença**  
O exemplo `create-license-configuration` a seguir cria uma configuração de licença com um limite flexível de 100 vCPUs. Ele usa uma regra para ativar a otimização de vCPUs.  

```
aws license-manager create-license-configuration --name my-license-configuration
    --license-counting-type vCPU \
    --license-count 100 \
    --license-rules "#honorVcpuOptimization=true"
```
Resultado:  

```
{
  "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE2222"
}
```
+  Para ver detalhes da API, consulte [CreateLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/create-license-configuration.html) na *Referência de comandos da AWS CLI*. 

### `delete-license-configuration`
<a name="license-manager_DeleteLicenseConfiguration_cli_topic"></a>

O código de exemplo a seguir mostra como usar `delete-license-configuration`.

**AWS CLI**  
**Para excluir uma configuração de licença**  
O exemplo `delete-license-configuration` a seguir exclui o perfil da configuração de licença especificada.  

```
aws license-manager delete-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Este comando não produz saída.  
+  Para ver detalhes da API, consulte [DeleteLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/delete-license-configuration.html) na *Referência de comandos da AWS CLI*. 

### `get-license-configuration`
<a name="license-manager_GetLicenseConfiguration_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-license-configuration`.

**AWS CLI**  
**Para obter informações sobre a configuração da licença**  
O exemplo `get-license-configuration` a seguir exibe os detalhes da configuração de licença especificada.  

```
aws license-manager get-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Resultado:  

```
{
    "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
        }
    ]
}
```
+  Para ver detalhes da API, consulte [GetLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-license-configuration.html) na *Referência de comandos da AWS CLI*. 

### `get-service-settings`
<a name="license-manager_GetServiceSettings_cli_topic"></a>

O código de exemplo a seguir mostra como usar `get-service-settings`.

**AWS CLI**  
**Para obter as configurações do License Manager**  
O exemplo `get-service-settings` a seguir exibe as configurações de serviço do License Manager na região atual.  

```
aws license-manager get-service-settings
```
Veja a seguir um exemplo de saída se a descoberta de recursos entre contas estiver desativada.  

```
{
    "OrganizationConfiguration": {
        "EnableIntegration": false
    },
    "EnableCrossAccountsDiscovery": false
}
```
Veja a seguir um exemplo de saída se a descoberta de recursos entre contas estiver ativada.  

```
{
    "S3BucketArn": "arn:aws:s3:::aws-license-manager-service-c22d6279-35c4-47c4-bb",
    "OrganizationConfiguration": {
        "EnableIntegration": true
    },
    "EnableCrossAccountsDiscovery": true
}
```
+  Para ver detalhes da API, consulte [GetServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-service-settings.html) na *Referência de comandos da AWS CLI*. 

### `list-associations-for-license-configuration`
<a name="license-manager_ListAssociationsForLicenseConfiguration_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-associations-for-license-configuration`.

**AWS CLI**  
**Para obter associações para uma configuração de licença**  
O exemplo `list-associations-for-license-configuration` a seguir exibe informações detalhadas das associações da configuração de licença especificada.  

```
aws license-manager list-associations-for-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Resultado:  

```
{
    "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
        }
    ]
}
```
+  Para ver detalhes da API, consulte [ListAssociationsForLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-associations-for-license-configuration.html) na *Referência de comandos da AWS CLI*. 

### `list-license-configurations`
<a name="license-manager_ListLicenseConfigurations_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-license-configurations`.

**AWS CLI**  
**Exemplo 1: listar todas as suas configurações de licença**  
O exemplo `list-license-configurations` a seguir lista todas as configurações de licença.  

```
aws license-manager list-license-configurations
```
Resultado:  

```
{
    "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
                }
            ]
        },
        {
            ...
        }
    ]
}
```
**Exemplo 2: listar uma configuração de licença específica**  
O exemplo `list-license-configurations` a seguir lista apenas a configuração específica da licença.  

```
aws license-manager list-license-configurations \
    --license-configuration-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
+  Para ver detalhes da API, consulte [ListLicenseConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-configurations.html) na *Referência de comandos da AWS CLI*. 

### `list-license-specifications-for-resource`
<a name="license-manager_ListLicenseSpecificationsForResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-license-specifications-for-resource`.

**AWS CLI**  
**Para listar as configurações de licença de um recurso**  
O exemplo `list-license-specifications-for-resource` a seguir lista as configurações de licença associadas à Imagem de máquina da Amazon (AMI) especificada.  

```
aws license-manager list-license-specifications-for-resource \
    --resource-arn arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0
```
Resultado:  

```
{
    "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE"
}
```
+  Para ver detalhes da API, consulte [ListLicenseSpecificationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-specifications-for-resource.html) na *Referência de comandos da AWS CLI*. 

### `list-resource-inventory`
<a name="license-manager_ListResourceInventory_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-resource-inventory`.

**AWS CLI**  
**Para listar recursos no inventário de recursos**  
O exemplo `list-resource-inventory` a seguir lista os recursos gerenciados usando o inventário do Systems Manager.  

```
aws license-manager list-resource-inventory
```
Resultado:  

```
{
    "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"
        }
    ]
}
```
+  Para ver detalhes da API, consulte [ListResourceInventory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-resource-inventory.html) na *Referência de comandos da AWS CLI*. 

### `list-tags-for-resource`
<a name="license-manager_ListTagsForResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-tags-for-resource`.

**AWS CLI**  
**Para listar as tags de uma configuração de licença**  
O exemplo `list-tags-for-resource` a seguir lista as tags da configuração da licença especificada.  

```
aws license-manager list-tags-for-resource \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Resultado:  

```
{
    "Tags": [
        {
            "Key": "project",
            "Value": "lima"
        }
    ]
}
```
+  Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-tags-for-resource.html) na *AWS CLI Command Reference*. 

### `list-usage-for-license-configuration`
<a name="license-manager_ListUsageForLicenseConfiguration_cli_topic"></a>

O código de exemplo a seguir mostra como usar `list-usage-for-license-configuration`.

**AWS CLI**  
**Para listar as licenças em uso para uma configuração de licença**  
O exemplo `list-usage-for-license-configuration` a seguir lista informações sobre os recursos que usam licenças para a configuração de licença especificada. Por exemplo, se o tipo de licença for vCPU, todas as instâncias consomem uma licença por vCPU.  

```
aws license-manager list-usage-for-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Resultado:  

```
{
    "LicenseConfigurationUsageList": [
        {
            "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-04a636d18e83cfacb",
            "ResourceType": "EC2_INSTANCE",
            "ResourceStatus": "running",
            "ResourceOwnerId": "123456789012",
            "AssociationTime": 1570892850.519,
            "ConsumedLicenses": 2
        }
    ]
}
```
+  Para ver detalhes da API, consulte [ListUsageForLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-usage-for-license-configuration.html) na *Referência de comandos da AWS CLI*. 

### `tag-resource`
<a name="license-manager_TagResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `tag-resource`.

**AWS CLI**  
**Para adicionar uma tag a uma configuração de licença**  
O exemplo `tag-resource` a seguir adiciona a tag especificada (nome e valor da chave) à configuração da licença especificada.  

```
aws license-manager tag-resource \
    --tags Key=project,Value=lima \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Este comando não produz saída.  
+  Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/tag-resource.html) na *Referência de comandos da AWS CLI*. 

### `untag-resource`
<a name="license-manager_UntagResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `untag-resource`.

**AWS CLI**  
**Para remover tags de uma configuração de licença**  
O exemplo `untag-resource` a seguir remove a tag especificada (nome e valor da chave) da configuração da licença especificada.  

```
aws license-manager untag-resource \
    --tag-keys project \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Este comando não produz saída.  
+  Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/untag-resource.html) na *Referência de comandos da AWS CLI*. 

### `update-license-configuration`
<a name="license-manager_UpdateLicenseConfiguration_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-license-configuration`.

**AWS CLI**  
**Para atualizar uma configuração de licença**  
O exemplo `update-license-configuration` a seguir atualiza a configuração da licença especificada para remover o limite fixo.  

```
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
```
Este comando não produz saída.  
O exemplo `update-license-configuration` a seguir atualiza a configuração da licença especificada para alterar seu status para `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
```
Este comando não produz saída.  
+  Para ver detalhes da API, consulte [UpdateLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-configuration.html) na *Referência de comandos da AWS CLI*. 

### `update-license-specifications-for-resource`
<a name="license-manager_UpdateLicenseSpecificationsForResource_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-license-specifications-for-resource`.

**AWS CLI**  
**Para atualizar as configurações de licença de um recurso**  
O exemplo `update-license-specifications-for-resource` a seguir substitui a configuração de licença associada à Imagem de máquina da Amazon (AMI) especificada removendo uma configuração de licença e adicionando outra.  

```
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
```
Este comando não produz saída.  
+  Para ver detalhes da API, consulte [UpdateLicenseSpecificationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-specifications-for-resource.html) na *Referência de comandos da AWS CLI*. 

### `update-service-settings`
<a name="license-manager_UpdateServiceSettings_cli_topic"></a>

O código de exemplo a seguir mostra como usar `update-service-settings`.

**AWS CLI**  
**Para atualizar as configurações do License Manager**  
O exemplo `update-service-settings` a seguir permite a descoberta de recursos entre contas para o License Manager na região da AWS atual. O bucket do Amazon S3 é a sincronização de dados de recursos necessária para o inventário do 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
```
Este comando não produz saída.  
+  Para ver detalhes da API, consulte [UpdateServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-service-settings.html) na *Referência de comandos da AWS CLI*.