Atualizar o nome amigável de uma assinatura

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Atualiza o nome amigável de uma assinatura.

Solicitação

Substitua <ServiceMgmt> pelo endereço do ponto de extremidade da API de Gerenciamento de Serviços. Substitua <SubscriptionId> pelo identificador de assinatura da Assinatura necessária.

Método	URI da solicitação	Versão HTTP
PATCH	<https:// ServiceMgmt>:30005/subscriptions/<SubscriptionId>	HTTP/1.1

Parâmetros de URI

Nenhum.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Autorização: Portador	Obrigatórios. Token de portador de autorização.
x-ms-principal-id:	Obrigatórios. O identificador principal.
x-ms-client-request-id:	Opcional. O identificador de solicitação do cliente.
x-ms-client-session-id:	Opcional. O identificador da sessão do cliente.
x-ms-principal-liveid:	Opcional. O identificador live principal.

Corpo da solicitação

A tabela a seguir descreve os elementos do corpo da solicitação.

Subscription

Um objeto Subscription (common object) com os seguintes elementos definidos:

Elemento	Descrição
SubscriptionID	O identificador da assinatura.
SubscriptionName	O nome da assinatura atualizada.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de status

Uma operação bem-sucedida retorna o código de status 204 (SEM CONTEÚDO). 404 se os parâmetros de URI estiverem incorretos. 404 se os parâmetros de URI estiverem incorretos.

Para obter informações sobre códigos de status, consulte Status e Códigos de Erro (Windows Gerenciamento de Serviço do Azure Pack).

Cabeçalhos de resposta

A resposta para essa operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos padrão estão em conformidade com a especificação de protocolo HTTP/1.1.

Corpo da resposta

Nenhum.

Exemplo

O exemplo de código a seguir mostra uma solicitação atualizar nome amigável da assinatura .

PATCH https://<Computer>:30005/subscriptions/1e0a2baf-c455-4613-932a-86d046d0e113 HTTP/1.1
Authorization: <Token>
x-ms-client-request-id: 134e00b3-1d39-4724-b09e-563f1c3c2546-2013-06-28 22:07:33Z
x-ms-client-session-id: fd7d55ae-4ea5-4624-b086-0522a50c87b2
x-ms-principal-id: person@contoso.com
Accept-Language: en-US
x-ms-principal-liveid: person@contoso.com
Content-Type: application/json; charset=utf-8
Host: <Computer>:30005
Content-Length: 410
Expect: 100-continue

{
  "SubscriptionID": "1e0a2baf-c455-4613-932a-86d046d0e113",
  "SubscriptionName": "FirstSubscription",
  "AccountAdminLiveEmailId": null,
  "ServiceAdminLiveEmailId": null,
  "CoAdminNames": null,
  "AddOnReferences": [

  ],
  "AddOns": [

  ],
  "State": 0,
  "QuotaSyncState": 0,
  "ActivationSyncState": 0,
  "PlanId": null,
  "Services": [

  ],
  "LastErrorMessage": null,
  "Features": null,
  "OfferFriendlyName": null,
  "OfferCategory": null,
  "Created": "0001-01-01T00:00:00"
}

Consulte Também

Interfaces de assinatura de locatário

Compartilhar via