Compartilhar via

Recursos de assinatura

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para a Nuvem Microsoft para o Governo dos EUA

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 fosse suspensa ou cancelada.

Subscrição

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 Tipo Descrição
ID cadeia O identificador da assinatura.
offerId cadeia O identificador da oferta.
identificador de direito cadeia O identificador de concessão (uma ID de assinatura do Azure).
nome da oferta cadeia O nome da oferta.
nome amigável cadeia O nome amigável da assinatura definida pelo parceiro para ajudar a desambiguar.
quantidade número A quantidade. Esta propriedade está ajustada para a contagem de licenças no faturamento baseado em licença.
Tipo de unidade cadeia As unidades que definem a quantidade para a assinatura são: "Licenças", "Com base no uso" ou "Benefício".
parentSubscriptionId cadeia Obtém ou define o identificador de assinatura principal.
data de criação cadeia Obtém ou define a data de criação, no formato de data e hora.
data de início efetiva cadeia de caracteres no formato de data e hora em UTC Obtém ou define a data de início efetiva dessa assinatura, no formato de data e hora. Essa propriedade é usada para fazer backup de uma assinatura migrada ou para alinhá-la com outra.
commitmentEndDate cadeia de caracteres no formato de data e hora em UTC A data de término do compromisso desta assinatura, em formato de data e hora. Para assinaturas que não são autorrenováveis, essa 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 fim do prazo está no final do dia inteiro. As datas de término herdadas 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 desta assinatura, em formato de data e hora. Para assinaturas que não são autorrenováveis, essa propriedade representa uma data muito distante no futuro.
status cadeia O status da assinatura: "nenhum", "ativo", "pendente", "suspenso", "expirado", "desabilitado" ou "excluído".
auto-renovação habilitada booleano Obtém um valor que indica se a assinatura é renovada automaticamente.
tipoDeCobrança cadeia Especifica como a assinatura é cobrada: "nenhum", "uso", "licença" ou "benefício".
ciclo de faturamento cadeia Indica a frequência com que o parceiro é cobrado por esse pedido. Os valores com suporte são os nomes de membro encontrados em BillingCycleType.
temComplementosCompráveis booleano Obtém ou define um valor que indica se a assinatura tem complementos adquiríveis.
isTrial booleano Um valor que indica se a assinatura é uma avaliação.
isMicrosoftProduct booleano Um valor que indica se a assinatura é um produto da Microsoft.
nomeDoPublicador cadeia 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 cadeia O PartnerID do revendedor de registro, usado no modelo de parceiro indireto.
IDs adicionais de Parceiro Matriz de cadeias de caracteres Uma coleção de PartnerIDs usada somente por distribuidores nos mercados da UE/EFTA.
razões de suspensão Matriz de cadeias de caracteres Somente leitura. Se a assinatura foi suspensa, indica o motivo.
tipoContrato cadeia Somente leitura. O tipo de contrato: "assinatura", "chave do produto" ou "código de resgate".
opções de reembolso matriz de recursos RefundOption Somente Leitura. O conjunto de opções de reembolso disponíveis para esta assinatura.
Instruções programadas para o próximo semestre scheduledNextTermInstructions Obtém ou define as instruções agendadas a serem executadas no início do próximo termo.
nextChargeInstructions nextChargeInstructions Obtém detalhes das instruções de cobrança para o período seguinte para alterações pendentes no ciclo de cobrança ao final do período atual.
Links SubscriptionLinks Obtém ou define os links de assinatura.
ID do pedido cadeia A ID do pedido que foi feito para iniciar a assinatura.
duração do prazo cadeia Uma representação ISO 8601 da duração do prazo. Os valores atuais suportados são P1M (1 mês), P1Y (1 ano) e P3Y (3 anos).
termLifeCycleState cadeia Uma representação do estado do ciclo de vida do termo subscrito. Os valores atuais com suporte são GA (geralmente disponível), EndOfSale e EndOfSaleWithConversions (podem ser convertidos para).
Atributos Atributos de recursos Os atributos de metadados correspondentes à assinatura.
duraçãoDoPeríodoDeRenovação cadeia Uma representação ISO 8601 da duração do prazo. Os valores atuais compatíveis são P1M (1 mês) e P1Y (1 ano).
Tipo de Produto Tipo de Item Somente leitura. O tipo de produto para o qual a assinatura se destina.
tipo de consumo matriz de recursos excedentes Obtém ou define a sobrecarga para um determinado cliente.
promotionId cadeia O identificador de promoção caso seja aplicado à assinatura. Exemplo de formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
DataPermitidaParaCancelamentoAté Data e Hora A última data para cancelamento.
BillingCycleEndDate Data e Hora Obtém ou define a data de término do ciclo de cobrança dessa assinatura, em formato de data e hora.
BillingCycleEndDateTime Data e Hora Obtém a data e hora de término do ciclo de cobrança para essa assinatura, no formato de data e hora.
ID do pedido do produto cadeia Identificador para 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 Tipo Descrição
oferta Link Obtém ou define a oferta.
assinatura principal Link Obtém ou define a assinatura pai.
produto Link Obtém o produto associado à assinatura.
Sku Link Obtém o sku do produto associado à assinatura.
disponibilidade Link Obtém a disponibilidade do SKU do produto associada à assinatura.
activationLinks Link Obtém a lista de links de ativação associados à assinatura.
eu Link O auto-URI.
Próximo Link A próxima página de itens.
anterior Link A página anterior dos itens.

StatusDeProvisãoDaAssinatura

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

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

Instruções programadas para o próximo semestre

O recurso scheduledNextTermInstructions define as instruções a serem aplicadas no início do próximo termo da assinatura. Apenas presente se as alterações agendadas estiverem definidas ou para todas as assinaturas experimentais.

Propriedade Tipo Descrição
produto produto Uma cadeia de caracteres formatada por GUID que identifica o SKU do produto.
quantidade número Fornece o número de assinaturas 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

Produto

O recurso scheduledNextTermInstructions.product e os atributos que uma alteração agendada aplicarão no próximo termo.

Propriedade Tipo Descrição
ID do produto fio A ID de um produto.
skuId fio Fornece o número de assinaturas após o provisionamento.
identificadorDeDisponibilidade fio O ID para essa disponibilidade. Essa ID é exclusiva apenas no contexto de seu produto pai e SKU. Nota As IDs de disponibilidade podem ser alteradas ao longo do tempo. Os parceiros só devem contar com esse valor em um curto período de tempo depois de recuperá-lo.
ciclo de faturamento fio Indica a frequência com que o parceiro é cobrado por esse pedido. Os valores com suporte são os nomes de membro encontrados em BillingCycleType.
duração do prazo fio Uma representação ISO 8601 da duração do prazo. Os valores atuais compatíveis são P1M (1 mês) e P1Y (1 ano).
promotionId fio O identificador de promoção a ser aplicado para o próximo período agendado. Exemplo de formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN".

nextChargeInstructions

O recurso nextChargeInstructions define as instruções do ciclo de cobrança aplicadas no início do próximo termo da assinatura. Só está presente quando há alterações pendentes no ciclo de cobrança.

Propriedade Tipo Descrição
produto produto Uma cadeia de caracteres formatada por GUID que identifica o SKU do produto.
quantidade número Fornece o número de assinaturas após o provisionamento.

SubscriptionRegistrationStatus

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

Propriedade Tipo Descrição
ID de assinatura cadeia O identificador da assinatura.
status cadeia Indica o status do registro: "registrado", "registrando" ou "não registrado".

SuporteContato

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

Propriedade Tipo Descrição
supportTenantId cadeia Uma cadeia de caracteres com o formato GUID que indica o identificador de inquilino do contato de suporte.
supportMpnId cadeia Identificador do parceiro do contato.
nome cadeia O nome do contato de suporte.
Links Links de recursos Links relacionados ao contato de suporte.
Atributos Atributos de recursos Os atributos de metadados. Contém "objectType": " SupportContact".

Excedente

O recurso excesso representa o excesso da assinatura de consumo ao qual pode ser atribuído, se está atribuída e o Revendedor designado.

Propriedade Tipo Descrição
azureEntitlementId cadeia Uma cadeia de caracteres no formato GUID que indica o identificador de assinatura de consumo.
partnerId cadeia O identificador de parceiro do revendedor associado à assinatura.
tipo cadeia O tipo de excedente pode ser "Serviços Telefônicos"
excedente booleano Um valor que indica se o sobreuso está habilitado.
Links Links de recursos Os links relacionados ao excedente.
Atributos Atributos de recursos Os atributos de metadados. Contém "objectType": "Overage".

RegistrarAssinatura

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

Opção de reembolso

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

Propriedade Tipo Descrição
tipo cadeia O tipo de reembolso. Os valores com suporte são "Parcial" e "Completo"
expiraApós cadeia de caracteres no formato de data e hora em UTC O horário em que esta opção expira. Se nula, a operação de reembolso não terá expiração.

AzureEntitlement

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

Propriedade Tipo Descrição
ID cadeia O identificador de direito
nome amigável cadeia O nome amigável da autorização.
status cadeia O status do direito adquirido.
ID de assinatura cadeia 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 cadeia O identificador do item de linha de assinatura.
nome amigável cadeia O nome amigável do item de linha de assinatura definido pelo parceiro para ajudar a desambiguar.
escopo Âmbito O escopo indica onde os benefícios se aplicam.
auto-renovação habilitada booleano Obtém um valor que indica se a assinatura é renovada automaticamente.
status cadeia O status da assinatura: "nenhum", "ativo", "pendente", "suspenso", "expirado", "desabilitado" ou "excluído".
compromisso de compra Compromisso de compra O valor fixo comprometido nos serviços de computação.

Scope

O escopo indica onde os benefícios se aplicam.

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

Compromisso de compra

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

Propriedade Tipo Descrição
quantidade cadeia O compromisso de valor fixo.
granularidade cadeia O período do compromisso.
moeda cadeia A moeda do compromisso.
  • Last updated on