使用 License Manager 範例 AWS CLI - AWS Command Line Interface

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 License Manager 範例 AWS CLI

下列程式碼範例說明如何透過 AWS Command Line Interface 搭配使用 License Manager 來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境和跨服務範例中查看內容中的動作。

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

每個範例都包含一個連結 GitHub,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例會示範如何使用create-license-configuration

AWS CLI

範例 1:建立授權組態

下列create-license-configuration範例會建立硬性限制為 10 個核心的授權組態。

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

輸出:

{ "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111" }

範例 2:建立授權組態

下列create-license-configuration範例會建立軟性限制為 100 個 vCPUs 的授權組態。它會使用規則來啟用 vCPU 最佳化。

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

輸出:

{ "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE2222" }

下列程式碼範例會示範如何使用delete-license-configuration

AWS CLI

刪除授權組態的步驟

下列delete-license-configuration範例會刪除指定的授權組態。

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

此命令不會產生輸出。

下列程式碼範例會示範如何使用get-license-configuration

AWS CLI

取得授權組態資訊的步驟

下列get-license-configuration範例顯示指定授權組態的詳細資料。

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

輸出:

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

下列程式碼範例會示範如何使用get-service-settings

AWS CLI

若要取得 License Manager 設定

下列get-service-settings範例顯示目前區域中 License Manager 的服務設定。

aws license-manager get-service-settings

以下顯示停用跨帳號資源探索時的範例輸出。

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

以下顯示啟用跨帳號資源探索時的範例輸出。

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

下列程式碼範例會示範如何使用list-associations-for-license-configuration

AWS CLI

取得授權組態關聯的步驟

下列list-associations-for-license-configuration範例顯示指定授權組態之關聯的詳細資訊。

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

輸出:

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

下列程式碼範例會示範如何使用list-license-configurations

AWS CLI

範例 1:列出所有授權組態

下列list-license-configurations範例會列出您的所有授權組態。

aws license-manager list-license-configurations

輸出:

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

範例 2:列出特定授權組態

下列list-license-configurations範例僅列出指定的授權組態。

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

下列程式碼範例會示範如何使用list-license-specifications-for-resource

AWS CLI

列出資源的授權規劃

下列list-license-specifications-for-resource範例列出與指定的 Amazon 機器映像 (AMI) 相關聯的授權組態。

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

輸出:

{ "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE" }

下列程式碼範例會示範如何使用list-resource-inventory

AWS CLI

若要列出資源庫存中的資源,請執

下列list-resource-inventory範例會列出使用系統管理員庫存管理的資源。

aws license-manager list-resource-inventory

輸出:

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

下列程式碼範例會示範如何使用list-tags-for-resource

AWS CLI

列出授權規劃標籤的步驟

下列list-tags-for-resource範例會列出指定授權組態的標籤。

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

輸出:

{ "Tags": [ { "Key": "project", "Value": "lima" } ] }

下列程式碼範例會示範如何使用list-usage-for-license-configuration

AWS CLI

列出用於授權組態的授權的步驟

以下list-usage-for-license-configuration範例列出有關針對指定授權組態使用授權之資源的資訊。例如,如果授權類型為 vCPU,則任何執行個體都會耗用每個 vCPU 一個授權。

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

輸出:

{ "LicenseConfigurationUsageList": [ { "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-04a636d18e83cfacb", "ResourceType": "EC2_INSTANCE", "ResourceStatus": "running", "ResourceOwnerId": "123456789012", "AssociationTime": 1570892850.519, "ConsumedLicenses": 2 } ] }

下列程式碼範例會示範如何使用tag-resource

AWS CLI

若要新增授權組態標籤

下列tag-resource範例會將指定的標籤 (金鑰名稱和值) 新增至指定的授權組態。

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

此命令不會產生輸出。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考TagResource中的。

下列程式碼範例會示範如何使用untag-resource

AWS CLI

從授權組態中移除標籤的步驟

下列untag-resource範例會從指定的授權組態中移除指定的標籤 (金鑰名稱和資源)。

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

此命令不會產生輸出。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考UntagResource中的。

下列程式碼範例會示範如何使用update-license-configuration

AWS CLI

更新授權規劃的步驟

下列update-license-configuration範例會更新指定的授權組態,以移除硬性限制。

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

此命令不會產生輸出。

下列update-license-configuration範例會更新指定的授權組態,以將其狀態變更為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

此命令不會產生輸出。

下列程式碼範例會示範如何使用update-license-specifications-for-resource

AWS CLI

更新資源的授權規劃

下列update-license-specifications-for-resource範例透過移除一個授權組態並新增另一個授權組態,取代與指定 Amazon 機器映像 (AMI) 相關聯的授權組態。

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

此命令不會產生輸出。

下列程式碼範例會示範如何使用update-service-settings

AWS CLI

更新 License Manager 設定的步驟

下列update-service-settings範例會針對目前 AWS 區域中的 License Manager 啟用跨帳號資源探索。Amazon S3 儲存貯體是 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

此命令不會產生輸出。