Criar um complemento
Aplica-se a: Windows Azure Pack
Cria um complemento.
Solicitação
Especifique a solicitação Criar Complemento da seguinte maneira: substitua <ServiceMgmt> pelo endereço do ponto de extremidade da API de Gerenciamento de Serviço.
Método |
URI da solicitação |
Versão HTTP |
|---|---|---|
POST |
<https:// ServiceMgmt>:30004/addons |
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. O 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
O corpo da solicitação inclui os seguintes elementos.
Nome do elemento |
Descrição |
|---|---|
PlanAddon |
Para obter mais informações, consulte PlanAddon (objeto Administrador). |
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 200 (OK).
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
A tabela a seguir descreve os elementos do corpo da resposta.
Nome do elemento |
Descrição |
|---|---|
PlanAddon |
Um objeto que representa o novo complemento. Para obter mais informações, consulte PlanAddon (objeto Administrador). |
Exemplo
O exemplo de código a seguir mostra uma solicitação Criar Complemento .
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 exemplo de código a seguir mostra uma resposta Criar Complemento .
{
"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
}