すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Management:OpenAPI 統合の例

最終更新日:May 01, 2026

このトピックでは、OpenAPI を使用して Intelligent Media Management (IMM) プロジェクトを作成する完全な例を紹介します。

OpenAPI ドキュメント

API 概要を参照し、Intelligent Media Management プロジェクトを作成するための OpenAPI(CreateProject)を確認してください。必要なパラメーターと権限を理解するために、API ドキュメントをよくお読みください。

ユーザー ID と権限

ID

  • この API オペレーションは、Alibaba Cloud アカウント、RAM ユーザー、または RAM ロールを引き受けることで呼び出すことができます。これらの ID の違いについては、「ID、認証情報、および権限付与」をご参照ください。この例では、RAM ユーザーを使用して API を呼び出します。Resource Access Management (RAM) にログインし、API 呼び出しのみを許可する RAM ユーザーを作成して、AccessKey ペアを記録してください。詳細については、「RAM ユーザーの作成」をご参照ください。

権限付与

  1. ユーザーページに移動し、対象の RAM ユーザーの 操作 列で [権限の追加] をクリックします。

  2. [権限の追加] パネルで、AliyunIMMFullAccess および AliyunSTSAssumeRoleAccess を選択します。

    説明
  3. [権限付与] をクリックします。

アクセス認証情報

  • 一時的なアクセス認証情報:OSS への一時的なアプリケーションアクセスなど、セキュリティ要件が高いシナリオでは、一時的なアクセス認証情報を使用してください。一時的なアクセス認証情報は有効期間を制限できるため、認証情報の漏洩リスクを低減できます。また、権限制御もサポートされているため、過剰な権限の付与を回避できます。詳細については、「アクセス認証情報の設定 (Go SDK V1)」をご参照ください。

  • 長期的なアクセス認証情報:セキュリティ上の理由から、長期的なアクセス認証情報の使用は推奨されません。代わりに一時的なアクセス認証情報を使用してください。利便性が重視されるシナリオでは、長期的なアクセス認証情報により長期間にわたって認証情報の再取得を回避できます。アカウントのセキュリティを向上させるため、長期的なアクセス認証情報は 3 か月ごとにローテーションしてください。長期的なアクセス認証情報が漏洩した場合や不要になった場合は、セキュリティリスクを軽減するために速やかに削除または無効化してください。詳細については、「アクセス認証情報の設定 (Go SDK V1)」をご参照ください。

長期 AccessKey

  1. AccessKey は RAM ユーザー作成時に生成できます。

  2. 対象の RAM ユーザー名をクリックしてユーザー詳細ページに移動します。認証管理 タブで、AccessKey の作成 をクリックします。詳細な手順については、「AccessKey の作成」をご参照ください。

STS 一時認証情報

重要

この操作は、RAM ユーザーまたは RAM ロールを引き受ける場合にのみ呼び出せます。Alibaba Cloud アカウントでは呼び出せません。

  1. RAM ユーザーを作成します。

    詳細については、「RAM ユーザーの作成」をご参照ください。

  2. RAM ユーザーに AliyunSTSAssumeRoleAccess 権限を付与します。

    詳細については、「RAM ユーザーへの権限付与」をご参照ください。

  3. RAM ユーザーとして、Security Token Service (STS) の AssumeRole 操作を呼び出して、一時的なアクセス認証情報を取得します。

    詳細については、「AssumeRole」をご参照ください。

説明

API 呼び出しに STS トークンを使用すると、長期 AccessKey が公開されるリスクを回避できるため、AccessKey を使用するよりも安全です。 IMM に対して複数回の一時的な呼び出しが必要な場合は、STS トークンを手動でリフレッシュする必要があります。

OpenAPI の呼び出し

本記事では Python SDK を使用して OpenAPI を呼び出す方法を説明します。他の言語の SDK の使用方法も同様です。詳細については、 をご参照ください。

Python 環境の準備

Python 3 をダウンロードしてインストールします。

説明

Python のバージョンを確認するには、ターミナルを開いて python --version と入力してください。

AccessKey 環境変数の設定

ここでは、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を例として使用します。必要に応じて、OSS_ACCESS_KEY_IDOSS_ACCESS_KEY_SECRET などの変数名に置き換えることができます。

重要

Alibaba Cloud アカウントの AccessKey ペアにはすべての API オペレーションに対する権限があります。API オペレーションの呼び出しや日常的な運用管理 (O&M) には、RAM ユーザーの AccessKey ペアを使用してください。認証情報をアプリケーションコード内に直接保存したり、バージョン管理システムにコミットしたりしないでください。

Linux および macOS での Alibaba Cloud AccessKey の環境変数設定

ここでは、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を例として使用します。必要に応じて、OSS_ACCESS_KEY_IDOSS_ACCESS_KEY_SECRET などの変数名に置き換えることができます。

export コマンドを使用した環境変数の設定

重要

export コマンドで設定された一時的な環境変数は、現在のセッションでのみ有効です。セッション終了時に変数はクリアされます。長期保存 (LTR) を行う場合は、export コマンドをオペレーティングシステムの起動設定ファイルに追加してください。

  • AccessKey ID を設定し、Enter キーを押します。

    # yourAccessKeyID を実際の AccessKey ID に置き換えます。
    export ALIBABA_CLOUD_ACCESS_KEY_ID=yourAccessKeyID
  • AccessKey Secret を設定し、Enter キーを押します。

    # yourAccessKeySecret を実際の AccessKey Secret に置き換えます。
    export ALIBABA_CLOUD_ACCESS_KEY_SECRET=yourAccessKeySecret
  • 設定を確認します。

    echo $ALIBABA_CLOUD_ACCESS_KEY_ID コマンドを実行します。正しい AccessKey ID が返された場合、設定は成功しています。

Windows での Alibaba Cloud AccessKey の環境変数設定

ここでは、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET を例として使用します。必要に応じて、OSS_ACCESS_KEY_IDOSS_ACCESS_KEY_SECRET などの変数名に置き換えることができます。

グラフィカルユーザーインターフェイス (GUI) の使用

  • 手順

    以下の手順は、Windows 10 で GUI を使用して環境変数を設定する方法を説明しています。

    デスクトップで [PC] を右クリックし、[プロパティ] > [システムの詳細設定] > [環境変数] > システム環境変数 または ユーザー環境変数 の下の [新規] を選択して、設定を完了します。

    変数

    例となる値

    AccessKey ID

    • 変数名: ALIBABA_CLOUD_ACCESS_KEY_ID

    • 変数値: yourAccessKeyID

    AccessKey Secret

    • 変数名: ALIBABA_CLOUD_ACCESS_KEY_SECRET

    • 変数値: yourAccessKeySecret

  • 設定のテスト

    [スタート] をクリックするか (Win+R キーボードショートカットを使用)、[実行] をクリックし、`cmd` と入力して [OK] をクリック (または Enter キーを押) してコマンドプロンプトを開きます。echo %ALIBABA_CLOUD_ACCESS_KEY_ID% および echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET% コマンドを実行します。正しい AccessKey が返された場合、設定は成功しています。

コマンドプロンプト (CMD) の使用

  • 手順

    管理者としてコマンドプロンプトを開き、次のコマンドを実行して新しい環境変数をシステムに追加します。

    setx ALIBABA_CLOUD_ACCESS_KEY_ID yourAccessKeyID /M
    setx ALIBABA_CLOUD_ACCESS_KEY_SECRET yourAccessKeySecret /M

    /M パラメーターはシステム環境変数を示します。ユーザー環境変数を設定する場合は、このパラメーターを省略できます。

  • 設定のテスト

    [スタート] をクリックするか (Win+R キーボードショートカットを使用)、[実行] をクリックし、`cmd` と入力して [OK] をクリック (または Enter キーを押) してコマンドプロンプトを開きます。echo %ALIBABA_CLOUD_ACCESS_KEY_ID% および echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET% コマンドを実行します。正しい AccessKey が返された場合、設定は成功しています。

Windows PowerShell の使用

PowerShell では、すべての新しいセッションで有効な新しい環境変数を設定できます。

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'yourAccessKeySecret', [System.EnvironmentVariableTarget]::User)

すべてのユーザー向けに環境変数を設定するには、管理者権限が必要です。

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'yourAccessKeySecret', [System.EnvironmentVariableTarget]::Machine)

現在のセッションでのみ有効な一時的な環境変数を設定することもできます。

$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "yourAccessKeyID"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "yourAccessKeySecret"

PowerShell で Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_ID および Get-ChildItem env:ALIBABA_CLOUD_ACCESS_KEY_SECRET コマンドを実行します。正しい AccessKey が返された場合、設定は成功しています。

重要

環境変数を設定した後、統合開発環境 (IDE) などの開発ツールやサービスを再起動する必要がある場合があります。これにより、新しい設定が反映されます。

Security Token Service (STS) トークンの環境変数設定

Mac OS X/Linux/UNIX

export IMM_ACCESS_KEY_ID=<ALIBABA_CLOUD_ACCESS_KEY_ID>
export IMM_ACCESS_KEY_SECRET=<ALIBABA_CLOUD_ACCESS_KEY_SECRET>
export IMM_SESSION_TOKEN=<ALIBABA_CLOUD_SECURITY_TOKEN>

Windows

set IMM_ACCESS_KEY_ID <ALIBABA_CLOUD_ACCESS_KEY_ID>
set IMM_ACCESS_KEY_SECRET <ALIBABA_CLOUD_ACCESS_KEY_SECRET>
set IMM_SESSION_TOKEN <ALIBABA_CLOUD_SECURITY_TOKEN>

サンプルコードのダウンロードと依存関係のインストール


pip install alibabacloud_credentials

[パラメーター設定] タブで、作成するプロジェクトの projectName などの必須パラメーター情報を入力します。

pip install alibabacloud_tea_console

サンプルコードパッケージをローカルに解凍し、alibabacloud_sample ディレクトリに移動します。

サンプルコードの実行

ターミナルで次のコマンドを実行します。

python sample.py

次の出力が返されます。

{
    "headers":{
        "date":"Thu, 10 Aug 2023 06:34:51 GMT",
        "content-type":"application/json;charset=utf-8",
        "content-length":"602",
        "connection":"keep-alive",
        "keep-alive":"timeout=25",
        "access-control-allow-origin":"*",
        "access-control-expose-headers":"*",
        "x-acs-request-id":"2C489857-69E6-5974-B963-A7DF99EFFF43",
        "x-acs-trace-id":"eccc35df82a086e7bb4f4fe778f****",
        "etag":"6HYADxT6iVDNgQUq+wGO****"
    },
    "statusCode":200,
    "body":{
        "Project":{
            "CreateTime":"2023-08-10T14:34:51.586696893+08:00",
            "DatasetCount":0,
            "DatasetMaxBindCount":10,
            "DatasetMaxEntityCount":10000000000,
            "DatasetMaxFileCount":100000000,
            "DatasetMaxRelationCount":100000000000,
            "DatasetMaxTotalFileSize":90000000000000000,
            "Description":"",
            "EngineConcurrency":200,
            "FileCount":0,
            "ProjectMaxDatasetCount":1000000000,
            "ProjectName":"testproject",
            "ProjectQueriesPerSecond":200,
            "ServiceRole":"AliyunIMMDefaultRole",
            "TemplateId":"Official:DefaultEmptyId",
            "TotalFileSize":0,
            "UpdateTime":"2023-08-10T14:34:51.586696977+08:00"
        },
        "RequestId":"2C489857-69E6-5974-B963-A7DF99EFFF43"
    }
}