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

Resource Orchestration Service:カスタムリソースリクエストオブジェクト

最終更新日:Jan 16, 2025

このトピックでは、テンプレート開発者からのリクエストのタイプとフィールドについて説明します。

テンプレート開発者リクエストのプロパティ

テンプレート開発者は、ALIYUN::ROS::CustomResource を使用して、テンプレートでカスタムリソースを指定します。

次の表は、ALIYUN::ROS::CustomResource に含まれる 3 つのプロパティ (ServiceToken、Parameters、Timeout) について説明しています。

プロパティ

タイプ

必須

説明

制約

ServiceToken

String

はい

カスタムサービスプロバイダーからテンプレート開発者に提供されるサービストークン。

サービストークンは、Function Compute 関数、MNS トピック、MNS キュー、または HTTP あるいは HTTPS URL を使用できます。

サービストークンはすべてのリージョンで使用できます。

Parameters

Map

いいえ

カスタムサービスプロバイダーに渡されるパラメーター。このプロパティは、カスタムサービスプロバイダーによって提供される仕様に基づいて指定する必要があります。

なし

Timeout

Number

いいえ

ROS がカスタムサービスプロバイダーからの応答を待機するタイムアウト期間。

有効な値: 1 ~ 43200。

単位: 秒。

デフォルト値: 60。

カスタムリソースプロバイダーのリクエストフィールド

これらのフィールドは、ROS からカスタムリソースプロバイダーへの JSON リクエストで送信されます。

フィールド

タイプ

必須

説明

制約

RequestType

String

はい

CreateStack、UpdateStack、DeleteStack などの ROS スタック操作によって設定されるリクエストタイプ。操作は、カスタムリソースを含むスタックに対してテンプレート開発者によって開始されます。

有効な値:

  • Create

  • Update

  • Delete

詳細については、「カスタムリソースリクエストタイプ」をご参照ください。

ResponseURL

String

はい

事前署名済みインターネット URL。この URL は、カスタムリソースプロバイダーから ROS への応答を受信します。

なし

IntranetResponseURL

String

はい

Elastic Compute Service ( ECS ) で使用できる事前署名済み内部 URL。この URL は、カスタムリソースプロバイダーから ROS への応答を受信します。

なし

StackId

String

はい

カスタムリソースを含むスタックの ID。

なし

StackName

String

はい

カスタムリソースを含むスタックの名前。

なし

ResourceOwnerId

String

はい

カスタムリソースを含むスタックが属する Alibaba Cloud アカウントの ID。

なし

CallerId

String

はい

スタック操作の実行に使用される Alibaba Cloud アカウントまたは RAM ユーザーの ID。

なし

RegionId

String

はい

カスタムリソースを含むスタックのリージョン ID。

なし

RequestId

String

はい

リクエストの一意の ID。 RequestId を StackId と組み合わせて使用すると、特定のカスタムリソースに対するリクエストを一意に識別する値を形成できます。

なし

ResourceType

String

はい

テンプレート開発者がテンプレート内のカスタムリソースに対して選択するリソースタイプ。

リソースタイプ名は最大 68 文字で、文字、数字、アンダースコア (_)、アットマーク (@)、およびハイフン (-) を含めることができます。

LogicalResourceId

String

はい

ROS テンプレート内のカスタムリソースに対してテンプレート開発者が選択した名前 (論理 ID)。このフィールドは、カスタムリソースプロバイダーとテンプレート開発者間の通信を容易にします。

なし

PhysicalResourceId

String

はい

カスタムリソースプロバイダーによって定義された物理 ID。この ID は、プロバイダーに対して一意です。

この ID は、更新リクエストと削除リクエストにのみ使用されます。

ResourceProperties

JSON オブジェクト

はい

リソースのプロパティ。このフィールドには、テンプレート開発者によって送信された Properties オブジェクトの内容が含まれています。内容は、カスタムリソースプロバイダーによって定義されます。

なし

OldResourceProperties

JSON オブジェクト

いいえ

更新リクエストの前に宣言されたリソースプロパティ。

これらのプロパティは、更新リクエストにのみ使用されます。