Marketplace Subscriptions - Create Or Update

サービス:: Machine Learning

API バージョン:: 2026-03-01

Marketplace サブスクリプション (非同期) を作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/marketplaceSubscriptions/{name}?api-version=2026-03-01

URI パラメーター

名前	/	必須	型	説明
name	path	True	string	コンテナー名。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string minLength: 1	ターゲットサブスクリプションの ID。
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Azure Machine Learning ワークスペース名
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
properties	True	MarketplaceSubscriptionProperties	[必須]エンティティの追加の属性。

応答

名前	型	説明
200 OK	MarketplaceSubscription	リソース「マーケットプレイスサブスクリプション」更新作業成功
201 Created	MarketplaceSubscription	要求が成功し、結果として新しいリソースが作成されました。ヘッダー Azure-AsyncOperation: string x-ms-async-operation-timeout: string
Other Status Codes	ErrorResponse	予期しないエラー応答。

名前

型

説明

200 OK

MarketplaceSubscription

リソース「マーケットプレイスサブスクリプション」更新作業成功

201 Created

MarketplaceSubscription

要求が成功し、結果として新しいリソースが作成されました。

ヘッダー

Azure-AsyncOperation: string
x-ms-async-operation-timeout: string

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

CreateOrUpdate Workspace Marketplace Subscription.

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/marketplaceSubscriptions/string?api-version=2026-03-01

{
  "properties": {
    "modelId": "string"
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "string",
  "type": "string",
  "id": "string",
  "properties": {
    "marketplacePlan": {
      "offerId": "string",
      "planId": "string",
      "publisherId": "string"
    },
    "marketplaceSubscriptionStatus": "Suspended",
    "modelId": "string",
    "provisioningState": "Failed"
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:08",
    "createdBy": "string",
    "createdByType": "Key",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:08",
    "lastModifiedBy": "string",
    "lastModifiedByType": "ManagedIdentity"
  }
}

状態コード:: 201

{
  "name": "string",
  "type": "string",
  "id": "string",
  "properties": {
    "marketplacePlan": {
      "offerId": "string",
      "planId": "string",
      "publisherId": "string"
    },
    "marketplaceSubscriptionStatus": "Suspended",
    "modelId": "string",
    "provisioningState": "Failed"
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:08",
    "createdBy": "string",
    "createdByType": "ManagedIdentity",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:08",
    "lastModifiedBy": "string",
    "lastModifiedByType": "ManagedIdentity"
  }
}

定義

名前	説明
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
MarketplacePlan
MarketplaceSubscription	Azure Resource Manager リソースエンベロープ。
MarketplaceSubscriptionProperties
MarketplaceSubscriptionProvisioningState
MarketplaceSubscriptionStatus
systemData	リソースの作成と最後の変更に関連するメタデータ。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

MarketplacePlan

Object

名前	型	説明
offerId	string	マーケットプレースプランのオファーの識別名。
planId	string	マーケットプレイスプランのプランの識別名。
publisherId	string	Marketplace プランの発行元の識別名。

MarketplaceSubscription

Object

Azure Resource Manager リソースエンベロープ。

名前	型	説明
id	string	リソースの完全修飾リソース ID。例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	リソースの名前
properties	MarketplaceSubscriptionProperties	[必須]エンティティの追加の属性。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

MarketplaceSubscriptionProperties

Object

名前	型	説明
marketplacePlan	MarketplacePlan	Marketplace サブスクリプションに関連付けられた Marketplace プラン。
marketplaceSubscriptionStatus	MarketplaceSubscriptionStatus	Marketplaceサブスクリプションの現在のステータス。
modelId	string minLength: 1 pattern: [a-zA-Z0-9_]	[必須]Marketplace サブスクリプションを作成する対象の Marketplace モデル ID。
provisioningState	MarketplaceSubscriptionProvisioningState	Marketplace サブスクリプションのプロビジョニング状態。

MarketplaceSubscriptionProvisioningState

列挙

値	説明
Creating	MarketplaceSubscription が作成されています。
Deleting	MarketplaceSubscription が削除されています。
Succeeded	MarketplaceSubscription が正常にプロビジョニングされました。
Failed	MarketplaceSubscription のプロビジョニングに失敗しました。
Updating	MarketplaceSubscription が更新されています。
Canceled

MarketplaceSubscriptionStatus

列挙

値	説明
Subscribed	これで、顧客は Marketplace サブスクリプションのモデルを使用できるようになり、課金されます。
Suspended	Marketplace サブスクリプションの料金を顧客に請求できませんでした。顧客はモデルにアクセスできません。
Unsubscribed	Marketplace サブスクリプションは、明示的な顧客または CSP のアクションに応答してこの状態に達します。 Marketplace サブスクリプションは、会費の未払いの結果として、しばらくの間 Suspended 状態になった後、暗黙的にキャンセルすることもできます。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。