Obter transições
Aplica-se a
- Partner Center
Funções apropriadas
- Agente de administração
Observação
As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (provedores de soluções em nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.
Usado para obter o histórico de transições para um determinado cliente e assinatura. O histórico inclui todos os eventos que foram processados para a transição. Isso só dá suporte a transições de assinatura baseadas em licença de novo comércio.
Pré-requisitos
Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Uma ID do cliente (
customer-tenant-id
). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o workspace Clientes, o cliente da lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id
).Uma ID de assinatura para a assinatura transferida.
Solicitação REST
[GET] clientes/{id do locatário do cliente}/assinaturas/{id da assinatura}/transições
Sintaxe da solicitação
Método | URI da solicitação |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1 |
Parâmetro do URI
Use os parâmetros de consulta a seguir para retornar transições qualificadas.
Nome | Digitar | Obrigatória | Descrição |
---|---|---|---|
id de locatário do cliente | guid | Y | Um GUID correspondente ao locatário do cliente. |
id da assinatura | guid | Y | Um GUID correspondente à assinatura inicial. |
ID da operação | guid | N | Um GUID para identificar exclusivamente uma transição e acompanhar seu status. |
Cabeçalhos da solicitação
Para obter mais informações, confira Cabeçalhos REST do Partner Center.
Corpo da solicitação
Nenhum
Exemplo de solicitação
GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Resposta REST
Se for bem-sucedido, isso retornará um histórico de transições para a assinatura fornecida.
Códigos de êxito e de erro de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de Erro.
Exemplo de resposta
HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT
{
"transition": [
{
"operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
"FromCatalogItemId": "CFQ7TTC0LDPB:0001:CFQ7TTC0LGNT",
"ToCatalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0K9G9",
"quantity": 1,
"transitionType": "transition_with_license_transfer",
"Events": [
{
"name": "Conversion",
"status": "Started ",
"timestamp": "2021-01-08T18:01:14.7488618Z",
"attributes":
{
"objectType": "TransitionEvent"
}
},
{
"name": "Conversion",
"status": "Completed",
"timestamp": "2021-01-08T18:37:41.591855Z",
"attributes":
{
"objectType": "TransitionEvent"
}
}
],
"attributes":
{
"objectType": "Transition"
}
}
],
"attributes":
{
"objectType": "Collection"
}
}