Recursos de assinatura
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. |
Links de Assinatura
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. |