Recursos de assinaturaSubscription resources

Aplica-se a:Applies to:

  • Partner CenterPartner Center
  • Partner Center operado pela 21VianetPartner Center operated by 21Vianet
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Partner Center do Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Uma assinatura permite que um cliente use um serviço por um determinado período de tempo.A subscription lets a customer use a service for a certain period of time. Nem todos os campos serão aplicados a todas as assinaturas.Not all fields will apply to all subscriptions. Muitos campos se aplicam apenas em determinados pontos no ciclo de vida, como se uma assinatura for suspensa ou cancelada.Many fields only apply at certain points in the life cycle, such as if a subscription is suspended or cancelled.

SubscriptionSubscription

Observação

O recurso de assinatura tem um limite de taxa de 500 solicitações por minuto por identificador de locatário.The Subscription resource has a rate limit of 500 requests per minute per tenant identifier.

O recurso de assinatura representa o ciclo de vida de uma assinatura e inclui propriedades que definem os Estados em todo o ciclo de vida da assinatura.The Subscription resource represents the life cycle of a subscription and includes properties that define the states throughout the subscription life cycle.

PropriedadeProperty TipoType DescriçãoDescription
idid stringstring O identificador da assinatura.The subscription identifier.
offerIdofferId stringstring O identificador da oferta.The offer identifier.
entitlementIdentitlementId stringstring O identificador de direito (uma ID de assinatura do Azure).The entitlement identifier (an Azure subscription ID).
offerNameofferName stringstring O nome da oferta.The offer name.
friendlyNamefriendlyName stringstring O nome amigável da assinatura definida pelo parceiro para ajudar a ambiguidade.The friendly name for the subscription defined by the partner to help disambiguate.
quantidadequantity númeronumber A quantidade.The quantity. Por exemplo, no caso de cobrança baseada em licença, essa propriedade é definida como a contagem de licenças.For example, in case of license-based billing, this property is set to the license count.
unitTypeunitType stringstring As unidades que definem a quantidade para a assinatura.The units defining quantity for the subscription.
parentSubscriptionIdparentSubscriptionId stringstring Obtém ou define o identificador da assinatura pai.Gets or sets the parent subscription identifier.
creationDatecreationDate stringstring Obtém ou define a data de criação, no formato de data e hora.Gets or sets the creation date, in date-time format.
effectiveStartDateeffectiveStartDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format Obtém ou define a data de início efetiva desta assinatura, no formato de data e hora.Gets or sets the effective start date for this subscription, in date-time format. Ele é usado para fazer a data de início de uma assinatura migrada ou para alinhá-la com outra.It is used to back date a migrated subscription or to align it with another.
commitmentEndDatecommitmentEndDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data de término do compromisso desta assinatura, no formato de data e hora.The commitment end date for this subscription, in date-time format. Para assinaturas que não são renováveis automaticamente, isso representa uma data até agora, longe no futuro.For subscriptions which are not auto-renewable, this represents a date far, far away in the future.
statusstatus stringstring O status da assinatura: "nenhum", "ativo", "pendente", "suspenso" ou "excluído".The subscription status: "none", "active", "pending", "suspended", or "deleted".
autoRenewEnabledautoRenewEnabled booleanoboolean Obtém um valor que indica se a assinatura é renovada automaticamente.Gets a value indicating whether the subscription is renewed automatically.
billtypebillingType stringstring Especifica como a assinatura é cobrada: "None", "Usage" ou "License".Specifies how the subscription is billed: "none", "usage", or "license".
billingCyclebillingCycle stringstring Indica a frequência com que o parceiro é cobrado por esse pedido.Indicates the frequency with which the partner is billed for this order. Os valores com suporte são os nomes de membro encontrados em BillingCycleType.Supported values are the member names found in BillingCycleType.
hasPurchasableAddonshasPurchasableAddons booleanoboolean Obtém ou define um valor que indica se a assinatura tem Complementos compráveis.Gets or sets a value indicating whether the subscription has purchasable add-ons.
isTrialisTrial booleanoboolean Um valor que indica se esta é uma assinatura de avaliação.A value indicating whether this is a trial subscription.
isMicrosoftProductisMicrosoftProduct booleanoboolean Um valor que indica se este é um produto da Microsoft.A value indicating whether this is a Microsoft product.
publisherNamepublisherName stringstring O nome do editor.The publisher name.
Açõesactions Matriz de cadeias de caracteresarray of strings Obtém ou define as ações que são permitidas.Gets or sets the actions that are allowed. Valores possíveis: "Editar", "Cancelar"Possible values: "edit", "cancel"
parceiroidpartnerId stringstring A ID de MPN do revendedor do registro, usada no modelo de parceiro indireto.The MPN ID of the reseller of record, used in the indirect partner model.
suspensionReasonssuspensionReasons Matriz de cadeias de caracteresarray of strings Somente leitura.Read-only. Se a assinatura foi suspensa, indica o porquê.If the subscription was suspended, indicates why.
contractTypecontractType stringstring Somente leitura.Read-only. O tipo de contrato: "assinatura", "productKey" ou "redemptionCode".The type of contract: "subscription", "productKey", or "redemptionCode".
reembolsaoptionsrefundOptions matriz de recursos de RefundOptionarray of RefundOption resources Somente leitura.Read-Only. O conjunto de opções de reembolso disponíveis para esta assinatura.The set of refund options available for this subscription.
linkslinks SubscriptionLinksSubscriptionLinks Obtém ou define os links de assinatura.Gets or sets the subscription links.
orderIdorderId stringstring A ID da ordem que foi colocada para iniciar a assinatura.The ID of the order that was placed to begin the subscription.
termDurationtermDuration stringstring Uma representação ISO 8601 da duração do termo.An ISO 8601 representation of the term's duration. Os valores atuais com suporte são P1M (1 mês), P1Y (1 ano) e P3Y (3 anos).The current supported values are P1M (1 month), P1Y (1 year) and P3Y (3 years).
Atributosattributes ResourcegroupResourceAttributes Os atributos de metadados correspondentes à assinatura.The metadata attributes corresponding to the subscription.
renewalTermDurationrenewalTermDuration stringstring Uma representação ISO 8601 da duração do termo.An ISO 8601 representation of the term's duration. Os valores atuais com suporte são P1M (1 mês) e P1Y (1 ano).The current supported values are P1M (1 month) and P1Y (1 year).

O recurso SubscriptionLinks descreve a coleção de links anexados a um recurso de assinatura.The SubscriptionLinks resource describes the collection of links attached to a subscription resource.

PropriedadeProperty TipoType DescriçãoDescription
ofertaoffer LinkLink Obtém ou define a oferta.Gets or sets the offer.
parentSubscriptionparentSubscription LinkLink Obtém ou define a assinatura pai.Gets or sets the parent subscription.
productproduct LinkLink Obtém o produto associado à assinatura.Gets the product associated with the subscription.
skusku LinkLink Obtém a SKU do produto associada à assinatura.Gets the product sku associated with the subscription.
availabilityavailability LinkLink Obtém a disponibilidade de SKU do produto associada à assinatura.Gets the product sku availability associated with the subscription.
activationLinksactivationLinks LinkLink Obtém a lista de links de ativação associados à assinatura.Gets the list of activation links associated with the subscription.
selfself LinkLink O próprio URI.The self URI.
Próximonext LinkLink A próxima página de itens.The next page of items.
previousprevious LinkLink A página anterior de itens.The previous page of items.

SubscriptionProvisioningStatusSubscriptionProvisioningStatus

O recurso SubscriptionProvisioningStatus fornece informações sobre o status de provisionamento de uma assinatura.The SubscriptionProvisioningStatus resource provides information about the provisioning status of a subscription.

PropriedadeProperty TipoType DescriçãoDescription
skuIdskuId stringstring Uma cadeia de caracteres formatada GUID que identifica a SKU do produto.A GUID formatted string that identifies the product SKU.
statusstatus stringstring Indica o status de provisionamento: "êxito", "pendente" ou "falha".Indicates the provisioning status: "success", "pending" or "failed".
quantidadequantity númeronumber Fornece a quantidade de assinatura após o provisionamento.Provides the subscription quantity after provisioning.
endDateendDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data de término da assinatura.The end date of the subscription.
Atributosattributes ResourcegroupResourceAttributes Os atributos de metadados.The metadata attributes.

SubscriptionRegistrationStatusSubscriptionRegistrationStatus

O recurso SubscriptionRegistrationStatus descreve a coleção de links anexados a um recurso de assinatura.The SubscriptionRegistrationStatus resource describes the collection of links attached to a subscription resource.

PropriedadeProperty TipoType DescriçãoDescription
subscriptionIdsubscriptionId stringstring O identificador da assinatura.The subscription identifier.
statusstatus stringstring Indica o status do registro: "registrado", "registrando" ou "não registrado".Indicates the registration status: "registered", "registering" or "notregistered".

SupportContactSupportContact

O recurso SupportContact representa um contato de suporte para a assinatura de um cliente.The SupportContact resource represents a support contact for a customer's subscription.

PropriedadeProperty TipoType DescriçãoDescription
supportTenantIdsupportTenantId stringstring Uma cadeia de caracteres formatada GUID que indica o identificador de locatário do contato de suporte.A GUID formatted string that indicates the support contact's tenant identifier.
supportMpnIdsupportMpnId stringstring O identificador de Microsoft Partner Network (MPN) do contato.The contact's Microsoft Partner Network (MPN) identifier.
namename stringstring O nome do contato de suporte.The name of the support contact.
linkslinks ResourceLinksResourceLinks Os links relacionados ao contato de suporte.The support contact related links.
Atributosattributes ResourcegroupResourceAttributes Os atributos de metadados.The metadata attributes. Contém "objectType": "SupportContact".Contains "objectType": " SupportContact".

RegisterSubscriptionRegisterSubscription

O recurso RegisterSubscription retorna um link que pode ser usado para consultar o status de registro de uma assinatura.The RegisterSubscription resource returns a link that can be used to query the registration status of a subscription. O status do registro é retornado no corpo da resposta de uma solicitação aceita com êxito para registrar uma assinatura do Azure.The registration status is returned in the response body of a successfully accepted request to register an Azure subscription.

PropriedadeProperty TipoType DescriçãoDescription
httpResponseMessagehttpResponseMessage objetoobject Retorna o código de status HTTP 202 "aceito", com um cabeçalho de local que contém um link para consultar o status do registro.Returns HTTP Status Code 202 "Accepted", with a Location header containing a link to query the registration status. Por exemplo, "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"For example, "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"

RefundOptionRefundOption

O recurso RefundOption representa uma possível opção de reembolso para a assinatura.The RefundOption resource represents a possible refund option for the subscription.

PropriedadeProperty TipoType DescriçãoDescription
tipotype cadeia de caracteresstring O tipo de reembolso.The type of refund. Os valores com suporte são "partial" e "Full"The supported values are "Partial" and "Full"
expiresAfterexpiresAfter cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format O carimbo de data/hora quando essa opção expira.The timestamp when this option expires. Se for NULL, isso significa que ele não tem expiração.If null, this means it has no expiration.

AzureEntitlementAzureEntitlement

O recurso AzureEntitlement representa os direitos do Azure para a assinatura.The AzureEntitlement resource represents the Azure entitlements for the subscription.

PropriedadeProperty TipoType DescriçãoDescription
idid stringstring O identificador de direitoThe entitlement identifier
friendlyNamefriendlyName stringstring O nome amigável do direito.The friendly name of the entitlement.
statusstatus stringstring O status de direito.The status of entitlement.
subscriptionIdsubscriptionId stringstring O identificador de assinatura ao qual o direito pertence.The subscription identifier the entitlement belongs to.