

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `get_app_url` 関数を `estimator` クラスメソッドとして使用して TensorBoard を開く
<a name="debugger-htb-access-tb-get-app-url-estimator-method"></a>

SageMaker Python SDK の `estimator` クラスを使用してトレーニングジョブを実行していて、`estimator` クラスのアクティブオブジェクトがある場合は、`estimator` クラスの[クラスメソッドとして `get_app_url` 関数](https://sagemaker.readthedocs.io/en/stable/api/training/estimators.html#sagemaker.estimator.EstimatorBase.get_app_url)にアクセスすることもできます。TensorBoard アプリケーションを開くか、以下のように `get_app_url` メソッドを実行して署名なし URL を取得します。`get_app_url` クラスメソッドは、推定器からトレーニングジョブ名を取得し、指定されたジョブを含む TensorBoard アプリケーションを開きます。

**注記**  
この機能は、SageMaker Python SDK v2.184.0 以降で利用できます。この機能を使用するには、必ず `pip install sagemaker --upgrade` を実行して SDK をアップグレードしてください。

**Topics**
+ [オプション 1: SageMaker Studio Classic の場合](#debugger-htb-access-tb-get-app-url-estimator-method-studio)
+ [オプション 2: Studio Classic 以外の環境の場合](#debugger-htb-access-tb-get-app-url-estimator-method-non-studio)

## オプション 1: SageMaker Studio Classic の場合
<a name="debugger-htb-access-tb-get-app-url-estimator-method-studio"></a>

**TensorBoard アプリケーションを開くには** 

次のコードは、お使いの環境のデフォルトウェブブラウザで `get_app_url()` メソッドが返す署名なし URL から TensorBoard アプリケーションを自動的に開きます。

```
estimator.get_app_url(
    app_type=SupportedInteractiveAppTypes.TENSORBOARD # Required.
)
```

**署名なし URL を取得して TensorBoard アプリケーションを手動で開くには**

次のコードは、ウェブブラウザにコピーして TensorBoard アプリケーションを開くことができる署名なし URL を出力します。

```
print(
    estimator.get_app_url(
        app_type=SupportedInteractiveAppTypes.TENSORBOARD, # Required.
        open_in_default_web_browser=False, # Optional. Set to False to print the URL to terminal.
    )
)
```

上記の 2 つのコードサンプルを SageMaker AI Studio Classic 環境の外部で実行すると、ドメインとユーザープロファイルへのサインイン情報が含まれていないため、関数は SageMaker AI コンソールの TensorBoard ランディングページの URL を返すことに注意してください。署名済み URL の作成については、次のセクションのオプション 2 を参照してください。

## オプション 2: Studio Classic 以外の環境の場合
<a name="debugger-htb-access-tb-get-app-url-estimator-method-non-studio"></a>

SageMaker ノートブックインスタンスや Amazon EC2 などの Studio Classic 以外の環境を使用していて、TensorBoard アプリケーションを開くための署名済み URL を生成する場合は、以下のようにドメインとユーザープロファイル情報を使用して `get_app_url` メソッドを使用します。

このオプションでは、ドメインユーザーに `sagemaker:CreatePresignedDomainUrl` アクセス許可が必要であることに注意してください。このアクセス許可がないと、ドメインユーザーには例外エラーが表示されます。

**重要**  
署名済み URL は共有しないでください。`get_app_url` 関数は署名済み URL を作成します。これにより、ドメインとユーザープロファイルで自動的に認証され、ドメインに関連するすべてのアプリケーションやファイルにアクセスできるようになります。

```
print(
    estimator.get_app_url(
        app_type=SupportedInteractiveAppTypes.TENSORBOARD, # Required
        create_presigned_domain_url=True,           # Reguired to be set to True for creating a presigned URL.
        domain_id="your-domain-id",                 # Required if creating a presigned URL (create_presigned_domain_url=True).
        user_profile_name="your-user-profile-name", # Required if creating a presigned URL (create_presigned_domain_url=True).
        open_in_default_web_browser=False,            # Optional. Set to False to print the URL to terminal.
        optional_create_presigned_url_kwargs={}       # Optional. Add any additional args for Boto3 create_presigned_domain_url
    )
)
```