Marketplace Subscriptions - Create Or Update

Serviço:: Machine Learning

Versão da API:: 2026-05-01

Crie ou atualize a Assinatura do Marketplace (assíncrona).

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

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
name	path	True	string	Nome do contêiner.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	O ID da assinatura de destino.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nome do Espaço de Trabalho do Azure Machine Learning
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Obrigatório	Tipo	Descrição
properties	True	MarketplaceSubscriptionProperties	[Obrigatório] Atributos adicionais da entidade.

Respostas

Name	Tipo	Descrição
200 OK	MarketplaceSubscription	Operação de atualização do recurso 'MarketplaceSubscription' bem-sucedida
201 Created	MarketplaceSubscription	O pedido foi bem-sucedido e, como resultado, foi criado um novo recurso. Cabeçalhos Azure-AsyncOperation: string x-ms-async-operation-timeout: string
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Name

Tipo

Descrição

200 OK

MarketplaceSubscription

Operação de atualização do recurso 'MarketplaceSubscription' bem-sucedida

201 Created

MarketplaceSubscription

O pedido foi bem-sucedido e, como resultado, foi criado um novo recurso.

Cabeçalhos

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

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Descrição
user_impersonation	assumir a identidade da sua conta de utilizador

Exemplos

CreateOrUpdate Workspace Marketplace Subscription.

Pedido de amostra

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-05-01

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Definições

Name	Descrição
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
MarketplacePlan
MarketplaceSubscription	Envelope de recursos do Azure Resource Manager.
MarketplaceSubscriptionProperties
MarketplaceSubscriptionProvisioningState
MarketplaceSubscriptionStatus
systemData	Metadados referentes à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

MarketplacePlan

Object

Name	Tipo	Descrição
offerId	string	O nome de identificação da Oferta do Plano de Marketplace.
planId	string	O nome identificador do Plano do Plano do Marketplace.
publisherId	string	O nome de identificação do Editor do Plano de Marketplace.