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

:GetServiceProvisions

最終更新日:Jun 04, 2026

Alibaba Cloud サービスの有効化ステータスおよびそのサービスリンクロールに関する情報をクエリします。

操作説明

使用上の注意

このトピックでは、中国 (杭州) リージョンにおける Elastic High Performance Computing (EHPC) の有効化ステータスおよび EHPC のサービスリンクロールに関する情報をクエリする方法の例を示します。

説明

GetRole 操作を呼び出す権限があることを確認してください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ros:GetServiceProvisions

list

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

リージョン ID です。最新のリージョン一覧は、DescribeRegions 操作を呼び出してクエリできます。

cn-hangzhou

TemplateBody

string

任意

テンプレート本文の構造です。テンプレート本文のサイズは 1~524,288 バイトである必要があります。テンプレート本文の長さが上限を超える場合は、URL が長くなりすぎることによるリクエスト失敗を回避するために、HTTP POST + Body Param 方式でリクエストボディにパラメーターを渡すことを推奨します。

説明

TemplateBody、TemplateURL、TemplateId、Services パラメーターのうち、いずれか 1 つのみを指定できます。

ROSTemplateFormatVersion: '2015-09-01'\r\nResources:\r\n Vpc:\r\n Type: ALIYUN::ECS::VPC\r\n Properties:\r\n CidrBlock: 192.168.0.0/24\r\n VpcName: TestVpc

TemplateURL

string

任意

テンプレート本文を含むファイルの URL です。URL は HTTP または HTTPS Web サーバー、または Object Storage Service (OSS) バケット上にあるテンプレートを指している必要があります。テンプレート本文のサイズは 1~524,288 バイトである必要があります。OSS URL の例:oss://ros/template/demo、oss://ros/template/demo?RegionId=cn-hangzhou。OSS バケットのリージョン ID を指定しない場合、RegionId パラメーターの値が使用されます。

TemplateBody、TemplateURL、TemplateId、Services パラメーターのうち、いずれか 1 つのみを指定できます。

oss://ros-template/demo

TemplateId

string

任意

テンプレート ID です。このパラメーターは、共有テンプレートおよびプライベートテンプレートに適用されます。

TemplateBody、TemplateURL、TemplateId、Services パラメーターのうち、いずれか 1 つのみを指定できます。

5ecd1e10-b0e9-4389-a565-e4c15efc****

TemplateVersion

string

任意

テンプレートのバージョンです。このパラメーターを指定しない場合、最新バージョンが使用されます。

このパラメーターは TemplateId を指定した場合にのみ有効です。

v1

Parameters

array<object>

任意

パラメーターです。

object

任意

ParameterKey

string

必須

パラメーターの名前です。パラメーターの名前と値を指定しない場合、Resource Orchestration Service (ROS) はテンプレートで指定されたデフォルトの名前と値を使用します。

説明

Parameters は省略可能です。Parameters を指定する場合は、ParameterKey を指定する必要があります。

Amount

ParameterValue

string

必須

パラメーターの値です。

説明

Parameters は省略可能です。Parameters を指定する場合は、ParameterValue を指定する必要があります。

12

Services

array<object>

任意

Alibaba Cloud サービスの一覧です。

object

任意

ServiceName

string

必須

Alibaba Cloud サービスの名前です。有効な値:

  • AHAS:Application High Availability Service

  • ARMS:Application Real-Time Monitoring Service

  • ApiGateway:API Gateway

  • BatchCompute:Batch Compute

  • BrainIndustrial:Industrial Intelligence

  • CloudStorageGateway:Cloud Storage Gateway

  • CMS:Cloud Monitor

  • CR:Container Registry

  • CS:Container Service

  • DCDN:DCDN

  • DataHub:DataHub

  • DataWorks:DataWorks

  • EDAS:Enterprise Distributed Application Service

  • EHPC:Elastic High Performance Computing

  • EMAS:Enterprise Mobile Application Studio

  • FC:Function Compute

  • FNF:CloudFlow

  • MaxCompute:MaxCompute

  • SMQ:Simple Message Queue (旧称:MNS)

  • HBR:Cloud Backup

  • IMM:Intelligent Media Management

  • IOT:IoT Platform

  • KMS:Key Management Service

  • NAS:File Storage NAS

  • NLP:Natural Language Processing

  • OSS:Object Storage Service

  • OTS:Tablestore

  • PrivateLink:PrivateLink

  • PrivateZone:PrivateZone

  • RocketMQ:Message Queue for Apache RocketMQ

  • SAE:Serverless App Engine

  • SLS:Simple Log Service

  • TrafficMirror:Traffic Mirroring

  • VS:Video Surveillance

  • Xtrace:トレーシング分析

EHPC

共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID です。

A9938C04-26AD-5EFA-B394-EA7866842DFF

ServiceProvisions

array<object>

Alibaba Cloud サービスの詳細です。

array<object>

ServiceName

string

Alibaba Cloud サービスの名前です。

EHPC

Status

string

Alibaba Cloud サービスの有効化ステータスです。有効な値:

  • Enabled:サービスが有効化されています。

  • Disabled:サービスが有効化されていません。

  • Unknown:有効化ステータスが不明です。

Enabled

StatusReason

string

Alibaba Cloud サービスが有効化されていない、または有効化ステータスが不明である理由です。

説明

このパラメーターは、Status の値が Disabled または Unknown の場合にのみ返されます。

No permission.

AutoEnableService

boolean

スタック作成時にテンプレートを使用してサービスを自動的に有効化するかどうかを示します。有効な値:

  • true:サービスが自動的に有効化されます。

  • false:サービスは自動的に有効化されません。

false

EnableURL

string

Alibaba Cloud サービスを有効化するために使用できる URL です。

説明

このパラメーターは、Status の値が Disabled の場合にのみ返されます。

https://common-buy-intl.alibabacloud.com/?commodityCode=nas

RoleProvision

object

Alibaba Cloud サービスのサービスリンクロールに関する情報です。このパラメーターが空の場合、サービスに関連付けられたサービスリンクロールはありません。

AuthorizationURL

string

サービスリンクロールに権限を付与するために使用できる URL です。

説明

このパラメーターは、Created の値が false の場合にのみ返されます。

https://ehpc.console.alibabacloud.com/

Roles

array<object>

サービスリンクロールです。

array<object>

RoleName

string

サービスリンクロールの名前です。

AliyunServiceRoleForEHPC

Created

boolean

サービスリンクロールが作成されているかどうかを示します。有効な値:

  • true:サービスリンクロールが作成されています。

  • false:サービスリンクロールが作成されていません。

true

Function

string

ロールの目的です。デフォルト値:Default。この値は、ロールがサービスのデフォルトロールであることを示します。

Default

ApiForCreation

object

ロールを作成するために使用される API オペレーションに関する情報です。

ApiProductId

string

API オペレーションが属する Alibaba Cloud サービスの ID です。

rds

ApiName

string

API オペレーションの名前です。

CreateServiceLinkedRole

ApiType

string

API オペレーションのタイプです。有効な値:

  • Open:Alibaba Cloud API オペレーション

  • Inner:内部 API オペレーション

Open

Parameters

object

API オペレーションのパラメーターです。パラメーターの値は動的値です。サポートされる動的値:${RegionId}(リージョン ID を示します)。

{ "ServiceLinkedRole": "AliyunServiceRoleForRdsPgsqlOnEcs", "RegionId": "${RegionId}" }

DependentServiceNames

array

クエリ対象のサービスが依存するサービスです。

string

クエリ対象のサービスが依存するサービスの名前です。

NAS

CommodityProvisions

array<object>

商品の詳細です。Container Compute Service (ACS) などの一部のサービスでは、複数の商品を有効化する必要があります。

object

CommodityCode

string

商品コードです。

acs_postpaid_public_cn

Status

string

Alibaba Cloud サービスの有効化ステータスです。有効な値:

  • Enabled:サービスが有効化されています。

  • Disabled:サービスが有効化されていません。

Disabled

EnableURL

string

商品を有効化するための URL です。

https://common-buy-intl.alibabacloud.com/?commodityCode=acs_postpaid_public_cn

成功レスポンス

JSONJSON

{
  "RequestId": "A9938C04-26AD-5EFA-B394-EA7866842DFF",
  "ServiceProvisions": [
    {
      "ServiceName": "EHPC",
      "Status": "Enabled",
      "StatusReason": "No permission.",
      "AutoEnableService": false,
      "EnableURL": "https://common-buy-intl.alibabacloud.com/?commodityCode=nas",
      "RoleProvision": {
        "AuthorizationURL": "https://ehpc.console.alibabacloud.com/",
        "Roles": [
          {
            "RoleName": "AliyunServiceRoleForEHPC",
            "Created": true,
            "Function": "Default",
            "ApiForCreation": {
              "ApiProductId": "rds",
              "ApiName": "CreateServiceLinkedRole",
              "ApiType": "Open",
              "Parameters": {
                "ServiceLinkedRole": "AliyunServiceRoleForRdsPgsqlOnEcs",
                "RegionId": "${RegionId}"
              }
            }
          }
        ]
      },
      "DependentServiceNames": [
        "NAS"
      ],
      "CommodityProvisions": [
        {
          "CommodityCode": "acs_postpaid_public_cn",
          "Status": "Disabled",
          "EnableURL": "https://common-buy-intl.alibabacloud.com/?commodityCode=acs_postpaid_public_cn"
        }
      ]
    }
  ]
}

エラーコード

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

変更履歴

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