Partilhar via


Criar um Add-on

 

Aplica-se a: Windows Azure Pack

Cria um complemento.

Pedir

Especifique o pedido de Adicionar da seguinte forma: Substitua <o ServiceMgmt> pelo seu endereço de ponto final API de Gestão de Serviços.

Método

URI do pedido

Versão HTTP

POST

<https:// ServiceMgmt>:30004/addons

HTTP/1.1

Parâmetros do URI

Nenhum.

Pedido cabeçalhos

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.

Cabeçalho do pedido

Description

Autorização: Portador

Obrigatório. O sinal do portador da autorização.

x-ms-principal-id

Obrigatório. O identificador principal.

x-ms-cliente-pedido-id

Opcional. O identificador de pedido do cliente.

x-ms-cliente-sessão-id

Opcional. O identificador da sessão do cliente.

x-ms-principal-liveid

Opcional. O principal identificador ao vivo.

Corpo do Pedido

O corpo de pedido inclui os seguintes elementos.

Nome do elemento

Descrição

PlanAddon

Para mais informações, consulte PlanAddon (objeto administrador).

Resposta

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

Código de Estado

Uma operação bem sucedida devolve o código de estado 200 (OK).

Para obter informações sobre códigos de estado, consulte Códigos de Estado e de Erro (Windows Gestão de Serviços de Pacote Azure).

Cabeçalhos de Resposta

A resposta para esta operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos standard estão de acordo com a especificação do protocolo HTTP/1.1.

Corpo de Resposta

A tabela seguinte descreve os elementos do corpo de resposta.

Nome do elemento

Descrição

PlanAddon

Um objeto que representa o novo addon. Para mais informações, consulte PlanAddon (objeto administrador).

Exemplo

O seguinte exemplo de código mostra um pedido de Add-on Create .

POST https://<Computer>:30004/addons HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-session-id: d19ca528-d7bf-4a62-9d4d-03adbb4f6c74
x-ms-principal-id: <COMPUTER>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <COMPUTER>\Administrator
Content-Type: application/json; charset=utf-8
Host: <Computer>:30004
Content-Length: 512
Expect: 100-continue

{
  "Id": "GoldAhihps8jy",
  "DisplayName": "GoldAddon",
  "State": 0,
  "ConfigState": 0,
  "QuotaSyncState": 2,
  "LastErrorMessage": null,
  "Advertisements": [
    {
      "LanguageCode": "en-us",
      "DisplayName": "GoldAddon",
      "Description": null
    }
  ],
  "ServiceQuotas": [
    {
      "ServiceName": "sqlservers",
      "ServiceInstanceId": "7BAD5022-79CA-4B53-8177-1ACAEEAFA099",
      "ServiceDisplayName": "SQL Servers",
      "ServiceInstanceDisplayName": null,
      "ConfigState": 0,
      "QuotaSyncState": 2,
      "Settings": [

      ]
    }
  ],
  "SubscriptionCount": 0,
  "AssociatedPlans": [

  ],
  "MaxOccurrencesPerPlan": 0,
  "Price": null
}

O seguinte exemplo de código mostra uma resposta Dedeseme de Criar .

{
  "Id": "GoldAhihps8jy",
  "DisplayName": "GoldAddon",
  "State": 0,
  "ConfigState": 0,
  "QuotaSyncState": 0,
  "LastErrorMessage": null,
  "Advertisements": [
    {
      "LanguageCode": "en-us",
      "DisplayName": "GoldAddon",
      "Description": null
    }
  ],
  "ServiceQuotas": [
    {
      "ServiceName": "sqlservers",
      "ServiceInstanceId": "7BAD5022-79CA-4B53-8177-1ACAEEAFA099",
      "ServiceDisplayName": "SQL Servers",
      "ServiceInstanceDisplayName": "SQL Servers",
      "ConfigState": 0,
      "QuotaSyncState": 0,
      "Settings": [

      ]
    }
  ],
  "SubscriptionCount": 0,
  "AssociatedPlans": [

  ],
  "MaxOccurrencesPerPlan": 1,
  "Price": null
}

Consulte também

Interfaces adicionais de administrador