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. |
AssinaturaLinks
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. |