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

CloudOps Orchestration Service:OOS カスタムテンプレートを使用した ROA 形式 API の構成

最終更新日:Mar 22, 2025

オブジェクトストレージサービス (OSS) を使用する場合、バケットプロパティの作成や設定などの機能がよく必要になります。 さらに、長距離データ転送には、バケット転送アクセラレーションの構成が必要です。 このトピックでは、CloudOps Orchestration Service (OOS) カスタムテンプレートを使用して ROA 形式 API を呼び出し、OSS バケットとその転送アクセラレーション機能を迅速かつ簡単に構成する方法について説明します。

背景情報

特定の Alibaba Cloud サービスに対して ROA 形式 API を呼び出すには、Body、Headers、Method、URI などの複雑なパラメーターを構成する必要があることがよくあります。 OOS はコンソールを使用してこのプロセスを簡素化し、複雑なパラメーター値を自動的に入力します。 コンソールのプロンプトは、ROA 形式 API のさまざまな呼び出しパラメーターを構成する際に役立ちます。

このチュートリアルでは、OOS カスタムテンプレートを使用して ROA 形式 API を呼び出すことによる、OSS バケットとその転送アクセラレーション機能の構成に焦点を当てています。 他のクラウドサービスの構成については、このトピックの手順を参照してください。

OOS が ROA 形式 API の構成をサポートするクラウドサービスの種類は次のとおりです。

説明

OOS が API 呼び出しをサポートするクラウドプロダクトの詳細については、「サポートされているクラウドプロダクトリスト」をご参照ください。 呼び出したい API のクラウドプロダクトがリストに含まれていない場合は、DingTalk グループ (グループ番号: 23330931) に参加してください。

手順

説明

RAM ユーザーを使用している場合は、Alibaba Cloud アカウントが RAM ユーザーに AliyunOOSFullAccess ポリシーと AliyunOSSFullAccess ポリシーを 付与していることを確認してください。

  1. OOS コンソール > カスタムタスクテンプレート ページに移動し、[テンプレートの作成] をクリックします。

  2. [サンプルに基づいてテンプレートを作成] を選択し、[テンプレートの選択][acs-oos-exampleexecuteecsdescriberegions] を選択して、[次のステップ] をクリックします。

    Basic Sample Template

  3. OOS を介して ROA 形式 API を呼び出すことにより、OSS バケットとその転送アクセラレーション機能を構成します。

    この例では、フロー構成エディターを使用して ROA 形式 API をすばやく呼び出し、OSS バケットとその転送アクセラレーション機能を構成する方法を示します。 YAML コマンドの準備ができている場合は、YAML メソッドを使用してこれらの機能を直接構成することもできます。

    展開して表示: YAML コマンドテンプレートの例

    FormatVersion: OOS-2019-06-01
    Description: 単一の API を実行します //日本語訳
    Tasks:
      - Name: PutBucket
        Action: ACS::ExecuteApi
        Description: ''
        Properties:
          Service: oss
          API: PutBucket
          Parameters:
            bucket: '{{ bucket }}'
          Headers:
            x-oss-acl: private
          Body:
            CreateBucketConfiguration:
              StorageClass: Standard
              DataRedundancyType: LRS
      - Action: ACS::ExecuteApi
        Name: ExecuteApi1
        Description: ''
        Properties:
          Service: oss
          API: PutBucketTransferAcceleration
          Parameters:
            bucket: '{{ bucket }}'
          Headers: {}
          Body:
            TransferAccelerationConfiguration:
              Enabled: 'true'
    Parameters:
      bucket:
        Type: String
    1. [プロセス構成] タブで、右側の [テンプレートパラメーターの追加] をクリックします。

    2. ポップアップ [パラメーター] パネルで、[パラメーター名] (例: Bucket-example) を設定し、[パラメータータイプ][文字列] に設定して、screenshot_2025-03-06_13-50-28 をクリックしてパネルを閉じます。

    3. [プロセス構成] タブの [executeapi] セクションで、タスク関連のパラメーターを構成できます。

      1. [タスク入力] セクションで、サービス名と API 名の両方を選択します。

        Service Name

      2. ROA 形式 API の対応するパラメーターを設定します。

        • 必須パラメーター: [bucket] パラメーターで、[参照パラメーター/タスク出力] を選択し、事前に構成されたテンプレートパラメーター (Bucket-example) を選択します。

          API Parameter Style

        • その他のパラメーター: Headers パラメーターまたは Body パラメーターは、必要に応じて選択します。特別な要件がない場合は、構成は不要です。

          説明

          特定のパラメーターについて詳しく理解するには、screenshot_2025-03-06_15-59-08 にカーソルを合わせて、関連するプロンプトを表示します。

    4. ページの下部にある [新しいタスクの追加] をクリックし、ポップアップ [クイック選択] ページで [acs::executeapi] を選択します。

      Add New Task

    5. [executeapi1] セクションで、関連するタスクパラメーターを構成します。

      1. [タスク入力] セクションで、サービス名と API 名を選択します。

        Service Name

      2. ROA 形式 API の対応するパラメーターを設定します。

        API Parameter Style

        • 必須パラメーター: [bucket] パラメーターで、[参照パラメーター/タスク出力] を選択し、事前に構成されたテンプレートパラメーター (Bucket-example) を選択します。

        • 本文: true を選択すると、バケットで転送アクセラレーション機能が有効になります。

          説明

          パラメーターについて詳しく理解するには、screenshot_2025-03-06_15-59-08 で示されているように、パラメーターの横にある隣接するプロンプトにカーソルを合わせます。

  4. [テンプレートの作成] をクリックし、ポップアップ ダイアログボックスにテンプレート名を入力して、[OK] をクリックします。

  5. 作成したカスタムタスクテンプレートを見つけ、対応する [アクション] 列の [実行の作成] をクリックし、[次のステップ: パラメーター設定] をクリックします。

  6. Bucket-example パラメーターにカスタムバケット名 (例: test-by-oos) を入力し、[次のステップ: 確認] をクリックしてから、[作成] をクリックします。

検証結果

  1. OOS コンソール > バケット ページにアクセスし、新しく作成したバケット名 (例: test-by-oos) をクリックします。

  2. 左側のナビゲーションウィンドウで、[バケット構成] > [転送アクセラレーション] を選択し、転送アクセラレーション機能がデフォルトで有効になっていることを確認します。

    Transfer Acceleration

    これは、OOS カスタムテンプレートを使用して ROA 形式 API を呼び出すことにより、バケットを効率的に作成し、転送アクセラレーション機能を有効にできることを示しています。