すべてのプロダクト
Search

このプロダクト

    DataWorks:GetResourceGroup

    ドキュメントセンター

    DataWorks:GetResourceGroup

    最終更新日:Mar 21, 2026

    リソースグループの ID を指定して、そのリソースグループの情報を照会します。

    操作説明

    DataWorks のベーシック版以上をご契約済みの場合にご利用いただけます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    dataworks:GetResourceGroup

    get

    *DwResourceGroup

    acs:dataworks:{#regionId}:{#accountId}:dwresourcegroup/{#DwResourceGroupId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Id

    string

    必須

    リソースグループの ID です。

    Serverless_res_group_524257424564736_6831777003XXXXX

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマです。

    Success

    boolean

    リクエストが成功したかどうかを示します。

    true
    ResourceGroup

    object

    リソースグループの詳細情報です。

    Id

    string

    リソースグループの ID です。

    Serverless_res_group_524257424564736_6831777003XXXXX
    Name

    string

    リソースグループの名前です。

    common_resource_group
    Remark

    string

    リソースグループの説明です。

    创建用于普通任务的通用资源组
    PaymentType

    string

    リソースグループの支払い方法です。有効な値は PrePaid（サブスクリプション課金）および PostPaid（従量課金）です。

    PrePaid
    Status

    string

    リソースグループのステータスです。有効な値は以下のとおりです。

    • Normal：リソースグループが実行中または利用中の状態です。

    • Stop：リソースグループの有効期限が切れた状態です。

    • Deleted：リソースグループがリリースまたは削除された状態です。

    • Creating：リソースグループが作成中の状態です。

    • CreateFailed：リソースグループの作成に失敗した状態です。

    • Updating：リソースグループがスケールイン／スケールアウト中、または構成が変更中の状態です。

    • UpdateFailed：リソースグループのスケールアウトまたはスペックアップに失敗した状態です。

    • Deleting：リソースグループがリリースまたは削除中の状態です。

    • DeleteFailed：リソースグループのリリースまたは削除に失敗した状態です。

    • Timeout：リソースグループに対する操作がタイムアウトした状態です。

    • Freezed：リソースグループが凍結された状態です。

    • Starting：リソースグループが起動中の状態です。

    Normal
    Spec

    object

    リソースグループの仕様です。

    Standard

    string

    リソースグループ内の計算ユニット (CU) 数です。

    2CU
    Amount

    integer

    リソースグループ内のリソース数です。

    1
    ResourceGroupType

    string

    リソースグループのタイプです。有効な値は以下のとおりです。

    • CommonV2：サーバーレスリソースグループ。

    • ExclusiveDataIntegration：データ統合専用リソースグループ。

    • ExclusiveScheduler：スケジューリング専用リソースグループ。

    • ExclusiveDataService：DataService Studio 専用リソースグループ。

    CommonV2
    OrderInstanceId

    string

    リソースグループを作成するために使用した注文のインスタンス ID です。

    c442b330-3b10-4584-959e-736e4edXXXXX
    CreateUser

    string

    リソースグループを作成するために使用したアカウントの ID です。

    11075500042XXXXX
    CreateTime

    integer

    リソースグループが作成された時刻です。値は 64 ビットのタイムスタンプです。

    1727055811000
    DefaultVpcId

    string

    リソースグループがデフォルトで関連付けられている VPC の ID です。

    vpc-m2et4f3oc8msfbccXXXXX
    DefaultVswitchId

    string

    リソースグループがデフォルトで関連付けられている vSwitch の ID です。

    vsw-uf8usrhs7hjd9amsXXXXX
    AliyunResourceGroupId

    string

    Alibaba Cloud リソースグループの ID です。

    rg-aek2kqofrgXXXXX
    AliyunResourceTags

    array<object>

    タグです。

    object

    タグです。

    Key

    string

    タグキーです。

    key
    Value

    string

    タグ値です。

    value
    RequestId

    string

    リクエスト ID です。

    6A6CBE87-9F91-1323-B680-E7A7065XXXXX

    例

    成功レスポンス

    JSONJSON

    {
  "Success": true,
  "ResourceGroup": {
    "Id": "Serverless_res_group_524257424564736_6831777003XXXXX",
    "Name": "common_resource_group",
    "Remark": "创建用于普通任务的通用资源组",
    "PaymentType": "PrePaid",
    "Status": "Normal",
    "Spec": {
      "Standard": "2CU",
      "Amount": 1
    },
    "ResourceGroupType": "CommonV2",
    "OrderInstanceId": "c442b330-3b10-4584-959e-736e4edXXXXX",
    "CreateUser": "11075500042XXXXX",
    "CreateTime": 1727055811000,
    "DefaultVpcId": "vpc-m2et4f3oc8msfbccXXXXX",
    "DefaultVswitchId": "vsw-uf8usrhs7hjd9amsXXXXX",
    "AliyunResourceGroupId": "rg-aek2kqofrgXXXXX",
    "AliyunResourceTags": [
      {
        "Key": "key",
        "Value": "value"
      }
    ]
  },
  "RequestId": "6A6CBE87-9F91-1323-B680-E7A7065XXXXX"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。