Marketplace Subscriptions - Create Or Update

Criar ou atualizar 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-03-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
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 workspace do Azure Machine Learning

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
properties True

MarketplaceSubscriptionProperties

[Obrigatório] Atributos adicionais da entidade.

Respostas

Nome Tipo Description
200 OK

MarketplaceSubscription

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

201 Created

MarketplaceSubscription

A solicitação foi bem-sucedida e um novo recurso foi criado como resultado.

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
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

CreateOrUpdate Workspace Marketplace Subscription.

Solicitação de exemplo

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"
  }
}

Resposta de exemplo

{
  "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"
  }
}
{
  "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

Nome Description
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

MarketplacePlan
MarketplaceSubscription

Azure Resource Manager resource envelope.

MarketplaceSubscriptionProperties
MarketplaceSubscriptionProvisioningState
MarketplaceSubscriptionStatus
systemData

Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
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 destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

MarketplacePlan

Nome Tipo Description
offerId

string

O nome de identificação da Oferta do Plano do Marketplace.

planId

string

O nome de identificação do Plano do Plano do Marketplace.

publisherId

string

O nome de identificação do Editor do Plano do Marketplace.

MarketplaceSubscription

Azure Resource Manager resource envelope.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties

MarketplaceSubscriptionProperties

[Obrigatório] Atributos adicionais da entidade.

systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

MarketplaceSubscriptionProperties

Nome Tipo Description
marketplacePlan

MarketplacePlan

Plano do Marketplace associado à Assinatura do Marketplace.

marketplaceSubscriptionStatus

MarketplaceSubscriptionStatus

Status atual da Assinatura do Marketplace.

modelId

string

minLength: 1
pattern: [a-zA-Z0-9_]

[Obrigatório] ID de modelo do Marketplace de destino para a qual criar uma assinatura do Marketplace.

provisioningState

MarketplaceSubscriptionProvisioningState

Estado de provisionamento da assinatura do Marketplace.

MarketplaceSubscriptionProvisioningState

Valor Description
Creating

MarketplaceSubscription está sendo criado.

Deleting

MarketplaceSubscription está sendo excluído.

Succeeded

MarketplaceSubscription foi provisionado com êxito.

Failed

Falha no provisionamento do MarketplaceSubscription.

Updating

MarketplaceSubscription está sendo atualizado.

Canceled

MarketplaceSubscriptionStatus

Valor Description
Subscribed

O cliente agora pode usar o modelo da Assinatura do Marketplace e será cobrado.

Suspended

O cliente não pôde ser cobrado pela Assinatura do Marketplace. O cliente não poderá acessar o modelo.

Unsubscribed

As assinaturas do Marketplace atingem esse estado em resposta a uma ação explícita do cliente ou do CSP. Uma Assinatura do Marketplace também pode ser cancelada implicitamente, como resultado do não pagamento de taxas, depois de estar no estado Suspenso por algum tempo.

systemData

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.