Contoh License Manager menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Dokumentasi ini AWS CLI hanya untuk Versi 1. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh License Manager menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface With License Manager.

Tindakan adalah kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakancreate-license-configuration.

AWS CLI

Contoh 1: Untuk membuat konfigurasi lisensi

create-license-configurationContoh berikut membuat konfigurasi lisensi dengan batas keras 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"
}

Contoh 2: Untuk membuat konfigurasi lisensi

create-license-configurationContoh berikut membuat konfigurasi lisensi dengan batas lunak 100vCPUs. Ini menggunakan aturan untuk mengaktifkan CPU optimasi v.

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"
}

Contoh kode berikut menunjukkan cara menggunakandelete-license-configuration.

AWS CLI

Untuk menghapus konfigurasi lisensi

delete-license-configurationContoh berikut menghapus konfigurasi lisensi yang ditentukan.

aws license-manager delete-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanget-license-configuration.

AWS CLI

Untuk mendapatkan informasi konfigurasi lisensi

get-license-configurationContoh berikut menampilkan rincian untuk konfigurasi lisensi yang ditentukan.

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
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanget-service-settings.

AWS CLI

Untuk mendapatkan pengaturan License Manager

get-service-settingsContoh berikut menampilkan pengaturan layanan untuk License Manager di Region saat ini.

aws license-manager get-service-settings

Berikut ini menunjukkan contoh keluaran jika penemuan sumber daya lintas akun dinonaktifkan.

{
    "OrganizationConfiguration": {
        "EnableIntegration": false
    },
    "EnableCrossAccountsDiscovery": false
}

Berikut ini menunjukkan contoh keluaran jika penemuan sumber daya lintas akun diaktifkan.

{
    "S3BucketArn": "arn:aws:s3:::aws-license-manager-service-c22d6279-35c4-47c4-bb",
    "OrganizationConfiguration": {
        "EnableIntegration": true
    },
    "EnableCrossAccountsDiscovery": true
}

Contoh kode berikut menunjukkan cara menggunakanlist-associations-for-license-configuration.

AWS CLI

Untuk mendapatkan asosiasi untuk konfigurasi lisensi

list-associations-for-license-configurationContoh berikut menampilkan informasi rinci untuk asosiasi konfigurasi lisensi yang ditentukan.

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
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-license-configurations.

AWS CLI

Contoh 1: Untuk mencantumkan semua konfigurasi lisensi Anda

list-license-configurationsContoh berikut mencantumkan semua konfigurasi lisensi Anda.

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
                }
            ]
        },
        {
            ...
        }
    ]
}

Contoh 2: Untuk membuat daftar konfigurasi lisensi tertentu

list-license-configurationsContoh berikut hanya mencantumkan konfigurasi lisensi yang ditentukan.

aws license-manager list-license-configurations \
    --license-configuration-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE

Contoh kode berikut menunjukkan cara menggunakanlist-license-specifications-for-resource.

AWS CLI

Untuk membuat daftar konfigurasi lisensi untuk sumber daya

list-license-specifications-for-resourceContoh berikut mencantumkan konfigurasi lisensi yang terkait dengan Amazon Machine Image (AMI) yang ditentukan.

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"
}

Contoh kode berikut menunjukkan cara menggunakanlist-resource-inventory.

AWS CLI

Untuk membuat daftar sumber daya dalam inventaris sumber daya

list-resource-inventoryContoh berikut mencantumkan sumber daya yang dikelola menggunakan inventaris 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"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk daftar tag untuk konfigurasi lisensi

list-tags-for-resourceContoh berikut mencantumkan tag untuk konfigurasi lisensi yang ditentukan.

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"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-usage-for-license-configuration.

AWS CLI

Untuk membuat daftar lisensi yang digunakan untuk konfigurasi lisensi

list-usage-for-license-configurationContoh berikut mencantumkan informasi tentang sumber daya yang menggunakan lisensi untuk konfigurasi lisensi yang ditentukan. Misalnya, jika jenis lisensinya vCPU, setiap instance menggunakan satu lisensi 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
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan tag konfigurasi lisensi

tag-resourceContoh berikut menambahkan tag yang ditentukan (nama kunci dan nilai) ke konfigurasi lisensi yang ditentukan.

aws license-manager tag-resource \
    --tags Key=project,Value=lima \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE

Perintah ini tidak menghasilkan output.

  • Untuk API detailnya, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari konfigurasi lisensi

untag-resourceContoh berikut menghapus tag yang ditentukan (nama kunci dan sumber daya) dari konfigurasi lisensi yang ditentukan.

aws license-manager untag-resource \
    --tag-keys project \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE

Perintah ini tidak menghasilkan output.

  • Untuk API detailnya, lihat UntagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-license-configuration.

AWS CLI

Untuk memperbarui konfigurasi lisensi

update-license-configurationContoh berikut memperbarui konfigurasi lisensi yang ditentukan untuk menghapus batas keras.

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

Perintah ini tidak menghasilkan output.

update-license-configurationContoh berikut memperbarui konfigurasi lisensi yang ditentukan untuk mengubah statusnya menjadiDISABLED.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanupdate-license-specifications-for-resource.

AWS CLI

Untuk memperbarui konfigurasi lisensi untuk sumber daya

update-license-specifications-for-resourceContoh berikut menggantikan konfigurasi lisensi yang terkait dengan Amazon Machine Image (AMI) yang ditentukan dengan menghapus satu konfigurasi lisensi dan menambahkan yang lain.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanupdate-service-settings.

AWS CLI

Untuk memperbarui pengaturan License Manager

update-service-settingsContoh berikut memungkinkan penemuan sumber daya lintas akun untuk License Manager di AWS Wilayah saat ini. Bucket Amazon S3 adalah Sinkronisasi Data Sumber Daya yang diperlukan untuk inventaris 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

Perintah ini tidak menghasilkan output.