Recursos de assinatura

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o 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.

Assinatura

Observação

O recurso Assinatura tem um limite de taxa de 500 solicitações por minuto por identificador de locatário.

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 da 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.
friendlyName string O nome amigável para a assinatura definido pelo parceiro para ajudar a desambiguar.
quantity número A quantidade. Essa propriedade é definida como a contagem de licenças para cobrança baseada em licença.
Tipo de unidade string As unidades que definem a quantidade para a assinatura: "Licenças", "Baseado em uso" ou "Benefício".
parentSubscriptionId string Obtém ou define o identificador de assinatura pai.
creationDate string Obtém ou define a data de criação, no formato data-hora.
effectiveStartDate cadeia de caracteres no formato de data e hora em UTC Obtém ou define a data de início efetiva para esta assinatura, no formato de data-hora. Essa propriedade é usada para retroceder uma assinatura migrada ou para alinhá-la com outra.
compromissoData de término do compromisso cadeia de caracteres no formato de data e hora em UTC A data de término do compromisso para esta assinatura, no formato data-hora. Para assinaturas que não são auto-renováveis, essa propriedade representa uma data distante no futuro. 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 do legado não são inclusivas.
commitmentEndDateTime cadeia de caracteres no formato de data e hora em UTC A data e a hora de término do compromisso para esta assinatura, no formato data-hora. Para assinaturas que não são auto-renováveis, essa propriedade representa uma data distante no futuro.
status 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.
tipo de faturamento string Especifica como a assinatura é cobrada: "nenhuma", "uso", "licença" ou "benefício".
billingCycle 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 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 de caracteres Obtém ou define as ações permitidas. Valores possíveis: "editar", "cancelar"
partnerId string O PartnerID do revendedor de registro, usado no modelo de parceiro indireto.
suspensãoRazões matriz de cadeias de caracteres Somente leitura. Se a assinatura foi suspensa, indica o motivo.
contractType string Somente leitura. O tipo de contrato: "assinatura", "productKey" ou "redemptionCode".
reembolsoOpções matriz de recursos RefundOption Somente leitura. O conjunto de opções de reembolso disponíveis para esta assinatura.
agendadoPróximoTermInstruções agendadoPróximoTermInstruções Obtém ou define as instruções agendadas executadas quando o próximo termo é iniciado.
próximoChargeInstruções próximoChargeInstruções Obtém detalhes para as instruções de faturamento do próximo período para alterações pendentes do ciclo de faturamento no final do período atual.
links Links de Assinatura Obtém ou define os links de assinatura.
orderId string A ID do pedido que foi feito para iniciar a assinatura.
prazoDuração string Uma representação ISO 8601 da duração do termo. Os valores atuais suportados são P1M (1 mês), P1Y (1 ano) e P3Y (3 anos).
Atributos ResourceAttributes Os atributos de metadados correspondentes à assinatura.
renovaçãoPrazoDuraçã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).
ProductType ItemType Somente leitura. O tipo de produto para o qual a assinatura se destina.
consumoTipo matriz de recursos excedentes Obtém ou define o excesso para um determinado cliente.
promotionId string O identificador da 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 cobrança para esta assinatura, no formato de data e hora.
BillingCycleEndDateTime DateTime Obtém a data de término do ciclo de cobrança e a hora desta assinatura, no formato de data e 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 Descrição
oferta Link Obtém ou define a oferta.
parentSubscrição Link Obtém ou define a assinatura pai.
produto Link Obtém o produto associado à assinatura.
sku Link Obtém a sku do produto associada à assinatura.
availability Link Obtém a disponibilidade de sku do produto associada à assinatura.
ativaçãoLinks Link Obtém a lista de links de ativação associados à assinatura.
self Link O auto-URI.
avançar Link A próxima página de itens.
Anterior Link A página anterior de itens.

SubscriptionProvisioningStatus

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

Propriedade Type Descrição
skuId string Uma cadeia de caracteres que identifica a SKU do produto.
status string Indica o status de provisionamento: "êxito", "pendente" ou "falha".
quantity número Fornece a quantidade de assinatura após o provisionamento.
endDate cadeia de caracteres no formato de data e hora em UTC A data de término da assinatura.
Atributos ResourceAttributes Os atributos de metadados.

agendadoPróximoTermInstruções

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

Propriedade Type Descrição
produto product Uma cadeia de caracteres formatada em GUID que identifica a SKU do produto.
quantity número Fornece a quantidade de assinatura após o provisionamento.
customTermEndDate cadeia de caracteres no formato de data e hora em UTC A data de término personalizada da assinatura quando alinhada à data de término de outra assinatura

Product

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

Propriedade Type Descrição
productId String A ID de um produto.
skuId String Fornece a quantidade de assinatura após o provisionamento.
availabilityId String O ID para essa disponibilidade. Esse ID é exclusivo somente no contexto de seu produto pai e SKU. Observação As IDs de disponibilidade podem mudar com o tempo. Os parceiros só devem confiar nesse valor dentro de um curto período de tempo após recuperá-lo.
billingCycle 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.
prazoDuraçã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óximoChargeInstruções

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

Propriedade Type Descrição
produto product Uma cadeia de caracteres formatada em GUID que identifica a SKU do produto.
quantity número 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 Descrição
subscriptionId string O identificador da assinatura.
status string Indica o status do registro: "registrado", "registrado" ou "não registrado".

SuporteContato

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

Propriedade Type Descrição
supportTenantId string Uma cadeia de caracteres formatada em GUID que indica o identificador de locatário do contato de suporte.
supportMpnId string O identificador de parceiro do contato.
name string O nome do contato de suporte.
links ResourceLinks Os links relacionados ao contato de suporte.
Atributos ResourceAttributes Os atributos de metadados. Contém "objectType": " SupportContact."

Excedente

O recurso de excesso representa o excesso de assinatura de consumo ao qual pode ser atribuído, seja ele atribuído e o Revendedor atribuído.

Propriedade Type Descrição
azureEntitlementId string Uma cadeia de caracteres formatada em GUID que indica o identificador de assinatura de consumo.
partnerId string O identificador de parceiro do revendedor associado à assinatura.
tipo string O tipo de excesso pode ser "PhoneServices"
Excedente boolean Um valor que indica se o excesso está habilitado.
links ResourceLinks Os links relacionados ao excesso de idade.
Atributos ResourceAttributes Os atributos de metadados. Contém "objectType": "Overage".

Cadastre-seAssinatura

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

Propriedade Type Descrição
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 Descrição
type string O tipo de reembolso. Os valores suportados são "Parcial" e "Completo"
expira após cadeia de caracteres no formato de data e hora em UTC O carimbo de data/hora quando essa opção expira. Se nula, a operação de reembolso não tem expiração.

AzureEntitlement

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

Propriedade Type Descrição
ID string O identificador de direito
friendlyName string O nome amigável do direito.
status string O status do direito.
subscriptionId string O identificador de assinatura ao qual o direito pertence.

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.
friendlyName string O nome amigável para o item de linha de assinatura definido pelo parceiro para ajudar a desambiguar.
scope Escopo O escopo indica onde os benefícios se aplicam.
autoRenewEnabled Booliano Obtém um valor que indica se a assinatura é renovada automaticamente.
status string O status da assinatura: "nenhum", "ativo", "pendente", "suspenso", "expirado", "desativado" ou "excluído".
compraCompromisso Compromisso de Compra O valor fixo comprometido em serviços de computação.

Escopo

O escopo indica onde os benefícios se aplicam.

Propriedade Tipo Descrição
type string O tipo de escopo de uma compra: "Único", "Compartilhado", "Grupo de recursos" ou "Grupo de gerenciamento".
subscriptionId string 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 computador.
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 computador.

Compromisso de Compra

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

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