Partilhar via


Recursos de subscrição

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government

Uma assinatura permite que um cliente use um serviço por um determinado período de tempo. Nem todos os campos se aplicam a todas as assinaturas. Muitos campos só se aplicam em determinados pontos do ciclo de vida, como se uma assinatura for suspensa ou cancelada.

Subscrição

Nota

O recurso Subscrição tem um limite de taxa de 500 pedidos por minuto por identificador de inquilino.

O recurso Assinatura representa o ciclo de vida de uma assinatura e inclui propriedades que definem os estados ao longo do ciclo de vida da assinatura.

Propriedade Type Descrição
ID string O identificador de assinatura.
offerId string O identificador da oferta.
entitlementId string O identificador de direito (uma ID de assinatura do Azure).
offerName string O nome da oferta.
friendlyNome string O nome amigável para a assinatura definido pelo parceiro para ajudar a desambiguar.
quantidade number A quantidade. Esta propriedade é definida para a contagem de licenças para faturamento baseado em licença.
tipo de unidade string As unidades que definem a quantidade para a assinatura: "Licenças", "Baseado no uso" ou "Benefício".
parentSubscriptionId string Obtém ou define o identificador de assinatura pai.
criaçãoData de criação string Obtém ou define a data de criação, no formato data-hora.
effectiveStartDate string no formato de data e hora UTC Obtém ou define a data de início efetiva para esta assinatura, no formato de data e hora. Essa propriedade é usada para retroceder uma assinatura migrada ou para alinhá-la com outra.
compromissoData-limite string no formato de data e hora UTC A data de término do compromisso para esta assinatura, no formato de data-hora. Para subscrições que não são renováveis automaticamente, esta propriedade representa uma data muito distante no futuro. As novas datas de término do comércio são inclusivas, o que significa que o final do prazo é no final do dia inteiro. As datas de término herdadas não são inclusivas.
compromissoDataFinalHora string no formato de data e hora UTC A data e hora de término do compromisso para esta assinatura, no formato data-hora. Para subscrições que não são renováveis automaticamente, esta propriedade representa uma data muito distante no futuro.
estado string O status da assinatura: "nenhum", "ativo", "pendente", "suspenso", "expirado", "desativado" ou "excluído".
autoRenewEnabled boolean Obtém um valor que indica se a assinatura é renovada automaticamente.
billingType string Especifica como a assinatura é cobrada: "nenhuma", "uso", "licença" ou "benefício".
faturamentoCiclo string Indica a frequência com que o parceiro é cobrado por este pedido. Os valores suportados são os nomes de membros encontrados em BillingCycleType.
hasPurchasableAddons boolean Obtém ou define um valor que indica se a assinatura tem complementos compráveis.
isTrial boolean Um valor que indica se a assinatura é uma versão de avaliação.
isMicrosoftProduct boolean Um valor que indica se a assinatura é um produto da Microsoft.
publisherName string O nome do editor.
ações matriz de cadeias Obtém ou define as ações permitidas. Valores possíveis: "editar", "cancelar"
ID do parceiro string O PartnerID do revendedor de registro, usado no modelo de parceiro indireto.
suspensãoRazões matriz de cadeias Só de Leitura. Se a subscrição foi suspensa, indica porquê.
Tipo de contrato string Só de Leitura. O tipo de contrato: "assinatura", "productKey" ou "redemptionCode".
reembolsOpções: matriz de recursos RefundOption Somente leitura. O conjunto de opções de reembolso disponíveis para esta subscrição.
agendadoPróximoTermoInstruções agendadoPróximoTermoInstruções Obtém ou define as instruções agendadas executadas quando o próximo termo é iniciado.
próximoChargeInstructions próximoChargeInstructions Obtém detalhes para as instruções de faturamento do próximo termo para alterações pendentes do ciclo de faturamento no final do prazo atual.
ligações AssinaturaLinks Obtém ou define os links de assinatura.
orderId string A ID do pedido que foi feito para iniciar a assinatura.
termoDuração string Uma representação ISO 8601 da duração do termo. Os valores suportados atuais são P1M (1 mês), P1Y (1 ano) e P3Y (3 anos).
atributos ResourceAttributes Os atributos de metadados correspondentes à assinatura.
renovaçãoTermDuração string Uma representação ISO 8601 da duração do termo. Os valores atuais suportados são P1M (1 mês) e P1Y (1 ano).
Tipo de Produto Tipo de Item Só de Leitura. O tipo de produto para o qual a assinatura se destina.
consumptionType Variedade de recursos excedentes Obtém ou define excedentes para um determinado cliente.
promotionId string O identificador de promoção, se aplicado à assinatura. Exemplo de formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
CancelamentoPermitidoUntilDate DateTime A última data para cancelamento.
BillingCycleEndDate DateTime Obtém ou define a data de término do ciclo de faturamento para esta assinatura, no formato data-hora.
BillingCycleEndDateTime DateTime Obtém a hora da data de término do ciclo de faturamento para esta assinatura, no formato data-hora.
productOrderId string Identificador de uma compra de produto específica (por exemplo, Reservas ou plano de poupança do Azure).
lineItems SubscriptionLineItem Um item de linha contém os detalhes de compra de uma assinatura específica.

O recurso SubscriptionLinks descreve a coleção de links anexados a um recurso de assinatura.

Propriedade Type Description
oferta Ligação Obtém ou define a oferta.
parentSubscrição Ligação Obtém ou define a assinatura pai.
produto Ligação Obtém o produto associado à assinatura.
sku Ligação Obtém a sku do produto associada à assinatura.
disponibilidade Ligação Obtém a disponibilidade de sku do produto associada à assinatura.
ativaçãoLinks Ligação Obtém a lista de links de ativação associados à assinatura.
Eu mesmo Ligação O auto-URI.
next Ligação A próxima página de itens.
anterior Ligação A página anterior de itens.

SubscriptionProvisioningStatus

O recurso SubscriptionProvisioningStatus fornece informações sobre o status de provisionamento de uma assinatura.

Propriedade Type Description
skuId string Uma cadeia de caracteres que identifica a SKU do produto.
estado string Indica o status de provisionamento: "sucesso", "pendente" ou "falha".
quantidade number Fornece a quantidade de assinatura após o provisionamento.
endDate string no formato de data e hora UTC A data de término da assinatura.
atributos ResourceAttributes Os atributos de metadados.

agendadoPróximoTermoInstruções

O recurso scheduledNextTermInstructions define as instruções a serem aplicadas no início do próximo período da assinatura. Presente apenas se as alterações agendadas estiverem definidas ou para todas as subscrições de avaliação.

Propriedade Type Description
produto produto Uma cadeia de caracteres formatada em GUID que identifica a SKU do produto.
quantidade number Fornece a quantidade de assinatura após o provisionamento.
customTermEndDate string no formato de data e hora UTC A data de término personalizada da assinatura quando alinhada à data de término de outra assinatura

Produto

O recurso scheduledNextTermInstructions.product e os atributos de uma alteração agendada serão aplicados no próximo termo.

Propriedade Type Description
productId String A ID de um produto.
skuId String Fornece a quantidade de assinatura após o provisionamento.
availabilityId String O ID para esta disponibilidade. Essa ID é exclusiva apenas no contexto de seu produto pai e SKU. Observação Os IDs de disponibilidade podem mudar ao longo do tempo. Os parceiros só devem contar com este valor num curto espaço de tempo após a sua recuperação.
faturamentoCiclo String Indica a frequência com que o parceiro é cobrado por este pedido. Os valores suportados são os nomes de membros encontrados em BillingCycleType.
termoDuração String Uma representação ISO 8601 da duração do termo. Os valores atuais suportados são P1M (1 mês) e P1Y (1 ano).
promotionId String O identificador de promoção a ser aplicado para o próximo período agendado. Exemplo de formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN."

próximoChargeInstructions

O recurso nextChargeInstructions define as instruções do ciclo de faturamento aplicadas no início do próximo período de vigência da assinatura. Presente apenas quando as alterações pendentes do ciclo de faturamento estiverem pendentes.

Propriedade Type Description
produto produto Uma cadeia de caracteres formatada em GUID que identifica a SKU do produto.
quantidade number Fornece a quantidade de assinatura após o provisionamento.

SubscriptionRegistrationStatus

O recurso SubscriptionRegistrationStatus descreve a coleção de links anexados a um recurso de assinatura.

Propriedade Type Description
subscriptionId cadeia O identificador de assinatura.
estado string Indica o estado do registo: "registado", "registado" ou "não registado".

SuporteContato

O recurso SupportContact representa um contato de suporte para a assinatura de um cliente.

Propriedade Type Description
supportTenantId string Uma cadeia de caracteres formatada em GUID que indica o identificador de locatário do contato de suporte.
suporteMpnId string O identificador de parceiro do contato.
nome string O nome do contato de suporte.
ligações Links de Recursos Os links relacionados ao contato de suporte.
atributos ResourceAttributes Os atributos de metadados. Contém "objectType": " SupportContact."

Utilização excedida

O recurso de excesso representa o excesso de subscrição de consumo a que pode ser atribuído, quer seja atribuído e o Revendedor atribuído.

Propriedade Type Description
azureEntitlementId string Uma cadeia de caracteres formatada em GUID que indica o identificador de assinatura de consumo.
ID do parceiro string O identificador de parceiro do revendedor associado à assinatura.
tipo string O tipo de excesso pode ser "PhoneServices"
excesso de idade boolean Um valor que indica se a sobrecarga está habilitada.
ligações Links de Recursos Os links relacionados com overage.
atributos ResourceAttributes Os atributos de metadados. Contém "objectType": "Overage".

RegistarSubscrição

O recurso RegisterSubscription retorna um link que pode ser usado para consultar o status de registro de uma assinatura. O status de registro é retornado no corpo de resposta de uma solicitação aceita com êxito para registrar uma assinatura do Azure.

Propriedade Type Description
httpResponseMessage objeto Retorna o código de status HTTP 202 "Aceito", com um cabeçalho Location contendo um link para consultar o status do registro. Por exemplo, "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"

RefundOption

O recurso RefundOption representa uma possível opção de reembolso para a assinatura.

Propriedade Type Description
tipo string O tipo de reembolso. Os valores suportados são "Parcial" e "Completo"
expiraDepois string no formato de data e hora UTC O carimbo de data/hora quando essa opção expira. Se nulo, a operação de reembolso não tem validade.

AzureEntitlement

O recurso AzureEntitlement representa os direitos do Azure para a assinatura.

Propriedade Type Descrição
ID string O identificador de direito
friendlyNome string O nome amigável do direito.
estado string O estatuto do direito.
subscriptionId cadeia O identificador de subscrição a que pertence o direito.

SubscriptionLineItem

Um item de linha contém os detalhes de compra de uma assinatura específica.

Propriedade Tipo Descrição
ID string O identificador de item de linha de assinatura.
friendlyNome string O nome amigável para o item de linha de assinatura definido pelo parceiro para ajudar a desambiguar.
âmbito Scope O âmbito indica onde se aplicam os benefícios.
autoRenewEnabled Boolean Obtém um valor que indica se a assinatura é renovada automaticamente.
estado string O status da assinatura: "nenhum", "ativo", "pendente", "suspenso", "expirado", "desativado" ou "excluído".
compraCompromisso Compromisso de compra O montante fixo comprometido em serviços de computação.

Âmbito

O âmbito indica onde se aplicam os benefícios.

Propriedade Tipo Descrição
tipo string O tipo de escopo de uma compra: "Único", "Compartilhado", "Grupo de recursos" ou "Grupo de gerenciamento".
subscriptionId cadeia A ID do plano do Azure que seria usado para uma compra. Necessário para escopo compartilhado.
entitlementId string A ID da assinatura do Azure que seria usada para uma compra. Necessário para escopo único.
managementGroupId string A ID do grupo de gerenciamento que seria usado para uma compra. Esse escopo só pode ser selecionado por meio do portal do Azure hoje, mas as atualizações refletem no PC.
resourceGroupId string A ID do grupo de recursos que seria usado para uma compra. Esse escopo só pode ser selecionado por meio do portal do Azure hoje, mas as atualizações refletem no PC.

Compromisso de compra

O montante fixo comprometido em serviços de computação.

Propriedade Tipo Descrição
montante string O compromisso de montante fixo.
cereais string O período para o compromisso.
moeda string A moeda do compromisso.