Alibaba Cloud CLI を使用した Resource Center API の呼び出し - Resource Management

基本概念

Alibaba Cloud CLI (Alibaba Cloud Command Line Interface) は、OpenAPI に基づくコマンドラインツールで、Resource Center の管理を自動化します。

ステップ1：Alibaba Cloud CLI のインストール

お使いのオペレーティングシステムに Alibaba Cloud CLI をインストールします。

Windows： Windows への Alibaba Cloud CLI のインストール。
Linux： Linux への Alibaba Cloud CLI のインストール。
macOS： macOS への Alibaba Cloud CLI のインストール。

Cloud Shell には Alibaba Cloud CLI がプリインストールされており、認証情報も自動的に構成されます。Cloud Shell でコマンドを直接デバッグできます。Cloud Shell とは。

ステップ2：Alibaba Cloud CLI の設定

重要

プライマリアカウントはすべての OpenAPI オペレーションに対するフルアクセス権限を持つため、セキュリティリスクが高くなります。RAM アイデンティティを作成し、最小権限の原則に基づいて権限を付与したうえで、その RAM アイデンティティを使用して OpenAPI オペレーションを呼び出すことを強く推奨します。Resource Center の権限ポリシーについては、「ResourceManager のシステムポリシー」および「Resource Management のカスタムポリシー」をご参照ください。
Resource Center は、アカウントがアクセス権を持つリソースのみをクエリできます。RAM アイデンティティを使用する場合は、Resource Center の権限に加えて、対象のクラウドリソースに対する読み取り専用権限を RAM ユーザーに付与する必要があります。RAM ユーザーに Resource Center を使用する権限を付与する。

Alibaba Cloud CLI を使用する前に、認証情報とリージョン ID を設定します。Alibaba Cloud CLI は複数の認証情報タイプをサポートしています (設定例)。この例では AccessKey 認証情報を使用します。

RAM ユーザーを作成し、AccessKey を作成します。
RAM ユーザーに Resource Center への読み取り専用アクセス用の AliyunResourceCenterReadOnlyAccess ポリシーと、対象のクラウドリソースに対するポリシーを付与します。たとえば、Virtual Private Cloud (VPC) リソースに対しては AliyunVPCReadOnlyAccess を付与します。RAM ユーザー権限の管理。
リージョン ID を取得します。利用可能な Resource Center のリージョンは「エンドポイント」に記載されています。

説明
--region オプションは、デフォルトの認証情報および環境変数で指定されたリージョンを上書きします。コマンドラインオプション。
RAM ユーザーの AccessKey とリージョン ID を使用して AccessKey 認証情報を設定します。プロファイル名は AkProfile とします。設定例。

ステップ3：CLI コマンド例の生成

OpenAPI Explorer で、SearchResources のデバッグページに移動します。

[Filter] などのパラメーターを設定し、[CLI Example] タブをクリックします。
パラメーターの設定 でリクエストパラメーターを入力し、[CLI Example] タブをクリックして、生成された CLI の例を確認します。
CLI の例をコピーするか、Cloud Shell で実行します。
- [start] ボタンをクリックして Cloud Shell を開き、コマンドをすばやくデバッグします。
- レプリケーション ボタンをクリックして、CLI の例をクリップボードにコピーします。ローカルのシェルに貼り付けるか、自動化スクリプトで使用します。
説明
CLI の例をローカルのシェルに貼り付ける際は、パラメーター形式が正しいことを確認してください。パラメーター形式。

OpenAPI Explorer は、生成された例に既定で --region を追加します。これにより、デフォルトのプロファイルおよび環境変数で指定されたリージョンが上書きされます。このオプションは保持または削除できます。

ステップ4：Resource Center API の呼び出し

例1：サポートされている Resource Center API の一覧表示

--help を使用して、Resource Center のすべての API を一覧表示します。API の概要。

次のコマンドを実行します。
```
aliyun resourcecenter --help
```

想定される出力：

Product: ResourceCenter (Resource Center)
Version: 2022-12-01
Available Api List:
    AssociateDefaultFilter                Sets a default filter.
    CreateFilter                          Creates a filter.
    CreateSavedQuery                      Creates a custom query template.
    DeleteFilter                          Deletes a filter.
    DeleteSavedQuery                      Deletes a custom query template.
    DisableMultiAccountResourceCenter     Disables cross-account resource search.
    DisableResourceCenter                 Disables Resource Center.
    DisassociateDefaultFilter             Disassociates the default filter.
    EnableMultiAccountResourceCenter      Enables cross-account resource search.

例2：アカウントリソースの検索

Resource Center の SearchResources API を呼び出し、現在のアカウント内の Virtual Private Cloud のルートテーブルリソースを検索します。

次のコマンドを実行します。

aliyun resourcecenter SearchResources --Filter.1.Key ResourceType --Filter.1.Value.1 'ACS::VPC::RouteTable' --Filter.1.MatchType Equals

想定される出力：

{
  "NextToken": "eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****",
  "RequestId": "D696E6EF-3A6D-5770-801E-4982081FE4D0",
  "MaxResults": 10,
  "Resources": [
    {
      "AccountId": "151266687691****",
      "ResourceGroupId": "rg-acfmzawhxxc****",
      "ResourceId": "vtb-bp11lbh452fr8940s****",
      "ResourceName": "group1",
      "CreateTime": "2024-09-25T08:55:30Z",
      "ResourceType": "ACS::VPC::RouteTable",
      "RegionId": "ap-northeast-1"
    }
  ]
}

説明

Resource Center API の呼び出しでエラーが返された場合は、リクエストパラメーターと値が有効であることを確認してください。

RequestId または SDK のエラーメッセージを記録し、OpenAPI 問題診断ページでトラブルシューティングを行ってください。